MVTec Software GmbH
  Building Vision For Business
Halcon

HALCON 5.2 FG interface for the Matrox Meteor board

This document provides some information about the HALCON framegrabber interface Meteor.dll for the Matrox framegrabber board Meteor. 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: 1.32

System Requirements

  • Intel compatible PC with Windows NT 4.0 (Service Pack 3).
  • 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 framegrabber board. Note that this interface was created based on the Matrox DLLs version 4.0.
  • HALCON framegrabber interface Meteor.dll (revision 1.30 or higher).
    Older revisions may be not compatible with HALCON 5.2. If you have properly installed the interface, Meteor.dll should reside in bin\i486-nt4 within the HALCON base directory %HALCONROOT% you have chosen during the installation of HALCON.

Features

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

Limitations

  • Only one framegrabber 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 'Meteor' 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. 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. Default: 1.
Width 0, width The width of the desired image part ('0' stands for for the complete image). Default: 0.
Height 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.
Bits 8, 24 Number of bits per pixel: Grayscale (8 bits) or color (24 bits). Specifies the video input (together with the parameters 'Generic' and 'Port'); please refer to the table below. Default: 24.
ColorSpace 'rgb' Desired color space. Default: 'rgb'.
Gain --- Ignored.
ExternalTrigger 'false' External triggering is not supported. Default: 'false'.
Generic 'NTSC', 'PAL', see below The generic parameter is used to specify the video signal: 'NTSC' or 'PAL'. Default: 'PAL'.
Furthermore, there exist 13 more values for the parameter 'Generic' 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 'Bits' and 'Generic'): '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 Bits/Generic/Port combinations:

Generic Bits Port Video Input
'M_RS170' 8 2 monochrome RS-170, 640x480, 12.5 MHZ, analog
'M_RS170_LOW' 8 2 monochrome RS-170, 512x480, 10.0 MHZ, analog
'M_CCIR' 8 2 monochrome CCIR, 768x576, 14.8 MHZ, analog
'M_NTSC' 24 2 color NTSC, 640x480, 12.5 MHZ, composite
'M_NTSC_RGB' 24 3 color NTSC RGB, 640x480, 12.5 MHZ
'M_NTSC_YC' 24 1 color NTSC Y/C (SVHS), 640x480, 12.5 MHZ
'M_NTSC_LOW' 24 2 color NTSC, 512x480, 10.0 MHZ, composite
'M_NTSC_YC_LOW' 24 1 color NTSC Y/C (SVHS), 512x480, 10.0 MHZ
'M_PAL' 24 2 color PAL I, 768x576, 14.8 MHZ, composite
'M_PAL_RGB' 24 3 color PAL I RGB, 768x576, 14.8 MHZ
'M_PAL_YC' 24 1 color PAL I Y/C (SVHS), 768x576, 14.8 MHZ
'M_SECAM' 24 2 color SECAM, 768x576, 14.8 MHZ, composite
'M_SECAM_RGB' 24 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 framegrabber interface Meteor.dll.

Release Notes

  • Revision 1.32 (March 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 (March 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