HALCON 5.2 FG interface for the MRT VideoPort Professional PCMCIA card

This document provides some information about the HALCON framegrabber interface VideoPort.dll for the MRT framegrabber PCMCIA card VideoPort Professional. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 1.5

• Intel compatible PC with Windows NT 4.0 (Service Pack 3).
• Successfully installed MRT driver Ms80x.sys.
  Typically, this file resides in the directory C:\Winnt\system32\drivers). If you do not have this driver, please contact MRT or the vendor from which you bought the framegrabber card.
• MRT DLL VPX32.dll.
  This DLL must be within your search path %PATH% (typically, it resides in the directory C:\Winnt\system32). If you do not have this DLL, please contact MRT or the vendor from which you bought the framegrabber card.
• HALCON Framegrabber interface VideoPort.dll.
  If you have properly installed the interface, VideoPort.dll should reside in bin\i486-nt4 within the HALCON base directory %HALCONROOT% you have chosen during the installation of HALCON.

• Synchronous grabbing.
• Asynchronous grabbing.
• Subsampling.
• Cropping arbitrary parts of an image.

• Only one PCMCIA card with one camera.
• grab_region and grab_region_async not supported.
• No LUTs.

Parameters for open_framegrabber():

	Name	'VideoPort'	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). Default: 8.
	ColorSpace	---	Ignored.
	Gain	---	Ignored.
	ExternalTrigger	---	Ignored.
	Generic	'NTSC', 'PAL', 'AUTO'	Specifies the video input. Default: 'AUTO'.
	Device	---	Ignored.
	Port	0, 1	Input channel of the imaging card. Default: 0.
	LineIn	---	Ignored.

Parameters for set_framegrabber_param():

	'volatile'	'enable', 'disable'	Grayscale only. In the volatile mode the two framegrabber 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: 'false'.

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	Revision of the HALCON framegrabber interface VideoPort.dll.

• Revision 1.5 (March 25, 1999):
  
  • HALCON 5.2 version of the interface (included in the HALCON 5.2 CD).
  • First official release.