Advanced Tutorial

Hide regions with clipping polygons

进阶高级30-45 分钟

裁切不是视觉技巧,而是专业分析能力。它让你可以在大场景里挖出重点区域,形成更聚焦的观察窗口。

Overview

适合哪些专业场景

  • 地下空间和管线分析。
  • 施工剖切和局部透视。
  • 只保留关注区域、隐藏周边干扰。

Study Focus

重点理解

  • 裁切对象是 terrain 还是 3D tiles。
  • 裁切边界如何定义。
  • 裁切后如何保留用户对上下文的理解。

Starter Code

裁切区域骨架

tileset.clippingPolygons = new ClippingPolygonCollection({
  polygons: [
    new ClippingPolygon({
      positions: Cartesian3.fromDegreesArray([
        116.39, 39.90,
        116.40, 39.90,
        116.40, 39.91,
        116.39, 39.91,
      ]),
    }),
  ],
});

Project Advice

让裁切真正可用

先做一个小区域 不要一开始就裁大范围,先验证边界和业务语义。
保留上下文 裁切后最好配引导或说明,告诉用户为什么这里被挖开。
优先固定方案 先跑通固定裁切,再考虑用户交互绘制。

Practice Flow

推荐步骤

  1. 先加载目标 terrain 或 tileset。
  2. 定义一块明确的小区域做第一次裁切。
  3. 调试边界和显示结果。
  4. 叠加你的业务对象,确认焦点已经建立。
  5. 最后再考虑更复杂的交互裁切。

Good For

典型用途

  • 地下空间查看。
  • 施工剖切窗口。
  • 地块重点分析。

Pitfalls

最容易出问题的点

  • 裁切坐标一旦不准,结果会完全偏离预期。
  • 只做剖切而不解释上下文,用户会不明白自己看到的是什么。
  • 对不同数据类型要分别验证裁切效果。