視口框架

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

一個 ViewportFrame 使用相機將 3D 物件渲染到 2D 視口中。理想的使用案例包括:

  • 在用戶螢幕的角落直接顯示遊戲的迷你地圖。
  • 在物品清單中顯示 3D 模型。
  • 旋轉角色所裝備的物件。

視口配置

用戶通過 ViewportFrame 查看 3D 物件時,這些物件可以隨著相機移動、保持靜止或在 ViewportFrame 中旋轉。此物件還可以包含作為立方體貼圖的 Sky 子物件以進行反射。

如果您希望 3D 物件隨著相機移動:

  1. 在遊戲中定位您的相機視圖,以便您想要在框架中看到的物件可見。

  2. 將新的 ViewportFrame 添加到 螢幕,然後確保在 Explorer 中選中它。

  3. Properties 窗口中,將 CurrentCamera 屬性分配給相機:

    1. 選擇 CurrentCamera 屬性。您的光標會改變。
    2. Explorer 窗口中,單擊頂層的 Camera 物件。
  4. 將所需的 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 時完全透明(不可見)。
©2026 Roblox Corporation、Roblox、Roblox 標誌及 Powering Imagination 是我們在美國及其他國家地區的部分註冊與未註冊商標。