Configure a FFmpeg Camera
A ffmpeg camera uses a camera, a video file, or a stream as a camera.
On the COMPONENTS subtab, navigate to the Create Component menu.
Enter a name for your camera, select the type camera, and select the ffmpeg model.
Fill in the attributes for your ffmpeg camera:
{
"name": "<camera_name>",
"type": "camera",
"model" : "ffmpeg",
"attributes": {
"intrinsic_parameters": {
"width_px": <integer>,
"height_px": <integer>,
"fx": <float64>,
"fy": <float64>,
"ppx": <float64>,
"ppy": <float64>
},
"distortion_parameters": {
"rk1": <float64>,
"rk2": <float64>,
"rk3": <float64>,
"tp1": <float64>,
"tp2": <float64>
},
"debug": <boolean>,
"video_path": <string>,
"input_kw_args": { ... },
"filters": [
{
"name": <string>,
"args": [ <string>, <string>, ... ],
"kw_args": { ... }
}
],
"output_kw_args": { ... },
}
}
The following attributes are available for ffmpeg cameras:
| Name | Inclusion | Description |
|---|---|---|
intrinsic_parameters | Optional | The intrinsic parameters of the camera used to do 2D <-> 3D projections:
|
distortion_parameters | Optional | Modified Brown-Conrady parameters used to correct for distortions caused by the shape of the camera lens:
|
debug | Optional | Enables the debug outputs from the camera if true. Defaults to false. |
video_path | Required | The file path to the color image. |
input_kw_args | Optional | The input keyword arguments. |
filters | Optional | The file path to the depth image. Array of filter objects that specify:
|
output_kw_args | Optional | The output keyword arguments. |
View the camera stream
Once your camera is connected, go to the CONTROL tab, and click on the camera’s dropdown menu. Toggle “View Camera”. If everything is configured correctly, you will see the live video feed from your camera.
