3D地图 JSAPI 类参考
    正在准备搜索索引...

    类 Tiles3DClip

    3DTiles 裁切区域控制器 持有裁切区域参数,提供 updateMaterial / disableMaterial 方法 配合 Cesium3DTileset 的 enableClip 使用

    const clip = new Tiles3DClip({
    type: 'polygon',
    area: [[x1, y1], [x2, y2], [x3, y3], ...],
    inside: false, // false: 保留区域内, true: 裁掉区域内
    });
    tileset.tiles3DClip = clip;
    tileset.enableClip = true;
    索引

    方法

    • 判断 raycast 命中点(世界坐标)是否落在 clip 多边形内。 跟 fragment shader 用同一套坐标空间逻辑:墨卡托 = world XY;ECEF = ENU(u, v)。 平面模式支持 polygon/circle/rect;经纬度 ENU 模式支持 polygon。

      参数

      • point: Vector3

        命中点世界坐标。墨卡托 = (mercX, mercY, alt);ECEF = ECEF 笛卡尔。

      返回 boolean

    • 为 material 禁用裁切

      参数

      • material: Material

      返回 void

    • 每帧更新所有已注入材质的 uniform(cameraOffset 随地图移动变化)

      返回 void

    • 为 material 启用裁切 通过 onBeforeCompile 注入 clip shader 代码和 uniform

      参数

      • material: Material

      返回 void

    访问器

    • get areas(): [number, number][][]

      平面裁切多边形集合。多个多边形按并集参与裁切。

      返回 [number, number][][]

    • set enabled(value: boolean): void

      运行时开关 clip 效果(不重编译 shader)。

      参数

      • value: boolean

      返回 void

    • get lnglatArea(): [number, number][]

      经纬度形态的 polygon,仅 ECEF 模式使用。设置后 fragment 在 ENU 平面做 inside 测试。 设为 null 退回到普通平面 area 路径(传统墨卡托语义)。

      返回 [number, number][]