HALCON 9.0 Image Acquisition Interface for VRmagic AreaScan3D Cameras

This page provides the documentation of the HALCON image acquisition interface for VRmagic AreaScan3D cameras. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 4.1

System Requirements

• Intel compatible PC with Windows XP/Vista/7.
• Successfully installed VRmAreaScan3D driver A3DSensor.dll (SDK version 2.3 or higher).
  If you do not have this driver version, please contact VRmagic or the vendor from which you bought the camera.
• HALCON image acquisition interface hAcqVRmAreaScan3D.dll or hAcqVRmAreaScan3D.dll, respectively. If you have properly installed the interface, all these DLLs should reside in bin\%HALCONARCH% within the HALCON base directory %HALCONROOT% you have chosen during the installation of HALCON.

Features

• Grabbing of distance images: Each call of the operator grab_data starts a new measurement and returns the depth image (as an 16 bit gray-value image), the texture image (as a three-channel RGB image), the valid image (as HALCON region which can be applied to the depth image by calling the operator reduce_domain), and the three scaling factors for x, y, and z.
• Grabbing of live images via grab_image or grab_image_async.
• Software control of brightness, measurement mode and projected pattern.

Limitations

• No triggering.
• No support of grab_data_async.

Description

Parameters for open_framegrabber():

	Name		'VRmAreaScan3D'		The name of the HALCON image acquisition interface.
	HorizontalResolution		---		Ignored. Default: 1 (full resolution).
	VerticalResolution		---		Ignored. Default: 1 (full resolution).
	ImageWidth		---		Ignored. Default: 1 (full resolution).
	ImageHeight		---		Ignored. Default: 1 (full resolution).
	StartRow		---		Ignored. Default: 0.
	StartColumn		---		Ignored. Default: 0.
	Field		---		Ignored. Default: 'default'.
	BitsPerChannel		---		Ignored. Default: 8.
	ColorSpace		---		Ignored. Default: 'gray'.
	Generic		---		Ignored. Default: -1.0.
	ExternalTrigger		---		Ignored. Default: 'false'.
	CameraType		---		Ignored. Default: 'default'.
	Device		ip_address, 'default'		IP address of the camera. Default: 'default'.
	Port		---		Ignored. Default: 0.
	LineIn		---		Ignored. Default: 0.

Parameters for set_framegrabber_param():

	'brightness'		min...max		Specifies the desired brightness. Default: 1 (minimum level).
	'do_project_pattern'		1, 2, 3, 4, 5		Sets specific pattern for projection. Default: None.
	'measurement_mode'		1, 2, 3		Specifies the desired measurement mode. Default: Specific to device.

Parameters for get_framegrabber_param():

Additional parameters supported by get_framegrabber_param only. Note that all parameters supported by set_framegrabber_param except the ones with prefix 'do_' can also be accessed by get_framegrabber_param. Furthermore, corresponding to the parameters supported by set_framegrabber_param, there may exist additional read-only parameters with the following postfixes:

• '_description': These parameters provide the tooltip of the corresponding parameter as a string.
• '_range': These parameters provide the minimum, maximum, stepwidth, and default values for the corresponding integer or float parameter as a tuple with 4 elements, e.g., get_framegrabber_param(..,'brightness_range',..) will return the output tuple [min,max,step,default]. Optionally, this tuple can also contain additional valid string values like 'auto' or 'manual'.
• '_values': These parameters provide the valid value list for the corresponding parameter as a tuple, e.g., get_framegrabber_param(..,'measurement_mode_values',..) will return the output tuple ['enable','disable'].

	'revision'		revision (string)		The revision number of the HALCON interface.
	'serial'		serial_number (long)		Serial number of the camera.

Release Notes

• Revision 4.1 (Mar 9, 2011):
  • Adapted to SDK version 2.3.
• Revision 4.0 (Aug 25, 2010):
  • First official release.