Frame di visualizzazione

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Un ViewportFrame utilizza una telecamera per renderizzare oggetti 3D in un'area di visualizzazione 2D. I casi d'uso ideali includono:

  • Una mappa in miniatura della vostra esperienza direttamente nell'angolo dello schermo di un utente.
  • Modelli 3D di oggetti in un menu inventario.
  • Oggetti rotanti che un personaggio ha equipaggiato.

Configurazioni del viewport

Gli oggetti 3D che gli utenti visualizzano tramite un ViewportFrame possono muoversi con la loro telecamera, rimanere statici o ruotare all'interno del ViewportFrame. Questo oggetto può anche includere un figlio Sky come cubemap per i riflessi.

Se desideri che un oggetto 3D si muova con la telecamera:

  1. Posiziona la vista della tua telecamera all'interno dell'esperienza in modo che l'oggetto che desideri vedere all'interno del frame sia visibile.

  2. Aggiungi un nuovo ViewportFrame allo schermo e assicurati che sia selezionato in Explorer.

  3. Nella finestra Properties, assegna la proprietà CurrentCamera alla telecamera:

    1. Seleziona la proprietà CurrentCamera. Il cursore cambia.
    2. Nella finestra Explorer, fai clic sull'oggetto Camera di livello superiore.
  4. Parentizza l'oggetto 3D desiderato al nuovo ViewportFrame. Nota che se vuoi ancora vedere l'oggetto all'interno della tua esperienza, devi duplicarlo nel Workspace e poi parentizzare l'oggetto duplicato al ViewportFrame.

Quando muovi la tua telecamera, l'oggetto si muoverà anche all'interno del ViewportFrame.

Illuminazione e aspetto

L'illuminazione all'interno di un ViewportFrame è controllata tramite tre proprietà:

ProprietàDescrizione
AmbientDetermina il tono complessivo dell'illuminazione applicato all'area all'interno del frame di visualizzazione. Predefinito a Color3.fromRGB(200, 200, 200) (grigio fantasma).
LightDirectionUn Vector3 che rappresenta la direzione della fonte di luce dalla posizione (0, 0, 0). Predefinito a (-1, -1, -1).
LightColorColore della luce direzionale. Predefinito a Color3.fromRGB(140, 140, 140) (argento).

Inoltre, puoi regolare l'aspetto generale reso del viewport tramite le seguenti proprietà:

ProprietàDescrizione
ImageColor3Cambia il colore/tinta dell'immagine senza modificare l'oggetto renderizzato. Il valore di colorazione predefinito è Color3.new(1, 1, 1) (bianco) nel quale non si verifica alcuna modifica di colore.
ImageTransparencyCambia la trasparenza dell'immagine senza modificare l'oggetto renderizzato. Un valore di 0 (predefinito) è completamente opaco e un valore di 1 è completamente trasparente (invisibile).
© 2026 Roblox Corporation. Roblox, il logo Roblox e Powering Imagination sono tra i nostri marchi registrati e non registrati negli Stati Uniti. e altri paesi.