HALCON 6.1 Frame Grabber Interface for The Imaging Source DFG VideoPort Cards

This page provides the documentation of the HALCON frame grabber interface HFGVideoPort.dll for the The Imaging Source frame grabber PCMCIA card DFG VideoPort. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 2.0

• Intel compatible PC with Windows NT 4.0 (Service Pack 4).
• Successfully installed DFG VideoPort driver Ms80x.sys.
  Typically, this file resides in the directory C:\Winnt\system32\drivers). If you do not have this driver, please contact the vendor from which you bought the frame grabber card.
• DFG VideoPort 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 the vendor from which you bought the frame grabber card.
• HALCON frame grabber interface HFGVideoPort.dll or parHFGVideoPort.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.

• 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 frame grabber interface.
	HorizontalResolution	1, 2, 4, width	The desired horizontal 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 vertical 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	8	Number of bits per image channel which delivers the board via the PCI bus. VideoPort supports 8 bit for 'gray' and 'rgb' (8-8-8 coded) ColorSpace. Default: 8.
	ColorSpace	'gray', 'rgb'	Specify the desired color space and thus the number of image channels of the resulting HALCON image. Default: 'rgb'.
	Gain	---	Ignored.
	ExternalTrigger	---	Ignored.
	CameraType	'ntsc', 'pal', 'auto'	Specifies the video input. The latter will do an automatic analysis of the signal. 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 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'.

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().