3D-Rendering-Funktionen von niedrigem Niveau
setTranslation
Legt die 3D-Position (Translation) eines Widgets in der Szene fest. Diese Funktion wird für die folgenden Widgets unterstützt: Modell Modellelement, 3D-Bild, 3D-Anzeige und 3D-Beschriftung sowie einige Verfolgungs-Widgets.
|
Name
|
Typ
|
Beschreibung
|
Erforderlich/Optional
|
|---|---|---|---|
|
name
|
Zeichenfolge
|
Studio ID des zu positionierenden Widgets
|
Erforderlich
|
|
x
|
Zahl
|
X-Koordinate in 3D-Raum (in Metern)
|
Erforderlich
|
|
y
|
Zahl
|
Y-Koordinate im 3D-Raum (in Metern)
|
Erforderlich
|
|
z
|
Zahl
|
Z-Koordinate in 3D-Raum (in Metern)
|
Erforderlich
|
|
successCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation erfolgreich abgeschlossen wurde
|
Optional
|
|
errorCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation fehlschlägt
|
Optional
|
setRotation
Legt die 3D-Drehung eines Widgets unter Verwendung von Euler-Winkeln in Grad fest. Diese Funktion wird für die folgenden Widgets unterstützt: Modell Modellelement, 3D-Bild, 3D-Anzeige und 3D-Beschriftung sowie einige Verfolgungs-Widgets.
|
Name
|
Typ
|
Beschreibung
|
Erforderlich/Optional
|
|---|---|---|---|
|
name
|
Zeichenfolge
|
Studio ID des zu drehenden Widgets
|
Erforderlich
|
|
x
|
Zahl
|
Drehung um die X-Achse (in Grad)
|
Erforderlich
|
|
y
|
Zahl
|
Drehung um die Y-Achse (in Grad)
|
Erforderlich
|
|
z
|
Zahl
|
Drehung um die Z-Achse (in Grad)
|
Erforderlich
|
|
successCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation erfolgreich abgeschlossen wurde
|
Optional
|
|
errorCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation fehlschlägt
|
Optional
|
setScale
Legt die Skalierung eines Widgets im 3D-Raum fest. Diese Funktion wird für die folgenden Widgets unterstützt: Modell Modellelement, 3D-Bild, 3D-Anzeige und 3D-Beschriftung sowie einige Verfolgungs-Widgets.
|
Name
|
Typ
|
Beschreibung
|
Erforderlich/Optional
|
|---|---|---|---|
|
name
|
Zeichenfolge
|
Studio ID des zu skalierenden Widgets
|
Erforderlich
|
|
x
|
Zahl
|
Skalierungsfaktor entlang der X-Achse
|
Erforderlich
|
|
y
|
Zahl
|
Skalierungsfaktor entlang der Y-Achse
|
Erforderlich
|
|
z
|
Zahl
|
Skalierungsfaktor entlang der Z-Achse
|
Erforderlich
|
|
successCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation erfolgreich abgeschlossen wurde
|
Optional
|
|
errorCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation fehlschlägt
|
Optional
|
 |
Verwenden Sie diese Funktion, um Objekte in der Szene einheitlich oder uneinheitlich zu skalieren.
|
transform
|
Name
|
Typ
|
Beschreibung
|
Erforderlich/Optional
|
|---|---|---|---|
|
name
|
Zeichenfolge
|
Studio ID des zu transformierenden Widgets
|
Erforderlich
|
|
dx
|
Zahl
|
X-Position im 3D-Raum (in Metern)
|
Erforderlich
|
|
dy
|
Zahl
|
Y-Position im 3D-Raum (in Metern)
|
Erforderlich
|
|
dz
|
Zahl
|
Z-Position im 3D-Raum (in Metern)
|
Erforderlich
|
|
drx
|
Zahl
|
Drehung um die X-Achse (in Grad)
|
Erforderlich
|
|
dry
|
Zahl
|
Drehung um die Y-Achse (in Grad)
|
Erforderlich
|
|
drz
|
Zahl
|
Drehung um die Z-Achse (in Grad)
|
Erforderlich
|
|
successCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation erfolgreich abgeschlossen wurde
|
Optional
|
|
errorCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation fehlschlägt
|
Optional
|
|
|
Diese Funktion entspricht dem Aufruf von setTranslation und setRotation in einem Schritt.
|
setTexture
Legt die Textur eines Widgets fest oder aktualisiert sie. Die Texturquelle kann eine Remote-URL oder eine base64-codierte Bildzeichenfolge sein.
|
Name
|
Typ
|
Beschreibung
|
Erforderlich/Optional
|
|---|---|---|---|
|
name
|
Zeichenfolge
|
Studio ID des Elements, auf das die Textur angewendet wird.
|
Erforderlich
|
|
texture
|
Zeichenfolge
|
URI oder base64-codierte Bildzeichenfolge. Wird die Angabe weglassen, wird jede vorhandene Textur aus dem Widget entfernt.
|
Erforderlich
|
|
successCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation erfolgreich abgeschlossen wurde
|
Optional
|
|
errorCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation fehlschlägt
|
Optional
|
|
|
Texturen können auf die folgenden Widgets angewendet werden: Modell, 3D-Bild, 3D-Anzeige und 3D-Beschriftung.
|
setColor
|
Name
|
Typ
|
Beschreibung
|
Erforderlich/Optional
|
|---|---|---|---|
|
name
|
Zeichenfolge
|
Studio ID des Modells, auf das die Farbe angewendet werden soll.
|
Erforderlich
|
|
color
|
Zeichenfolge
|
Die Farbe wird als CSS-Stil, RGB- oder RGBA-Wert angegeben (z.B. rgb(255, 165, 0) oder rgba(255, 165, 0, 1.0) für Orange). Wird die Angabe weggelassen, wird die aktuelle Farbe entfernt.
|
Erforderlich
|
|
successCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation erfolgreich abgeschlossen wurde
|
Optional
|
|
errorCallback
|
Funktion
|
Wird aufgerufen, wenn die Operation fehlschlägt
|
Optional
|
|
|
• Die Farbe muss als Zeichenfolge im Format rgba(r,g,b,a) oder rgb(r,g,b) angegeben werden, wobei gilt:
◦ r, g, b sind Ganzzahlen zwischen 0 und 255
◦ a ist eine Gleitkommazahl zwischen 0.0 und 1.0 (wenn nicht angegeben, wird der Standardwert 1.0 verwendet)
• Wenn die Farbzeichenfolge ungültig ist, ist das Standard-Fallback Schwarz mit vollständiger Opazität (rgba(0,0,0,1)).
• Wird die Farbe weggelassen wird, wird die zuvor festgelegte Farbüberschreibung gelöscht, und das Element wird mit seiner Standardmaterialfarbe gerendert.
|