get_shape_model_contours — Return the contour representation of a shape model.
The operator get_shape_model_contours returns a representation of the shape model ModelID as XLD contours in ModelContours. The parameter Level 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 ModelContours is normalized such that the reference point of the model (see set_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).
Contour representation of the shape model.
Handle of the model.
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
If the handle of the model is valid, the operator get_shape_model_contours returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.
create_shape_model, create_scaled_shape_model, create_aniso_shape_model, read_shape_model
find_shape_model, find_scaled_shape_model, find_aniso_shape_model, find_shape_models, find_scaled_shape_models, find_aniso_shape_models