HALCON 9.0 Image Acquisition Interface for DT3162 Boards

This page provides the documentation of the HALCON DT3162 image acquisition interface for the Data Translation frame grabber board DT3162. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 4.0

System Requirements

• Intel compatible PC with Windows 2000/XP.
• Successfully installed DT3162 device driver.
• HALCON image acquisition interface hAcqDT3162.dll or hAcqDT3162xl.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

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

Limitations

• grab_data and grab_data_async not supported.
• No LUTs.

Description

Parameters for open_framegrabber:

	Name		'DT3162'		The name of the HALCON image acquisition interface.
	HorizontalResolution		1		Ignored (the desired image resolution is set via the camera configuration file specified in the CameraType parameter!). Default: 1.
	VerticalResolution		1		Ignored (the desired image resolution is set via the camera configuration file specified in the CameraType parameter!). Default: 1.
	ImageWidth		---		Ignored.
	ImageHeight		---		Ignored.
	StartRow		---		Ignored.
	StartColumn		---		Ignored.
	Field		---		Ignored.
	BitsPerChannel		---		Ignored.
	ColorSpace		---		Ignored.
	Generic		---		Ignored.
	ExternalTrigger		---		Ignored (the desired trigger parameters are set via the camera configuration file specified in the CameraType parameter!).
	CameraType		'ccf_file'		The CameraType parameter is used to specify the desired camera configuration file. To check a camera or to alter the camera configuration file, use the DT Acquire program delivered with the DT3162 device driver.
	Device		'device'		Specify the desired board name. Default: 'DT3162-1'.
	Port		---		Ignored.
	LineIn		---		Ignored.

Parameters for set_framegrabber_param:

	'grab_timeout'		msec		Specify the desired timeout (milliseconds passed as an integer) for aborting a pending grab (the default value is specified in the camera configuration file).

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. 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		Revision of the HALCON DT3162 image acquisition interface.

Release Notes

• Revision 4.0 (Dec 1, 2008):
  • HALCON 9.0 version of the interface (legacy only).
• 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 (Jan 11, 2005):
  • HALCON 7.1 version of the interface (included in the HALCON 7.1 CD).
  • The query types 'bits_per_channel', 'camera_type', 'color_space', 'device', 'external_trigger', 'field', and 'port' for info_framegrabber provide now specific value lists for the corresponding parameters in open_framegrabber.
• Revision 2.0 (Nov 20, 2003):
  • HALCON 7.0 version of the interface (included in the HALCON 7.0 CD).
  • First official release.