get_shape_model_3d_contoursT_get_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContoursget_shape_model_3d_contours (Operator)

Name

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

Signature

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)

def get_shape_model_3d_contours(shape_model_3did: HHandle, level: int, view: int) -> Tuple[HObject, Sequence[Union[int, float]]]

Description

The operator get_shape_model_3d_contoursget_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContoursGetShapeModel3dContoursget_shape_model_3d_contours returns a representation of a single model view of the 3D shape model ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DIDshape_model_3did as XLD contours in ModelContoursModelContoursModelContoursModelContoursmodelContoursmodel_contours. The parameters LevelLevelLevelLevellevellevel and ViewViewViewViewviewview determine for which model view the contour representation should be returned, where LevelLevelLevelLevellevellevel denotes the pyramid level and ViewViewViewViewviewview denotes the model view on this pyramid level.

The permitted range of values for LevelLevelLevelLevellevellevel and ViewViewViewViewviewview can previously be determined by using the operator get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParamsget_shape_model_3d_params and passing 'num_views_per_level'"num_views_per_level""num_views_per_level""num_views_per_level""num_views_per_level""num_views_per_level" for GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name.

The contours can be used to visualize and rate the 3D shape model that was created with create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d. 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_3dFindShapeModel3dFindShapeModel3dFindShapeModel3dfind_shape_model_3d 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_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d.

Additionally, the pose of the selected view is returned in ViewPoseViewPoseViewPoseViewPoseviewPoseview_pose. 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_3dProjectShapeModel3dProjectShapeModel3dProjectShapeModel3dproject_shape_model_3d. The rating of the model contours that was described above can then be performed by comparing the ModelContoursModelContoursModelContoursModelContoursmodelContoursmodel_contours 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

Parameters

ModelContoursModelContoursModelContoursModelContoursmodelContoursmodel_contours (output_object)  xld_cont-array objectHXLDContHObjectHXLDContHobject *

Contour representation of the model view.

ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DIDshape_model_3did (input_control)  shape_model_3d HShapeModel3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the 3D shape model.

LevelLevelLevelLevellevellevel (input_control)  integer HTupleintHTupleHtuple (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

ViewViewViewViewviewview (input_control)  integer HTupleintHTupleHtuple (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

ViewPoseViewPoseViewPoseViewPoseviewPoseview_pose (output_control)  pose HPose, HTupleSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

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

Result

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

Possible Predecessors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d, read_shape_model_3dread_shape_model_3dReadShapeModel3dReadShapeModel3dReadShapeModel3dread_shape_model_3d, get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParamsget_shape_model_3d_params

Possible Successors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d

Module

3D Metrology