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 expérience 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 cadre de vue
Les objets 3D que les utilisateurs voient à travers un ViewportFrame peuvent soit se déplacer avec leur caméra, rester statiques ou pivoter à 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 l'expérience de manière à ce que l'objet que vous souhaitez voir dans le cadre soit visible.
Ajoutez un nouveau ViewportFrame à l'écran puis assurez-vous qu'il est sélectionné dans l'Explorer.
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 Explorer, cliquez sur l'objet Camera de premier niveau.
Parentez l'objet 3D souhaité au nouveau ViewportFrame. Notez que si vous souhaitez toujours voir l'objet dans votre expérience, vous devez le dupliquer dans le Workspace puis parenter l'objet dupliqué au ViewportFrame.
Lorsque vous déplacez votre caméra, l'objet se déplacera également à l'intérieur du ViewportFrame.
Lorsque vous souhaitez mettre à jour la vue de votre ViewportFrame, veillez à 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 générale 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 à partir de 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) où aucune modification de couleur n'a lieu. |
| 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). |