MVTec Software GmbH
  Building Vision For Business
Halcon

HALCON 6.0 Frame Grabber Interface for Matrox Meteor-I Boards

This page provides the documentation of the HALCON frame grabber interface HFGMeteor1.dll for the Matrox frame grabber board Meteor-I. Registered customers can download the latest revision of this interface from the MVTec WWW server. Please note that this interface currently supports only basic grabbing functions!

Revision: 2.0

System Requirements

  • Intel compatible PC with Windows NT 4.0 (Service Pack 4).
  • Successfully installed MATROX driver Meteor.sys.
  • Matrox DLLs mil.dll, milhost.dll, milmet.dll, miltiff.dll, milvga.dll, and milvhook.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 Matrox or the vendor from which you bought the frame grabber board. Note that this interface was created based on the Matrox DLLs version 4.0.
  • HALCON frame grabber interface HFGMeteor1.dll or parHFGMeteor1.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

  • One frame grabber board with one camera.
  • Synchronous grabbing.
  • Subsampling.
  • Cropping arbitrary parts of an image.

Limitations

  • Only one frame grabber board with one camera.
  • No asynchronous grabbing (grab_image_async not supported).
  • No external trigger.
  • grab_region() and grab_region_async() not supported.
  • No LUTs.

Description

Parameters for open_framegrabber():

Name 'Meteor1' 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. 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. Default: 1.
ImageWidth 0, width The width of the desired image part ('0' stands for for the complete image). Default: 0.
ImageHeight 0, height The height of the desired image part ('0' stands for for the complete image). Default: 0.
StartRow 0, row The row coordinate of the upper left pixel within the desired image part ('0' obviously results in delivering the complete image). Default: 0.
StartColumn 0, column The column coordinate of the upper left pixel within the desired image part ('0' obviously results in delivering the complete image). Default: 0.
Field --- Ignored.
BitsPerChannel --- Ignored.
ColorSpace 'gray', 'rgb' Desired color space. Specifies the video input (together with the parameters CameraType and Port); please refer to the table below. Default: 'rgb'.
Gain --- Ignored.
ExternalTrigger 'false' External triggering is not supported. Default: 'false'.
CameraType 'ntsc', 'pal', see below The CameraType parameter is used to specify the video signal: 'ntsc' or 'pal'. Default: 'pal'.
Furthermore, there exist 13 more values for the parameter CameraType corresponding to the MATROX MIL library; please refer to the table below.
Device --- Ignored.
Port 1, 2, 3 Specifies the video input (together with the parameters BitsPerChannel and CameraType): '1' denotes the S-VHS jack, '2' the RCA (composite video) jack, and '3' the RGB (SUBD) jack; please see also the table below. Default: 1.
LineIn 1 The desired input line (fixed). Default: 1.

Specify the video input by the following ColorSpace/CameraType/Port combinations:

CameraType ColorSpace Port Video Input
'm_rs170' 'gray' 2 monochrome RS-170, 640x480, 12.5 MHZ, analog
'm_rs170_low' 'gray' 2 monochrome RS-170, 512x480, 10.0 MHZ, analog
'm_ccir' 'gray' 2 monochrome CCIR, 768x576, 14.8 MHZ, analog
'm_ntsc' 'rgb' 2 color NTSC, 640x480, 12.5 MHZ, composite
'm_ntsc_rgb' 'rgb' 3 color NTSC RGB, 640x480, 12.5 MHZ
'm_ntsc_yc' 'rgb' 1 color NTSC Y/C (SVHS), 640x480, 12.5 MHZ
'm_ntsc_low' 'rgb' 2 color NTSC, 512x480, 10.0 MHZ, composite
'm_ntsc_yc_low' 'rgb' 1 color NTSC Y/C (SVHS), 512x480, 10.0 MHZ
'm_pal' 'rgb' 2 color PAL I, 768x576, 14.8 MHZ, composite
'm_pal_rgb' 'rgb' 3 color PAL I RGB, 768x576, 14.8 MHZ
'm_pal_yc' 'rgb' 1 color PAL I Y/C (SVHS), 768x576, 14.8 MHZ
'm_secam' 'rgb' 2 color SECAM, 768x576, 14.8 MHZ, composite
'm_secam_rgb' 'rgb' 3 color SECAM RGB, 768x576, 14.8 MHZ

Parameters for set_framegrabber_param(): Not supported.

Parameters for get_framegrabber_param():

'revision' revision Revision of the HALCON frame grabber interface HFGMeteor1.dll.

Release Notes

  • Revision 2.0 (Sep 20, 2000):
    • Adaptation to the HALCON 6.x frame grabber interface.
  • Revision 1.32 (Mar 19, 1999):
    • HALCON 5.2 version of the interface (included in the HALCON 5.2 CD).
    • Two new values for the generic parameter in open_framegrabber(): 'NTSC', 'PAL'.
    • New parameter 'revision'; several bugfixes.
  • Revision 1.30 (Mar 10, 1998):
    • HALCON 5.1 version of the interface (included in the HALCON 5.1 CD).

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