get_deformable_model_contoursT_get_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContours (Operator)

Name

get_deformable_model_contoursT_get_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContours — Auslesen der Konturrepräsentation eines Formmodells.

Signatur

get_deformable_model_contours( : ModelContours : ModelID, Level : )

Beschreibung

Der Operator get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursGetDeformableModelContours gibt in ModelContoursModelContoursModelContoursModelContoursmodelContours eine Repräsentation des Formmodells ModelIDModelIDModelIDModelIDmodelID als XLD-Konturen zurück. Der Parameter LevelLevelLevelLevellevel gibt an, für welche Pyramidenstufe des Modells die Konturrepräsentation zurückgegeben werden soll. Die Konturen können z.B. zur Visualisierung der gefundenen Instanzen des Modells verwendet werden.

Im Falle, dass das Modell mit create_planar_calib_deformable_model_xldcreate_planar_calib_deformable_model_xldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXld erzeugt wurde, wird die Kontur des Modells standardmäßig im Weltkoordinatensytem in metrischem Maß zurückgegeben. Für die Visualisierung müssen die Konturen mit der zurückgelieferten Pose transformiert werden.

In allen anderen Fällen wird die Kontur des Modells standardmäßig im Bildkoordinatensystem im Pixelmaß zurückgegeben. Für den kalibrierten Fall handelt es sich dabei um das rektifizierte Bildkoordinatensystem. Das rektifizierte Bildkoordinatensystem entspricht dem Koordinatensystem eines Bildes, das man mit change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImageChangeRadialDistortionImage unter Verwendung der rektifizierten Kameraparameter erhält. Die rektifizierten Kameraparameter lassen sich mit get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsGetDeformableModelParams abfragen. Es ist darauf zu achten, dass die Lage von ModelContoursModelContoursModelContoursModelContoursmodelContours so normalisiert worden ist, dass der Referenzpunkt des Modells (siehe set_deformable_model_originset_deformable_model_originSetDeformableModelOriginSetDeformableModelOriginSetDeformableModelOrigin) an der Pixelposition (0,0) liegt. D.h., die Konturen müssen mit der Homographie lediglich an die gefundene Stelle transformiert werden.

Das Standardverhalten kann mit dem generischen 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''getDeformableModelContoursCoordSystem' des Operators set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamSetDeformableModelParam geändert werden.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

ModelContoursModelContoursModelContoursModelContoursmodelContours (output_object) xld_cont-array → object

Konturrepräsentation des Formmodells.

ModelIDModelIDModelIDModelIDmodelID (input_control) deformable_model → (handle)

Handle des Modells.

LevelLevelLevelLevellevel (input_control) integer → (integer)

Pyramidenebene, für die die Konturrepräsentation zurückgegeben werden soll.

Defaultwert: 1

Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

Restriktion: Level >= 1

Ergebnis

Ist der Handle des Modells gültig, dann liefert get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursGetDeformableModelContours den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModel, create_planar_uncalib_deformable_model_xldcreate_planar_uncalib_deformable_model_xldCreatePlanarUncalibDeformableModelXldCreatePlanarUncalibDeformableModelXldCreatePlanarUncalibDeformableModelXld, read_deformable_modelread_deformable_modelReadDeformableModelReadDeformableModelReadDeformableModel, create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModel, create_planar_calib_deformable_model_xldcreate_planar_calib_deformable_model_xldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXld, create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelCreateLocalDeformableModel, create_local_deformable_model_xldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXldCreateLocalDeformableModelXld

Siehe auch

set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamSetDeformableModelParam, find_planar_uncalib_deformable_modelfind_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModel, find_planar_calib_deformable_modelfind_planar_calib_deformable_modelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModel

Modul

Matching