Back to Aurora Vision Library website

You are here: Start » Function Reference » Camera Support » GoPxL » GoPxL_GrabImages

GoPxL_GrabImages


Header: ThirdPartySdk.h
Namespace: avl
Module: ThirdParty

Captures images from GoPxL device.

Syntax

bool avl::GoPxL_GrabImages
(
	GoPxL_State& ioState,
	const atl::Optional<avl::GoPxLAddress>& inAddress,
	int inInputQueueSize,
	atl::Optional<int> inSourceID1,
	atl::Optional<int> inSourceID2,
	avl::Image& outImage1,
	avl::Image& outImage2,
	avl::GoPxLFrameInfo& outFrameInfo
)

Parameters

Name Type Range Default Description
Input will be modified ioState GoPxL_State& Object used to maintain state of the function.
Input value inAddress const Optional<GoPxLAddress>& NIL GoPxL Device identifying IP address (e.g. "127.0.0.1" or "127.0.0.1:3600") or serial number (e.g. "SN:17335")
Input value inInputQueueSize int 1 - 50000 Number of incoming frames that can be buffered before the application is able to process them
Input value inSourceID1 Optional<int> -1 - NIL ID of the data source in Gocator Protocol 1
Input value inSourceID2 Optional<int> -1 - NIL ID of the data source in Gocator Protocol 2
Output value outImage1 Image& Image 1
Output value outImage2 Image& Image 2
Output value outFrameInfo GoPxLFrameInfo& Frame metadata

Remarks

Device driver software

This filter is intended to cooperate with a Gocator device running GoPxL firmware. It is not required to install any additional software to connect to the device.

Device identification

When there is only one device connected, the field inAddress can be set to Auto. In this situation, the first available device will be used.

inAddress can be used to pick one of multiple devices connected to the computer. inAddress can be set to:

  • IP Address - GoPxL Device identifying IP address (e.g. "127.0.0.1" or "127.0.0.1:3600")
  • Serial Number - GoPxL Device serial number with "SN:" prefix (e.g. "SN:17335")
Gocator Protocol data source ID

When the fields inSourceID1 and inSourceID2 are set to Auto, all data sources of type Image would be processed by this filter. To process only specific data sources, set the values of these fields to appropriate IDs. Data source IDs can be found in the GoPxL web interface, under Control/Gocator tab. To disable one or both outputs of this filter set the corresponding IDs to -1.

See Also

  • GoPxL_GrabPoint3DGrid_WithTimeout – Captures Point3DGrid (not resampled surface) from GoPxL device with timeout; returns Nil if no data comes in the specified time.