HALCON 6.1 Frame Grabber Interface for Feith Sensor To Image Ramses-1 Boards

This page provides the documentation of the HALCON frame grabber interface HFGRamses1.dll for the Feith Sensor To Image frame grabber board Ramses-1v2. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 2.1

• Intel compatible PC with Windows NT 4.0 (Service Pack 4) or Windows 2000.
• Successfully installed Ramses-1 driver.
• Feith Sensor To Image DLL ra1v2.dll.
  This DLL must be within your search path %PATH%. Typically it resides in C:\Winnt\system32. Note that HFGRamses1.dll was built and tested with version 2 of ra1v2.dll. If you do not have this DLL, please contact Feith Sensor To Image or the vendor from which you bought the frame grabber board.
• HALCON frame grabber interface HFGRamses1.dll or parHFGRamses1.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.

• Multiple frame grabber boards with one camera per board.
• Synchronous and asynchronous grabbing.
• External trigger.
• Support of analog (standard) or digital (Takenaka FC1300) cameras (depending on the hardware setup of the Ramses-1 board).
• Software control of the type of trigger signal.

• Only one camera per frame grabber board.
• No subsampling or cropping of image parts.
• No LUTs.
• grab_region() and grab_region_async() not supported.

Parameters for open_framegrabber():

	Name	'Ramses1'	The name of the HALCON frame grabber interface.
	HorizontalResolution	1, width	The desired image resolution. Use '1' for full resolution or the corresponding absolute values 640 (NTSC), 768 (PAL), or 1476 (FC1300). Default: 1.
	VerticalResolution	1, height	The desired image resolution. Use '1' for full resolution or the corresponding absolute values 480 (NTSC), 576 (PAL), or 1000 (FC1300). Default: 1.
	ImageWidth	0	The width of the desired image part ('0' stands for the complete image). Default: 0.
	ImageHeight	0	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 ('0' obviously results in delivering the complete image). Default: 0.
	StartColumn	0	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	Ramses-1 boards support only grayscale grabbing. Default: 8.
	ColorSpace	'gray'	Ramses-1 boards support only grayscale grabbing.
	Gain	---	Ignored.
	ExternalTrigger	'true', 'false'	Activate/deactivate external triggering. Default: 'false'.
	CameraType	'ntsc', 'pal', 'fc1300'	The CameraTupe parameter is used to specify the video signal: 'ntsc' (default), 'pal', or 'fc1300' (digital camera by Takenaka).
	Device	'1', '2', '3'	The number of the frame grabber board (passed as a string!). Default: '1'.
	Port	---	Ignored.
	LineIn	1	Fixed.

Parameters for set_framegrabber_param():

	'trigger_signal'		'falling', 'rising'		Specify the desired type of trigger signal for external triggering (default: 'rising').
	'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!

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

	'pci_transfer_rate'		rate		Get the PCI transfer rate of your PC in MB per second.
	'revision'		revision		The revision number of the HALCON Ramses1 frame grabber interface.

• Revision 2.1 (November 13th, 2000):
  
  • HALCON 6.1 version of the interface (included in HALCON 6.1 CD).
  • Adaptation to Ramses1 V2 SDK.
• Revision 2.0 (September 20th, 2000):
  
  • Adaptation to the HALCON 6.0 frame grabber interface.
• Revision 1.8 (March 22, 1999):
  
  • HALCON 5.2 version of the interface (included in the HALCON 5.2 CD).
• Revision 1.6 (March 10, 1998):
  
  • HALCON 5.1 version of the interface.