HALCON 7.0 Frame Grabber Interface for C-Cam Technologies CCi4 Cameras

This page provides the documentation of the HALCON frame grabber interface HFGCCi4.dll for the C-Cam Technologies CCi4 CMOS imaging sensors. Registered customers can download the latest revision of this interface from the MVTec WWW server.

Revision: 2.0

System Requirements

• Intel compatible PC with Windows NT 4.0 (Service Pack 4) or Windows 2000.
• Successfully installed C-Cam Technologies cc.sys driver.
• C-Cam Technologies DLL CCi4.dll.
  This DLL must be within your search path %PATH%. If you do not have this DLL, please contact C-Cam Technologies or the vendor from which you bought the camera.
• C-Cam Technologies logic files cclvds.ttb and ibis4c.ttb.
  These files are necessary during the initialization of the camera (and the board), see parameter description of CameraType below for more details. If you do not have these files, please contact C-Cam Technologies or the vendor from which you bought the camera.
• HALCON frame grabber interface HFGCCi4.dll or parHFGCCi4.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.

Features

• Support of multiple cameras (one camera per board).
• Software control of window of interest (cropping of image parts).
• Software control of gain, offset, and integration time.

Limitations

• No asynchronous grabbing (grab_image_async() and grab_image_start() not supported).
• No external trigger.
• Currently support of grayscale cameras only.
• No subsampling.
• No support of lookup tables.
• grab_region() and grab_region_async() not supported.

Description

Parameters for open_framegrabber():

	Name	'CCi4'	The name of the HALCON frame grabber interface.
	HorizontalResolution	1, width	The desired image resolution. Use '1' or the corresponding absolute value for full resolution. Default: 1.
	VerticalResolution	1, height	The desired image resolution. Use '1' or the corresponding absolute value for full resolution. Default: 1.
	ImageWidth	0, width	The width of the desired image part ('0' stands for the complete image). Default: 0.
	ImageHeight	0, height	The height of the desired image part ('0' stands 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, 10, 12	The number of bits per channel. By specifying a value greater than 8 the operator grab_image() will return a int2 image (instead of a byte image). Default: 8.
	ColorSpace	'gray'	Fixed (up to now only support of grayscale cameras!). Default: 'gray'.
	Gain	---	Ignored.
	ExternalTrigger	---	Ignored.
	CameraType	ibis4c_filename	Specify the location of the file 'ibis4c.ttb' with the camera interface logic. Note that the file 'cclvds.ttb' with the interface logic must be located in the same directory! Default: '.\\ibis4c.ttb'.
	Device	'0', '1', '2', ...	The number of the frame grabber board (passed as a string!). Default: '0'.
	Port	---	Ignored.
	LineIn	---	Ignored.

Parameters for set_framegrabber_param():

	'analog_values'		[anaval0,anaval1]		Specify the two analog values of the Ibis sensor (see C-Cam software manual for more information). Default: [48,48].
	'gain_offset'		[gain,offset]		Specify the two values for gain and offset to regulate the the analogue signal going into the ADC converter (see C-Cam software manual for more information). Default: [3,3].
	'integration_time'		usec		Specify the desired value for the exposure time, expressed in useconds (see C-Cam software manual for more information). Default: 50000.
	'volatile'		'enable', 'disable'		In the volatile mode the two image 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!
	'window_of_interest'		[row1,col1,row2,col2]		The desired window of interest specified as a rectangle with top left corner (row1,col1) and bottom right corner (row2,col2). Note, that changing the current window of interest is not possible in volatile mode!

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

	'driver_version'		version		The version number of the CCi4 driver cc.sys.
	'library_version'		version		The version number of the CCi4 library CCi4.dll.
	'revision'		revision		The revision number of the HALCON CCi4 frame grabber interface.

Release Notes

• Revision 2.0 (April 6, 2001):
  
  • HALCON 6.1 version of the interface (included in HALCON 6.1 CD).
  • First official release.