Setup and Usage

Requirements

Either tiscamera or tiscamera-tcamproperty has to be installed before installing tiscamera-dutils. tcamdutils will only work when a tiscamera/tcampimipi/tcamtegrasrc source element is in the pipeline.

Dependencies

Additional dependencies:

  • libgstreamer1.0-0
  • libgstreamer-plugins-base1.0-0
  • libgirepository-1.0-1

Usage

The tiscamera-dutils project is a drop-in for our open source gstreamer elements that is optimized for performance. Furthermore it contains additional properties like tonemapping.

If you are using the tcambin for image retrieval you can continue doing so. The tcambin detects the presence of the tcamdutils and uses them automatically.

To disable this behavior set the property conversion-element to false.

tcambin conversion-element=tcamconvert ! ....

The tcamdutils uses automatic load balancing that distributes the image analysis / correction on all available cpu cores.

Manual Pipeline

tcamsrc ! video/x-bayer,format=bggr ! tcamdutils ! ...

Automatic Pipelines

If you want to use the tcambin you can set the property device-caps. This influences the internal caps negotiation to only allow that format.

tcambin device-caps="video/x-bayer,format=bggr12" ! video/x-raw,format=BGRx ! ....

The internal pipeline would look like:

tcamsrc ! video/x-bayer,format=bggr12 ! tcamdutils ! ...

The pipeline that is used can always be found in the gstreamer log output of tcambin. See tiscamera gstreamer logging documentation

Restrictions

Since release v0.14.0 the following architectures are supported:

  • amd64/x86_64 and (SSE 4.1 minimum, can use AVX2 when available)
  • arm64/aarch64
  • armhf on Pi4

Unsupported devices

Not supported are the following devices:

  • DFK AFU050-L34

Warning

Using these with tiscamera and tiscamera-dutils will likely prevent image retrieval.