描述位于包含
廣告牌示例
new BillboardGraphics(options)
Entity位置的二維圖標(biāo)。廣告牌示例
Parameters:
options
(Object)
| Name | Description |
|---|---|
options.show
Property
default true
|
指定公告牌可見性的布爾屬性。 |
options.image
Property
|
指定要用于公告牌的圖像、URI或畫布的屬性。 |
options.scale
Property
default 1.0
|
指定要應(yīng)用于圖像大小的比例的數(shù)值屬性。 |
options.pixelOffset
Property
default Cartesian2.ZERO
|
指定像素偏移的Cartesian2屬性。
|
options.eyeOffset
Property
default Cartesian3.ZERO
|
指定眼偏移的Cartesian3屬性。
|
options.horizontalOrigin
Property
default HorizontalOrigin.CENTER
|
指定HorizontalOrigin的屬性。
|
options.verticalOrigin
Property
default VerticalOrigin.CENTER
|
指定VerticalOrigin的屬性。
|
options.heightReference
Property
default HeightReference.NONE
|
指定高度相對(duì)高度的屬性。 |
options.color
Property
default Color.WHITE
|
指定圖像色調(diào)的屬性。 |
options.rotation
Property
default 0
|
指定圍繞Alignedaxis旋轉(zhuǎn)的數(shù)值屬性。 |
options.alignedAxis
Property
default Cartesian3.ZERO
|
ACartesian3屬性，指定旋轉(zhuǎn)的單位矢量軸。
|
options.sizeInMeters
Property
|
一個(gè)布爾屬性，指定是否應(yīng)以米為單位測(cè)量此公告牌的大小。 |
options.width
Property
|
以像素為單位指定公告牌寬度的數(shù)值屬性，覆蓋本機(jī)大小。 |
options.height
Property
|
以像素為單位指定公告牌高度的數(shù)值屬性，覆蓋本機(jī)大小。 |
options.scaleByDistance
Property
|
ANearFarScalar屬性，用于根據(jù)與相機(jī)的距離縮放點(diǎn)。
|
options.translucencyByDistance
Property
|
一個(gè)NearFarScalar屬性，用于根據(jù)與相機(jī)的距離設(shè)置半透明。
|
options.pixelOffsetScaleByDistance
Property
|
一個(gè)NearFarScalar屬性，用于根據(jù)與相機(jī)的距離設(shè)置PixeLoffset。
|
options.imageSubRegion
Property
|
指定BoundingRectangle的屬性，該屬性定義用于公告牌的圖像的子區(qū)域，而不是整個(gè)圖像，從左下角開始以像素度量。
|
options.distanceDisplayCondition
Property
|
一個(gè)屬性，指定此公告牌將顯示在與相機(jī)的距離。 |
options.disableDepthTestDistance
Property
|
一個(gè)屬性，指定從要禁用深度測(cè)試的相機(jī)到的距離。 |
Members
alignedAxis : Property
獲取或設(shè)置指定固定框架中旋轉(zhuǎn)的單位矢量軸的
Cartesian3屬性。當(dāng)設(shè)置為cartesian3.zero時(shí)，旋轉(zhuǎn)從屏幕頂部開始。
-
Default Value:
Cartesian3.ZERO
color : Property
獲取或設(shè)置指定與
image相乘的Color的屬性。這有兩個(gè)常見的用例。首先，許多不同的廣告牌可以使用相同的白色紋理，每個(gè)顏色都不同，以創(chuàng)建彩色廣告牌。其次，顏色的alpha組件可以用來使廣告牌半透明，如下所示。字母0.0使廣告牌透明，字母1.0使廣告牌不透明。default | alpha : 0.5 |
-
Default Value:
Color.WHITE
(readonly) definitionChanged : Event
獲取每當(dāng)屬性或子屬性更改或修改時(shí)引發(fā)的事件。
disableDepthTestDistance : Property
獲取或設(shè)置與要禁用深度測(cè)試的照相機(jī)之間的距離，例如，防止對(duì)地形進(jìn)行剪切。當(dāng)設(shè)置為零時(shí)，始終應(yīng)用深度測(cè)試。當(dāng)設(shè)置為數(shù)字正無窮大時(shí)，深度測(cè)試永遠(yuǎn)不會(huì)應(yīng)用。
distanceDisplayCondition : Property
獲取或設(shè)置
DistanceDisplayCondition屬性，指定此公告牌將顯示在距相機(jī)的距離。
eyeOffset : Property
獲取或設(shè)置
Cartesian3屬性，該屬性指定公告牌在眼睛坐標(biāo)中的偏移量。眼睛坐標(biāo)是一個(gè)左手坐標(biāo)系，其中x指向觀看者的右側(cè)，y指向上方，z指向屏幕。眼睛偏移通常用于在同一位置安排多個(gè)廣告牌或?qū)ο?，例如，在其相?yīng)的3D模型上方安排一個(gè)廣告牌。
下面，廣告牌位于地球的中心，但是眼睛的偏移使它總是出現(xiàn)在地球的頂部，而不管觀眾或地球的方向如何。 |  |
b.eyeOffset = new Cartesian3(0.0, 8000000.0, 0.0);-
Default Value:
Cartesian3.ZERO
height : Property
獲取或設(shè)置以像素為單位指定公告牌高度的數(shù)字屬性。如果未定義，則使用本機(jī)高度。
heightReference : Property
獲取或設(shè)置指定
HeightReference的屬性。
-
Default Value:
HeightReference.NONE
horizontalOrigin : Property
獲取或設(shè)置指定
HorizontalOrigin的屬性。
-
Default Value:
HorizontalOrigin.CENTER
image : Property
獲取或設(shè)置用于公告牌的指定圖像、URI或畫布的屬性。
imageSubRegion : Property
獲取或設(shè)置指定
BoundingRectangle的屬性，該屬性定義image的子區(qū)域以左下角的像素度量，用于公告牌，而不是整個(gè)圖像。
pixelOffset : Property
獲取或設(shè)置
廣告牌的原點(diǎn)用黃色點(diǎn)表示。
Cartesian2屬性，該屬性指定公告牌在屏幕空間中相對(duì)于此公告牌原點(diǎn)的像素偏移量。這通常用于在同一位置對(duì)齊多個(gè)廣告牌和標(biāo)簽，例如圖像和文本。屏幕空間原點(diǎn)是畫布的左上角；x從左到右增加，y從上到下增加。default | b.pixeloffset = new Cartesian2(50, 25); |
-
Default Value:
Cartesian2.ZERO
pixelOffsetScaleByDistance : Property
獲取或設(shè)置
NearFarScalar屬性，該屬性基于與相機(jī)的距離指定公告牌的像素偏移量。廣告牌的像素偏移量將在NearFarScalar#nearValue和NearFarScalar#farValue之間插入，而相機(jī)距離在指定NearFarScalar#near和NearFarScalar#far的上下限內(nèi)。在這些范圍之外，廣告牌的像素偏移量保持固定到最近的界限。
rotation : Property
獲取或設(shè)置數(shù)字屬性，該屬性指定圖像從
alignedAxis逆時(shí)針旋轉(zhuǎn)。
-
Default Value:
0
scale : Property
獲取或設(shè)置指定要應(yīng)用于圖像的統(tǒng)一比例的數(shù)值屬性。大于
從左到右在上圖中，比例分別為
1.0的比例放大廣告牌，而小于1.0的比例縮小廣告牌。從左到右在上圖中，比例分別為
0.5、1.0和2.0。-
Default Value:
1.0
scaleByDistance : Property
獲取或設(shè)置
NearFarScalar屬性，該屬性基于與相機(jī)的距離指定公告牌的比例。廣告牌的比例將在NearFarScalar#nearValue和NearFarScalar#farValue之間插入，而攝像機(jī)距離在指定NearFarScalar#near和NearFarScalar#far的上下限內(nèi)。在這些范圍之外，廣告牌的比例仍然被限制在最近的范圍內(nèi)。
show : Property
獲取或設(shè)置用于指定公告牌可見性的布爾屬性。
-
Default Value:
true
sizeInMeters : Property
獲取或設(shè)置用于指定此公告牌的大小是否以米為單位的布爾屬性。
-
Default Value:
false
translucencyByDistance : Property
獲取或設(shè)置
NearFarScalar屬性，該屬性基于與相機(jī)的距離指定公告牌的半透明性。廣告牌的半透明將插入NearFarScalar#nearValue和NearFarScalar#farValue之間，而相機(jī)距離在指定NearFarScalar#near和NearFarScalar#far的上下限內(nèi)。在這些范圍之外，廣告牌的半透明性保持在最近的范圍內(nèi)。
verticalOrigin : Property
獲取或設(shè)置指定
VerticalOrigin的屬性。
-
Default Value:
VerticalOrigin.CENTER
width : Property
獲取或設(shè)置以像素為單位指定公告牌寬度的數(shù)字屬性。如果未定義，則使用本機(jī)寬度。
Methods
clone(result) → {BillboardGraphics}
復(fù)制此實(shí)例。
Parameters:
將此對(duì)象上的每個(gè)未分配屬性分配給所提供源對(duì)象上相同屬性的值。