Configuration

Some parameters of the Pylon driver classes can be configured via a TOML configuration file.

Configuration Options

The configuration file has to be in TOML format. Below is an overview of the supported sections/settings and their default values. All settings are optional. If not specified the default values are used.

[pylon_driver]
pylon_settings_file = "path/to/default_pylon_camera_settings.txt"

[tricamera_driver]
frame_rate_fps = 10.0

pylon_driver

Settings concerning all Pylon cameras.

pylon_settings_file

Path to the file containing the settings for the Pylon SDK (see Pylon Settings). If not set, the default settings file shipped with this package is used (see Default Pylon Camera Settings).

tricamera_driver

Settings specific to TriCameraDriver.

frame_rate_fps

Frequency at which frames are fetched from the cameras. Important: This is limited by the AcquisitionFrameRate setting in the Pylon Settings, i.e. make sure to set AcquisitionFrameRate >= frame_rate_fps.

How to use the custom configuration

To use the file, simply write the path to the environment variable TRIFINGER_CAMERA_CONFIG:

export TRIFINGER_CAMERA_CONFIG="/path/to/config.toml"

Alternatively, if you instantiate the PylonDriver or TriCameraDriver classes in your own code, you can create a Settings instance (specify the path to the TOML file in the constructor) and pass this to the constructor of the driver class.

Pylon Settings

The driver for Pylon cameras uses the Pylon SDK, which allows configuration of camera settings like frame rate, white balancing, etc. These settings are stored in a file, which is loaded by the PylonDriver class during initialisation. The path to this file can be configured through the pylon_settings_file setting (see above).

This package ships with a default settings file (see Default Pylon Camera Settings). For simple changes like adjusting the frame rate, you may simply copy that file and change the corresponding values. For more complex changes, it is recommended to use the graphical interface of the Pylon Viewer application (part of the SDK) and then save the settings to a file using pylon_dump_camera_settings.