Back to Adaptive Vision Library website

You are here: Start » Function Reference » Camera Support » Gocator » Gocator_GrabPoint3DGrid_WithTimeout

Gocator_GrabPoint3DGrid_WithTimeout


Header: ThirdPartySdk.h
Namespace: avl
Module: ThirdParty

Captures Point3DGrid (Un-Resampled surface) from Gocator device with timeout; returns Nil if no data comes in the specified time.

Syntax

bool avl::Gocator_GrabPoint3DGrid_WithTimeout
(
	Gocator_State& ioState,
	const atl::Optional<avl::GocatorAddress>& inAddress,
	int inInputQueueSize,
	int inTimeout,
	atl::Conditional<avl::Point3DGrid>& outPoint3DGrid,
	atl::Conditional<avl::Image>& outSurfaceIntensity,
	atl::Conditional<avl::GocatorFrameInfo>& outFrameInfo
)

Parameters

Name Type Range Default Description
Input will be modified
 ioState Gocator_State& Object used to maintain state of the function.
Input value
 inAddress const Optional<GocatorAddress>& NIL Gocator Device identifying IP address (e.g. "127.0.0.1") 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
 inTimeout int 10 - 100 Maximum time to wait for data in milliseconds
Output value
 outPoint3DGrid Conditional<Point3DGrid>&
Output value
 outSurfaceIntensity Conditional<Image>&
Output value
 outFrameInfo Conditional<GocatorFrameInfo>&

Remarks

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 - Gocator Device identifying IP address (e.g. "127.0.0.1")
  • Serial Number - Gocator Device serial number with "SN:" prefix (e.g. "SN:17335")
Gocator emulator

This filter was tested with Gocator emulator in version 6.1.20.8.