ClassificationPrimitive

分類原語表示要突出顯示的Scene中的封閉幾何體。

基本體將幾何體實(shí)例與描述完整著色的Appearance結(jié)合起來，包括Material和RenderState。大致上，幾何體實(shí)例定義結(jié)構(gòu)和位置，外觀定義視覺特征。分離幾何體和外觀允許我們混合和匹配大多數(shù)幾何體和外觀，并獨(dú)立地添加新的幾何體或外觀。當(dāng)直接使用ClassificationPrimitive時(shí)，此時(shí)只支持在所有實(shí)例中使用相同顏色的PerInstanceColorAppearance。對(duì)地形或3D瓦片進(jìn)行分類時(shí)，要獲得充分的Appearance支持，請(qǐng)使用GroundPrimitive代替。

要正確渲染，此功能需要ext{frag{depth webgl擴(kuò)展。對(duì)于不支持此擴(kuò)展的硬件，將存在一些視角的渲染工件。

有效幾何圖形為BoxGeometry、CylinderGeometry、EllipsoidGeometry、PolylineVolumeGeometry和SphereGeometry。

橢球表面后的幾何圖形，例如CircleGeometry、CorridorGeometry、EllipseGeometry、PolygonGeometry和RectangleGeometry，如果是拉伸體積，也有效；否則，將不會(huì)渲染它們。

new ClassificationPrimitive(options)

Parameters:

options (Object)

Name	Description
options.geometryInstances `(Array \| GeometryInstance)`	要渲染的幾何體實(shí)例。這可以是單個(gè)實(shí)例，也可以是長度為1的數(shù)組。
options.appearance `Appearance`	用于呈現(xiàn)原語的外觀。當(dāng)幾何實(shí)例具有顏色屬性時(shí)，默認(rèn)為PerInstanceColorAppearance。
options.show `Boolean` default `true`	確定是否顯示此基元。
options.vertexCacheOptimize `Boolean` default `false`	當(dāng)`true`時(shí)，幾何體頂點(diǎn)將針對(duì)頂點(diǎn)前和頂點(diǎn)后明暗器緩存進(jìn)行優(yōu)化。
options.interleave `Boolean` default `false`	當(dāng)`true`時(shí)，幾何頂點(diǎn)屬性交錯(cuò)，這可以稍微提高渲染性能，但增加加載時(shí)間。
options.compressVertices `Boolean` default `true`	當(dāng)`true`時(shí)，幾何體頂點(diǎn)被壓縮，這將節(jié)省內(nèi)存。
options.releaseGeometryInstances `Boolean` default `true`	當(dāng)`true`時(shí)，原語不保留對(duì)輸入`geometryInstances`的引用以保存內(nèi)存。
options.allowPicking `Boolean` default `true`	當(dāng)`true`時(shí)，每個(gè)幾何體實(shí)例只能使用`Scene#pick`進(jìn)行選擇。當(dāng)`false`時(shí)，保存GPU內(nèi)存。
options.asynchronous `Boolean` default `true`	確定在準(zhǔn)備就緒之前是異步創(chuàng)建基元還是阻止創(chuàng)建基元。如果為false，則必須首先調(diào)用initiaterrainheights（）。
options.classificationType `ClassificationType` default `ClassificationType.BOTH`	確定地形、三維瓦片還是兩者都要分類。
options.debugShowBoundingVolume `Boolean` default `false`	僅用于調(diào)試。確定是否顯示此基元的命令的邊界球。
options.debugShowShadowVolume `Boolean` default `false`	僅用于調(diào)試。確定是否繪制基本體中每個(gè)幾何體的陰影體積。在釋放幾何圖形或選項(xiàng)之前，要?jiǎng)?chuàng)建的卷在創(chuàng)建時(shí)必須為`true`。ReleaseGeometryInstance必須為`false`。

See:

Members

(readonly) allowPicking : Boolean

當(dāng)true時(shí)，每個(gè)幾何體實(shí)例只能使用Scene#pick進(jìn)行選擇。當(dāng)false時(shí)，保存GPU內(nèi)存。

Default Value: true

(readonly) asynchronous : Boolean

確定是否將在Web工作者上創(chuàng)建和批處理幾何體實(shí)例。

Default Value: true

classificationType : ClassificationType

確定地形、三維瓦片還是兩者都要分類。

Default Value: ClassificationType.BOTH

(readonly) compressVertices : Boolean

當(dāng)true時(shí)，幾何體頂點(diǎn)被壓縮，這將節(jié)省內(nèi)存。

Default Value: true

debugShowBoundingVolume : Boolean

此屬性僅用于調(diào)試；它既不用于生產(chǎn)，也不進(jìn)行優(yōu)化。

為基本體中的每個(gè)draw命令繪制邊界球體。

Default Value: false

debugShowShadowVolume : Boolean

