Operator Reference

HALCON Operator Reference / 3D Matching / Shape-Based
ClassesClasses | | Operators

get_shape_model_3d_contoursT_get_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContoursget_shape_model_3d_contours (Operator)

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_contoursGetShapeModel3dContoursGetShapeModel3dContoursget_shape_model_3d_contours returns a representation of a single model view of the 3D shape model ShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DIDshape_model_3did as XLD contours in ModelContoursModelContoursModelContoursmodelContoursmodel_contours. 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_paramsGetShapeModel3dParamsGetShapeModel3dParamsget_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" for GenParamNameGenParamNameGenParamNamegenParamNamegen_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_3dCreateShapeModel3dCreateShapeModel3dcreate_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_3dFindShapeModel3dFindShapeModel3dfind_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_3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d.

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

  • 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 model view.

ShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DIDshape_model_3did (input_control)  shape_model_3d → HShapeModel3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the 3D shape 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

ViewViewViewviewview (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

View for which the contour representation should be returned.

Default: 1

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

Restriction: View >= 1

ViewPoseViewPoseViewPoseviewPoseview_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_contoursGetShapeModel3dContoursGetShapeModel3dContoursget_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_3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d, read_shape_model_3dread_shape_model_3dReadShapeModel3dReadShapeModel3dread_shape_model_3d, get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsget_shape_model_3d_params

Possible Successors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d

Module

3D Metrology

ClassesClasses | | Operators