定位在三維場景中的圖形點(diǎn),使用
new PointPrimitive()
PointPrimitiveCollection
創(chuàng)建和渲染。創(chuàng)建點(diǎn)并通過調(diào)用PointPrimitiveCollection#add
設(shè)置其初始屬性。
Throws
-
DeveloperError : scaleByDistance.far必須大于scaleByDistance.near
-
DeveloperError : translucencybydistance.far必須大于translucencybydistance.near。
-
DeveloperError : 距離displayCondition.far必須大于距離displayCondition.near
Members
color : Color
獲取或設(shè)置點(diǎn)的內(nèi)部顏色。紅色、綠色、藍(lán)色和字母值由
value
sred
、green
、blue
和alpha
屬性表示,如示例1所示。這些成分的范圍從0.0
(無強(qiáng)度)到1.0
(全強(qiáng)度)。
Examples:
// Example 1. Assign yellow.
p.color = bmgl.Color.YELLOW;
// Example 2. Make a pointPrimitive 50% translucent.
p.color = new bmgl.Color(1.0, 1.0, 1.0, 0.5);
disableDepthTestDistance : Number
獲取或設(shè)置與要禁用深度測試的照相機(jī)之間的距離,例如,防止對地形進(jìn)行剪切。當(dāng)設(shè)置為零時(shí),始終應(yīng)用深度測試。當(dāng)設(shè)置為數(shù)字正無窮大時(shí),深度測試永遠(yuǎn)不會應(yīng)用。
-
Default Value:
0.0
distanceDisplayCondition : DistanceDisplayCondition
獲取或設(shè)置條件,該條件指定此點(diǎn)將顯示在距相機(jī)的距離處。
-
Default Value:
undefined
id : *
獲取或設(shè)置拾取點(diǎn)時(shí)返回的用戶定義值。
outlineColor : Color
獲取或設(shè)置點(diǎn)的輪廓顏色。
outlineWidth : Number
獲取或設(shè)置輪廓寬度(像素)。這個(gè)寬度增加了像素大小,增加了點(diǎn)的總大小。
pixelSize : Number
獲取或設(shè)置點(diǎn)的內(nèi)部大小(像素)。
position : Cartesian3
獲取或設(shè)置此點(diǎn)的笛卡爾位置。
scaleByDistance : NearFarScalar
獲取或設(shè)置基于點(diǎn)與相機(jī)的距離的點(diǎn)的近和遠(yuǎn)縮放屬性。點(diǎn)的比例將在
NearFarScalar#nearValue
和NearFarScalar#farValue
之間插入,而相機(jī)距離在指定NearFarScalar#near
和NearFarScalar#far
的上下限內(nèi)。在這些范圍之外,點(diǎn)的比例仍保持固定到最近的界限。該比例將像素大小和大綱寬度相乘,以影響點(diǎn)的總大小。如果未定義,將禁用scaleByDistance。
Examples:
// Example 1.
// Set a pointPrimitive's scaleByDistance to scale to 15 when the
// camera is 1500 meters from the pointPrimitive and disappear as
// the camera distance approaches 8.0e6 meters.
p.scaleByDistance = new bmgl.NearFarScalar(1.5e2, 15, 8.0e6, 0.0);
// Example 2.
// disable scaling by distance
p.scaleByDistance = undefined;
show : Boolean
確定是否顯示此點(diǎn)。使用此選項(xiàng)可隱藏或顯示點(diǎn),而不是將其刪除并重新添加到集合中。
translucencyByDistance : NearFarScalar
獲取或設(shè)置基于點(diǎn)與相機(jī)的距離的點(diǎn)的近半透明和遠(yuǎn)半透明屬性。點(diǎn)的半透明將在
NearFarScalar#nearValue
和NearFarScalar#farValue
之間插入,而相機(jī)距離在指定NearFarScalar#near
和NearFarScalar#far
的上下限內(nèi)。在這些范圍之外,該點(diǎn)的半透明性保持固定到最近的邊界。如果未定義,半透明Y距離將被禁用。
Examples:
// Example 1.
// Set a point's translucency to 1.0 when the
// camera is 1500 meters from the point and disappear as
// the camera distance approaches 8.0e6 meters.
p.translucencyByDistance = new bmgl.NearFarScalar(1.5e2, 1.0, 8.0e6, 0.0);
// Example 2.
// disable translucency by distance
p.translucencyByDistance = undefined;
Methods
computeScreenSpacePosition(scene, result) → {Cartesian2}
計(jì)算點(diǎn)原點(diǎn)的屏幕空間位置。屏幕空間原點(diǎn)是畫布的左上角;
x
從左到右增加,y
從上到下增加。
Parameters:
Throws
-
DeveloperError : PointPrimitive必須在集合中。
確定此點(diǎn)是否等于另一點(diǎn)。如果點(diǎn)的所有屬性都相等,則點(diǎn)是相等的。不同集合中的點(diǎn)可以相等。