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() 後立即同步調用。