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