Configuration#
Windows#
To use ItalaApiPython the user should install the itala wheel with the standard Python packet manager: pip. The Itala wheel requires Python 3.8.0 or higher.
The wheel is located under Development\bindings
.
...Development\bindings> pip install itala-1.0.0-....whl
ItalaApiPython is available to the user code under the itala
module in the itala
package. For example:
from itala import itala
For hardware or network configuration instructions, please refer to the manual of the camera.
Linux#
To use ItalaApiPython the user should install the itala wheel with the standard Python packet manager: pip. The Itala wheel requires Python 3.8.0 or higher.
The wheel is located under /bindings
.
.../bindings> pip install itala-1.0.0-....whl
ItalaApiPython is available to the user code under the itala
module in the itala
package. For example:
from itala import itala
For hardware or network configuration instructions, please refer to the manual of the camera.
IP Configurator#
To configure cameras network addresses a command line IP configurator is provided on Linux only. You can find the executable under /opt/itala-sdk/
.
To list all the available devices you can simply execute:
/opt/itala-sdk/itala-ipconfig list
To have a complete overview of the commands (staticip
, dhcp
, forceip
) available please execute it with --help
.
Firmware Updater#
To update the firmare a command line Firmware Updater is provided on Linux only. You can find the executable under /opt/itala-sdk/
.
To have a complete list of the available commands please execute the updater with --help
.
For instance: to list all the available devices you can simply execute:
/opt/itala-sdk/itala-fwupdate list
GenTL Producer#
A GenTL producer implementation (ItalaGenTL.cti file) is provided along with ItalaApiNET. The path of the producer is automatically added to the GENICAM_GENTL64_PATH variable so that GenTL consumers on the machine can use ItalaGenTL. Under Linux, the changes in the variable are effetive only after a new login of the user.
Device Emulation#
The Itala GenTL producer implementation provides a convenient way to experiment with its functionalities by emulating a simple camera, referred to as Virtual Camera This way, there is no need to have a physical device connected to the host. Despite the set of functionalities of the virtual camera is kept minimal, it’s sufficient to understand how the camera configuration and acquisition processes work.
To activate the virtual device functionality, a specific environment variable must be manually defined:
ITALA_VIRTUAL_CAMERA_COUNT = 2
The value of the variable states the number of virtual devices available on the host. Once the variable is set, the device can be enumerated and accessed in the usual way, both from GenTL and the API.
Warning
Due to the restricted set of of feature available Wizards and IP Configurator in Itala View are not supported.
Logging#
The logging functionality of ItalaApi is based on the Log4Cpp library and it can be activated by placing the logging configuration file logging.properties in the working directory of the user application.
The file is available in the Development\logging
folder under Windows and /opt/itala-sdk/logging
under Linux. By editing it (with the Log4Cpp syntax) the user
is able to customize the logging level, output and more.