set_scene_3d_label_paramT_set_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParamset_scene_3d_label_param (Operator)

Name

set_scene_3d_label_paramT_set_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParamset_scene_3d_label_param — Setzen von Parametern eines Labels in einer 3D-Szene.

Signatur

Beschreibung

set_scene_3d_label_paramset_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParamSetScene3dLabelParamset_scene_3d_label_param setzt Parameter des Labels mit dem Index LabelIndexLabelIndexLabelIndexLabelIndexlabelIndexlabel_index in der 3D-Szene Scene3DScene3DScene3DScene3Dscene3Dscene_3d. Name und Wert eines Parameters werden in GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value übergeben. Es ist möglich, ein Paar aus GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value für einzelne oder mehrere Labels zu setzen.

Die folgenden Werte können gesetzt werden:

'reference_point'"reference_point""reference_point""reference_point""reference_point""reference_point":

Koordinaten des Bezugspunkts als [X, Y, Z]-Koordinatentupel. Um einen Bezugspunkt zu entfernen, kann auch ein leeres Tupel übergeben werden. Das ist nur möglich wenn 'relates_to'"relates_to""relates_to""relates_to""relates_to""relates_to" auf 'window'"window""window""window""window""window" gesetzt ist.

'position'"position""position""position""position""position":

Position (fest oder relativ, abhängig von 'relates_to'"relates_to""relates_to""relates_to""relates_to""relates_to") des Labels. Entweder als [Row, Column]-Koordinaten oder eine der folgenden vordefinierten Positionen: 'top_left'"top_left""top_left""top_left""top_left""top_left", 'top'"top""top""top""top""top", 'top_right'"top_right""top_right""top_right""top_right""top_right", 'left'"left""left""left""left""left", 'center'"center""center""center""center""center", 'right'"right""right""right""right""right", 'bottom_left'"bottom_left""bottom_left""bottom_left""bottom_left""bottom_left", 'bottom'"bottom""bottom""bottom""bottom""bottom" oder 'bottom_right'"bottom_right""bottom_right""bottom_right""bottom_right""bottom_right".

'relates_to'"relates_to""relates_to""relates_to""relates_to""relates_to":

Art der Positionierung. Ist entweder 'window'"window""window""window""window""window" (feste Positionierung in Fensterkoordinaten) oder 'point'"point""point""point""point""point" (Positionierung relativ zum Bezugspunkt). 'relates_to'"relates_to""relates_to""relates_to""relates_to""relates_to" kann nicht auf 'point'"point""point""point""point""point" gesetzt werden, wenn der Bezugspunkt auf einen leeren Tupel gesetzt wurde.

Werteliste: 'window'"window""window""window""window""window", 'point'"point""point""point""point""point".

Standardwert: 'window'"window""window""window""window""window".

'text'"text""text""text""text""text":

Text des Labels. Mehrere Zeilen werden mit '\n'"\n""\n""\n""\n""\n" getrennt.

'font'"font""font""font""font""font":

Schriftart des Textlabels.

Mögliche Werte: Verfügbare Schriftarten können mit query_fontquery_fontQueryFontQueryFontQueryFontquery_font abgefragt werden.

Standardwert: Font des ersten Fensters, in dem die Szene dargestellt wird. Ansonsten die Default-Systemschriftart.

'text_color'"text_color""text_color""text_color""text_color""text_color":

Farbe des Texts. Die verfügbaren Farben können mit dem Operator query_colorquery_colorQueryColorQueryColorQueryColorquery_color 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.

Wertevorschläge: 'red'"red""red""red""red""red", 'green'"green""green""green""green""green".

Standardwert: 'white'"white""white""white""white""white".

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

Transparenz des Labelhintergrunds.

Mögliche Werte: Zahl zwischen 0.0 (voll transparent) und 1.0 (voll opak).

Standardwert: 1.0.

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

Flag, ob der Hintergrund des Labels dargestellt wird.

Werteliste: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false".

Standardwert: 'false'"false""false""false""false""false".

'disp_connecting_line'"disp_connecting_line""disp_connecting_line""disp_connecting_line""disp_connecting_line""disp_connecting_line":

Flag, ob die Verbindungslinie zwischen dem Label und dem entsprechenden 3D-Punkt angezeigt werden soll.

Werteliste: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false".

Standardwert: 'false'"false""false""false""false""false".

'visible'"visible""visible""visible""visible""visible":

Setzt die Sichtbarkeit des Labels. Wird 'visible'"visible""visible""visible""visible""visible" auf 'if_point_is_visible'"if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible" gesetzt, ist das Label nur sichtbar, wenn der Bezugspunkt sichtbar ist. Im Kompatibilitätsmodus oder im Falle, dass kein Bezugspunkt gesetzt ist, verhält sich 'if_point_is_visible'"if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible" wie 'true'"true""true""true""true""true".

Werteliste: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 'if_point_is_visible'"if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible".

Standardwert: 'false'"false""false""false""false""false".

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

Ergebnis

Sind die Parameterwerte korrekt, dann liefert set_scene_3d_label_paramset_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParamSetScene3dLabelParamset_scene_3d_label_param den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

add_scene_3d_labeladd_scene_3d_labelAddScene3dLabelAddScene3dLabelAddScene3dLabeladd_scene_3d_label

Modul

3D Metrology