Arbeiten mit Widgets > 3D > 3D-Anzeige
  
3D-Anzeige
Was macht dieses Widget?
Das Widget "3D-Anzeige" kombiniert Bild- und Text-Widget-Funktionalität in der 3D-Canvas eines AR-Erlebnisses. Nachdem das Widget "3D-Anzeige" in die Canvas gezogen und abgelegt wurde, werden ein Standardbild und ein Standardtext angezeigt (die beide aktualisiert werden können). Zu den unterstützten Dateiformaten gehören:
.png
.jpg, .jpeg
.svg
.gif
.bmp
Wann sollte ich dieses Widget verwenden?
Verwenden Sie ein 3D-Anzeige-Widget, wenn Sie eine Eigenschaft aus einer verbundenen Sache in einer 3D-Anzeige anzeigen möchten. Wenn Sie beispielsweise die Motortemperatur von einem Generator aus anzeigen möchten, binden Sie einfach die EngineTemp-Eigenschaft an das Messgerät.
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.
Ressource
src
resource url
Der Pfad zum Bild, das für die 3D-Anzeige verwendet wird. Standardmäßig wird dies auf vu_gauge1.svg festgelegt.
Um eine 3D-Anzeige einzuschließen, können Sie einen der folgenden Schritte ausführen:
Klicken Sie neben dem Feld auf , um eine neue Bilddatei hinzuzufügen.
Geben oder fügen Sie eine Bild-URL direkt in das Feld ein.
Wählen Sie im Dropdown-Menü ein Bild aus.
Zu den unterstützten Dateiformaten gehören:
.png
.jpg
.svg
.jpeg
.gif
.bmp
Schriftart
font
string
Die Schriftart. Standardmäßig wird dies auf "Arial" festgelegt.
Schriftgrad
fontsize
string
Die Größe der Schriftart, in Pixel angegeben. Standardmäßig wird dies auf 40 px festgelegt.
Textattribute
textattrs
string
Attribute des Textes, einschließlich:
Füllung
Text-Grundlinie
Textausrichtung
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
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.
X-Koordinate des Texts im Hinblick auf Canvas
textx
number
Position des Textes auf der X-Achse im Hinblick auf die Canvas.
Y-Koordinate des Texts im Hinblick auf Canvas
texty
number
Position des Textes auf der Y-Achse im Hinblick auf die Canvas.
Skala
scale
string
Skala der Anzeige.
X-Koordinate
x
number
Position der Anzeige auf der X-Achse.
Y-Koordinate
y
number
Position der Anzeige auf der Y-Achse.
Z-Koordinate
z
number
Position der Anzeige auf der Z-Achse.
X-Drehung
rx
number
Rotation der Anzeige um die X-Achse.
Y-Drehung
ry
number
Rotation der Anzeige um die Y-Achse.
Z-Drehung
rz
number
Rotation der Anzeige um die Z-Achse.
X-Koordinate des Bilds im Hinblick auf Canvas
imagex
number
Position der Anzeige auf der X-Achse im Hinblick auf die Canvas.
Y-Koordinate des Bilds im Hinblick auf Canvas
imagey
number
Position der Anzeige auf der Y-Achse im Hinblick auf die Canvas.
Überschreibung der Canvas-Vergrößerung
canvasgrowthoverride
string
Ermöglicht es Ihnen zu wählen, wann die Leinwandgröße aufgehoben wird. Wählen Sie eine der folgenden Optionen aus.
Canvas wächst mit Textgröße – die Größe der Canvas ändert sich, wenn der Text größer oder kleiner wird.
Canvas wächst mit Bildgröße – die Größe der Canvas ändert sich, wenn das Bild größer oder kleiner wird.
Canvas wächst mit Bild- und Textgröße (Standard) – Die Größe der Canvas ändert sich, wenn das Bild oder der Text größer oder kleiner werden (ein größerer Wert zwischen dem Text und dem Bild überschreibt die Größe der Canvas).
Keine Überschreibung – Die Größe der Canvas bleibt gleich und entspricht der Größe, die durch die Eigenschaften Canvas-Höhe und Canvas-Breite definiert wurde.
Canvas-Höhe
canvasheight
number
Höhe der Canvas.
Canvas-Breite
canvaswidth
number
Breite der Canvas.
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
Ist dieses Kontrollkästchen aktiviert, so 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
select
Bestimmt den Neutralpunkt des Bildes:
Oben links
Oben zentriert
Oben rechts
Mitte links
Mitte zentriert
Mitte rechts
Unten links
Unten zentriert
Unten rechts
Höhe
height
number
Höhe der Anzeige in Metern.
Breite
width
number
Breite der Anzeige in Metern.
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-Anzeige-Widget in die Canvas, und legen Sie es ab.
2. Suchen Sie im Fensterbereich Daten nach einer Entität, die einen Dienst mit einer numerischen Eigenschaft hat.
3. Sobald der Dienst hinzugefügt wurde, ziehen Sie eine numerische Eigenschaft unter Aktuell ausgewähltes Element auf das Widget, und wählen Sie Text im Fenster Bindungsziel auswählen aus.
* 
Wählen Sie im Fensterbereich DatenBeim Start aufrufenDienste > Konfiguration aus.