get_shape_model_3d_contours
— Auslesen der Konturrepräsentation einer Ansicht eines
3D-Formmodells.
get_shape_model_3d_contours( : ModelContours : ShapeModel3DID, Level, View : ViewPose)
Der Operator get_shape_model_3d_contours
gibt in
ModelContours
eine Repräsentation einer Modellansicht des
3D-Formmodells ShapeModel3DID
als XLD-Konturen zurück. Die
Parameter Level
und View
geben an, für welche
Modellansicht die Konturrepräsentation zurückgegeben werden
soll. Dabei bezeichnet Level
die Pyramidenstufe und
View
die Ansicht auf dieser Pyramidenstufe.
Die erlaubten Wertebereiche für Level
und View
können zuvor mit dem Operator get_shape_model_3d_params
ermittelt werden, indem man für GenParamName
'num_views_per_level' übergibt.
Die Konturen können zur Visualisierung und Beurteilung des mit
create_shape_model_3d
erstellten Modells verwendet werden.
Dies ermöglicht es abzuschätzen, ob die Anzahl der Pyramidenebenen
korrekt gewählt wurde. Zeigen z.B. die Konturen auf der obersten
Ebene nicht genügend Details, um für die Modellansicht noch
repräsentativ zu sein, sollte bei der Suche mit
find_shape_model_3d
die Anzahl der Pyramidenebenen mit
NumLevels
entsprechend nach unten korrigiert werden. Für
den Fall, dass die Konturen selbst auf der obersten Pyramidenebene
noch zu viele Details enthalten, sollte bereits beim Erstellen des
3D-Formmodells mit create_shape_model_3d
eine größere Anzahl
an Pyramidenebenen gewählt werden.
Zusätzlich wird in ViewPose
die Pose der gewählte Ansicht
zurückgegeben. Diese kann z.B. verwendet werden, um das
3D-Formmodell in der der Ansicht entsprechenden Pose mit
project_shape_model_3d
zu projizieren. Das projizierte
Modell kann dann als Grundlage für die oben beschriebene Bewertung
der Modellkonturen ModelContours
dienen. Zu beachten ist,
dass aufgrund von radialen Verzeichnungen die Position der Konturen
der Projektion leicht von der Position der Modellkonturen abweichen
kann.
ModelContours
(output_object) xld_cont-array →
object
Konturrepräsentation der Modellansicht.
ShapeModel3DID
(input_control) shape_model_3d →
(handle)
Handle des 3D-Formmodells.
Level
(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
View
(input_control) integer →
(integer)
Ansicht, 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: View >= 1
ViewPose
(output_control) pose →
(real / integer)
3D-Lage (Pose) des 3D-Formmodells in der Ansicht.
Sind die Parameterwerte korrekt, dann liefert
get_shape_model_3d_contours
den Wert 2 (H_MSG_TRUE). Gegebenenfalls
wird eine Fehlerbehandlung durchgeführt.
create_shape_model_3d
,
read_shape_model_3d
,
get_shape_model_3d_params
3D Metrology