CumulusCloud

internal constructor new Cesium.CumulusCloud()

engine/Source/Scene/CumulusCloud.js 34

通过调用 CloudCollection#add 和 CloudCollection#remove 来创建云并设置其初始属性。 不要直接调用构造函数。

在3D场景中定位的积云广告牌，通过 CloudCollection 创建并渲染。

示例积云

Performance:

类似于 Billboard，读取一个属性，例如 CumulusCloud#show，所需时间是恒定的。 赋值给一个属性的时间是恒定的，但在 CloudCollection#update 被调用时会导致 CPU 到 GPU 的流量。 每个云的流量与更新的属性数量无关。如果集合中的大多数云需要更新， 使用 CloudCollection#removeAll 清空集合并添加新云可能比修改每个云更高效。

Demo:

• Cesium Sandcastle Cloud Parameters Demo

See:

• CloudCollection
• CloudCollection#add

Members

获取或设置云的亮度。可以用来使云呈现更暗、更灰的外观。

cloud.brightness = 1.0;

cloud.brightness = 0.6;

cloud.brightness = 0.0;

Default Value: 1.0

Default Value: Color.WHITE

获取或设置在广告牌上渲染的积云的最大大小。 这定义了云可以出现的最大椭球体积。 而不是保证一个特定的大小，这指定了云出现的边界， 改变它可能会影响云的形状。

改变 maximumSize 的 z 值对云的外观有最显著的影响， 因为它改变了云的深度，从而影响了云形状纹理的采样位置。

cloud.maximumSize = new Cesium.Cartesian3(14, 9, 10);	cloud.maximumSize.x = 25;
cloud.maximumSize.y = 5;	cloud.maximumSize.z = 17;

要修改广告牌的实际大小，请修改云的 scale 属性。

See:

• CumulusCloud#scale

获取或设置积云广告牌的缩放比例（以米为单位）。 scale 属性将影响广告牌的大小， 但不会影响云的实际外观。

cloud.scale = new Cesium.Cartesian2(12, 8);

cloud.scale = new Cesium.Cartesian2(24, 10);

要修改云的外观，请修改其 maximumSize 和 slice 属性。

See:

• CumulusCloud#maximumSize
• CumulusCloud#slice

Default Value: true

获取或设置在广告牌上渲染的云的“切片”，即为广告牌外观选择的云的特定横截面。 给定一个介于 0 和 1 之间的值，切片指定在云的 z 方向最大大小基础上切入云的深度。

cloud.slice = 0.32;

cloud.slice = 0.5;

cloud.slice = 0.6;

由于此切片的计算方式，低于 0.2 的值可能会导致横截面过小， 椭球体的边缘将会可见。同样，高于 0.7 的值会导致云的外观变小。 完全应避免在 [0.1, 0.9] 范围之外的值，因为它们不会产生理想的结果。

cloud.slice = 0.08;

cloud.slice = 0.8;

如果将 slice 设置为负数，云将不会渲染横截面。 相反，它将渲染可见的椭球体外部。对于具有较小 `maximumSize.z` 值的云，这可以产生良好的效果， 但对于较大的云，这可能会导致云在椭球体体积中变形，效果不佳。

cloud.slice = -1.0; cloud.maximumSize.z = 18;

cloud.slice = -1.0; cloud.maximumSize.z = 30;

Default Value: -1.0