set_framegrabber_paramT_set_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param (Operator)

Name

set_framegrabber_paramT_set_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param — Set specific parameters of an image acquisition device.

Signature

set_framegrabber_param( : : AcqHandle, Param, Value : )

Herror T_set_framegrabber_param(const Htuple AcqHandle, const Htuple Param, const Htuple Value)

void SetFramegrabberParam(const HTuple& AcqHandle, const HTuple& Param, const HTuple& Value)

void HFramegrabber::SetFramegrabberParam(const HTuple& Param, const HTuple& Value) const

void HFramegrabber::SetFramegrabberParam(const HString& Param, const HString& Value) const

void HFramegrabber::SetFramegrabberParam(const char* Param, const char* Value) const

void HFramegrabber::SetFramegrabberParam(const wchar_t* Param, const wchar_t* Value) const   (Windows only)

static void HOperatorSet.SetFramegrabberParam(HTuple acqHandle, HTuple param, HTuple value)

void HFramegrabber.SetFramegrabberParam(HTuple param, HTuple value)

void HFramegrabber.SetFramegrabberParam(string param, string value)

def set_framegrabber_param(acq_handle: HHandle, param: MaybeSequence[str], value: MaybeSequence[Union[str, float, int]]) -> None

Description

The operator set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param sets specific parameters for the image acquisition device specified by AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle. Additional information for a specific image acquisition device is available via info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber. A comprehensive documentation of all image acquisition device-specific parameters can be found in the corresponding interface documentation in the directory doc/html/reference/acquisition.

Attention

For a multithreaded application all image acquisition operators (as listed in open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber) are an own group in which info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber and close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbersclose_all_framegrabbers are executed exclusively.

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

Execution Information

This operator modifies the state of the following input parameter:

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

Parameters

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

Handle of the acquisition device to be used.

ParamParamParamParamparamparam (input_control)  string(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Parameter name.

Suggested values: 'color_space'"color_space""color_space""color_space""color_space""color_space", 'continuous_grabbing'"continuous_grabbing""continuous_grabbing""continuous_grabbing""continuous_grabbing""continuous_grabbing", 'external_trigger'"external_trigger""external_trigger""external_trigger""external_trigger""external_trigger", 'grab_timeout'"grab_timeout""grab_timeout""grab_timeout""grab_timeout""grab_timeout", 'image_height'"image_height""image_height""image_height""image_height""image_height", 'image_width'"image_width""image_width""image_width""image_width""image_width", 'port'"port""port""port""port""port", 'start_column'"start_column""start_column""start_column""start_column""start_column", 'start_row'"start_row""start_row""start_row""start_row""start_row", 'volatile'"volatile""volatile""volatile""volatile""volatile"

ValueValueValueValuevaluevalue (input_control)  string(-array) HTupleMaybeSequence[Union[str, float, int]]HTupleHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong)

Parameter value to be set.

Result

If the image acquisition device is open and the specified parameter / parameter value is supported, the operator set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber

Possible Successors

grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image, grab_datagrab_dataGrabDataGrabDataGrabDatagrab_data, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStartgrab_image_start, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async, grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsyncgrab_data_async, get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param

See also

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param

Module

Foundation