Cesium快速入门18:Entity材质设置
2026/5/26 18:29:17 网站建设 项目流程

前面的课程里,我们先后讲了 Entity(实体)和 Primitive(图元)这两种“物体”。
它们都能贴材质,只不过用法有简有繁。
今天先集中火力把Entity 的材质系统撸一遍,看看 Cesium 到底给我们备好了哪些“现成布料”,以及怎么换布料。


一、Entity 材质入口:material 属性

以矩形为例,只要在配置项里写一行material: ...就能换皮肤。
既可以直给颜色,也能塞一个正式的 MaterialProperty 对象。

rectangle: { coordinates: Cesium.Rectangle.fromDegrees(...), material: Cesium.Color.RED.withAlpha(0.5) // 直接写颜色,底层会自动包成 ColorMaterialProperty }

二、MaterialProperty 是什么?

MaterialProperty是所有材质属性的“老祖宗”,一个抽象基类,不能直接 new
它只规定派生类必须实现哪些方法和属性。
我们真正用的是它的那群“子子孙孙”——
名字统一以***MaterialProperty结尾,随手一搜就能找到。


三、官方常备“布料”清单

下面 4 种最常用,无需自己写着色器,直接配参数即可。

  • 纯色布料(ColorMaterialProperty)

    和直接写颜色等效,写不写都行。

const material = new Cesium.ColorMaterialProperty( Cesium.Color.RED.withAlpha(0.5) );
  • 棋盘格(CheckerboardMaterialProperty)

    黑白格子,可改颜色、可改密度。

const material = new Cesium.CheckerboardMaterialProperty({ evenColor: Cesium.Color.WHITE, // 偶数格 oddColor: Cesium.Color.BLACK, // 奇数格 repeat: new Cesium.Cartesian2(4, 4) // 横向、纵向各重复 4 次 });
  • 条纹布(StripeMaterialProperty)

    横条 or 竖条,随你挑。

const stripMaterial = new Cesium.StripeMaterialProperty({ evenColor: Cesium.Color.WHITE, oddColor: Cesium.Color.BLACK, repeat: 32, // 条纹数量 offset: 0.0, // 起始偏移 orientation: Cesium.StripeOrientation.HORIZONTAL // 或 VERTICAL });
  • 网格布(GridMaterialProperty)

    把面切成“豆腐块”,适合画地块、棋盘。

const gridMaterial = new Cesium.GridMaterialProperty({ color: Cesium.Color.YELLOW, // 网格线颜色 cellAlpha: 0.2, // 格子填充透明度 lineCount: new Cesium.Cartesian2(8, 8), // 横、竖各 8 条线 lineThickness: new Cesium.Cartesian2(2.0, 2.0) // 线宽(像素) });

四、把布料穿到矩形上

无论哪种材质,最后都交给material字段即可。

const redRectangle = viewer.entities.add({ name: "Red translucent rectangle", rectangle: { coordinates: Cesium.Rectangle.fromDegrees(114.0, 23.4, 114.4, 23.6), extrudedHeight: 30000.0, // 挤出高度,单位米 material: material, // 上面任意一种材质 }, });

小结一句话

Entity 换皮肤 = 找***MaterialProperty→ 配参数 → 扔给material
官方给的“布料”不够炫?后面我们教你亲手写着色器,想怎么酷就怎么酷。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询