ClassesClassesClassesClasses | | | | Operators

get_shape_model_3d_contoursT_get_shape_model_3d_contoursGetShapeModel3dContoursget_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContours (Operator)

Name

get_shape_model_3d_contoursT_get_shape_model_3d_contoursGetShapeModel3dContoursget_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContours — 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)

Herror get_shape_model_3d_contours(Hobject* ModelContours, const HTuple& ShapeModel3DID, const HTuple& Level, const HTuple& View, HTuple* ViewPose)

HXLDContArray HShapeModel3D::GetShapeModel3dContours(const HTuple& Level, const HTuple& View, HTuple* ViewPose) const

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

void HOperatorSetX.GetShapeModel3dContours(
[out] IHUntypedObjectX*ModelContours, [in] VARIANT ShapeModel3DID, [in] VARIANT Level, [in] VARIANT View, [out] VARIANT* ViewPose)

IHXLDContX* HShapeModel3DX.GetShapeModel3dContours(
[in] Hlong Level, [in] Hlong View, [out] VARIANT* ViewPose)

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)

Description

The operator get_shape_model_3d_contoursget_shape_model_3d_contoursGetShapeModel3dContoursget_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContours returns a representation of a single model view of the 3D shape model ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DID as XLD contours in ModelContoursModelContoursModelContoursModelContoursModelContoursmodelContours. 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_paramsGetShapeModel3dParamsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParams 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 GenParamNamesGenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames.

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

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

Parallelization

Parameters

ModelContoursModelContoursModelContoursModelContoursModelContoursmodelContours (output_object)  xld_cont-array objectHXLDContHXLDContHXLDContArrayHXLDContXHobject *

Contour representation of the model view.

ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DID (input_control)  shape_model_3d HShapeModel3D, HTupleHTupleHShapeModel3D, HTupleHShapeModel3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the 3D shape model.

LevelLevelLevelLevelLevellevel (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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 HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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

ViewPoseViewPoseViewPoseViewPoseViewPoseviewPose (output_control)  pose HPose, HTupleHTupleHTupleHPoseX, VARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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_contoursGetShapeModel3dContoursget_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContours returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3d, read_shape_model_3dread_shape_model_3dReadShapeModel3dread_shape_model_3dReadShapeModel3dReadShapeModel3d, get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParams

Possible Successors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3d

Module

3D Metrology


ClassesClassesClassesClasses | | | | Operators