BillboardGraphics
描述位于包含
示例广告牌
Entity
位置的二维图标。![](http://develop.cesium.xin/cesiumdoc/images/Billboard.png)
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options | Object | optional Object with the following properties:
|
Members
alignedAxis : Property
获取或设置
Cartesian3
属性,指定单位矢量旋转轴在固定的框架中。设置为Cartesian3.ZERO时,旋转位于屏幕顶部。- Default Value:
Cartesian3.ZERO
获取或设置属性,指定与
image
相乘的 Color
。这有两个常见的用例。首先,许多不同的广告牌可以使用相同的白色纹理,每个都有不同的颜色,以创建彩色广告牌。其次,颜色的alpha分量可以是用于使广告牌半透明,如下所示。 0.0
的alpha值构成广告牌透明, 1.0
使广告牌不透明。default ![]() | alpha:0.5 ![]() |
- Default Value:
Color.WHITE
readonly definitionChanged : Event
获取每当更改或修改属性或子属性时引发的事件。
disableDepthTestDistance : Property
获取或设置从摄像机到禁用深度测试的距离,例如,防止对地形进行裁剪。设置为零时,始终应用深度测试。设置为Number.POSITIVE_INFINITY时,永远不会应用深度测试。
distanceDisplayCondition : Property
获取或设置
DistanceDisplayCondition
属性,指定此广告牌将显示的距离相机的距离。eyeOffset : Property
获取或设置
Cartesian3
属性,指定广告牌在眼睛坐标中的偏移量。眼睛坐标是左手坐标系,其中 x
指向观察者对, y
指向上方, z
指向屏幕。眼睛偏移通常用于在同一位置布置多个广告牌或物体,例如在相应的3D模型上方安排一个广告牌。
在下面,广告牌位于地球的中心,但眼睛偏移使它始终无论观者或地球的方向如何,都会出现在地球的顶部。![]() | ![]() |
b.eyeOffset = new Cartesian3(0.0,8000000.0,0.0);
- Default Value:
Cartesian3.ZERO
获取或设置指定广告牌高度的数字属性(以像素为单位)。未定义时,使用原生高度。
heightReference : Property
获取或设置指定
HeightReference
的Property。- Default Value:
HeightReference.NONE
horizontalOrigin : Property
获取或设置指定
HorizontalOrigin
的Property。- Default Value:
HorizontalOrigin.CENTER
获取或设置Property,指定要用于广告牌的Image,URI或Canvas。
imageSubRegion : Property
获取或设置指定
BoundingRectangle
的属性,该属性定义了用于广告牌的 image
的子区域,而不是整个图像,以左下角的像素为单位。pixelOffset : Property
获取或设置
广告牌的起源用黄点表示。
Cartesian2
属性,指定屏幕空间中广告牌的像素偏移量从这个广告牌的起源。这通常用于对齐多个广告牌和标签相同的位置,例如图像和文本。屏幕空间原点是顶部的左上角帆布; x
从左到右增加, y
从上到下增加。默认 ![]() | b.pixeloffset = new Cartesian2(50,25); ![]() |
- Default Value:
Cartesian2.ZERO
pixelOffsetScaleByDistance : Property
获取或设置
NearFarScalar
属性,根据与摄像机的距离指定广告牌的像素偏移量。广告牌的像素偏移将在 NearFarScalar #nearValue
之间进行插值, NearFarScalar#farValue
,而相机距离在上限和下限范围内指定的 NearFarScalar#near
和 NearFarScalar#far 代码>
。在这些范围之外,广告牌的像素偏移量仍然被钳位到最近的边界。rotation : Property
获取或设置指定图像旋转的数字属性逆时针方向从
alignedAxis
开始。- Default Value:
0
获取或设置数字属性,指定要应用于图像的统一比例。大于
在上图中,从左到右,比例为
1.0
的比例放大广告牌,而小于 1.0
的比例缩小它。![](http://develop.cesium.xin/cesiumdoc/images/Billboard.setScale.png)
0.5
, 1.0
和 2.0
。- Default Value:
1.0
scaleByDistance : Property
获取或设置
NearFarScalar
属性,根据与摄像机的距离指定广告牌的比例。广告牌的比例将在 NearFarScalar #nearValue
之间进行插值, NearFarScalar#farValue
,而相机距离在上限和下限范围内指定的 NearFarScalar#near
和 NearFarScalar#far 代码>
。在这些范围之外,广告牌的比例仍然被限制在最近的范围内。获取或设置布尔属性,指定广告牌的可见性。
- Default Value:
true
sizeInMeters : Property
获取或设置布尔属性,指定此广告牌的大小是否以米为单位。
- Default Value:
false
translucencyByDistance : Property
获取或设置
NearFarScalar
属性,根据与摄像机的距离指定广告牌的半透明度。广告牌的半透明度将在 NearFarScalar #nearValue
之间进行插值, NearFarScalar#farValue
,而相机距离在上限和下限范围内指定的 NearFarScalar#near
和 NearFarScalar#far 代码>
。在这些范围之外,广告牌的半透明度仍然被限制在最近的范围内。verticalOrigin : Property
获取或设置指定
VerticalOrigin
的Property。- Default Value:
VerticalOrigin.CENTER
获取或设置指定广告牌宽度的数字属性(以像素为单位)。未定义时,使用原生宽度。
Methods
clone ( result ) → BillboardGraphics
复制此实例。
Name | Type | Description |
---|---|---|
result | BillboardGraphics | 可选 要存储结果的对象。 |
Returns:
修改后的结果参数或新实例(如果未提供)。
将此对象上的每个未分配属性分配给该值提供的源对象上的相同属性。
Name | Type | Description |
---|---|---|
source | BillboardGraphics | 要合并到此对象的对象。 |
Documentation generated by JSDoc 3.5.5 翻译:http://cesium.xin