一个 ViewportFrame 使用相机将3D对象渲染到2D视口中。理想的使用案例包括:
- 游戏的迷你地图,直接显示在用户屏幕的角落。
- 库存菜单中的物品3D模型。
- 角色装备的旋转物体。
视口配置
用户通过 ViewportFrame 观看的3D对象可以与相机一起移动、保持静态或在 ViewportFrame 内旋转。该对象还可以包含一个 Sky 子对象作为反射的立方体贴图。
如果您希望3D对象与相机一起移动:
在游戏中定位您的相机视图,以便您希望在框架中看到的对象可见。
向 屏幕 添加一个新的 ViewportFrame,然后确保在 资源管理器 中选择它。
在 属性 窗口中,将 CurrentCamera 属性分配给相机:
- 选择 CurrentCamera 属性。您的光标会改变。
- 在 资源管理器 窗口中,单击顶层的 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 时完全透明(不可见)。 |