HALCON Reference Manual 10.0.2
Table of Contents / Matching / Shape-Based ClassesClassesClasses | | | Operators

get_shape_model_paramsget_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams (Operator)

Name

get_shape_model_paramsget_shape_model_paramsget_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 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_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams returns the parameters of the shape model ModelIDModelIDModelIDModelIDmodelID that were used to create it using create_shape_modelcreate_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel, or create_aniso_shape_modelcreate_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel. In particular, this output can be used to check the parameters NumLevelsNumLevelsNumLevelsNumLevelsnumLevels, AngleStepAngleStepAngleStepAngleStepangleStep, ScaleStepScaleStepScaleStepScaleStepscaleStep, and MinContrastMinContrastMinContrastMinContrastminContrast if they were determined automatically during the model creation with create_shape_modelcreate_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel, or create_aniso_shape_modelcreate_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel.

If the shape model was created using create_shape_modelcreate_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModel or create_scaled_shape_modelcreate_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel a single value is returned in ScaleMinScaleMinScaleMinScaleMinscaleMin, ScaleMaxScaleMaxScaleMaxScaleMaxscaleMax, and ScaleStepScaleStepScaleStepScaleStepscaleStep. 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_modelcreate_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 OptimizationOptimizationOptimizationOptimizationoptimization and ContrastContrastContrastContrastcontrast that also can be determined automatically during the model creation cannot be queried by using get_shape_model_paramsget_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams. If their value is of interest determine_shape_model_paramsdetermine_shape_model_paramsdetermine_shape_model_paramsDetermineShapeModelParamsDetermineShapeModelParams should be used instead.

Parallelization

Parameters

ModelIDModelIDModelIDModelIDmodelID (input_control)  shape_model → HShapeModel, HTupleHShapeModel, HTupleHShapeModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Handle of the model.

NumLevelsNumLevelsNumLevelsNumLevelsnumLevels (output_control)  integer → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Number of pyramid levels.

AngleStartAngleStartAngleStartAngleStartangleStart (output_control)  angle.rad → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Smallest rotation of the pattern.

AngleExtentAngleExtentAngleExtentAngleExtentangleExtent (output_control)  angle.rad → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Extent of the rotation angles.

Assertion: AngleExtent >= 0

AngleStepAngleStepAngleStepAngleStepangleStep (output_control)  angle.rad → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Step length of the angles (resolution).

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

ScaleMinScaleMinScaleMinScaleMinscaleMin (output_control)  number(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Minimum scale of the pattern.

Assertion: ScaleMin > 0

ScaleMaxScaleMaxScaleMaxScaleMaxscaleMax (output_control)  number(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Maximum scale of the pattern.

Assertion: ScaleMax >= ScaleMin

ScaleStepScaleStepScaleStepScaleStepscaleStep (output_control)  number(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Scale step length (resolution).

Assertion: ScaleStep >= 0

MetricMetricMetricMetricmetric (output_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Match metric.

MinContrastMinContrastMinContrastMinContrastminContrast (output_control)  number → HTupleHTupleVARIANTHtuple (integer) (int / long) (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_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

create_shape_modelcreate_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel, create_aniso_shape_modelcreate_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel, read_shape_modelread_shape_modelread_shape_modelReadShapeModelReadShapeModel

See also

find_shape_modelfind_shape_modelfind_shape_modelFindShapeModelFindShapeModel, find_scaled_shape_modelfind_scaled_shape_modelfind_scaled_shape_modelFindScaledShapeModelFindScaledShapeModel, find_aniso_shape_modelfind_aniso_shape_modelfind_aniso_shape_modelFindAnisoShapeModelFindAnisoShapeModel, find_shape_modelsfind_shape_modelsfind_shape_modelsFindShapeModelsFindShapeModels, find_scaled_shape_modelsfind_scaled_shape_modelsfind_scaled_shape_modelsFindScaledShapeModelsFindScaledShapeModels, find_aniso_shape_modelsfind_aniso_shape_modelsfind_aniso_shape_modelsFindAnisoShapeModelsFindAnisoShapeModels

Module

Matching

Table of Contents / Matching / Shape-Based ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH