GStreamer - ZED X One Camera Source
GStreamer - ZED X One Camera Source
The GStreamer element ZED X One Camera Source, zedxonesrc, allows for the injection of the monocular camera color stream from ZED X One to a GStreamer pipeline.
Properties
$ blocksize : Size in bytes to read per buffer (-1 = default) $ flags: readable, writable $ Unsigned Integer. Range: 0 - 4294967295 Default: 4096 $ camera-flip : Mirror image vertically if camera is flipped $ flags: readable, writable $ Boolean. Default: false $ camera-fps : Camera frame rate $ flags: readable, writable $ Enum "GstZedXOneSrcFPS" Default: 30, "30 FPS" $ (120): 120 FPS - Only with SVGA. Not with ZED X One 4K $ (60): 60 FPS - Not available with 4K mode $ (30): 30 FPS - Available with all the resolutions $ (15): 15 FPS - Available with all the resolutions $ camera-id : Select camera from cameraID $ flags: readable, writable $ Integer. Range: -1 - 255 Default: -1 $ camera-resolution : Camera Resolution $ flags: readable, writable $ Enum "GstZedXOneSrcResol" Default: 2, "HD1200" $ (4): 4K - 3840x2160 (only ZED X One 4K) $ (3): QHDPLUS - 3200x1800 (only ZED X One 4K) $ (2): HD1200 - 1920x1200 $ (1): HD1080 - 1920x1080 $ (0): SVGA - 960x600 (only ZED X One GS) $ camera-sn : Select camera from the serial number $ flags: readable, writable $ Integer64. Range: 0 - 999999999 Default: 0 $ camera-timeout : Connection opening timeout in seconds $ flags: readable, writable $ Float. Range: 0.5 - 86400 Default: 5 $ ctrl-analog-gain : Camera control: Analog Gain value $ flags: readable, writable $ Integer. Range: 1000 - 30000 Default: 30000 $ ctrl-auto-analog-gain: Enable Automatic Analog Gain $ flags: readable, writable $ Boolean. Default: true $ ctrl-auto-analog-gain-range-max: Maximum Analog Gain for the automatic analog gain setting $ flags: readable, writable $ Integer. Range: 1000 - 30000 Default: 30000 $ ctrl-auto-analog-gain-range-min: Minimum Analog Gain for the automatic analog gain setting $ flags: readable, writable $ Integer. Range: 1000 - 30000 Default: 1000 $ ctrl-auto-digital-gain: Enable Automatic Digital Gain $ flags: readable, writable $ Boolean. Default: true $ ctrl-auto-digital-gain-range-max: Maximum Digital Gain for the automatic digital gain setting $ flags: readable, writable $ Integer. Range: 1 - 256 Default: 256 $ ctrl-auto-digital-gain-range-min: Minimum Digital Gain for the automatic digital gain setting $ flags: readable, writable $ Integer. Range: 1 - 256 Default: 1 $ ctrl-auto-exposure : Enable Automatic Exposure $ flags: readable, writable $ Boolean. Default: true $ ctrl-auto-exposure-range-max: Maximum exposure time in microseconds for the automatic exposure setting $ flags: readable, writable $ Integer. Range: 1024 - 66666 Default: 66666 $ ctrl-auto-exposure-range-min: Minimum exposure time in microseconds for the automatic exposure setting $ flags: readable, writable $ Integer. Range: 1024 - 66666 Default: 1024 $ ctrl-denoising : Denoising factor $ flags: readable, writable $ Integer. Range: 0 - 100 Default: 50 $ ctrl-digital-gain : Digital Gain value $ flags: readable, writable $ Integer. Range: 1 - 256 Default: 3 $ ctrl-exposure-compensation: Exposure Compensation $ flags: readable, writable $ Integer. Range: 0 - 100 Default: 50 $ ctrl-exposure-time : Exposure time in microseconds $ flags: readable, writable $ Integer. Range: 1024 - 66666 Default: 10000 $ ctrl-gamma : Image gamma $ flags: readable, writable $ Integer. Range: 1 - 9 Default: 2 $ ctrl-saturation : Image saturation $ flags: readable, writable $ Integer. Range: 0 - 8 Default: 4 $ ctrl-sharpness : Image sharpness $ flags: readable, writable $ Integer. Range: 0 - 8 Default: 1 $ ctrl-whitebalance-auto: Image automatic white balance $ flags: readable, writable $ Boolean. Default: true $ ctrl-whitebalance-temperature: Image white balance temperature $ flags: readable, writable $ Integer. Range: 2800 - 6500 Default: 4200 $ do-timestamp : Apply current stream time to buffers $ flags: readable, writable $ Boolean. Default: false $ enable-hdr : Enable HDR if supported by resolution and frame rate. $ flags: readable, writable $ Boolean. Default: false $ name : The name of the object $ flags: readable, writable, 0x2000 $ String. Default: "zedxonesrc0" $ num-buffers : Number of buffers to output before sending EOS (-1 = unlimited) $ flags: readable, writable $ Integer. Range: -1 - 2147483647 Default: -1 $ opencv-calibration-file: Optional OpenCV Calibration File $ flags: readable, writable $ String. Default: "" $ parent : The parent of the object $ flags: readable, writable, 0x2000 $ Object of type "GstObject" $ typefind : Run typefind before negotiating (deprecated, non-functional) $ flags: readable, writable, deprecated $ Boolean. Default: false $ verbose-level : ZED SDK Verbose level $ flags: readable, writable $ Integer. Range: 0 - 999 Default: 1
Example pipelines
Display the color stream on the screen with FPS information
This simple pipeline starts the ZED X One grabbing using the default parameters of the zedxonesrc element and automatically converts (autovideoconvert) the frames to the correct format for the fpsdisplaysink element in order to be displayed on the screen with FPS information.
$ gst-launch-1.0 zedxonesrc ! queue ! autovideoconvert ! queue ! fpsdisplaysink
The queue element is used to decouple frames in a different queue thread, useful for data synchronization for more complex pipelines.
When using the ZED X One 4K model, you can leverage the full 4K resolution:
$ gst-launch-1.0 zedxonesrc camera-resolution=3 camera-fps=15 ! queue ! autovideoconvert ! queue ! fpsdisplaysink
When using the ZED X One GS model, you can stream frames at 1200p resolution with 60 Hz freqeuncy:
$ gst-launch-1.0 zedxonesrc camera-resolution=2 camera-fps=60 ! queue ! autovideoconvert ! queue ! fpsdisplaysink