一個 ViewportFrame 使用相機將 3D 物件渲染到 2D 視口中。理想的使用案例包括:
- 在用戶螢幕的角落直接顯示遊戲的迷你地圖。
- 在物品清單中顯示 3D 模型。
- 旋轉角色所裝備的物件。
視口配置
用戶通過 ViewportFrame 查看 3D 物件時,這些物件可以隨著相機移動、保持靜止或在 ViewportFrame 中旋轉。此物件還可以包含作為立方體貼圖的 Sky 子物件以進行反射。
如果您希望 3D 物件隨著相機移動:
在遊戲中定位您的相機視圖,以便您想要在框架中看到的物件可見。
將新的 ViewportFrame 添加到 螢幕,然後確保在 Explorer 中選中它。
在 Properties 窗口中,將 CurrentCamera 屬性分配給相機:
- 選擇 CurrentCamera 屬性。您的光標會改變。
- 在 Explorer 窗口中,單擊頂層的 Camera 物件。
將所需的 3D 物件作為子物件添加到新的 ViewportFrame 中。請注意,如果您仍希望在遊戲中看到該物件,則必須在 Workspace 中複製它,然後將 複製的 物件作為子物件添加到 ViewportFrame。
當您移動相機時,物件也會在 ViewportFrame 中移動。
照明和外觀
ViewportFrame 內的照明通過三個屬性進行控制:
| 屬性 | 描述 |
|---|---|
| Ambient | 確定應用於視口框架內區域的整體照明色調。默認為 Color3.fromRGB(200, 200, 200)(幽靈灰)。 |
| LightDirection | 表示光源方向的 Vector3,從位置 (0, 0, 0) 發出。默認為 (-1, -1, -1)。 |
| LightColor | 方向光的顏色。默認為 Color3.fromRGB(140, 140, 140)(銀色)。 |
此外,您可以通過以下屬性調整視口的整體渲染外觀:
| 屬性 | 描述 |
|---|---|
| ImageColor3 | 在不修改渲染物件的情況下更改圖像顏色/色調。默認顏色化值為 Color3.new(1, 1, 1)(白色),此時不會發生顏色修改。 |
| ImageTransparency | 在不修改渲染物件的情況下更改圖像透明度。值為 0(默認)時完全不透明,值為 1 時完全透明(不可見)。 |