disp_object_model_3dT_disp_object_model_3dDispObjectModel3ddisp_object_model_3dDispObjectModel3dDispObjectModel3d (Operator)

Name

disp_object_model_3dT_disp_object_model_3dDispObjectModel3ddisp_object_model_3dDispObjectModel3dDispObjectModel3d — Ausgeben von 3D Objektmodellen.

Signatur

Beschreibung

disp_object_model_3ddisp_object_model_3dDispObjectModel3ddisp_object_model_3dDispObjectModel3dDispObjectModel3d zeigt die 3D Objektmodelle ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D im Fenster WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle an. Die Szene wird über die Kameraparameter CamParamCamParamCamParamCamParamCamParamcamParam und die Posen (in PosePosePosePosePosepose) der 3D Objektmodelle definiert. Wird ein leeres Tupel für CamParamCamParamCamParamCamParamCamParamcamParam übergeben, verwendet disp_object_model_3ddisp_object_model_3dDispObjectModel3ddisp_object_model_3dDispObjectModel3dDispObjectModel3d Default-Kameraparameter, die auf der Fenstergröße beruhen. PosePosePosePosePosepose kann entweder eine Pose enthalten, die für alle 3D Objektmodelle gilt, oder eine individuelle Pose für jedes 3D Objektmodell. Wird ein leeres Tupel für PosePosePosePosePosepose übergeben, schätzt disp_object_model_3ddisp_object_model_3dDispObjectModel3ddisp_object_model_3dDispObjectModel3dDispObjectModel3d diese Parameter so, dass alle Objekte sichtbar sind.

3D Objektmodelle, die Dreiecke oder Polygone beinhalten, werden als geschlossene Körper dargestellt. 3D Objektmodelle, die nur Koordinaten enthalten, werden dagegen als Punktwolken visualisiert. 3D-Primitive (wie sie zum Beispiel von fit_primitives_object_model_3dfit_primitives_object_model_3dFitPrimitivesObjectModel3dfit_primitives_object_model_3dFitPrimitivesObjectModel3dFitPrimitivesObjectModel3d erzeugt werden), werden auch als geschlossene Körper dargestellt. Mit dem generischen Parameter 'attribute'"attribute""attribute""attribute""attribute""attribute" kann explizit die Art der Darstellung ausgewählt werden.

Um 3D Objektmodelle in ein Bild zu rendern, kann der Operator render_object_model_3drender_object_model_3dRenderObjectModel3drender_object_model_3dRenderObjectModel3dRenderObjectModel3d benutzt werden.

Mit GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue können weitere Eigenschaften der Szene konfiguriert werden. Die folgenden Werte beeinflussen die gesamte Szene:

'disp_background'"disp_background""disp_background""disp_background""disp_background""disp_background":

Flag, ob der gegenwärtige Fensterinhalt als Hintergrund verwendet werden soll.

Werte: 'true' oder 'false'

Defaultwert: 'false'

'light_position'"light_position""light_position""light_position""light_position""light_position":

Position der Lichtquelle. Dieser Parameter muss als String mit vier Fließkommawerten (getrennt durch Leerzeichen) übergeben werden. Ist der vierte Wert 0.0, wird eine gerichtete Lichtquelle verwendet, wobei die ersten drei Werte die Richtung bestimmen. Ansonsten wird eine Punktlichtquelle verwendet, deren Position durch die ersten drei Werte bestimmt ist.

Defaultwert: '-100.0 -100.0 0.0 1.0'

'light_ambient'"light_ambient""light_ambient""light_ambient""light_ambient""light_ambient":

Ambienter Anteil der Lichtquelle. Dieser Parameter muss als String mit drei Fließkommawerten (getrennt durch Leerzeichen) übergeben werden.

Defaultwert: '0.2 0.2 0.2'

'light_diffuse'"light_diffuse""light_diffuse""light_diffuse""light_diffuse""light_diffuse":

Diffuser Anteil der Lichtquelle. Dieser Parameter muss als String mit drei Fließkommawerten (getrennt durch Leerzeichen) übergeben werden.

Defaultwert: '0.8 0.8 0.8'

'colored'"colored""colored""colored""colored""colored":

Darstellung von 3D Objektmodellen mit unterschiedlichen Farben. Der Wert dieses Parameters bestimmt die Anzahl der verwendeten Farben.

Werte: 3, 6 oder 12

Defaultwert: alle 3D Objektmodelle werden weiß dargestellt

'object_index_persistence'"object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence":

