ClassesClassesClassesClasses | | | | Operators

set_shape_model_paramT_set_shape_model_paramSetShapeModelParamset_shape_model_paramSetShapeModelParamSetShapeModelParam (Operator)

Name

set_shape_model_paramT_set_shape_model_paramSetShapeModelParamset_shape_model_paramSetShapeModelParamSetShapeModelParam — Set selected parameters of the shape model.

Signature

set_shape_model_param( : : ModelID, GenParamNames, GenParamValues : )

Herror T_set_shape_model_param(const Htuple ModelID, const Htuple GenParamNames, const Htuple GenParamValues)

Herror set_shape_model_param(const HTuple& ModelID, const HTuple& GenParamNames, const HTuple& GenParamValues)

void HShapeModel::SetShapeModelParam(const HTuple& GenParamNames, const HTuple& GenParamValues) const

void SetShapeModelParam(const HTuple& ModelID, const HTuple& GenParamNames, const HTuple& GenParamValues)

void HShapeModel::SetShapeModelParam(const HTuple& GenParamNames, const HTuple& GenParamValues) const

static void HImage::SetShapeModelParam(const HShapeModel& ModelID, const HTuple& GenParamNames, const HTuple& GenParamValues)

void HOperatorSetX.SetShapeModelParam(
[in] VARIANT ModelID, [in] VARIANT GenParamNames, [in] VARIANT GenParamValues)

void HShapeModelX.SetShapeModelParam(
[in] VARIANT GenParamNames, [in] VARIANT GenParamValues)

void HImageX.SetShapeModelParam(
[in] IHShapeModelX* ModelID, [in] VARIANT GenParamNames, [in] VARIANT GenParamValues)

static void HOperatorSet.SetShapeModelParam(HTuple modelID, HTuple genParamNames, HTuple genParamValues)

void HShapeModel.SetShapeModelParam(HTuple genParamNames, HTuple genParamValues)

static void HImage.SetShapeModelParam(HShapeModel modelID, HTuple genParamNames, HTuple genParamValues)

Description

The operator set_shape_model_paramset_shape_model_paramSetShapeModelParamset_shape_model_paramSetShapeModelParamSetShapeModelParam sets the selected parameters GenParamNamesGenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames in the shape model ModelIDModelIDModelIDModelIDModelIDmodelID. The following parameters can be modified:

'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast""min_contrast"

Sets the minimum contrast of the object in the search images for the shape model ModelIDModelIDModelIDModelIDModelIDmodelID. Thereby, the value of 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast""min_contrast" that was originally set, e.g. with create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, is overwritten for the shape model ModelIDModelIDModelIDModelIDModelIDmodelID. Note that if the shape model ModelIDModelIDModelIDModelIDModelIDmodelID was read from file and if this file should be changed as well, the shape model ModelIDModelIDModelIDModelIDModelIDmodelID must again be written to file after the execution of the operator set_shape_model_paramset_shape_model_paramSetShapeModelParamset_shape_model_paramSetShapeModelParamSetShapeModelParam.

'timeout'"timeout""timeout""timeout""timeout""timeout"

Sets the maximum runtime of the operators used to find the shape model ModelIDModelIDModelIDModelIDModelIDmodelID (e.g. find_shape_modelfind_shape_modelFindShapeModelfind_shape_modelFindShapeModelFindShapeModel). This is especially useful in cases where a maximum cycle time has to be ensured. The 'timeout'"timeout""timeout""timeout""timeout""timeout" must be given in milliseconds. The temporal accuracy depends on several factors including the size of the model, the speed of your computer, and the 'timer_mode'"timer_mode""timer_mode""timer_mode""timer_mode""timer_mode" set via set_systemset_systemSetSystemset_systemSetSystemSetSystem. Be aware that the runtime of the search increases by up to 10 percent with activated timeout. To disable the timeout you can either use a negative value or 'false'"false""false""false""false""false".

'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models""border_shape_models"

This parameter determines whether the shape model ModelIDModelIDModelIDModelIDModelIDmodelID to be found with, e.g., find_shape_modelfind_shape_modelFindShapeModelfind_shape_modelFindShapeModelFindShapeModel, may lie partially outside the image (i.e., whether they may cross the image border). The value of 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models""border_shape_models" can be 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", or 'system'"system""system""system""system""system". The value 'system'"system""system""system""system""system" is the default behavior and uses the system-wide used value that was set by set_systemset_systemSetSystemset_systemSetSystemSetSystem for the parameter 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models""border_shape_models".

Parallelization

This operator modifies the state of the following input parameter:

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

ModelIDModelIDModelIDModelIDModelIDmodelID (input_control, state is modified)  shape_model HShapeModel, HTupleHTupleHShapeModel, HTupleHShapeModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the model.

GenParamNamesGenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames (input_control)  attribute.name-array HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Parameter names.

List of values: 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models""border_shape_models", 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast""min_contrast", 'timeout'"timeout""timeout""timeout""timeout""timeout"

GenParamValuesGenParamValuesGenParamValuesGenParamValuesGenParamValuesgenParamValues (input_control)  attribute.value-array HTupleHTupleHTupleVARIANTHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*) (double / Hlong / BSTR) (double / Hlong / char*)

Parameter values.

List of values: 'false'"false""false""false""false""false", 'system'"system""system""system""system""system", 'true'"true""true""true""true""true"

Result

If the parameters are valid, the operator set_shape_model_paramset_shape_model_paramSetShapeModelParamset_shape_model_paramSetShapeModelParamSetShapeModelParam returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

create_shape_model_xldcreate_shape_model_xldCreateShapeModelXldcreate_shape_model_xldCreateShapeModelXldCreateShapeModelXld, create_scaled_shape_model_xldcreate_scaled_shape_model_xldCreateScaledShapeModelXldcreate_scaled_shape_model_xldCreateScaledShapeModelXldCreateScaledShapeModelXld, create_aniso_shape_model_xldcreate_aniso_shape_model_xldCreateAnisoShapeModelXldcreate_aniso_shape_model_xldCreateAnisoShapeModelXldCreateAnisoShapeModelXld

Possible Successors

find_shape_modelfind_shape_modelFindShapeModelfind_shape_modelFindShapeModelFindShapeModel, find_scaled_shape_modelfind_scaled_shape_modelFindScaledShapeModelfind_scaled_shape_modelFindScaledShapeModelFindScaledShapeModel, find_aniso_shape_modelfind_aniso_shape_modelFindAnisoShapeModelfind_aniso_shape_modelFindAnisoShapeModelFindAnisoShapeModel

See also

create_shape_model_xldcreate_shape_model_xldCreateShapeModelXldcreate_shape_model_xldCreateShapeModelXldCreateShapeModelXld, create_scaled_shape_model_xldcreate_scaled_shape_model_xldCreateScaledShapeModelXldcreate_scaled_shape_model_xldCreateScaledShapeModelXldCreateScaledShapeModelXld, create_aniso_shape_model_xldcreate_aniso_shape_model_xldCreateAnisoShapeModelXldcreate_aniso_shape_model_xldCreateAnisoShapeModelXldCreateAnisoShapeModelXld

Module

Matching


ClassesClassesClassesClasses | | | | Operators