此屬性僅用于調(diào)試；它既不用于生產(chǎn)，也不進(jìn)行優(yōu)化。

為基本體中的每個(gè)幾何體繪制陰影體積。

Default Value: false

(readonly) geometryInstances : (Array|GeometryInstance)

使用此基元渲染的幾何體實(shí)例。在構(gòu)造基元時(shí)，如果options.releaseGeometryInstances是true，則可能是undefined。

在呈現(xiàn)基元后更改此屬性沒有效果。

由于使用的渲染技術(shù)，所有幾何體實(shí)例必須是相同的顏色。如果存在顏色不同的實(shí)例，則在第一次嘗試呈現(xiàn)時(shí)將拋出DeveloperError。

Default Value: undefined

(readonly) interleave : Boolean

確定幾何體頂點(diǎn)屬性是否交錯(cuò)，這可以稍微提高渲染性能。

Default Value: false

(readonly) ready : Boolean

確定基元是否已完成并準(zhǔn)備好呈現(xiàn)。如果此屬性為真，則下次調(diào)用ClassificationPrimitive#update時(shí)將呈現(xiàn)原語。

(readonly) readyPromise : Promise.<ClassificationPrimitive>

獲取解決基元何時(shí)準(zhǔn)備呈現(xiàn)的承諾。

(readonly) releaseGeometryInstances : Boolean

當(dāng)true時(shí)，原語不保留對(duì)輸入geometryInstances的引用以保存內(nèi)存。

Default Value: true

show : Boolean

確定是否顯示基元。這會(huì)影響基本體中的所有幾何體實(shí)例。

Default Value: true

(readonly) vertexCacheOptimize : Boolean

當(dāng)true時(shí)，幾何體頂點(diǎn)將針對(duì)頂點(diǎn)前和頂點(diǎn)后明暗器緩存進(jìn)行優(yōu)化。

Default Value: true

Methods

(static) isSupported(scene) → {Boolean}

確定是否支持ClassificationPrimitive呈現(xiàn)。

Parameters:

scene (Scene) 現(xiàn)場。

destroy()

銷毀此對(duì)象持有的WebGL資源。銷毀對(duì)象允許確定地釋放WebGL資源，而不是依賴?yán)占鱽礓N毀此對(duì)象。

一旦對(duì)象被破壞，就不應(yīng)使用它；調(diào)用除isDestroyed以外的任何函數(shù)都將導(dǎo)致DeveloperError異常。因此，將返回值（undefined）賦給對(duì)象，如示例中所述。

Example

e = e && e.destroy();

Throws

DeveloperError : 此對(duì)象已被銷毀，即調(diào)用destroy（）。

See:

ClassificationPrimitive#isDestroyed

getGeometryInstanceAttributes(id) → {Object}

返回GeometryInstance的每個(gè)實(shí)例可修改屬性。

Parameters:

id (*) GeometryInstance的ID。

Example

var attributes = primitive.getGeometryInstanceAttributes('an id');
attributes.color = bmgl.ColorGeometryInstanceAttribute.toValue(bmgl.Color.AQUA);
attributes.show = bmgl.ShowGeometryInstanceAttribute.toValue(true);

Throws

DeveloperError : 必須在調(diào)用GetGeometryInstanceAttributes之前調(diào)用Update。

isDestroyed() → {Boolean}

如果此對(duì)象被破壞，則返回true；否則返回false。

如果此對(duì)象被破壞，則不應(yīng)使用它；調(diào)用除isDestroyed以外的任何函數(shù)都將導(dǎo)致DeveloperError異常。

See:

ClassificationPrimitive#destroy

update()

當(dāng)Viewer或BMWidget渲染場景以獲取渲染此原語所需的繪制命令時(shí)調(diào)用。

不要直接調(diào)用此函數(shù)。這只是為了列出渲染場景時(shí)可能傳播的異常：

Throws

DeveloperError : 所有實(shí)例幾何必須具有相同的PrimitiveType。
DeveloperError : 外觀和材料有一個(gè)統(tǒng)一的名稱。
DeveloperError : 并非所有幾何體實(shí)例都具有相同的顏色屬性。

BIGEMAP卫星地图_高清卫星地图_北斗高清地图_地图软件_矢量地图数据_专题地图

Parameters:

See:

Members

(readonly) allowPicking : Boolean

(readonly) asynchronous : Boolean

classificationType : ClassificationType

(readonly) compressVertices : Boolean

debugShowBoundingVolume : Boolean

debugShowShadowVolume : Boolean

(readonly) geometryInstances : (Array|GeometryInstance)

(readonly) interleave : Boolean

(readonly) ready : Boolean

(readonly) readyPromise : Promise.<ClassificationPrimitive>

(readonly) releaseGeometryInstances : Boolean

show : Boolean

(readonly) vertexCacheOptimize : Boolean

Methods

Parameters:

Example

Throws

See:

Parameters:

Example

Throws

See:

Throws