Muss auf 'true'"true""true""true""true""true" gesetzt werden, wenn der Objektindex mit get_disp_object_model_3d_infoget_disp_object_model_3d_infoGetDispObjectModel3dInfoget_disp_object_model_3d_infoGetDispObjectModel3dInfoGetDispObjectModel3dInfo abgefragt werden soll.

Werte: 'true' oder 'false'

Defaultwert: 'false'

'depth_persistence'"depth_persistence""depth_persistence""depth_persistence""depth_persistence""depth_persistence":

Muss auf 'true'"true""true""true""true""true" gesetzt werden, wenn die Tiefe mit get_disp_object_model_3d_infoget_disp_object_model_3d_infoGetDispObjectModel3dInfoget_disp_object_model_3d_infoGetDispObjectModel3dInfoGetDispObjectModel3dInfo abgefragt werden soll.

Werte: 'true' oder 'false'

Defaultwert: 'false'

'quality'"quality""quality""quality""quality""quality":

Kann auf 'low'"low""low""low""low""low" gesetzt werden um schnelleres Rendering ohne Antialiasing zu erzielen.

Werte: 'low' oder 'high'

Defaultwert: 'high'

Die folgenden Parameter können entweder für alle 3D Objektmodelle der Szene oder für ein einzelnes 3D Objektmodell gesetzt werden (indem der Index des 3D Objektmodells an den Parameternamen angehängt wird, z.B. 'color_0'"color_0""color_0""color_0""color_0""color_0").

'attribute'"attribute""attribute""attribute""attribute""attribute"

Wählt explizit die Art und Weise aus, wie ein 3D Objektmodell visualisiert wird.

Werte: 'auto', 'faces', 'primitive', 'points', 'lines'

Defaultwert: 'auto'

'color'"color""color""color""color""color":

Farbe des 3D Objektmodells. Die verfügbaren Farben können mit dem Operator query_colorquery_colorQueryColorquery_colorQueryColorQueryColor erfragt werden. Darüberhinaus kann die Farbe auch über ein RGB-Tripel in der Form '#rrggbb'"#rrggbb""#rrggbb""#rrggbb""#rrggbb""#rrggbb" gesetzt werden, wobei 'rr', 'gg' und 'bb' jeweils hexadezimale Zahlen zwischen '00' und 'ff' sind.

Werte: 'red', 'green', ...

Defaultwert: 'white'

'alpha'"alpha""alpha""alpha""alpha""alpha":

Transluzenz des 3D Objektmodells. Das Darstellen von 3D Objektmodellen mit Transluzenz kleiner 1.0 kann zu signifikant höherer Laufzeit führen.

Werte: Fließkommawerte zwischen 0.0 (transparent) und 1.0 (opak).

Defaultwert: 1.0

'disp_pose'"disp_pose""disp_pose""disp_pose""disp_pose""disp_pose":

Flag, ob die Pose des 3D Objektmodells visualisiert werden soll.

Werte: 'true' oder 'false'

Defaultwert: 'false'

'disp_lines'"disp_lines""disp_lines""disp_lines""disp_lines""disp_lines":

Flag, ob die Konturen der Polygone des 3D Objektmodells angezeigt werden sollen.

Werte: 'true' oder 'false'

Defaultwert: 'false'

'disp_normals'"disp_normals""disp_normals""disp_normals""disp_normals""disp_normals":

Flag, ob die Oberflächennormalen der Polygone des 3D Objektmodells angezeigt werden sollen.

Werte: 'true' oder 'false'

Defaultwert: 'false'

'line_color'"line_color""line_color""line_color""line_color""line_color":

Farbe der Konturen, falls 'disp_lines'"disp_lines""disp_lines""disp_lines""disp_lines""disp_lines" auf 'true'"true""true""true""true""true" gesetzt ist. Die verfügbaren Farben können mit dem Operator query_colorquery_colorQueryColorquery_colorQueryColorQueryColor erfragt werden. Darüberhinaus kann die Farbe auch über ein RGB-Tripel in der Form '#rrggbb'"#rrggbb""#rrggbb""#rrggbb""#rrggbb""#rrggbb" gesetzt werden, wobei 'rr', 'gg' und 'bb' jeweils hexadezimale Zahlen zwischen '00' und 'ff' sind.

Werte: 'red', 'green', ...

Defaultwert: Der Wert von 'color'"color""color""color""color""color"

'line_width'"line_width""line_width""line_width""line_width""line_width":

Setzt die Breite von Linien in Pixel.

Defaultwert: 1.0

'normal_color'"normal_color""normal_color""normal_color""normal_color""normal_color":

