MVTec Software GmbH
  Building Vision For Business
Halcon

HALCON 7.0 Frame Grabber Interface for DT315x Boards

This page provides the documentation of the HALCON frame grabber interface HFGDT315x.dll for the Data Translation frame grabber boards DT3152, DT3153, and DT3155. 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 4.0 (Service Pack 4) or Windows 2000.
  • 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 frame grabber board. Note that this interface was created based on olfg32.dll and olimg32.dll version 2.00.0.
  • HALCON frame grabber interface HFGDT315x.dll or parHFGDT315x.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 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.

Limitations

  • grab_region() and grab_region_async() not supported.
  • No LUTs.

Description

Parameters for open_framegrabber():

Name 'DT315x' The name of the HALCON frame grabber interface.
HorizontalResolution 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.
VerticalResolution 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.
ImageWidth 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.
ImageHeight 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 Number of bits per channel: 8 bit grayscale and color (see parameter ColorSpace). Color is supported by the DT3153 only. Default: 8.
ColorSpace 'gray', 'rgb' Desired color space. Default: 'gray'.
Gain --- Ignored.
ExternalTrigger 'true', 'false' Activate/deactivate external triggering. Default: 'false'.
CameraType 'default', 'volatile' In the volatile mode (color space 'gray' only) the two frame grabber 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 frame grabber board you have specified during the installation of the Data Translation software. Use 'default' if there is only one frame grabber board in your PC.
Port 1, 2, ... The desired input line, i.e., camera (if you use multiple cameras per frame grabber board). Default: 1.
LineIn --- Ignored.

Parameters for set_framegrabber_param():

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

'based_source' 'enable', 'disable' Activate/deactivate the "Based Source Mode" (see the Data Translation documentation for details).
'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.
'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).
'sync_sentinel' 'enable', 'disable' Activate/deactivate the "Sync Sentinel" of the board (see the Data Translation documentation for details).
'timeout' seconds The timeout value for the grabbing of images.
'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 watchdog enabled, a HALCON error is reported instead.
'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().

'black_level_max' millivolt The maximum allowed voltage level for 'black' pixels in millivolts (floating point number).
'black_level_min' millivolt The minimum allowed voltage level for 'black' pixels in millivolts (floating point number).
'revision' revision The revision number of the HALCON DT315x frame grabber interface.
'white_level_max' millivolt The maximum allowed voltage level for 'white' pixels in millivolts (floating point number).
'white_level_min' millivolt The minimum allowed voltage level for 'white' pixels in millivolts (floating point number).

Release Notes

  • Revision 2.2 (Dec 10, 2004):
    • The setting of the desired input line has changed from the LineIn to the Input parameter of open_framegrabber. For backward compatibility the LineIn parameter is still in use.
    • 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.1 (Nov 11, 2000):
    • HALCON 7.0 version of the interface (included in HALCON 7.0 CD).
    • HALCON 6.1 version of the interface (included in HALCON 6.1 CD).
    • Bugfix in cleaning up internal structures if open_framegrabber() fails.
    • Bugfix in close_framegrabber().
    • Bugfix in accessing color images.
  • Revision 2.0 (Sep 20, 2000):
    • Adaptation to the HALCON 6.0 frame grabber interface.
  • Revision 1.24 (Mar 22, 1999):
    • HALCON 5.2 version of the interface (included in the HALCON 5.2 CD).
  • Revision 1.23 (Jul 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 (Mar 10, 1998):
    • HALCON 5.1 version of the interface (included in the HALCON 5.1 CD).
  • Revision 1.17 (Feb 12, 1998):
    • External triggering is now individually available for each input line of a single frame grabber 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.

© Copyright 2008, MVTec Software GmbH, corporate/legal/privacy information






Last modified: Fri Apr 22 10:18:53 CEST 2005