Arbeiten mit Widgets > 3D > 3D-Beschriftung
  
3D-Beschriftung
Was macht dieses Widget?
Das Widget "3D-Beschriftung" ermöglicht es Ihnen, Daten und Informationen zu Ihren 3D-Modelle anzuzeigen.
Wann sollte ich dieses Widget verwenden?
Verwenden Sie eine 3D-Beschriftungs-Widget, wenn Sie Text in eine 3D-Canvas eines AR-Erlebnisses einschließen möchten. Die 3D-Beschriftung kann für einfache Ein- oder Zwei-Wort-Texte oder auch für größere Textmengen verwendet werden.
Gibt es besondere Eigenschaften, Dienste, Ereignisse oder Aktionen?
Eine Liste von allgemeinen Widget-Eigenschaften, -Diensten und -Ereignissen finden Sie unter Allgemeine Widget-Eigenschaften, -Dienste und -Ereignisse.
Die folgende Tabelle ist eine Liste von Eigenschaften, die für dieses Widget spezifisch sind.
Eigenschaft
JavaScript
Typ
Beschreibung
Text
text
string
Text, der im Widget angezeigt wird.
Höhe
height
number
Die Höhe der Beschriftung. Standardmäßig (oder wenn das Feld leer gelassen wird) wird dies auf 0,05 festgelegt.
Breite
width
number
Die Breite der Beschriftung.
Klasse
class
string
Die dem Widget zugewiesene Klasse.
Die folgenden CSS-Eigenschaften werden derzeit unterstützt:
font-family – legt die Schriftartfamilie fest
color – legt die Schrift-/Füllfarbe fest
--text-stroke-color – ähnlich wie color, legt aber die Schrift-Strichfarbe fest
--text-stroke-width – legt die Strichstärke fest
font-weight – legt das Gewicht oder die Dicke der Schrift fest
font-style
– legt den Schriftschnitt (normal, kursiv, schräg usw.) fest
background-color – legt die Füllfarbe der Beschriftung fest
text-decoration – unterstützt Unterstreichen
border-color – legt die Farbe des Rands um die Beschriftung fest
border-radius – rundet die Ecken des Rands um das Bild ab
border-style – legt den Stil des Rands um die Beschriftung fest
border-width – legt die Strichstärke des Rands um die Beschriftung fest
border – kombiniert border-colorborder-style und border-width
padding – wendet Auffüllen außerhalb des Beschriftungstextes an
Klicken Sie beispielsweise im Fensterbereich PROJEKT, unter STILE, auf Anwendung, und geben Sie im Editor Folgendes ein:
.my-label {
font-family: Century Gothic;
color: black;
--text-stroke-color: yellow;
--text-stroke-width: 3px;
font-weight: normal;
font-style: italic;
background-color: grey
}
* 
Angegebene Farben müssen CSS-Farben sein. Wenn Sie sich bezüglich gültiger CSS-Farben nicht sicher sind, können Sie im Internet nach "CSS-Farben" suchen.
Geben Sie anschließend im Feld Klasse der 3D-Beschriftung Folgendes ein: my-label. Dies bezieht sich auf Inhalt, der unter Stile > Anwendung hinzugefügt wurde.
Statusbasierte Formatierung aktivieren
enableStateFormatting
boolean
Ermöglicht es Ihnen, das Widget auf Basis von Statusdefinitionen zu formatieren, die in ThingWorx festgelegt wurden.
Wenn das Kontrollkästchen aktiviert ist, werden die folgenden Eigenschaften angezeigt:
Abhängiges Feld
Statusdefinition
Wenn eine 3D-Beschriftung z.B. fürStatusdefinition den Wert error hat, wird die Beschriftung rot.
Weitere Informationen zu Stil- und Statusdefinitionen in ThingWorx finden Sie unter Stil- und Statusdefinitionen im ThingWorx Hilfe-Center.
Abhängiges Feld
stateFormatValue
string
Diese Eigenschaft ist sichtbar, wenn das Kontrollkästchen Statusbasierte Formatierung aktivieren ausgewählt ist. Weitere Informationen zu Stil- und Statusdefinitionen in ThingWorx finden Sie unter Stil- und Statusdefinitionen im ThingWorx Hilfe-Center.
Statusdefinition
stateFormat
boolean
Diese Eigenschaft ist sichtbar, wenn das Kontrollkästchen Statusbasierte Formatierung aktivieren ausgewählt ist. Weitere Informationen zu Stil- und Statusdefinitionen in ThingWorx finden Sie unter Stil- und Statusdefinitionen im ThingWorx Hilfe-Center.
Schriftartfamilie
fontFamily
string
Stil der Schriftart. Geben Sie eine gültige Schriftartfamilie wie Arial, Times New Roman, Century Gothic usw. ein. Standardmäßig wird dies auf "Arial" festgelegt.
Schriftartfarbe
fontColor
string
Farbe der Schriftart. Geben Sie den Namen, hexadezimalen Wert oder RGBA-Wert einer Farbe ein. Wenn die Schriftfarbe beispielsweise Rot sein soll, können Sie einen der folgenden Werte eingeben:
red
#FF0000
rgba(255, 0, 0, 1)
Standardmäßig wird dies auf Schwarz festgelegt.
Schriftart-Konturfarbe
fontOutlineColor
string
Farbe der Schriftkontur. Geben Sie den Namen, hexadezimalen Wert oder RGBA-Wert einer Farbe ein. Wenn die Kontur der Beschriftung beispielsweise rot sein soll, können Sie einen der folgenden Werte eingeben:
red
#FF0000
rgba(255, 0, 0, 1)
Standardmäßig wird dies auf Weiß festgelegt.
Skala
scale
string
Skala der Beschriftung.
X-Koordinate
x
number
Position der Beschriftung auf der X-Achse.
Y-Koordinate
y
number
Position der Beschriftung auf der Y-Achse.
Z-Koordinate
z
number
Position der Beschriftung auf der Z-Achse.
X-Drehung
rx
number
Rotation der Beschriftung um die X-Achse.
Y-Drehung
ry
number
Rotation der Beschriftung um die Y-Achse.
Z-Drehung
rz
number
Rotation der Beschriftung um die Z-Achse.
Billboard
billboard
boolean
Dreht ein Widget um seine Mitte, so das es immer dem Betrachter zugewandt ist. Es wird nach dem Bildschirm ausgerichtet.
Verdeckend
occlude
boolean
Wenn diese Option ausgewählt ist, ist die Geometrie eines Widgets unsichtbar, aber gleichzeitig werden alle weiteren Augmentationen ausgeblendet, die in der 3D-Szene dahinter liegen.
Deshalb wird dort, wo das verdeckte Widget sein sollte, der Hintergrund oder der Kamera-Feed angezeigt. Das kann verwendet werden, um einige Augmentationen durch Ausblenden der umliegenden 3D-Geometrie zu betonen.
Immer im Vordergrund
decal
boolean
Überlagert die Widget-Geometrie auf sämtliche anderen Augmentationen in der Szene, unabhängig von seiner Tiefe in der 3D-Szene. Wenn dies auf Ja festgelegt ist, wird das Widget nie durch andere Augmentationen ausgeblendet. Eine typische Verwendung hierfür sind Beschriftungen oder Sensoren, die immer sichtbar bleiben müssen.
Durchlässigkeit (1 Undurchsichtig - 0 Transparent)
opacity
number
Eine Zahl zwischen 0 und 1, die die Transparenzstufe des Objekts steuert. 0 = vollkommen durchsichtig und 1 = vollkommen undurchsichtig.
Pivot
pivot
number
Bestimmt den Neutralpunkt des Bildes:
Oben links
Oben zentriert
Oben rechts
Mitte links
Mitte zentriert
Mitte rechts
Unten links
Unten zentriert
Unten rechts
Das Widget in Aktion
Hier ist ein Beispiel, wie Ihr Widget aussehen könnte.
Minimale Schritte, die für die Verwendung erforderlich sind
Wie das Ergebnis aussieht
1. Ziehen Sie ein 3D-Beschriftung-Widget in die Canvas, und legen Sie es ab.
2. (Optional) Wählen Sie das Kontrollkästchen für Billboard im Fensterbereich DETAILS aus.
3. Geben Sie den Text, der im Feld Text angezeigt werden soll, ein oder binden Sie eine Dateneigenschaft an das Feld Text des Widgets.
Widget mit CSS stylen
Sie können CSS verwenden, um das Widget zu stylen! Nachfolgend sehen Sie ein Beispiel für eine CSS-Klasse, die Sie erstellen und anwenden können:
* 
Beachten Sie, dass Klassen eindeutige Namen haben sollten, sodass es nicht zu Konflikten mit anderen Klassen oder vorkonfigurierten Eigenschaften kommt.
CSS-Beispiel
Wie das Ergebnis aussieht
.ptc-3DLabel {
font-family: Century Gothic;
color: black;
--text-stroke-color: yellow;
--text-stroke-width: 3px; /*csslint ignore*/
font-weight: normal;
font-style: italic;
background-color: grey
}
Weitere Informationen zum Implementieren von CSS-Klassen finden Sie unter Anwendungsstile.