LCCObject::setClipBox

对单个 LCC 模型进行 Box 裁切。

可用于裁切掉 LCC 模型边缘不整齐的区域，也可用于控制 LCC 模型局部场景的显示或隐藏，例如模型高度裁切。

版本要求

SDK v0.5.2+

引擎支持

Three.js / CesiumJS

API

LCCObject::setClipBox(param?: ClipBoxParam): void

参数

参数	类型	必选	默认值	描述
`param.position`	`{ x: number, y: number, z: number }` / `[number, number, number]`	否	-	平移裁切盒。
`param.rotation`	`{ x: number, y: number, z: number }` / `[number, number, number]`	否	-	旋转裁切盒，单位为弧度。
`param.scale`	`{ x: number, y: number, z: number }` / `[number, number, number]`	否	-	缩放裁切盒。
`param.clipSide`	`1` / `-1`	否	-	裁切方向。`1`：裁掉裁切盒之外的场景；`-1`：裁掉裁切盒之内的场景。

返回值

void

使用示例

设置 Box 裁切

lccObject.setClipBox({
    scale: { x: 1, y: 1, z: 1 }, // or [1, 1, 1]
    position: { x: 0, y: 0, z: 0 }, // or [0, 0, 0]
    rotation: {
        x: Math.PI / 3,
        y: 0,
        z: 0
    }, // or [Math.PI / 3, 0, 0]
    clipSide: 1 // or -1
});

清除 Box 裁切

将 param 设置为 undefined，清空当前裁切效果。

lccObject.setClipBox(undefined);

注意事项

此接口可以在 LCCRender.load() 后立即同步调用。