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

get_shape_model_contoursget_shape_model_contoursget_shape_model_contoursGetShapeModelContoursGetShapeModelContours (Operator)

Name

get_shape_model_contoursget_shape_model_contoursget_shape_model_contoursGetShapeModelContoursGetShapeModelContours — Return the contour representation of a shape model.

Signature

get_shape_model_contours( : ModelContours : ModelID, Level : )

Herror get_shape_model_contours(Hobject* ModelContours, const Hlong ModelID, const Hlong Level)

Herror T_get_shape_model_contours(Hobject* ModelContours, const Htuple ModelID, const Htuple Level)

Herror get_shape_model_contours(Hobject* ModelContours, const HTuple& ModelID, const HTuple& Level)

HXLDContArray HShapeModel::GetShapeModelContours(const HTuple& Level) const

void HOperatorSetX.GetShapeModelContours(
[out] IHUntypedObjectX*ModelContours, [in] VARIANT ModelID, [in] VARIANT Level)

IHXLDContX* HShapeModelX.GetShapeModelContours([in] Hlong Level)

static void HOperatorSet.GetShapeModelContours(out HObject modelContours, HTuple modelID, HTuple level)

HXLDCont HShapeModel.GetShapeModelContours(int level)

Description

The operator get_shape_model_contoursget_shape_model_contoursget_shape_model_contoursGetShapeModelContoursGetShapeModelContours returns a representation of the shape model ModelIDModelIDModelIDModelIDmodelID as XLD contours in ModelContoursModelContoursModelContoursModelContoursmodelContours. The parameter LevelLevelLevelLevellevel determines for which pyramid level of the model the contour representation should be returned. The contours can be used, for example, to visualize the found instances of the model in an image. It should be noted that the position of ModelContoursModelContoursModelContoursModelContoursmodelContours is normalized such that the reference point of the model (see set_shape_model_originset_shape_model_originset_shape_model_originSetShapeModelOriginSetShapeModelOrigin) lies at the pixel position (0,0). Hence, the contours simply need to be translated to the found position in the image (and possibly rotated and scaled around this point).

Parallelization

Parameters

ModelContoursModelContoursModelContoursModelContoursmodelContours (output_object)  xld_cont-array objectHXLDContHXLDContArrayHXLDContXHobject *

Contour representation of the shape model.

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

Handle of the model.

LevelLevelLevelLevellevel (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Pyramid level for which the contour representation should be returned.

Default value: 1

Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

Restriction: Level >= 1

Result

If the handle of the model is valid, the operator get_shape_model_contoursget_shape_model_contoursget_shape_model_contoursGetShapeModelContoursGetShapeModelContours 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