HALCON Website / HALCON Operator Reference / Matching / Shape-Based
ClassesClassesClassesClasses | | | | Operators

get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams (Operator)

Name

get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams — Return the parameters of a shape model.

Signature

get_shape_model_params( : : ModelID : NumLevels, AngleStart, AngleExtent, AngleStep, ScaleMin, ScaleMax, ScaleStep, Metric, MinContrast)

Herror get_shape_model_params(const Hlong ModelID, Hlong* NumLevels, double* AngleStart, double* AngleExtent, double* AngleStep, double* ScaleMin, double* ScaleMax, double* ScaleStep, char* Metric, Hlong* MinContrast)

Herror T_get_shape_model_params(const Htuple ModelID, Htuple* NumLevels, Htuple* AngleStart, Htuple* AngleExtent, Htuple* AngleStep, Htuple* ScaleMin, Htuple* ScaleMax, Htuple* ScaleStep, Htuple* Metric, Htuple* MinContrast)

Herror get_shape_model_params(const HTuple& ModelID, Hlong* NumLevels, double* AngleStart, double* AngleExtent, double* AngleStep, double* ScaleMin, double* ScaleMax, double* ScaleStep, char* Metric, Hlong* MinContrast)

Herror get_shape_model_params(const HTuple& ModelID, HTuple* NumLevels, HTuple* AngleStart, HTuple* AngleExtent, HTuple* AngleStep, HTuple* ScaleMin, HTuple* ScaleMax, HTuple* ScaleStep, HTuple* Metric, HTuple* MinContrast)

Hlong HShapeModel::GetShapeModelParams(HTuple* AngleStart, HTuple* AngleExtent, HTuple* AngleStep, HTuple* ScaleMin, HTuple* ScaleMax, HTuple* ScaleStep, HTuple* Metric, HTuple* MinContrast) const

void GetShapeModelParams(const HTuple& ModelID, HTuple* NumLevels, HTuple* AngleStart, HTuple* AngleExtent, HTuple* AngleStep, HTuple* ScaleMin, HTuple* ScaleMax, HTuple* ScaleStep, HTuple* Metric, HTuple* MinContrast)

Hlong HShapeModel::GetShapeModelParams(double* AngleStart, double* AngleExtent, double* AngleStep, HTuple* ScaleMin, HTuple* ScaleMax, HTuple* ScaleStep, HString* Metric, Hlong* MinContrast) const

Hlong HShapeModel::GetShapeModelParams(double* AngleStart, double* AngleExtent, double* AngleStep, double* ScaleMin, double* ScaleMax, double* ScaleStep, HString* Metric, Hlong* MinContrast) const

void HOperatorSetX.GetShapeModelParams(
[in] VARIANT ModelID, [out] VARIANT* NumLevels, [out] VARIANT* AngleStart, [out] VARIANT* AngleExtent, [out] VARIANT* AngleStep, [out] VARIANT* ScaleMin, [out] VARIANT* ScaleMax, [out] VARIANT* ScaleStep, [out] VARIANT* Metric, [out] VARIANT* MinContrast)

Hlong HShapeModelX.GetShapeModelParams(
[out] double* AngleStart, [out] double* AngleExtent, [out] double* AngleStep, [out] VARIANT* ScaleMin, [out] VARIANT* ScaleMax, [out] VARIANT* ScaleStep, [out] BSTR* Metric, [out] Hlong* MinContrast)

static void HOperatorSet.GetShapeModelParams(HTuple modelID, out HTuple numLevels, out HTuple angleStart, out HTuple angleExtent, out HTuple angleStep, out HTuple scaleMin, out HTuple scaleMax, out HTuple scaleStep, out HTuple metric, out HTuple minContrast)

int HShapeModel.GetShapeModelParams(out double angleStart, out double angleExtent, out double angleStep, out HTuple scaleMin, out HTuple scaleMax, out HTuple scaleStep, out string metric, out int minContrast)

int HShapeModel.GetShapeModelParams(out double angleStart, out double angleExtent, out double angleStep, out double scaleMin, out double scaleMax, out double scaleStep, out string metric, out int minContrast)

Description

The operator get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams returns the parameters of the shape model ModelIDModelIDModelIDModelIDModelIDmodelID that were used to create it using create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel, or create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel. In particular, this output can be used to check the parameters NumLevelsNumLevelsNumLevelsNumLevelsNumLevelsnumLevels, AngleStepAngleStepAngleStepAngleStepAngleStepangleStep, ScaleStepScaleStepScaleStepScaleStepScaleStepscaleStep, and MinContrastMinContrastMinContrastMinContrastMinContrastminContrast if they were determined automatically during the model creation with create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel, or create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel.

If the shape model was created using create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel or create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel a single value is returned in ScaleMinScaleMinScaleMinScaleMinScaleMinscaleMin, ScaleMaxScaleMaxScaleMaxScaleMaxScaleMaxscaleMax, and ScaleStepScaleStepScaleStepScaleStepScaleStepscaleStep. This parameters corresponds to the isotropic scaling parameters of the shape model. If the shape model was created using create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel two values each are returned in the above three parameters. Here, the first value of the respective parameter refers to the scaling in the row direction, while the second value refers to the scaling in the column direction.

Note that the parameters OptimizationOptimizationOptimizationOptimizationOptimizationoptimization and ContrastContrastContrastContrastContrastcontrast that also can be determined automatically during the model creation cannot be queried by using get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams. If their value is of interest determine_shape_model_paramsdetermine_shape_model_paramsDetermineShapeModelParamsdetermine_shape_model_paramsDetermineShapeModelParamsDetermineShapeModelParams should be used instead.

Parallelization

Parameters

ModelIDModelIDModelIDModelIDModelIDmodelID (input_control)  shape_model → HShapeModel, HTupleHTupleHShapeModel, HTupleHShapeModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the model.

NumLevelsNumLevelsNumLevelsNumLevelsNumLevelsnumLevels (output_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of pyramid levels.

AngleStartAngleStartAngleStartAngleStartAngleStartangleStart (output_control)  angle.rad → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Smallest rotation of the pattern.

AngleExtentAngleExtentAngleExtentAngleExtentAngleExtentangleExtent (output_control)  angle.rad → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Extent of the rotation angles.

Assertion: AngleExtent >= 0

AngleStepAngleStepAngleStepAngleStepAngleStepangleStep (output_control)  angle.rad → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Step length of the angles (resolution).

Assertion: AngleStep >= 0 && AngleStep <= pi / 16

ScaleMinScaleMinScaleMinScaleMinScaleMinscaleMin (output_control)  number(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Minimum scale of the pattern.

Assertion: ScaleMin > 0

ScaleMaxScaleMaxScaleMaxScaleMaxScaleMaxscaleMax (output_control)  number(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Maximum scale of the pattern.

Assertion: ScaleMax >= ScaleMin

ScaleStepScaleStepScaleStepScaleStepScaleStepscaleStep (output_control)  number(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Scale step length (resolution).

Assertion: ScaleStep >= 0

MetricMetricMetricMetricMetricmetric (output_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Match metric.

MinContrastMinContrastMinContrastMinContrastMinContrastminContrast (output_control)  number → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Minimum contrast of the objects in the search images.

Result

If the handle of the model is valid, the operator get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel, create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel, read_shape_modelread_shape_modelReadShapeModelread_shape_modelReadShapeModelReadShapeModel

See also

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, find_shape_modelsfind_shape_modelsFindShapeModelsfind_shape_modelsFindShapeModelsFindShapeModels, find_scaled_shape_modelsfind_scaled_shape_modelsFindScaledShapeModelsfind_scaled_shape_modelsFindScaledShapeModelsFindScaledShapeModels, find_aniso_shape_modelsfind_aniso_shape_modelsFindAnisoShapeModelsfind_aniso_shape_modelsFindAnisoShapeModelsFindAnisoShapeModels

Module

Matching

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH