视口框架

*此内容使用人工智能(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 内的光照通过三个属性进行控制:

属性描述
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 是我们在美国及其他国家或地区的注册与未注册商标。