The Imaging Source Linux Repository
This repository will give you additional resources to control your TIS camera.
What do we offer?
- gstreamer elements
- gobject introspection
- uvc extensions
- examples on how to interact with your camera
You can find an online version of the included user documentation here:
Version 1.0.0 introduces several API changes.
To port your software check our upgrade guide
The following device types are not supported going forward:
A complete compatibility list can be found here: https://www.theimagingsource.com/documentation/tiscamera/supported-devices.html
Compilation dependencies for debian can be found be executing:
./scripts/dependency-manager list --compilation
Runtime dependencies for debian can by executing:
./scripts/dependency-manager list --runtime
On a Debian / Ubuntu system, the following command line can be used to install all required packages in one go:
The following commands will build and install our software with default settings.
git clone https://github.com/TheImagingSource/tiscamera.git cd tiscamera # only works on Debian based systems like Ubuntu sudo ./scripts/dependency-manager install mkdir build cd build # With ARAVIS: cmake -DTCAM_BUILD_ARAVIS=ON .. # Without ARAVIS cmake -DTCAM_BUILD_ARAVIS=OFF .. make sudo make install
The default installation prefix is
Some components have to be installed in
If you want to change the prefix, read the section installation directories in our documentation.
The most important cmake options are:
-DTCAM_BUILD_ARAVIS=<ON/OFF> Build tiscamera with support for GigE cameras via aravis.
-DTCAM_BUILD_TOOLS=<ON/OFF> Build additional tools for camera interaction (e.g. firmware tools and tcam-capture).
-DTCAM_BUILD_V4L2=<ON/OFF> Build tiscamera with support for USB cameras via UVC/V4L2.
-DTCAM_BUILD_LIBUSB=<ON/OFF> Build tiscamera with support for USB cameras via LibUsb (i.e. AFU420, AFU050, DFK73).
-DTCAM_BUILD_DOCUMENTATION=<ON/OFF> Build html user documentation.
-DCMAKE_INSTALL_PREFIX Installation target prefix (defaults to /usr/)
For a complete overview, read the section cmake options in out documentation.
Optional for GigE-Vision devices: Start the gige-daemon
GigE-Vision cameras have a several seconds long delay before they can be reliably detected on the network.
To speed up this process for applications, a background daemon is built and installed, which detects cameras before an application starts. The following commands will activate the daemon on your system:
sudo systemctl daemon-reload # make systemd aware of gige-daemon sudo systemctl enable gige-daemon.service # start on every boot sudo systemctl start gige-daemon.service # start the actual daemon sudo systemctl status gige-daemon.service # check if statemd say everything is ok
Where to go from here
After installation you can try one of our examples or directly start with a gstreamer pipeline like:
gst-launch-1.0 tcambin ! videoconvert ! ximagesink
For questions simply open a ticket or write us a mail at firstname.lastname@example.org.
All files are published under the Apache License 2.0, unless otherwise noted.
PugiXml 1.6, which is available under the "MIT" license.
The json library by Niels Lohmann, which is available under the "MIT" license.
7z, which is published as public domain.
aravis, which is available under the LGPLv2.
CLI11, available under the 3-Clause BSD-License
Catch2, which is published under the Boost Software License, Version 1.0
spdlog, which is available under the "MIT" license.
fmt, which is available under the "MIT" license.