本文内容
Box Shape 组件
Box Shape组件创建透明框。可以使用 Dimensions 属性或通过进入编辑模式来编辑框的尺寸。Box Shape （长方体形状） 组件不是网格，而是一个辅助几何体，可用于定义雾、生成器、形状渐变、音频、植被、PhysX 以及任何可利用 Shape EBus （形状事件总线） 的应用程序的体积。有关使用 Shape 组件的更多信息，请参阅 Shape 组件。
提供方
Box Shape 属性
| 属性 | 说明 | 值 | 默认值 |
|---|---|---|---|
| Visible | 启用此选项可始终在视区中显示形状，即使未选择实体也是如此。禁用可在未选择实体时隐藏形状。 | Boolean | Enabled |
| Game View | 启用此选项可在游戏模式下显示形状。 | Boolean | Disabled |
| Filled | 启用此选项可将形状显示为已填充。 禁用以将形状显示为线框。 | Boolean | Enabled |
| Shape Color | 形状的颜色。 | 每通道颜色 8 位: 0-255 | 255,255,199 |
| Dimensions | 形状在局部空间的 X、Y 和 Z 维度中的大小。 | Vector3: -Infinity to Infinity | X:1.0, Y:1.0, Z:1.0 |
| Translation Offset | 形状相对于其实体的平移偏移。 | Vector3: -Infinity to Infinity | X:0.0, Y:0.0, Z:0.0 |
| Edit | 选择 Edit 按钮进入 Edit 模式。在编辑模式下，您可以使用下面的 编辑模式操作 中概述的方法在视区中修改形状的尺寸。在 Edit 模式下，菜单栏中的 Edit （编辑） 菜单显示可用的操作和热键。要退出 Edit 模式，请在组件界面中选择 Done。 |
编辑模式操作
编辑模式提供两个子模式。您可以使用 编辑器 左上角的 Viewport UI Cluster 中的按钮、使用下面列出的键盘热键或使用 Ctrl + Mousewheel Up/Down 在子模式之间切换。
| 模式 | 图标 | 快捷键 | 说明 |
|---|---|---|---|
| Dimensions |  | 1 | 左键单击并拖动 Box Shape （箱体形状） 两侧的黑色手柄，以调整箱体在其局部 X、Y 和 Z 维度上的大小。默认情况下，可以单独编辑长方体的每个面。按住 Shift 可对称地编辑相对的面对。 |
| Translation Offset |  | 2 | 单击鼠标左键并拖动线性或平面操纵器以编辑 Translation Offset。 |
| Reset Current Mode | R | 将当前子模式操作的属性重置为其默认值。 |
BoxShapeComponentRequestsBus
将以下请求函数与 ‘BoxShapeComponentRequestsBus’ 事件总线接口结合使用，以便与游戏中的 Box Shape 组件进行通信。
| 方法名称 | 说明 | 参数 | 返回值 | 脚本化 |
|---|---|---|---|---|
GetBoxConfiguration | 返回框形状的配置。 | None | 包含属性 ‘Dimensions’ 的 ‘BoxShapeConfig’ 对象。 | Yes |
GetBoxDimensions | 返回框形状的 Dimensions。 | None | Dimensions: Vector3 | Yes |
SetBoxDimensions | 设置框形状的 Dimensions。 | Dimensions: Vector3 | None | Yes |
请参阅 Shape 组件 Ebus 接口 以获取所有 Shape 组件可用的功能说明。