描述位于包含
廣告牌示例
new BillboardGraphics(options)
Entity
位置的二維圖標(biāo)。
廣告牌示例
Parameters:
options
(Object)
Name | Description |
---|---|
options.show
Property
default true
|
指定公告牌可見(jiàn)性的布爾屬性。 |
options.image
Property
|
指定要用于公告牌的圖像、URI或畫(huà)布的屬性。 |
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è)圖像,從左下角開(kāi)始以像素度量。
|
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)從屏幕頂部開(kāi)始。
-
Default Value:
Cartesian3.ZERO
color : Property
獲取或設(shè)置指定與
image
相乘的Color
的屬性。這有兩個(gè)常見(jiàn)的用例。首先,許多不同的廣告牌可以使用相同的白色紋理,每個(gè)顏色都不同,以創(chuàng)建彩色廣告牌。其次,顏色的alpha組件可以用來(lái)使廣告牌半透明,如下所示。字母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ù)字正無(wú)窮大時(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或畫(huà)布的屬性。
imageSubRegion : Property
獲取或設(shè)置指定
BoundingRectangle
的屬性,該屬性定義image
的子區(qū)域以左下角的像素度量,用于公告牌,而不是整個(gè)圖像。
pixelOffset : Property
獲取或設(shè)置
廣告牌的原點(diǎn)用黃色點(diǎn)表示。
Cartesian2
屬性,該屬性指定公告牌在屏幕空間中相對(duì)于此公告牌原點(diǎn)的像素偏移量。這通常用于在同一位置對(duì)齊多個(gè)廣告牌和標(biāo)簽,例如圖像和文本。屏幕空間原點(diǎn)是畫(huà)布的左上角;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è)置用于指定公告牌可見(jiàn)性的布爾屬性。
-
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ì)象上相同屬性的值。