视口框架

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

一个 ViewportFrame 使用相机将3D对象渲染到2D视口中。理想的使用情况包括:

  • 用户屏幕角落中的体验迷你地图。
  • 库存菜单中的物品3D模型。
  • 角色装备的旋转对象。

视口配置

用户通过 ViewportFrame 查看3D对象时,这些对象可以随相机移动、保持静止或在 ViewportFrame 内旋转。此对象还可以包含一个 Sky 子对象,作为环境反射的立方体贴图。

如果你希望3D对象随相机移动:

  1. 在体验中定位你的相机视图,以便要在框架中查看的对象是可见的。

  2. 屏幕 添加新的 ViewportFrame,然后确保在资源管理器中选中它。

  3. 属性窗口中,将 CurrentCamera 属性分配给相机:

    1. 选择 CurrentCamera 属性。你的光标会发生改变。
    2. 资源管理器窗口中,单击顶层的 Camera 对象。
  4. 将所需的3D对象作为子对象附加到新的 ViewportFrame。请注意,如果你仍希望在体验中查看对象,你必须在 Workspace 中复制它,然后将复制的对象作为子对象添加到 ViewportFrame

当你移动相机时,对象也会在 ViewportFrame 内移动。

光照和外观

ViewportFrame 内的光照通过三个属性进行控制:

属性描述
环境光确定应用于视口框架内区域的整体光线色调。默认为 Color3.fromRGB(200, 200, 200)(幽灵灰色)。
光源方向一个表示光源方向的 Vector3,从位置 (0, 0, 0) 向外。默认为 (-1, -1, -1)
光源颜色方向光的颜色。默认为 Color3.fromRGB(140, 140, 140)(银色)。

此外,你还可以通过以下属性调整视口的整体渲染外观:

属性描述
图像颜色在不修改渲染对象的情况下更改图像颜色/色调。默认的颜色化值为 Color3.new(1, 1, 1)(白色),此时不会进行颜色修改。
图像透明度在不修改渲染对象的情况下更改图像透明度。值为 0(默认)时完全不透明,值为 1 时完全透明(不可见)。
©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。