Back to Adaptive 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.