Un ViewportFrame utilise une caméra pour rendre des objets 3D dans un cadre 2D. Les cas d'utilisation idéaux incluent :
- Une mini-carte de votre jeu directement dans le coin de l'écran d'un utilisateur.
- Des modèles 3D d'objets dans un menu d'inventaire.
- Des objets en rotation qu'un personnage a équipés.
Configurations de vue
Les objets 3D que les utilisateurs voient à travers un ViewportFrame peuvent soit se déplacer avec leur caméra, rester statiques, ou tourner à l'intérieur du ViewportFrame. Cet objet peut également inclure un enfant Sky comme cubemap pour les réflexions.
Si vous souhaitez qu'un objet 3D se déplace avec la caméra :
Positionnez votre vue de caméra dans le jeu de manière à ce que l'objet que vous souhaitez voir dans le cadre soit visible.
Ajoutez un nouveau ViewportFrame à l'écran et assurez-vous qu'il est sélectionné dans l'Explorateur.
Dans la fenêtre Propriétés, assignez la propriété CurrentCamera à la caméra :
- Sélectionnez la propriété CurrentCamera. Votre curseur change.
- Dans la fenêtre Explorateur, cliquez sur l'objet Camera de niveau supérieur.
Parent l'objet 3D souhaité au nouveau ViewportFrame. Notez que si vous souhaitez toujours voir l'objet dans votre jeu, vous devez le dupliquer dans le Workspace puis parent l'objet dupliqué au ViewportFrame.
Lorsque vous déplacez votre caméra, l'objet se déplacera également dans le ViewportFrame.
Lorsque vous souhaitez mettre à jour la vue de votre ViewportFrame, assurez-vous de mettre à jour la caméra, pas les objets dans la vue.
Éclairage et apparence
L'éclairage à l'intérieur d'un ViewportFrame est contrôlé par trois propriétés :
| Propriété | Description |
|---|---|
| Ambient | Détermine la teinte d'éclairage globale appliquée à la zone à l'intérieur du cadre de vue. Par défaut, c'est Color3.fromRGB(200, 200, 200) (gris fantôme). |
| LightDirection | Un Vector3 représentant la direction de la source de lumière depuis la position (0, 0, 0). Par défaut, c'est (-1, -1, -1). |
| LightColor | Couleur de la lumière directionnelle. Par défaut, c'est Color3.fromRGB(140, 140, 140) (argent). |
De plus, vous pouvez ajuster l'apparence globale rendue du cadre à travers les propriétés suivantes :
| Propriété | Description |
|---|---|
| ImageColor3 | Change la couleur/teinte de l'image sans modification de l'objet rendu. La valeur de coloration par défaut est Color3.new(1, 1, 1) (blanc) à laquelle aucune modification de couleur ne se produit. |
| ImageTransparency | Change la transparence de l'image sans modification de l'objet rendu. Une valeur de 0 (par défaut) est complètement opaque et une valeur de 1 est complètement transparente (invisible). |