HALCON 5.2 FG interface for the Cheops Ramses-1 board

This document provides some information about the HALCON framegrabber interface Ramses1.dll for the Cheops framegrabber board Ramses-1. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 1.9

• Intel compatible PC with Windows NT 4.0 (Service Pack 3).
• Successfully installed Cheops Ramses-1 driver.
• Cheops DLL ra1v2.dll.
  This DLL must be within your search path %PATH%. Typically it resides in C:\Winnt\system32. Note that Ramses1.dll was built and tested with version 2 of ra1v2.dll. If you do not have this DLL, please contact Cheops or the vendor from which you bought the framegrabber board.
• HALCON Framegrabber interface Ramses1.dll revision 1.9 or higher.
  Older versions may not be compatible with HALCON 5.2. Note that you can check the current version of the DLL after you opened the framegrabber via open_framegrabber using get_framegrabber_param(FGHandle,'revision',Revision). If this fails, you've got revision 1.5 or older. If you have properly installed the interface, Ramses1.dll should reside in bin\i486-nt4 within the HALCON base directory %HALCONROOT% you have chosen during the installation of HALCON.

• Multiple framegrabber 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 framegrabber 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 framegrabber interface.
	FGWidth	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.
	FGHeight	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.
	Width	0	The width of the desired image part ('0' stands for the complete image). Default: 0.
	Height	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.
	Bits	8	Ramses-1 boards support only grayscale grabbing. Default: 8.
	ColorSpace	---	Ignored.
	Gain	---	Ignored.
	ExternalTrigger	'true', 'false'	Activate/deactivate external triggering. Default: 'false'.
	Generic	'NTSC', 'PAL', 'FC1300'	The generic 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 framegrabber board (passed as a string!). Default: '1'.
	Port	---	Ignored.
	LineIn	1	Fixed.

Parameters for set_framegrabber_param():

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

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 framegrabber interface Ramses1.dll.
	'pci_transfer_rate'	rate	Get the PCI transfer rate of your PC in MB per second.

• Revision 1.9 (November 13, 2000):
  
  • Adaptation to Ramses1 V2 SDK.
• 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.