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 #
analog-gain : Analog Gain value in dB
flags: readable, writable
Float. Range: 0.1 - 30 Default: 1
anti-banding : AE Anti Banding
flags: readable, writable
Enum "GstZedXOneSrcAntiBanding" Default: 1, "Automatic"
(0): Disabled - Anti Banding disabled
(1): Automatic - Automatic Anti Banding
(2): 50 Hz - 50 Hz Anti Banding
(3): 60 Hz - 60 Hz Anti Banding
auto-analog-gain : Enable Automatic Analog Gain
flags: readable, writable
Boolean. Default: true
auto-analog-gain-range-max: Maximum Analog Gain in dB for the automatic analog gain setting
flags: readable, writable
Float. Range: 0.1 - 30 Default: 30
auto-analog-gain-range-min: Minimum Analog Gain in dB for the automatic analog gain setting
flags: readable, writable
Float. Range: 0.1 - 30 Default: 0
auto-digital-gain : Enable Automatic Digital Gain
flags: readable, writable
Boolean. Default: true
auto-digital-gain-range-max: Maximum Digital Gain for the automatic digital gain setting
flags: readable, writable
Float. Range: 1 - 256 Default: 256
auto-digital-gain-range-min: Minimum Digital Gain for the automatic digital gain setting
flags: readable, writable
Float. Range: 1 - 256 Default: 1
auto-exposure : Enable Automatic Exposure
flags: readable, writable
Boolean. Default: true
auto-exposure-range-max: Maximum exposure time in microseconds for the automatic exposure setting
flags: readable, writable
Integer. Range: 28 - 66000 Default: 66000
auto-exposure-range-min: Minimum exposure time in microseconds for the automatic exposure setting
flags: readable, writable
Integer. Range: 28 - 66000 Default: 28
auto-wb : Enable Automatic White Balance
flags: readable, writable
Boolean. Default: true
blocksize : Size in bytes to read per buffer (-1 = default)
flags: readable, writable
Unsigned Integer. Range: 0 - 4294967295 Default: 4096
camera-fps : Camera frame rate
flags: readable, writable
Enum "GstZedXOneSrcFPS" Default: 15, "15 FPS"
(120): 120 FPS - Only with SVGA. Not available with 4K mode
(60): 60 FPS - Not available with 4K mode
(30): 30 FPS - Not available with 4K mode
(15): 15 FPS - all resolutions (NO GMSL2)
camera-id : Select camera from cameraID
flags: readable, writable
Integer. Range: 0 - 255 Default: 0
camera-resolution : Camera Resolution
flags: readable, writable
Enum "GstZedXOneSrcResol" Default: 2, "HD1200"
(3): 4K - 3840x2160
(2): HD1200 - 1920x1200
(1): HD1080 - 1920x1080
(0): SVGA - 960x600
camera-timeout : Connection timeout in milliseconds
flags: readable, writable
Integer. Range: 100 - 100000000 Default: 1000
ctrl-aec-agc-roi-h : Auto gain/exposure ROI height (-1 to not set ROI)
flags: readable, writable
Integer. Range: -1 - 2160 Default: -1
ctrl-aec-agc-roi-w : Auto gain/exposure ROI width (-1 to not set ROI)
flags: readable, writable
Integer. Range: -1 - 3810 Default: -1
ctrl-aec-agc-roi-x : Auto gain/exposure ROI top left 'X' coordinate (-1 to not set ROI)
flags: readable, writable
Integer. Range: -1 - 3810 Default: -1
ctrl-aec-agc-roi-y : Auto gain/exposure ROI top left 'Y' coordinate (-1 to not set ROI)
flags: readable, writable
Integer. Range: -1 - 2160 Default: -1
denoising : Denoising factor
flags: readable, writable
Float. Range: 0 - 1 Default: 0.5
digital-gain : Digital Gain value
flags: readable, writable
Integer. Range: 1 - 256 Default: 128
do-timestamp : Apply current stream time to buffers
flags: readable, writable
Boolean. Default: false
exposure-compensation: Exposure Compensation
flags: readable, writable
Float. Range: -2 - 2 Default: 0
exposure-time : Exposure time in microseconds
flags: readable, writable
Integer. Range: 28 - 66000 Default: 2000
name : The name of the object
flags: readable, writable
String. Default: "zedxonesrc0"
num-buffers : Number of buffers to output before sending EOS (-1 = unlimited)
flags: readable, writable
Integer. Range: -1 - 2147483647 Default: -1
parent : The parent of the object
flags: readable, writable
Object of type "GstObject"
saturation : Color Saturation
flags: readable, writable
Float. Range: 0 - 2 Default: 1
sharpening : Image Sharpening
flags: readable, writable
Float. Range: 0 - 1 Default: 1
swap-rb : Swap Red and Blue color channels
flags: readable, writable
Boolean. Default: false
tone-map-gamma-b : Set the tone mapping curve from a gamma value (Channel B)
flags: readable, writable
Float. Range: 1.5 - 3.5 Default: 2
tone-map-gamma-g : Set the tone mapping curve from a gamma value (Channel G)
flags: readable, writable
Float. Range: 1.5 - 3.5 Default: 2
tone-map-gamma-r : Set the tone mapping curve from a gamma value (Channel R)
flags: readable, writable
Float. Range: 1.5 - 3.5 Default: 2
typefind : Run typefind before negotiating (deprecated, non-functional)
flags: readable, writable, deprecated
Boolean. Default: false
verbose-level : Capture Library Verbose level
flags: readable, writable
Integer. Range: 0 - 4 Default: 0
white-balance-temp : White Balance Temperature [°]
flags: readable, writable
Integer. Range: 2800 - 12000 Default: 5000
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