HALCON Image Acquisition Interface for GINGA digital Boards

This document provides information about the multi WOI mode that can be used by the HALCON GingaDG interface. The latest revision of this interface can be downloaded from the Support Area of the LinX WWW server. In case of installation problems please send e-mail (techimage@linx.jp) or fax (81-45-979-0732) to LinX technical support center.

Multi WOI Mode

Using a camera with Multi WOI Grabbing function, each image on each WOI is grabbed. Generally, for grabbing an image, a HALCON object is not generated until the whole frame is grabbed completely. However, by using the Multi WOI Grabbing function, the HALCON object is available as soon as one WOI has been grabbed. By using this function, you can construct the parallel processing.
When the frame capture starts, all WOI image grabbing in a frame are started. If grab_image call will be late, WOI capture missing isn?t occurred. When grab_image is called in number of WOI, one frame capture is finished.
In addition, this function supports asynchronous grabbing and software trigger like normal grabbing function. It is because the command of grabbing one frame is called when the first WOI is grabbed.

Parameters for set_framegrabber_param():

	'multi_woi_grabbing'		'enable', 'disable'		Run the multi WOI grabbing mode. You can get one image for one WOI by calling grab_image. Shutter runs when first WOI is grabbed.
	'multi_woi_index'		index		Change the index of the multi WOI. If an already grabbed WOI is not collected by a call of grab_image the old one is thrown away and a new image is grabbed.

Parameters for get_framegrabber_param():

	'multi_woi_count'		1 ... 16		Get the number of WOI.

Sample Program

close_all_framegrabbers ()
open_framegrabber ('GingaDG', 1, 1, 0, 0, 0, 0, 'default', -1, 'default', -1, 'default', 'teli/CSB4000CL_T1_NORM_WOI3', 'default', 0, -1, AcqHandle)
set_framegrabber_param (AcqHandle, 'multi_woi_grabbing', 'enable')
get_framegrabber_param (AcqHandle, 'multi_woi_count', Count)
for i:=1 to Count by 1
    dev_close_window ()
endfor
WindowHandle := []
for i:=1 to Count by 1
    dev_open_window ((i-1)*50, (i-1)*50, 512, 512, 'black', WinHandle)
    tuple_concat (WindowHandle, WinHandle, WindowHandle)
endfor
while(1)
    for i:=1 to Count by 1
        tuple_select (WindowHandle, i-1, Selected)
        dev_set_window (WindowHandle)
        grab_image(Image, AcqHandle)
        dev_display(Image)
    endfor
endwhile
close_all_framegrabbers ()