Billboard
A viewport-aligned image positioned in the 3D scene, that is created and rendered using a
BillboardCollection
. A billboard is created and its initial properties are set by calling
BillboardCollection#add
.
viewport-aligned形象定位在3 d场景,创建 并呈现使用
例子的广告牌
BillboardCollection
。 和最初创建一个广告牌 通过调用属性集
BillboardCollection#add
。
![](http://cesiumjs.org/Cesium/Build/Documentation/images/Billboard.png)
例子的广告牌
性能:
阅读一个属性,例如,Billboard#show
是恒定的。 财产分配是常数时间但结果 当CPU与GPU流量BillboardCollection#update
被称为。 per-billboard交通是 是一样的,不管你有多少属性更新。 如果大多数广告牌需要集合 更新,它可能是更有效的清除集合BillboardCollection#removeAll
添加新的广告牌而不是修改每一个。
抛出:
-
DeveloperError :scaleByDistance。 必须大于scaleByDistance.near
-
DeveloperError :translucencyByDistance。 必须大于translucencyByDistance.near
-
DeveloperError :pixelOffsetScaleByDistance。 必须大于pixelOffsetScaleByDistance.near
-
DeveloperError :distanceDisplayCondition。 必须大于distanceDisplayCondition.near
成员
-
获取或设置在世界空间轴对齐。 对齐的轴的单位向量向量指向广告牌。 缺省值是零向量,这意味着广告牌向量对齐到屏幕上。
例子:
// Example 1. // Have the billboard up vector point north billboard.alignedAxis = Cesium.Cartesian3.UNIT_Z;
// Example 2. // Have the billboard point east. billboard.alignedAxis = Cesium.Cartesian3.UNIT_Z; billboard.rotation = -Cesium.Math.PI_OVER_TWO;
// Example 3. // Reset the aligned axis billboard.alignedAxis = Cesium.Cartesian3.ZERO;
-
获取或设置颜色乘以广告牌的纹理。 这有两个常见的用例。 首先, 相同的白色纹理可能使用许多不同的广告牌,每一个都有不同的颜色,去创造 彩色的广告牌。 第二,颜色的α组件可以用来制造广告牌半透明如下所示。 的α
0.0
使广告牌透明,1.0
使广告牌不透明。
default
alpha : 0.5
红、绿、蓝,α值表示value
的red
,green
,blue
,alpha
属性,如例1所示。 这些组件包括0.0
(没有强度)1.0
(完整的强度)。例子:
// Example 1. Assign yellow. b.color = Cesium.Color.YELLOW;
// Example 2. Make a billboard 50% translucent. b.color = new Cesium