Farbe der Oberflächennormalen, falls 'disp_normals'"disp_normals""disp_normals""disp_normals""disp_normals""disp_normals" auf 'true'"true""true""true""true""true" gesetzt ist. Die verfügbaren Farben können mit dem Operator query_colorquery_colorQueryColorquery_colorQueryColorQueryColor erfragt werden. Darüberhinaus kann die Farbe auch über ein RGB-Tripel in der Form '#rrggbb'"#rrggbb""#rrggbb""#rrggbb""#rrggbb""#rrggbb" gesetzt werden, wobei 'rr', 'gg' und 'bb' jeweils hexadezimale Zahlen zwischen '00' und 'ff' sind.

Werte: 'red', 'green', ...

Defaultwert: Der Wert von 'color'"color""color""color""color""color"

'point_size'"point_size""point_size""point_size""point_size""point_size":

Setzt den Durchmesser der Punkte.

Defaultwert: 3.5

'lut'"lut""lut""lut""lut""lut":

Setzt die LUT, die die Werte des mit 'color_attrib'"color_attrib""color_attrib""color_attrib""color_attrib""color_attrib" gesetzten Attributes in Farben umwandelt. In der Dokumentation von set_lutset_lutSetLutset_lutSetLutSetLut befindet sich eine Liste der verfügbaren LUTs. Ist 'lut'"lut""lut""lut""lut""lut" auf etwas anderes als 'default'"default""default""default""default""default" gesetzt, wird 'color'"color""color""color""color""color" ignoriert.

Defaultwert: 'default'

'color_attrib'"color_attrib""color_attrib""color_attrib""color_attrib""color_attrib":

Name eines Punktattributes, das für die Falschfarbendarstellung verwendet wird.

Falls ein Attribut gesetzt ist, wird die Farbe eines dargestellten 3D-Punktes durch den Attributwert des Punktes und die aktuell gesetzte LUT bestimmt (siehe 'lut'"lut""lut""lut""lut""lut"). Auf diese Weise ist es möglich, Attribute in Falschfarben darzustellen.

Beispiel: Wenn 'color_attrib'"color_attrib""color_attrib""color_attrib""color_attrib""color_attrib" auf 'coord_z'"coord_z""coord_z""coord_z""coord_z""coord_z" und 'lut'"lut""lut""lut""lut""lut" auf 'color1'"color1""color1""color1""color1""color1" gesetzt ist, werden die Z-Koordinaten von rot nach blau farbkodiert.

Falls 'lut'"lut""lut""lut""lut""lut" auf 'default'"default""default""default""default""default" gesetzt ist, werden die Attributwerte verwendet, um die mit 'color'"color""color""color""color""color" gesetzte Farbe zu skalieren.

Falls 'lut'"lut""lut""lut""lut""lut" auf etwas anderes gesetzt, werden die Attributwerte intern auf den Bereich [0,255] skaliert und als Eingabe für die LUT-Funktion verwendet.

Die Abbildung wird außerdem von den Parametern 'color_attrib_start'"color_attrib_start""color_attrib_start""color_attrib_start""color_attrib_start""color_attrib_start" und 'color_attrib_end'"color_attrib_end""color_attrib_end""color_attrib_end""color_attrib_end""color_attrib_end" bestimmt (siehe unten).

Falls Flächen dargestellt werden, wird ihre Farbe zwischen den Eckpunktfarben interpoliert.

Werte: 'none', '&distance', 'coord_x', 'coord_y', 'coord_z', user defined point attributes, or any other point attribute available.

Defaultwert: 'none'

'color_attrib_start'"color_attrib_start""color_attrib_start""color_attrib_start""color_attrib_start""color_attrib_start",'color_attrib_end'"color_attrib_end""color_attrib_end""color_attrib_end""color_attrib_end""color_attrib_end":

Der maßgebliche Wertebereich für das mit 'color_attrib'"color_attrib""color_attrib""color_attrib""color_attrib""color_attrib" eingestellte Attribut.

Die Attributwerte zwischen 'color_attrib_start'"color_attrib_start""color_attrib_start""color_attrib_start""color_attrib_start""color_attrib_start" und 'color_attrib_end'"color_attrib_end""color_attrib_end""color_attrib_end""color_attrib_end""color_attrib_end" werden auf den Anfang und das Ende der ausgewählten LUT skaliert. Attributwerte außerhalb des Bereiches werden beschnitten. Damit ist es möglich, einen festen Farbbereich darzustellen, der nicht durch Ausreißer verzerrt wird.

