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