Back to Aurora Vision Studio website

You are here: Start » Filter Reference » Hardware Support » Z4Sight » AILDigitizer_GrabMultiPartImage (AILDigitizer_GrabImage MultiPart)

AILDigitizer_GrabMultiPartImage (AILDigitizer_GrabImage MultiPart)

Advanced

Module: ThirdParty

Captures a multi-part image from the digitizer. Allows to receive multi-part video stream (with multiple images per frame) from multi-component devices, like separate depth, confidence and luminosity images in 3D cameras.

Name Type Range Description
Input value inDeviceID AILSystemAndDeviceIdentifierDigitizer* Device identification.
Input value inInputQueueSize Integer 1 - Capacity of output frames queue.
Input value inTimeout Integer 100 - Maximum time to wait for frame in milliseconds.
Input value inSkipInvalidFrames Bool Skips invalid frames.
Output value outFramePart1 Image? First part of the captured frame.
Output value outFramePart2 Image? Second part of the captured frame.
Output value outFramePart3 Image? Third part of the captured frame.
Output value outFramePart4 Image? Fourth part of the captured frame.
Output value outFrameData AILFrameInformation? Frame data of the captured frame.
Output value outFrameID Long? Frame ID set by the device.
Output value outTimestamp Long? Frame capture timestamp set by the device.

Remarks

I/O device driver software

This filter is intended to cooperate with AIL digitizer systems:

  • GigeVision - can work with cameras connected by Ethernet cable;
  • GenTL - AIL specific devices like Matrox CoaXPress GenTL Producer;
  • USB3Vision - can work with cameras connected by USB3 cable;
  • RapixoCxp and RapixoCL - Rapixo frame grabbers for CoaXPress and Camera Link protocols;
  • IrisGTX - Iris GTX Smart Camera;

To be able to connect to the device, it is required to install Zebra AIL X SDK (Lite or Full version).

Adding the DLL path to system environment variables may be required.

Recommended Zebra AIL X SDK version for Aurora Vision Studio usage is V23H2 (10.70.0963).

Device identification

System field is used to specify camera protocol.

  • Host
  • GigeVision
  • GenTL
  • USB3Vision
  • RapixoCxp
  • RapixoCL
  • IrisGTX

Device field specifies the hardware board identifier within the selected system. Device can be set to:

  • DEFAULT - Specifies the default board. The default board is set in the MILConfig utility.
  • DEVn - Specifies the device number (rank) of the board (where 0 <= n <=15).

GenTLProducerIndex field is used to specify the index of the GenTL Producer - index is between 0 and 127. It is used only when System is set to GenTL.

Digitizer field specifies how the camera should be accessed. Digitizer can be set to:

  • DEFAULT - Specifies the default board. The default board is set in the MILConfig utility.
  • DEVn - Specifies the device number (rank) of the board (where 0 <= n <=15).
  • CamIp - Specifies that camera should connect using its IP address.
  • CamName - Specifies that camera should connect using its name.

CamID field is used when Digitizer is set to CamIp or CamName.

Note: It is strongly recommended to set the appropriate Device and Digitizer parameter to avoid communication issues.
Warning:All tools applied to a specific device or file should be managed within a single thread to ensure centralized tracking, traceability, and consistency throughout the process.

Complexity Level

This filter is available on Advanced Complexity Level.

Disabled in Lite Edition

This filter is disabled in Lite Edition. It is available only in full, Aurora Vision Studio Professional version.

Filter Group

This filter is member of AILDigitizer_GrabImage filter group visible as MultiPart.