Operator Reference

HALCON Operator Reference / Image / Acquisition

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

set_framegrabber_callbackT_set_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback (Operator)

set_framegrabber_callbackT_set_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback — Register a callback function for an image acquisition device.

Signature

set_framegrabber_callback( : : AcqHandle, CallbackType, CallbackFunction, UserContext : )

Herror T_set_framegrabber_callback(const Htuple AcqHandle, const Htuple CallbackType, const Htuple CallbackFunction, const Htuple UserContext)

void SetFramegrabberCallback(const HTuple& AcqHandle, const HTuple& CallbackType, const HTuple& CallbackFunction, const HTuple& UserContext)

void HFramegrabber::SetFramegrabberCallback(const HString& CallbackType, void* CallbackFunction, void* UserContext) const

void HFramegrabber::SetFramegrabberCallback(const char* CallbackType, void* CallbackFunction, void* UserContext) const

void HFramegrabber::SetFramegrabberCallback(const wchar_t* CallbackType, void* CallbackFunction, void* UserContext) const   ( Windows only)

static void HOperatorSet.SetFramegrabberCallback(HTuple acqHandle, HTuple callbackType, HTuple callbackFunction, HTuple userContext)

void HFramegrabber.SetFramegrabberCallback(string callbackType, IntPtr callbackFunction, IntPtr userContext)

def set_framegrabber_callback(acq_handle: HHandle, callback_type: str, callback_function: int, user_context: int) -> None

Description

The operator set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback registers a callback function for the image acquisition device specified by AcqHandleAcqHandleAcqHandleacqHandleacq_handle. The parameter CallbackFunctionCallbackFunctionCallbackFunctioncallbackFunctioncallback_function contains a pointer to the function to register, while CallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type specifies to which function of the underlying API the callback should be connected.

Suggested values for CallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type are:

'exception':

The image acquisition has raised an exception.

'exposure_end':

The exposure of the next image has been finished.

'exposure_start':

The exposure of the next image has been started.

'transfer_end':

A new image is ready to be fetched by grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncgrab_image_async.

Depending on the functionality of the underlying API, additional values for CallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type are possible. All actually supported callback types of a specific image acquisition device can be queried by calling get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamget_framegrabber_param with the parameter 'available_callback_types'. For more details see the documentation of the specific image acquisition interface.

Once the callback is registered, on every occurrence of the underlying event (e.g., the notification that the exposure has finished) the specified callback function CallbackFunctionCallbackFunctionCallbackFunctioncallbackFunctioncallback_function will be called. If CallbackFunctionCallbackFunctionCallbackFunctioncallbackFunctioncallback_function is set to NULL, the corresponding callback will be unregistered.

The signature of the callback function is the following: Herror HAcqCallback(void *AcqHandle, void *Context, void *UserContext)

The first parameter of the callback function contains the handle to the image acquisition device passed in AcqHandleAcqHandleAcqHandleacqHandleacq_handle, the second one provides a pointer to interface-specific context data, and the third parameter is a user-specific pointer that is specified in UserContextUserContextUserContextuserContextuser_context.

Attention

For a multithreaded application, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, and close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber are executed exclusively.

set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback runs in parallel with all non-exclusive operators inside and outside of this group.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

This operator modifies the state of the following input parameter:

• AcqHandleAcqHandleAcqHandleacqHandleacq_handle

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

AcqHandleAcqHandleAcqHandleacqHandleacq_handle (input_control, state is modified)  framegrabber → HFramegrabber, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the acquisition device to be used.

CallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Callback type.

Default: 'transfer_end' "transfer_end" "transfer_end" "transfer_end" "transfer_end"

Suggested values: 'exception'"exception""exception""exception""exception", 'exposure_end'"exposure_end""exposure_end""exposure_end""exposure_end", 'exposure_start'"exposure_start""exposure_start""exposure_start""exposure_start", 'transfer_end'"transfer_end""transfer_end""transfer_end""transfer_end"

CallbackFunctionCallbackFunctionCallbackFunctioncallbackFunctioncallback_function (input_control)  pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Pointer to the callback function to be set.

UserContextUserContextUserContextuserContextuser_context (input_control)  pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Pointer to user-specific context data.

Result

If the image acquisition device is open and the specified callback was registered successfully, the operator set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback returns the value 2 ( H_MSG_TRUE) . Otherwise an exception is raised.

Possible Predecessors

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param

Possible Successors

grab_imagegrab_imageGrabImageGrabImagegrab_image, grab_datagrab_dataGrabDataGrabDatagrab_data, grab_image_startgrab_image_startGrabImageStartGrabImageStartgrab_image_start, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncgrab_image_async, grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async, get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamget_framegrabber_param

See also

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback

Module

Foundation

---

ClassesClasses | | Operators