System#
- itala.itala.create_system()#
Entry point of the runtime. It allocates all necessary resources and creates the system instance. Only one system can be created at a time. If a system instance is already alive, a call to this function leads to an error.
- Return type:
- Returns:
Created system instance.
- class itala.itala.ISystem(*args, **kwargs)#
Bases:
IDisposable
Root of the API. This interface represents the whole runtime and its main task is to provide functions for device enumeration and configuration. Only one system can be created at a time. It encloses the functionalities defined by the GenTL standard. The ownership of the system instance belongs to the client code: it needs to be disposed when it’s no longer required via ISystem::Dispose.
- property thisown#
The membership flag
- enumerate_devices(*args)#
Overload 1:
Enumerates devices across all interfaces. The maximum number of enumerated devices is 255.
- Parameters:
timeout (int) – maximum amount of time in ms for the enumeration to terminate.
- Return type:
DeviceInfoList
- Returns:
A list of information objects identifying each enumerated device.
Overload 2:
Enumerates all devices under a specific network interface. The maximum number of enumerated devices is 255.
- Parameters:
itfInfo (
InterfaceInfo
) – info object identyfing the interface to be used for enumeration.timeout (int) – maximum amount of time in ms for the enumeration to terminate.
See also: EnumerateDevices()
Overload 3:
Enumerates all devices under a list of specific interfaces. The maximum number of enumerated devices is 255.
- Parameters:
itfInfos (
InterfaceInfoList
) – list of info objects identyfing the interfaces to be used for enumeration.timeout (int) – maximum amount of time in ms for the enumeration to terminate.
See also: EnumerateDevices()
- create_device(devInfo)#
Creates a device instance which represents a physical device, given its identyfing info. The maximum number of simultaneously created devices is 50. When no longer needed, device instances must be disposed via IDevice::Dispose. The filter driver and packet resend functionalities are automatically enabled for the created device instance. Make sure the filter driver component is enabled on the NIC the device is connected to.
- Parameters:
devInfo (
DeviceInfo
) – info object identyfing the device to be created.- Return type:
- Returns:
Pointer to the created device instance.
- enumerate_interfaces()#
Enumerates the available network interfaces.
- Return type:
InterfaceInfoList
- Returns:
List of information objects identifying each interface found.
- property node_map: INodeMap#
Get the GenICam nodemap of the GenTL System module. The nodemap instance is accessible via GenApi library and allows the user to configure the behaviour of the system. The nodemap is owned by ItalaApi thus it’s returned by reference.
- Return type:
- Returns:
System nodemap.
- property interface_node_map: INodeMap#
Get the GenICam nodemap of a network interface. The nodemap instance is accessible via GenApi library and allows the user to configure the behaviour of the interface. The nodemap is owned by ItalaApi thus it’s returned by reference.
- Return type:
- Returns:
Nodemap of the requested interface.