get_deformable_model_contoursT_get_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours (算子)
名称
get_deformable_model_contoursT_get_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours — 返回可变形模型的轮廓描述。
签名
def get_deformable_model_contours(model_id: HHandle, level: int) -> HObject
描述
算子 get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours returns a
representation of the deformable model ModelIDModelIDModelIDModelIDmodelIDmodel_id as XLD contours
in ModelContoursModelContoursModelContoursModelContoursmodelContoursmodel_contours. The parameter LevelLevelLevelLevellevellevel 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_xldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldcreate_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_imageChangeRadialDistortionImageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image when
using the rectified camera parameters. The rectified camera parameters
can be queried by get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params。It should
be noted that the position of ModelContoursModelContoursModelContoursModelContoursmodelContoursmodel_contours is normalized
such that the reference point of the model (see
set_deformable_model_originset_deformable_model_originSetDeformableModelOriginSetDeformableModelOriginSetDeformableModelOriginset_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""get_deformable_model_contours_coord_system"
of the operator set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamSetDeformableModelParamset_deformable_model_param。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
ModelContoursModelContoursModelContoursModelContoursmodelContoursmodel_contours (输出对象) xld_cont-array → objectHXLDContHObjectHXLDContHobject *
Contour representation of the deformable model.
ModelIDModelIDModelIDModelIDmodelIDmodel_id (输入控制) deformable_model → HDeformableModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the model.
LevelLevelLevelLevellevellevel (输入控制) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Pyramid level for which the contour representation
should be returned.
默认值：
1
建议值：
1, 2, 3, 4, 5, 6, 7, 8, 9, 10
限制：
Level >= 1
结果
如果模型的句柄有效，算子
get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours 返回值 2 ( H_MSG_TRUE )。如有必要，则抛出异常。
可能的前趋
create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_model,
create_planar_uncalib_deformable_model_xldcreate_planar_uncalib_deformable_model_xldCreatePlanarUncalibDeformableModelXldCreatePlanarUncalibDeformableModelXldCreatePlanarUncalibDeformableModelXldcreate_planar_uncalib_deformable_model_xld,
read_deformable_modelread_deformable_modelReadDeformableModelReadDeformableModelReadDeformableModelread_deformable_model,
create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelcreate_planar_calib_deformable_model,
create_planar_calib_deformable_model_xldcreate_planar_calib_deformable_model_xldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldcreate_planar_calib_deformable_model_xld,
create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelCreateLocalDeformableModelcreate_local_deformable_model,
create_local_deformable_model_xldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXldCreateLocalDeformableModelXldcreate_local_deformable_model_xld
另见
set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamSetDeformableModelParamset_deformable_model_param,
find_planar_uncalib_deformable_modelfind_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelfind_planar_uncalib_deformable_model,
find_planar_calib_deformable_modelfind_planar_calib_deformable_modelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelfind_planar_calib_deformable_model
模块
匹配