HALCON 5.2 FG interface for DT315x boards

This document provides some information about the HALCON framegrabber interface DT315x.dll for the Data Translation framegrabber boards DT3152, DT3153, and DT3155. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 1.24

• Intel compatible PC with Windows NT 4.0 (Service Pack 3).
• Successfully installed Data Translation driver DT3152.sys, DT3153.sys, or DT3155.sys, respectively.
• Data Translation DLLs olfg32.dll and olimg32.dll.
  These DLLs must be within your search path %PATH% (typically, they reside in the directory C:\Winnt\system32). If you do not have these DLLs, please contact Data Translation or the vendor from which you bought the framegrabber board. Note that this interface was created based on olfg32.dll and olimg32.dll version 2.00.0.
• HALCON Framegrabber interface DT315x.dll revision 1.24 or higher.
  Older revisions are not compatible with HALCON 5.2. If you have properly installed the interface, DT315x.dll should reside in bin\i486-nt4 within the HALCON base directory %HALCONROOT% you have chosen during the installation of HALCON.

• Multiple framegrabber boards with multiple cameras.
• Synchronous and asynchronous grabbing.
• External trigger.
• Subsampling.
• Cropping of image parts (DT3152 only).
• Software control of grabbing timeout.
• Software control of "black" and "white" level.
• Software control of sync mode and field to be grabbed.

• grab_region and grab_region_async not supported.
• No LUTs.

Parameters for open_framegrabber():

	Name	'DT315x'	The name of the HALCON framegrabber interface.
	FGWidth	1, 2, 4, width	The desired image resolution. Use '1' for full resolution, '2' for subsampling by factor 2, '4' for subsampling by factor 4, or the corresponding absolute values 640, 320, 160 (NTSC) or 768, 384, 192 (PAL). Default: 1.
	FGHeight	1, 2, 4, height	The desired image resolution. Use '1' for full resolution, '2' for subsampling by factor 2, '4' for subsampling by factor 4, or the corresponding absolute values 480, 240, 120 (NTSC) or 576, 288, 144 (PAL). Default: 1.
	Width	0, width	The width of the desired image part (use '0' for the complete image). Values other than '0' are only supported by the DT3152. Default: 0.
	Height	0, height	The height of the desired image part (use '0' for the complete image). Values other than '0' are only supported by the DT3152. Default: 0.
	StartRow	0, row	The row coordinate of the upper left pixel within the desired image part (use '0' for the complete image). Values other than '0' are only supported by the DT3152. Default: 0.
	StartColumn	0, column	The column coordinate of the upper left pixel within the desired image part (use '0' for the complete image). Values other than '0' are only supported by the DT3152. Default: 0.
	Field	---	Ignored.
	Bits	8, 24	Number of bits per pixel: Grayscale (8 bits) or color (24 bits). 24 bits are supported by the DT3153 only. Default: 8.
	ColorSpace	---	Ignored.
	Gain	---	Ignored.
	ExternalTrigger	'true', 'false'	Activate/deactivate external triggering. Default: 'false'.
	Generic	'default', 'volatile'	In the volatile mode (8 bits only) the two framegrabber interface buffers are used directly to store HALCON images. This is the fastest mode avoiding to copy raw image data in memory. However, be aware that older images are overwritten again and again as a side-effect. Thus, you can only process one image while you grab another image. Older images are invalid!
	Device	'default', 'name'	The name of the framegrabber board you have specified during the installation of the Data Translation software. Use 'default' if there is only one framegrabber board in your PC.
	Port	---	Ignored.
	LineIn	1, 2, ...	The desired input line, i.e., camera (if you use multiple cameras per framegrabber board). Default: 1.

Parameters for set_framegrabber_param():

Note that all these settings are valid for all input lines, i.e., cameras connected to one framegrabber board.

	'timeout'	seconds	The timeout value for the grabbing of images.
	'sync_sentinel'	'enable', 'disable'	Activate/deactivate the "Sync Sentinel" of the board (see the Data Translation documentation for details).
	'based_source'	'enable', 'disable'	Activate/deactivate the "Based Source Mode" (see the Data Translation documentation for details).
	'frame_type'	'even_field_first', 'odd_field_first', 'next_field_first', 'even_field_only', 'odd_field_only', 'next_field_only', 'noninterlaced'	Select which field should be grabbed (see the Data Translation documentation for details).
	'watch_dog'	'enable', 'disable'	Activate/deactivate the experimental watchdog timer. Note that Data Translation fails to return an error code in order to detect timeouts. Thus, the previous image is delivered again and again. With this watch dog enabled, a HALCON error is reported instead.
	'black_level'	millivolts	The desired voltage level for 'black' pixels in millivolts (floating point number). The valid range for a particular board can (and should) be queried via get_framegrabber_param() calls with 'Param' set to 'black_level_min' and 'black_level_max', respectively.
	'white_level'	millivolts	The desired voltage level for 'white' pixels in millivolts (floating point number). The valid range for a particular board can (and should) be queried via get_framegrabber_param() calls with 'Param' set to 'white_level_min' and 'white_level_max', respectively.

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 framegrabber interface DT315x.dll.
	'black_level_min'	millivolt	The minimum allowed voltage level for 'black' pixels in millivolts (floating point number).
	'black_level_max'	millivolt	The maximum allowed voltage level for 'black' pixels in millivolts (floating point number).
	'white_level_min'	millivolt	The minimum allowed voltage level for 'white' pixels in millivolts (floating point number).
	'white_level_max'	millivolt	The maximum allowed voltage level for 'white' pixels in millivolts (floating point number).

• Revision 1.24 (March 22, 1999):
  
  • HALCON 5.2 version of the interface (included in the HALCON 5.2 CD).
• Revision 1.23 (July 7, 1998):
  
  • Support of the programmable ADC with new parameters 'white_level' and 'black_level' added. Also added 'white/black_level_min/max' (get_framegrabber_param only).
• Revision 1.19 (May 28, 1998):
  
  • LineIn selection for single instance (one camera per board) debugged.
  • Parameter 'revision' (get_framegrabber_param only).
• Revision 1.18 (March 10, 1998):
  
  • HALCON 5.1 version of the interface (included in the HALCON 5.1 CD).
• Revision 1.17 (February 12, 1998):
  
  • External triggering is now individually available for each input line of a single framegrabber board.
  • The "Based Source Mode" can be activated/deactivated via set_framegrabber_param(FGHandle, 'based_source', 'enable/disable').
  • The bug in the query 'generic' in info_framegrabber() has been eliminated.