BillboardGraphics

new Cesium.BillboardGraphics ( options )

描述位于包含 Entity 的位置的二维图标。


示例广告牌
Name Type Description
options BillboardGraphics.ConstructorOptions 可选 描述初始化选项的对象
Demo:

Members

获取或设置 Cartesian3 属性,该属性指定旋转的单位矢量轴在固定框架中。设置为Cartesian3.ZERO时,旋转从屏幕顶部开始。
Default Value: Cartesian3.ZERO
获取或设置指定与 image 相乘的 Color 的属性。这有两个常见的用例。首先,许多不同的广告牌都可以使用相同的白色纹理,每个都有不同的颜色,以创建彩色广告牌。其次,颜色的alpha分量可以是用于使广告牌透明,如下所示。 0.0 的Alpha成为广告牌透明,而 1.0 使广告牌不透明。

默认
alpha:0.5
< /td>
Default Value: Color.WHITE
获取每当属性或子属性发生更改或修改时引发的事件。

disableDepthTestDistance : Property |undefined

获取或设置与相机的距离,在深度处禁用深度测试,例如,以防止剪切地形。设置为零时,将始终应用深度测试。设置为Number.POSITIVE_INFINITY时,永远不会应用深度测试。

distanceDisplayCondition : Property |undefined

获取或设置 DistanceDisplayCondition 属性,该属性指定将在距摄像机的距离处显示此广告牌。
获取或设置 Cartesian3 属性,该属性指定广告牌在眼坐标中的偏移量。眼睛坐标是一个左手坐标系,其中 x 指向查看者的右边, y 指向上方, z 指向屏幕。

视线偏移通常用于将多个广告牌或对象布置在同一位置,例如在相应的3D模型上方布置广告牌。

在下方,广告牌位于地球的中心,但眼球偏移使其始终处于无论观看者或地球的方向如何,它都会出现在地球的顶部。

b.eyeOffset =新的Cartesian3(0.0,8000000.0,0.0);
Default Value: Cartesian3.ZERO
获取或设置数字属性,该属性指定广告牌的高度(以像素为单位)。未定义时,将使用原始高度。
获取或设置指定 HeightReference 的属性。
Default Value: HeightReference.NONE
获取或设置指定 Horizo​​ntalOrigin 的属性。
Default Value: HorizontalOrigin.CENTER
获取或设置指定用于广告牌的Image,URI或Canvas的属性。
获取或设置指定 BoundingRectangle 的属性,该属性定义了 image 的子区域(而不是整个图像)用于广告牌,从左下角开始以像素为单位进行测量。
获取或设置 Cartesian2 属性,该属性指定广告牌在屏幕空间中的像素偏移量从此广告牌的来源开始。通常用于对齐多个广告牌和标签相同的位置,例如图片和文字。屏幕空间原点是屏幕顶部的左上角帆布; x 从左到右增加, y 从上到下增加。

默认
b.pixeloffset = new Cartesian2(50,25);
广告牌的原点由黄点表示。
Default Value: Cartesian2.ZERO

pixelOffsetScaleByDistance : Property |undefined

获取或设置 NearFarScalar 属性,该属性根据距照相机的距离指定广告牌的像素偏移。广告牌的像素偏移将在 NearFarScalar#nearValue NearFarScalar#farValue ,而摄像头距离在上下限之内指定的 NearFarScalar#near NearFarScalar#far 代码> 。在这些范围之外,广告牌的像素偏移保持钳位到最近的范围。
获取或设置数字属性,该属性指定图像的旋转从 alignedAxis 逆时针旋转。
Default Value: 0
获取或设置数字属性,该属性指定要应用于图像的统一比例。大于 1.0 的比例将扩大广告牌,而小于 1.0 的比例将缩小广告牌。


