Usage¶
Using tiscamera¶
To list the cameras attached via CSI or FPD-Link:
tcam-ctrl -l
Output will be in the style of:
Model: DFM 37CX390-ML Serial: 45020098 Type: pimipi
To show a live-stream with this camera a simple example command is:
gst-launch-1.0 tcambin ! ximagesink
This starts the tcampimipisrc with the first camera connected and displays a simple live-stream.
See https://www.theimagingsource.com/support/downloads-for-linux/install/tiscameraarm6432/ for a download link.
Using tiscamera-dutils¶
The Imaging Source provides a module that implemnents many highly optimized transformations and additional properties.
See https://www.theimagingsource.com/support/downloads-for-linux/install/tiscameradutilsarmhfpi/ for a download link.
Directly using the tcampimipisrc gstreamer element¶
The tcampimipisrc package contains 2 gstreamer elements
- tcampimipisrc, as the actual gstreamer source filter
- tcamby1xtransform, as a helper filter to convert the packed raw bayer data to video/x-bayer data
When you start a pipeline, you have to convert the input format the sensor delivers via tcamby1xtransform and then bayer2rgb.
A live video window can be started like this:
gst-launch-1.0 tcampimipisrc ! tcamby1xtransform ! bayer2rgb ! ximagesink
GStreamer object properties¶
The tcampimipisrc object has the following gstreamer properties:
serial
- Specifies/fetches the serial number of the current device.
- In
state == GST_STATE_NULL
it can be written, to set the device to open when changing toGST_STATE_READY
. - In
state >= GST_STATE_READY
this is read-only. - When empty, the first available device is opened and then reading in
GST_STATE_READY
returns the actual serial of thr first device found.
max-queued-gst-buffers
- Specifies the count of buffers to queue in gstreamer before dropping additional buffers.
do-timestamp
- Apply current stream time to buffers (Internally this sets
gst_base_src_set_do_timestamp
)
- Apply current stream time to buffers (Internally this sets
drop-incomplete-buffer
- Enable/disable incomplete buffer dropping. If this is enabled, incomplete buffers can be delivered.
show-overlay
- Debug property that enables a overlay with information about the current image stream.