Bei 'auto'"auto""auto""auto""auto""auto" wird der kleinste Attributwert auf den Anfang der LUT abgebildet, der größte Wert auf das Ende, es sei denn, 'color_attrib'"color_attrib""color_attrib""color_attrib""color_attrib""color_attrib" ist 'normal_x'"normal_x""normal_x""normal_x""normal_x""normal_x", 'normal_y'"normal_y""normal_y""normal_y""normal_y""normal_y" oder 'normal_z'"normal_z""normal_z""normal_z""normal_z""normal_z". In diesem Fall, werden Start und Ende automatisch auf -1 und 1 gesetzt.

Der Startwert kann höher als der Endwert sein. In dem Fall wird die LUT umgedreht.

Werte: 0, 0.1, 1, 100, 255, ...

Defaultwerte: 'auto'

'red_channel_attrib'"red_channel_attrib""red_channel_attrib""red_channel_attrib""red_channel_attrib""red_channel_attrib", 'green_channel_attrib'"green_channel_attrib""green_channel_attrib""green_channel_attrib""green_channel_attrib""green_channel_attrib", 'blue_channel_attrib'"blue_channel_attrib""blue_channel_attrib""blue_channel_attrib""blue_channel_attrib""blue_channel_attrib":

Name eines Punktattributes, das für den Rot-, Grün-, oder Blaukanal verwendet wird.

Das ist besonders nützlich, wenn drei zusammengehörige Attribute verwendet werden, z.B. RGB-Farben oder Normalenvektoren. Auf diese Weise können Punkte mit farbigen Texturen, z.B. RGB-Sensor-Daten, dargestellt oder Punktnormalen in Falschfarben kodiert werden.

Um ein einzelnes Attribut in Falschfarben darzustellen, verwenden Sie bitte 'color_attrib'"color_attrib""color_attrib""color_attrib""color_attrib""color_attrib" (siehe oben).

Per Default wird angenommen, dass die Attributwerte zwischen 0 und 255 liegen. Falls die Attribute andere Wertebereiche haben, müssen zusätzlich die Parameter 'rgb_channel_attrib_start'"rgb_channel_attrib_start""rgb_channel_attrib_start""rgb_channel_attrib_start""rgb_channel_attrib_start""rgb_channel_attrib_start" und 'rgb_channel_attrib_end'"rgb_channel_attrib_end""rgb_channel_attrib_end""rgb_channel_attrib_end""rgb_channel_attrib_end""rgb_channel_attrib_end" gesetzt werden (siehe unten).

Falls nur 1 oder 2 Kanäle gesetzt sind, verwenden die übrigen Kanäle den RGB-Wert der mit 'color'"color""color""color""color""color" eingestellten Farbe.

Falls Flächen dargestellt werden, wird ihre Farbe zwischen den Eckpunktfarben interpoliert.

Werte: 'none', '&red','&green','&blue', 'normal_x', 'normal_y', 'normal_z', user defined point attributes, or any other point attribute available.

Defaultwerte: 'none'

'rgb_channel_attrib_start'"rgb_channel_attrib_start""rgb_channel_attrib_start""rgb_channel_attrib_start""rgb_channel_attrib_start""rgb_channel_attrib_start", 'rgb_channel_attrib_end'"rgb_channel_attrib_end""rgb_channel_attrib_end""rgb_channel_attrib_end""rgb_channel_attrib_end""rgb_channel_attrib_end":

Der maßgebliche Wertebereich für die mit 'red_channel_attrib'"red_channel_attrib""red_channel_attrib""red_channel_attrib""red_channel_attrib""red_channel_attrib", 'green_channel_attrib'"green_channel_attrib""green_channel_attrib""green_channel_attrib""green_channel_attrib""green_channel_attrib" und 'blue_channel_attrib'"blue_channel_attrib""blue_channel_attrib""blue_channel_attrib""blue_channel_attrib""blue_channel_attrib" eingestellten Attribute.

Diese Parameter definieren den Wertebereich, der auf die gesamten RGB-Kanäle skaliert wird. Das ist nützlich, wenn die Werte der Eingabeattribute nicht im Intervall [0,255] liegen.

Bei 'auto'"auto""auto""auto""auto""auto" wird der kleinste Attributwert auf 0 abgebildet, der größte Wert auf 255, es sei denn, das Attribut ist 'normal_x'"normal_x""normal_x""normal_x""normal_x""normal_x", 'normal_y'"normal_y""normal_y""normal_y""normal_y""normal_y" oder 'normal_z'"normal_z""normal_z""normal_z""normal_z""normal_z". In diesem Fall, werden Start und Ende automatisch auf -1 und 1 gesetzt.

Der Startwert kann höher als der Endwert sein. In dem Fall werden die RGB-Farben invertiert.

