get_shape_model_3d_contoursT_get_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContours (Operator)


get_shape_model_3d_contoursT_get_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContours — Return the contour representation of a 3D shape model view.


get_shape_model_3d_contours( : ModelContours : ShapeModel3DID, Level, View : ViewPose)

Herror T_get_shape_model_3d_contours(Hobject* ModelContours, const Htuple ShapeModel3DID, const Htuple Level, const Htuple View, Htuple* ViewPose)

void GetShapeModel3dContours(HObject* ModelContours, const HTuple& ShapeModel3DID, const HTuple& Level, const HTuple& View, HTuple* ViewPose)

HXLDCont HShapeModel3D::GetShapeModel3dContours(Hlong Level, Hlong View, HPose* ViewPose) const

static void HOperatorSet.GetShapeModel3dContours(out HObject modelContours, HTuple shapeModel3DID, HTuple level, HTuple view, out HTuple viewPose)

HXLDCont HShapeModel3D.GetShapeModel3dContours(int level, int view, out HPose viewPose)


The operator get_shape_model_3d_contoursget_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContoursGetShapeModel3dContours returns a representation of a single model view of the 3D shape model ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DID as XLD contours in ModelContoursModelContoursModelContoursModelContoursmodelContours. The parameters LevelLevelLevelLevellevel and ViewViewViewViewview determine for which model view the contour representation should be returned, where LevelLevelLevelLevellevel denotes the pyramid level and ViewViewViewViewview denotes the model view on this pyramid level.

The permitted range of values for LevelLevelLevelLevellevel and ViewViewViewViewview can previously be determined by using the operator get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParams and passing 'num_views_per_level'"num_views_per_level""num_views_per_level""num_views_per_level""num_views_per_level" for GenParamNameGenParamNameGenParamNameGenParamNamegenParamName.

The contours can be used to visualize and rate the 3D shape model that was created with create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d. With this it is possible, for example, to decide whether the number of pyramid levels in the model is appropriate or not. If the contours on the highest pyramid do not show enough details to be representative for the model view, the number of pyramid levels that are used during the search with find_shape_model_3dfind_shape_model_3dFindShapeModel3dFindShapeModel3dFindShapeModel3d should be adjusted downwards. In contrast, if the contours show too many details even on the highest pyramid level, a higher number of pyramid levels should be chosen already during the creation of the 3D shape model by using create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d.

Additionally, the pose of the selected view is returned in ViewPoseViewPoseViewPoseViewPoseviewPose. It can be used, for example, to project the 3D shape model according to the view pose by using project_shape_model_3dproject_shape_model_3dProjectShapeModel3dProjectShapeModel3dProjectShapeModel3d. The rating of the model contours that was described above can then be performed by comparing the ModelContoursModelContoursModelContoursModelContoursmodelContours to the projected model. Note that the position of the contours of the projection and the position of the model contours may slightly differ because of radial distortions.

Execution Information


ModelContoursModelContoursModelContoursModelContoursmodelContours (output_object)  xld_cont-array objectHXLDContHXLDContHobject *

Contour representation of the model view.

ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DID (input_control)  shape_model_3d HShapeModel3D, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the 3D shape model.

LevelLevelLevelLevellevel (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (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

ViewViewViewViewview (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

View for which the contour representation should be returned.

Default value: 1

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

Restriction: View >= 1

ViewPoseViewPoseViewPoseViewPoseviewPose (output_control)  pose HPose, HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

3D pose of the 3D shape model at the current view.


If the parameters are valid, the operator get_shape_model_3d_contoursget_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContoursGetShapeModel3dContours returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d, read_shape_model_3dread_shape_model_3dReadShapeModel3dReadShapeModel3dReadShapeModel3d, get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParams

Possible Successors



3D Metrology