# cameracalibrate

Performs camera calibration by having it point at a chessboard pattern using upstream/downstream cameraundistort

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──GstBaseTransform
                        ╰──GstVideoFilter
                            ╰──GstOpencvVideoFilter
                                ╰──cameracalibrate

## Factory details

Authors: – Philippe Renon

Classification: – `Filter/Effect/Video`

Rank – none

Plugin – opencv

Package – GStreamer Bad Plug-ins

## Pad Templates

### `sink`

    video/x-raw:
             format: RGBx
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: xRGB
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: BGRx
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: xBGR
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: RGBA
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: ARGB
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: BGRA
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: ABGR
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: RGB
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: BGR
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: GRAY8
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]

Presence – always

Direction – sink

Object type – GstPad

### `src`

    video/x-raw:
             format: RGBx
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: xRGB
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: BGRx
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: xBGR
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: RGBA
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: ARGB
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: BGRA
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: ABGR
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: RGB
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: BGR
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]
    video/x-raw:
             format: GRAY8
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]
          framerate: [ 0/1, 2147483647/1 ]

Presence – always

Direction – src

Object type – GstPad

## Properties

### aspect-ratio

    “aspect-ratio” gfloat

The aspect ratio

Flags : Read / Write

Default value : 1

### board-height

    “board-height” gint

The board height in number of items (e.g. number of squares for chessboard)

Flags : Read / Write

Default value : 6

### board-width

    “board-width” gint

The board width in number of items (e.g. number of squares for chessboard)

Flags : Read / Write

Default value : 9

### center-principal-point

    “center-principal-point” gboolean

Fix the principal point at the center

Flags : Read / Write

Default value : false

### corner-sub-pixel

    “corner-sub-pixel” gboolean

Improve corner detection accuracy for chessboard

Flags : Read / Write

Default value : true

### delay

    “delay” gint

Sampling periodicity in ms

Flags : Read / Write

Default value : 350

### frame-count

    “frame-count” gint

The number of frames to use from the input for calibration

Flags : Read / Write

Default value : 25

### pattern

    “pattern” Camera-calibration-pattern *

One of the chessboard, circles, or asymmetric circle pattern

Flags : Read / Write

Default value : chessboard (0)

### settings

    “settings” gchararray

Camera correction parameters (opaque string of serialized OpenCV objects)

Flags : Read

Default value : NULL

### show-corners

    “show-corners” gboolean

Show corners

Flags : Read / Write

Default value : true

### square-size

    “square-size” gfloat

The size of a square in your defined unit (point, millimeter, etc.)

Flags : Read / Write

Default value : 50

### use-fisheye

    “use-fisheye” gboolean

Use fisheye camera model for calibration

Flags : Read / Write

Default value : false

### zero-tangent-distorsion

    “zero-tangent-distorsion” gboolean

Assume zero tangential distortion

Flags : Read / Write

Default value : false

## Named constants

### Camera-calibration-pattern

#### Members

`chessboard` (0) – Chessboard
`circle_grids` (1) – Circle Grids
`asymmetric_circle_grids` (2) – Asymmetric Circle Grids

The results of the search are