Der Bereich kann für jeden Kanal einzeln eingestellt werden, indem im Parameternamen das 'rgb'"rgb""rgb""rgb""rgb""rgb" durch den jeweiligen Kanal ersetzt wird, z.B. 'green_channel_attrib_start'"green_channel_attrib_start""green_channel_attrib_start""green_channel_attrib_start""green_channel_attrib_start""green_channel_attrib_start".

Werte: 'auto', 0, 0.1, 1, 100, 255, ...

Defaultwerte: 0, 255

Alle generischen Parameter werden von links nach rechts ausgewertet. Um beispielsweise die Farbe des ersten Objekts auf rot und die Farbe aller anderen Objekte auf grün zu setzen, muss GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf ['color','color_0']["color","color_0"]["color","color_0"]["color","color_0"]["color","color_0"]["color","color_0"] und GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue auf ['green','red']["green","red"]["green","red"]["green","red"]["green","red"]["green","red"] gesetzt werden.

disp_object_model_3ddisp_object_model_3dDispObjectModel3ddisp_object_model_3dDispObjectModel3dDispObjectModel3d benötigt OpenGL 2.1, GLSL 1.2 und die OpenGL Extensions GL_EXT_framebuffer_object und GL_EXT_framebuffer_blit. Andernfalls wird automatisch der Kompatibilitätsmodus mit geringeren Anforderungen an OpenGL benutzt.

Bei Grafikkarten mit geringem Speicher können bei großer Auflösung des Renderfensters folgende Fehlermeldungen auftreten:

Low-Level Fehler: 'Incomplete attachment'

Unbehandelte Ausnahme: 'Benötigtes Framebuffer Objekt wird nicht unterstützt'

Lösungen:

Um die Anforderungen an den Speicher der Grafikkarte zu verringern, kann der Parameter 'quality'"quality""quality""quality""quality""quality" auf 'low'"low""low""low""low""low" gesetzt oder der Kompatibilitätsmodus verwendet werden.

Die Systemvariable (siehe set_systemset_systemSetSystemset_systemSetSystemSetSystem) 'opengl_compatibility_mode_enable'"opengl_compatibility_mode_enable""opengl_compatibility_mode_enable""opengl_compatibility_mode_enable""opengl_compatibility_mode_enable""opengl_compatibility_mode_enable" kann auf 'true'"true""true""true""true""true" gesetzt werden, um den Kompatibilitätsmodus permanent einzuschalten. Dieser Modus benötigt OpenGL 1.1.

Im Kompabilitätsmodus werden die Parameter 'object_index_persistence'"object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence", 'depth_persistence'"depth_persistence""depth_persistence""depth_persistence""depth_persistence""depth_persistence" und 'quality'"quality""quality""quality""quality""quality" nicht unterstützt.

Auf Linux Remote-Desktop wird 'disp_background'"disp_background""disp_background""disp_background""disp_background""disp_background" nicht unterstützt.

Parallelisierung

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

Parameter

Ergebnis

disp_object_model_3ddisp_object_model_3dDispObjectModel3ddisp_object_model_3dDispObjectModel3dDispObjectModel3d liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt. Sollte das Rendering den verfügbaren Speicher der Grafikkarte überschreiten, wird die Fehlermeldung 5188 zurückgegeben.

Vorgänger

find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel, fit_primitives_object_model_3dfit_primitives_object_model_3dFitPrimitivesObjectModel3dfit_primitives_object_model_3dFitPrimitivesObjectModel3dFitPrimitivesObjectModel3d, read_object_model_3dread_object_model_3dReadObjectModel3dread_object_model_3dReadObjectModel3dReadObjectModel3d, segment_object_model_3dsegment_object_model_3dSegmentObjectModel3dsegment_object_model_3dSegmentObjectModel3dSegmentObjectModel3d

Nachfolger

get_disp_object_model_3d_infoget_disp_object_model_3d_infoGetDispObjectModel3dInfoget_disp_object_model_3d_infoGetDispObjectModel3dInfoGetDispObjectModel3dInfo

Siehe auch

render_object_model_3drender_object_model_3dRenderObjectModel3drender_object_model_3dRenderObjectModel3dRenderObjectModel3d, project_object_model_3dproject_object_model_3dProjectObjectModel3dproject_object_model_3dProjectObjectModel3dProjectObjectModel3d, project_shape_model_3dproject_shape_model_3dProjectShapeModel3dproject_shape_model_3dProjectShapeModel3dProjectShapeModel3d, object_model_3d_to_xyzobject_model_3d_to_xyzObjectModel3dToXyzobject_model_3d_to_xyzObjectModel3dToXyzObjectModel3dToXyz

Modul

3D Metrology