get_deformable_model_contoursT_get_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours (Operator)
Name
get_deformable_model_contoursT_get_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours — Return the contour representation of a deformable model.
Signature
def get_deformable_model_contours(model_id: HHandle, level: int) -> HObject
Description
The operator get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours returns a
representation of the deformable model ModelIDModelIDModelIDmodelIDmodel_id as XLD contours
in ModelContoursModelContoursModelContoursmodelContoursmodel_contours. The parameter LevelLevelLevellevellevel 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.
In case that the model was generated by
create_planar_calib_deformable_model_xldcreate_planar_calib_deformable_model_xldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldcreate_planar_calib_deformable_model_xld, the contours by default
are returned in the world coordinate system in metric units. Here, the
contours must be transformed by the returned pose for visualizing a match.
In all other cases, the contours of the model by default are returned in the
image coordinate system in pixel units. In the calibrated case this
system corresponds to the rectified image coordinate system. The
rectified image coordinate system is the coordinate system of an image
one would obtain by change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image when
using the rectified camera parameters. The rectified camera parameters
can be queried by get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params.
It should
be noted that the position of ModelContoursModelContoursModelContoursmodelContoursmodel_contours is normalized
such that the reference point of the model (see
set_deformable_model_originset_deformable_model_originSetDeformableModelOriginSetDeformableModelOriginset_deformable_model_origin) lies at the pixel position (0,0).
Hence, the contours simply need to be transformed by the found
homography in the image.
The default behavior for the calibrated case can be changed with the
generic parameter 'get_deformable_model_contours_coord_system'"get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system"
of the operator set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamset_deformable_model_param.
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 deformable model.
ModelIDModelIDModelIDmodelIDmodel_id (input_control) deformable_model → HDeformableModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the 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
Result
If the handle of the model is valid, the operator
get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours returns the value 2 (
H_MSG_TRUE)
. If
necessary an exception is raised.
Possible Predecessors
create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_model,
create_planar_uncalib_deformable_model_xldcreate_planar_uncalib_deformable_model_xldCreatePlanarUncalibDeformableModelXldCreatePlanarUncalibDeformableModelXldcreate_planar_uncalib_deformable_model_xld,
read_deformable_modelread_deformable_modelReadDeformableModelReadDeformableModelread_deformable_model,
create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelcreate_planar_calib_deformable_model,
create_planar_calib_deformable_model_xldcreate_planar_calib_deformable_model_xldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldcreate_planar_calib_deformable_model_xld,
create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelcreate_local_deformable_model,
create_local_deformable_model_xldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXldcreate_local_deformable_model_xld
See also
set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamset_deformable_model_param,
find_planar_uncalib_deformable_modelfind_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelfind_planar_uncalib_deformable_model,
find_planar_calib_deformable_modelfind_planar_calib_deformable_modelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelfind_planar_calib_deformable_model
Module
Matching