Back to Aurora Vision Library website

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

Gocator_GrabSection


Header: ThirdPartySdk.h
Namespace: avl
Module: ThirdParty

Captures Section from Gocator device.

Syntax

bool avl::Gocator_GrabSection
(
	Gocator_State& ioState,
	const atl::Optional<avl::GocatorAddress>& inAddress,
	int inInputQueueSize,
	int inSectionID,
	atl::Array<avl::Point2D>& outSectionData,
	atl::Conditional<avl::Profile>& outSectionIntensity,
	atl::real& outXScale,
	atl::real& outXOffset,
	atl::real& outZScale,
	atl::real& outZOffset,
	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 inSectionID int 0 -
Output value outSectionData Array<Point2D>&
Output value outSectionIntensity Conditional<Profile>&
Output value outXScale real& X scale in mm
Output value outXOffset real& X offset in mm
Output value outZScale real& Z scale in mm
Output value outZOffset real& Z offset in mm
Output value outFrameInfo 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.