Funzioni di rendering 3D di livello basso
setTranslation
Imposta la posizione 3D (traslazione) di un widget nella scena. Questa funzione è supportata per i seguenti widget: Modello, Elemento modello, Immagine 3D, Indicatore 3D, Etichetta 3D e alcuni widget tracker.
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|---|---|---|---|
|
name
|
Stringa
|
ID Studio del widget da posizionare.
|
Obbligatorio
|
|
x
|
Numero
|
Coordinata X nello spazio 3D (in metri).
|
Obbligatorio
|
|
y
|
Numero
|
Coordinata Y nello spazio 3D (in metri).
|
Obbligatorio
|
|
z
|
Numero
|
Coordinata Z nello spazio 3D (in metri).
|
Obbligatorio
|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
setRotation
Imposta la rotazione 3D di un widget utilizzando angoli di Eulero in gradi. Questa funzione è supportata per i seguenti widget: Modello, Elemento modello, Immagine 3D, Indicatore 3D, Etichetta 3D e alcuni widget tracker.
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|---|---|---|---|
|
name
|
Stringa
|
ID Studio del widget da ruotare.
|
Obbligatorio
|
|
x
|
Numero
|
Rotazione attorno all'asse X (in gradi).
|
Obbligatorio
|
|
y
|
Numero
|
Rotazione attorno all'asse Y (in gradi).
|
Obbligatorio
|
|
z
|
Numero
|
Rotazione attorno all'asse Z (in gradi).
|
Obbligatorio
|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
setScale
Imposta la scala di un widget nello spazio 3D. Questa funzione è supportata per i seguenti widget: Modello, Elemento modello, Immagine 3D, Indicatore 3D, Etichetta 3D e alcuni widget tracker.
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|---|---|---|---|
|
name
|
Stringa
|
ID Studio del widget da mettere in scala.
|
Obbligatorio
|
|
x
|
Numero
|
Fattore di scala lungo l'asse X.
|
Obbligatorio
|
|
y
|
Numero
|
Fattore di scala lungo l'asse Y.
|
Obbligatorio
|
|
z
|
Numero
|
Fattore di scala lungo l'asse Z.
|
Obbligatorio
|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
 |
Utilizzare questa funzione per ridimensionare in modo uniforme o non uniforme gli oggetti nella scena.
|
transform
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|---|---|---|---|
|
name
|
Stringa
|
ID Studio del widget da trasformare.
|
Obbligatorio
|
|
dx
|
Numero
|
Posizione X nello spazio 3D (in metri).
|
Obbligatorio
|
|
dy
|
Numero
|
Posizione Y nello spazio 3D (in metri).
|
Obbligatorio
|
|
dz
|
Numero
|
Posizione Z nello spazio 3D (in metri).
|
Obbligatorio
|
|
drx
|
Numero
|
Rotazione attorno all'asse X (in gradi).
|
Obbligatorio
|
|
dry
|
Numero
|
Rotazione attorno all'asse Y (in gradi).
|
Obbligatorio
|
|
drz
|
Numero
|
Rotazione attorno all'asse Z (in gradi).
|
Obbligatorio
|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
|
|
Questa funzione equivale a chiamare setTranslation e setRotation in un unico passo.
|
setTexture
Imposta o aggiorna la texture di un widget. L'origine della texture può essere un URL remoto o una stringa di immagine con codifica base64.
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|---|---|---|---|
|
name
|
Stringa
|
ID Studio dell'elemento a cui viene applicata la texture.
|
Obbligatorio
|
|
texture
|
Stringa
|
URI o stringa di immagine con codifica base64. Se omessa, qualsiasi texture esistente viene rimossa dal widget.
|
Obbligatorio
|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
|
|
Le texture possono essere applicate ai seguenti widget: Modello, Immagine 3D, Indicatore 3D ed Etichetta 3D.
|
setColor
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|---|---|---|---|
|
name
|
Stringa
|
ID Studio del modello a cui applicare il colore.
|
Obbligatorio
|
|
color
|
Stringa
|
Il colore viene specificato come stile CSS o come valore rgb o rgba (ad esempio, rgb(255, 165, 0) o rgba(255, 165, 0, 1.0) per l'arancione). Se omessa, il colore corrente viene rimosso.
|
Obbligatorio
|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
|
|
• Il colore deve essere fornito come stringa in formato rgba(r,g,b,a) o rgb(r,g,b), dove:
◦ r, g, b sono numeri interi compresi tra 0 e 255
◦ a è un numero decimale compreso tra 0.0 e 1.0 (il valore di default è 1.0 se omesso)
• Se la stringa di colore non è valida, il fallback di default è nero con opacità completa (rgba(0,0,0,1)).
• Se il colore viene omesso, il colore sostitutivo impostato in precedenza viene cancellato e l'elemento viene visualizzato con il colore di materiale di default.
|