HALCON 5.2 frame grabber interface for MATRIX Vision boards

This document provides some information about the HALCON frame grabber interface MatrixVision.dll for the MATRIX Vision boards MVdelta, MVsigma, PCimage, and MVtitan. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 1.0

• Intel compatible PC with Windows NT 4.0 (Service Pack 4).
• Successfully installed MATRIX Vision driver from the MATRIX Vision Driver CD (CD2000/A or higher).
• Successfully installed MVpilot with MVacquireControl (version 3.68 or higher).
  If you do not find this version on your CD, please download it from the MATRIX Vision WWW server.
• Working on Windows NT you should enable at least the following advanced user right (via the Windows NT administration program User Manager): 'Increase scheduling priority' (for the German version of Windows NT: 'Anheben der Zeitplanungspriorität').
• HALCON frame grabber interface MatrixVision.dll (revision 1.0 or higher).
  If you have properly installed the interface, MatrixVision.dll should reside in bin\i486-nt4 within the HALCON base directory %HALCONROOT% you have chosen during the installation of HALCON.

• Multiple frame grabber boards.
• Multiple compatible cameras per board.
• Synchronous and asynchronous grabbing.
• External trigger (not available for MVdelta).
• Support of a large variety of analog and digital cameras based on the MATRIX Vision camera configurations.
• Online configuration via the MVacquireControl.

• No subsampling or cropping of image parts.
• No LUTs.
• grab_region and grab_region_async not supported.

Parameters for open_framegrabber():

	Name	'MatrixVision'	The name of the HALCON frame grabber interface.
	FGWidth	1	Ignored (the desired image resolution is set via the camera configuration specified in the Generic parameter or via the online camera control dialog!). Default: 1.
	FGHeight	1	Ignored (the desired image resolution is set via the camera configuration specified in the Generic parameter or via the online camera control dialog!). Default: 1.
	Width	0, width	The width of the desired image part ('0' stands for the complete image). Default: 0.
	Height	0, height	The height of the desired image part ('0' stands for the complete image). Default: 0.
	StartRow	0	The row coordinate of the upper left pixel within the desired image part. Default: 0.
	StartColumn	0	The column coordinate of the upper left pixel within the desired image part. Default: 0.
	Field	---	Ignored (the desired field is set via the camera configuration specified in the Generic parameter or via the online camera control dialog!).
	Bits	8, 24	Number of bits per pixel: Gray scale (8 bits) or color (24 bits). Note that not all MATRIX Vision board types support both modes! Default: 8.
	ColorSpace	---	Ignored.
	Gain	---	Ignored.
	ExternalTrigger	'true', 'false'	Activate/deactivate external triggering. Note that this setting overrides the corresponding setup in the camera configuration. Default: 'false'.
	Generic	'configname'	The generic parameter is used to specify the camera configuration which is stored in the Windows NT registry. To check a camera or to alter the camera configuration file, use the MVconfig program delivered with the MATRIX Vision software.
	Device	---	Ignored.
	Port	number	Specifies the port the camera is connected to. The possible values (default: 1) depend on the specific board type:    MVdelta: number = 1, 2, 3, 4    MVsigma: number = 1, 2, 3, 4    PCimage-SG: number = 1, 2, 3, 4    PCimage-SRGB: number = 1, 2    PCimage-SDIG: number is ignored.    MVtitan-C16: number = 1, 2, 3, 4    MVtitan-G1: number = 1, 2, 3, 4    MVtitan-DIG: number = 1, 2, 3, 5
	LineIn	---	Ignored.

Parameters for set_framegrabber_param():

	'volatile'	'enable', 'disable'	In the volatile mode the two frame grabber interface buffers are used directly to store HALCON images. This is the fastest mode avoiding to copy raw images 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! Default: 'disable'.
	'dialog'	'enable', 'disable'	Open/close the online acquire control of the MATRIX Vision configuration software. Using this dialog you can modify the settings of the current camera configuration. Default: 'disable'.
	'grab_timeout'	msec	Specify the desired timeout (milliseconds passed as an integer) for aborting a pending grab (without external triggering). Default: 1000.
	'trigger_timeout'	msec	Specify the desired timeout (milliseconds passed as an integer) for aborting a pending grab when using an external trigger. Default: 10000.
	'port'	number	Switch to the camera connected to the specified port number (see the description of possible values above).

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 frame grabber interface MatrixVision.dll.

• Revision 1.0 (March 15, 2000):
  
  • First official release.