在上图中从左到右,比例分别为 0.5 1.0 2.0
Default Value: 1.0
获取或设置 NearFarScalar 属性,该属性根据距摄像机的距离来指定广告牌的比例。广告牌的比例将在 NearFarScalar#nearValue NearFarScalar#farValue ,而摄像头距离在上下限之内指定的 NearFarScalar#near NearFarScalar#far 代码> 。超出这些范围时,广告牌的比例将保持在最近的范围内。
获取或设置指定广告牌可见性的布尔属性。
Default Value: true
获取或设置布尔属性,该属性指定此广告牌的大小是否以米为单位。
Default Value: false

translucencyByDistance : Property |undefined

获取或设置 NearFarScalar 属性,该属性根据距摄像机的距离来指定广告牌的透明度。广告牌的半透明性会在 NearFarScalar#nearValue NearFarScalar#farValue ,而摄像头距离在上下限之内指定的 NearFarScalar#near NearFarScalar#far 代码> 。在这些范围之外,广告牌的半透明性仍保持在最近的范围内。
获取或设置指定 VerticalOrigin 的属性。
Default Value: VerticalOrigin.CENTER
获取或设置数字属性,该属性指定广告牌的宽度(以像素为单位)。未定义时,使用本机宽度。

Methods

复制此实例。
Name Type Description
result BillboardGraphics 可选 将结果存储到的对象。
Returns:
修改后的结果参数或一个新实例(如果未提供)。
将此对象上每个未分配的属性分配给该值提供的源对象具有相同属性。
Name Type Description
source BillboardGraphics 要合并到该对象中的对象。

Type Definitions

Cesium.BillboardGraphics.ConstructorOptions

BillboardGraphics构造函数的初始化选项
Properties:
Name Type Attributes Default Description
show Property | boolean <optional>
true 一个布尔属性,用于指定广告牌的可见性。
image Property | string | HTMLCanvasElement <optional>
一个属性,指定用于广告牌的图像,URI或画布。
scale Property | number <optional>
1.0 一个数字属性,指定要应用于图像尺寸的比例。
pixelOffset Property | Cartesian2 <optional>
Cartesian2.ZERO 一个 Cartesian2 属性,用于指定像素偏移。
eyeOffset Property | Cartesian3 <optional>
Cartesian3.ZERO 一个 Cartesian3 属性,指定了眼睛偏移。
horizontalOrigin Property | HorizontalOrigin <optional>
HorizontalOrigin.CENTER 一个属性,指定 Horizo​​ntalOrigin
verticalOrigin Property | VerticalOrigin <optional>
VerticalOrigin.CENTER 一个属性,指定 VerticalOrigin
heightReference Property | HeightReference <optional>
HeightReference.NONE 一个属性,指定相对于高度的高度。
color Property | Color <optional>
Color.WHITE 一个属性,它指定图像的色调 颜色
rotation Property | number <optional>
0 一个数字属性,用于指定关于alignedAxis的旋转。
alignedAxis Property | Cartesian3 <optional>
Cartesian3.ZERO A Cartesian3 属性,用于指定单位矢量旋转轴。
sizeInMeters Property | boolean <optional>
一个布尔型属性,指定是否应以米为单位测量此广告牌的大小。
width Property | number <optional>
一个数字属性,用于指定广告牌的宽度(以像素为单位),并覆盖原始尺寸。
height Property | number <optional>
一个数字属性,用于指定广告牌的高度(以像素为单位),并覆盖原始尺寸。
scaleByDistance Property | NearFarScalar <optional>
A NearFarScalar 该属性用于根据距相机的距离缩放点。
translucencyByDistance Property | NearFarScalar <optional>
NearFarScalar 该属性用于根据距相机的距离设置半透明性。
pixelOffsetScaleByDistance Property | NearFarScalar <optional>
A NearFarScalar 该属性用于根据距相机的距离来设置pixelOffset。
imageSubRegion Property | BoundingRectangle <optional>
一个属性,它指定 BoundingRectangle ,该属性定义了要用于广告牌的图像的子区域,而不是整个图像,而是从左下角开始以像素为单位。
distanceDisplayCondition Property | DistanceDisplayCondition <optional>
一个属性,它指定将在距摄像机的距离上显示此广告牌。
disableDepthTestDistance Property | number <optional>
一个属性,它指定要禁用深度测试的距离相机的距离。