HALCON 7.1 Frame Grabber 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: 2.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 frame grabber interface HFGdPict.dll or parHFGdPict.dll, respectively.
  If you have properly installed the interface, both DLLs should reside in bin\i586-nt4 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_region and grab_region_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 frame grabber 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'.
	Gain		---		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.

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

Release Notes

• Revision 2.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 HDevelop.
• 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.