get_shape_model_contoursT_get_shape_model_contoursGetShapeModelContoursGetShapeModelContoursget_shape_model_contours (Operator)
Name
get_shape_model_contoursT_get_shape_model_contoursGetShapeModelContoursGetShapeModelContoursget_shape_model_contours — Return the contour representation of a shape model.
Signature
def get_shape_model_contours(model_id: HHandle, level: int) -> HObject
Description
The operator get_shape_model_contoursget_shape_model_contoursGetShapeModelContoursGetShapeModelContoursget_shape_model_contours returns a
representation of the shape model ModelIDModelIDModelIDmodelIDmodel_id as XLD contours
in ModelContoursModelContoursModelContoursmodelContoursmodel_contours. 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 ModelContoursModelContoursModelContoursmodelContoursmodel_contours is normalized
such that the reference point of the model (see
set_shape_model_originset_shape_model_originSetShapeModelOriginSetShapeModelOriginset_shape_model_origin) 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).
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ModelContoursModelContoursModelContoursmodelContoursmodel_contours (output_object) xld_cont-array → objectHXLDContHObjectHObjectHobject *
Contour representation of the shape model.
ModelIDModelIDModelIDmodelIDmodel_id (input_control) shape_model → HShapeModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the model.
LevelLevelLevellevellevel (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Pyramid level for which the contour representation
should be returned.
Default:
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_contoursGetShapeModelContoursGetShapeModelContoursget_shape_model_contours returns the value 2 (
H_MSG_TRUE)
. If
necessary an exception is raised.
Possible Predecessors
create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelcreate_shape_model,
create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModelcreate_scaled_shape_model,
create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModelcreate_aniso_shape_model,
read_shape_modelread_shape_modelReadShapeModelReadShapeModelread_shape_model
Alternatives
get_generic_shape_model_objectget_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_object
See also
find_shape_modelfind_shape_modelFindShapeModelFindShapeModelfind_shape_model,
find_scaled_shape_modelfind_scaled_shape_modelFindScaledShapeModelFindScaledShapeModelfind_scaled_shape_model,
find_aniso_shape_modelfind_aniso_shape_modelFindAnisoShapeModelFindAnisoShapeModelfind_aniso_shape_model,
find_shape_modelsfind_shape_modelsFindShapeModelsFindShapeModelsfind_shape_models,
find_scaled_shape_modelsfind_scaled_shape_modelsFindScaledShapeModelsFindScaledShapeModelsfind_scaled_shape_models,
find_aniso_shape_modelsfind_aniso_shape_modelsFindAnisoShapeModelsFindAnisoShapeModelsfind_aniso_shape_models
Module
Matching