HALCON 8.0 Image Acquisition Interface for dPict Aexeon and Nexeon CL Boards

This page provides the documentation of the HALCON dPict interface for Aexeon and Nexeon CL frame grabber boards from dPict Imaging. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 3.2

System Requirements

• Intel compatible PC with Windows NT/2000/XP.
• Successfully installed dPict Imaging dVeloper Foundation SDK. Note that for using the HALCON dPict interface you need a valid camera configuration in your dpconfig.dpx file which must be created using the dPiction application!
• HALCON image acqusition interface hAcqdPict.dll or parhAcqdPict.dll, respectively.
  If you have properly installed the interface, both DLLs should reside in bin\%HALCONARCH% within the HALCON base directory %HALCONROOT% you have chosen during the installation of HALCON.

Features

• Multiple frame grabber boards.
• Support of a variety of analog and CameraLink cameras based on the dPict camera configuration files.
• Synchronous and asynchronous grabbing.

Limitations

• grab_data and grab_data_async not supported.
• No LUTs.
• External trigger not supported.
• Color images not yet supported.

Description

Parameters for open_framegrabber():

	Name		'dPict'		The name of the HALCON image acquisition interface.
	HorizontalResolution		---		Ignored (the size of the desired image part will be set according to the settings in the camera configuration file).
	VerticalResolution		---		Ignored (the size of the desired image part will be set according to the settings in the camera configuration file).
	ImageWidth		---		Ignored.
	ImageHeight		---		Ignored.
	StartRow		---		Ignored.
	StartColumn		---		Ignored.
	Field		---		Ignored.
	BitsPerChannel		8, 10, 12, 14, 16		Number of bits per image channel. Default: 8.
	ColorSpace		'gray'		Specify the desired color space and thus the number of image channels of the resulting HALCON image. Default: 'gray'.
	Generic		---		Ignored.
	ExternalTrigger		---		Ignored.
	CameraType		'configname'		Specify the name of the camera configuration in the dpconfig.dpx file. A valid camera configuration can be created with the tool dPiction. 'default' uses the standard default configuration. Default: 'default'.
	Device		'<BoardType>:<index>', 'default'		Select the frame grabber board to connect. The type (Aexeon or Nexeon) and the index ('0', '1', ...) of the frame grabber board (passed as one string), e.g. 'Aexeon:0'. 'default' selects the first detected board. Default: 'default'.
	Port		---		Ignored.
	LineIn		---		Ignored.

Parameters for set_framegrabber_param():

	'grab_timeout'		100 ... 327680		Specifies the desired timeout (milliseconds passed as an integer) for aborting a pending grab. Default: 5000.
	'linescan_trigger_high'		-1, 1, 2, 3, ...		Sets the time (in microseconds) of the high period of the CC1 signal. If no delay is desired, set it to -1.
	'linescan_trigger_low'		-1, 1, 2, 3, ...		Sets the time (in microseconds) of the low period of the CC1 signal. If no second transition is desired, set it to -1.
	'trigger_signal'		'high_active', 'low_active'		Specifies the polarity of the trigger signal. Default: 'low_active'.

Parameters for get_framegrabber_param():

Additional parameters supported by get_framegrabber_param only. Note that all parameters supported by set_framegrabber_param 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(..,'exposure_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(..,'volatile_values',..) will return the output tuple ['enable','disable'].

	'revision'		revision		The revision number of the HALCON dPict interface.

Release Notes

• Revision 3.2 (Aug 13, 2008):
  • info_framegrabber('info_boards') now returns an empty string instead of a NULL pointer to enable the basic auto-detection of actually available devices in the HDevelop Image Acquisition Assistant.
• Revision 3.1 (Apr 22, 2008):
  • Added read-only parameters with postfix '_description', '_range', and '_values' to enable the easy parameterization via a generic graphical user interface.
• Revision 3.0 (May 15, 2007):
  • HALCON 8.0 version of the interface (included in HALCON 8.0 DVD).
• Revision 2.1 (Oct 25, 2006):
  • Added parameters 'linescan_trigger_low', 'linescan_trigger_high', and 'trigger_signal' to support line scan cameras.
• Revision 2.0 (May 5, 2006):
  • First official release.