ClassificationPrimitive

分类原语表示要突出显示的Scene中的封闭几何体。

基本体将几何体实例与描述完整着色的Appearance结合起来，包括Material和RenderState。大致上，几何体实例定义结构和位置，外观定义视觉特征。分离几何体和外观允许我们混合和匹配大多数几何体和外观，并独立地添加新的几何体或外观。当直接使用ClassificationPrimitive时，此时只支持在所有实例中使用相同颜色的PerInstanceColorAppearance。对地形或3D瓦片进行分类时，要获得充分的Appearance支持，请使用GroundPrimitive代替。

要正确渲染，此功能需要ext{frag{depth webgl扩展。对于不支持此扩展的硬件，将存在一些视角的渲染工件。

有效几何图形为BoxGeometry、CylinderGeometry、EllipsoidGeometry、PolylineVolumeGeometry和SphereGeometry。

椭球表面后的几何图形，例如CircleGeometry、CorridorGeometry、EllipseGeometry、PolygonGeometry和RectangleGeometry，如果是拉伸体积，也有效；否则，将不会渲染它们。

new ClassificationPrimitive(options)

Parameters:

options (Object)

Name	Description
options.geometryInstances `(Array \| GeometryInstance)`	要渲染的几何体实例。这可以是单个实例，也可以是长度为1的数组。
options.appearance `Appearance`	用于呈现原语的外观。当几何实例具有颜色属性时，默认为PerInstanceColorAppearance。
options.show `Boolean` default `true`	确定是否显示此基元。
options.vertexCacheOptimize `Boolean` default `false`	当`true`时，几何体顶点将针对顶点前和顶点后明暗器缓存进行优化。
options.interleave `Boolean` default `false`	当`true`时，几何顶点属性交错，这可以稍微提高渲染性能，但增加加载时间。
options.compressVertices `Boolean` default `true`	当`true`时，几何体顶点被压缩，这将节省内存。
options.releaseGeometryInstances `Boolean` default `true`	当`true`时，原语不保留对输入`geometryInstances`的引用以保存内存。
options.allowPicking `Boolean` default `true`	当`true`时，每个几何体实例只能使用`Scene#pick`进行选择。当`false`时，保存GPU内存。
options.asynchronous `Boolean` default `true`	确定在准备就绪之前是异步创建基元还是阻止创建基元。如果为false，则必须首先调用initiaterrainheights（）。
options.classificationType `ClassificationType` default `ClassificationType.BOTH`	确定地形、三维瓦片还是两者都要分类。
options.debugShowBoundingVolume `Boolean` default `false`	仅用于调试。确定是否显示此基元的命令的边界球。
options.debugShowShadowVolume `Boolean` default `false`	仅用于调试。确定是否绘制基本体中每个几何体的阴影体积。在释放几何图形或选项之前，要创建的卷在创建时必须为`true`。ReleaseGeometryInstance必须为`false`。

See:

Members

(readonly) allowPicking : Boolean

当true时，每个几何体实例只能使用Scene#pick进行选择。当false时，保存GPU内存。

Default Value: true

(readonly) asynchronous : Boolean

确定是否将在Web工作者上创建和批处理几何体实例。

Default Value: true

classificationType : ClassificationType

确定地形、三维瓦片还是两者都要分类。

Default Value: ClassificationType.BOTH

(readonly) compressVertices : Boolean

当true时，几何体顶点被压缩，这将节省内存。

Default Value: true

debugShowBoundingVolume : Boolean

此属性仅用于调试；它既不用于生产，也不进行优化。

为基本体中的每个draw命令绘制边界球体。

Default Value: false

debugShowShadowVolume : Boolean

此属性仅用于调试；它既不用于生产，也不进行优化。

为基本体中的每个几何体绘制阴影体积。

Default Value: false

(readonly) geometryInstances : (Array|GeometryInstance)

使用此基元渲染的几何体实例。在构造基元时，如果options.releaseGeometryInstances是true，则可能是undefined。

在呈现基元后更改此属性没有效果。

由于使用的渲染技术，所有几何体实例必须是相同的颜色。如果存在颜色不同的实例，则在第一次尝试呈现时将抛出DeveloperError。

Default Value: undefined

(readonly) interleave : Boolean

确定几何体顶点属性是否交错，这可以稍微提高渲染性能。

Default Value: false

(readonly) ready : Boolean

确定基元是否已完成并准备好呈现。如果此属性为真，则下次调用ClassificationPrimitive#update时将呈现原语。

(readonly) readyPromise : Promise.<ClassificationPrimitive>

获取解决基元何时准备呈现的承诺。

(readonly) releaseGeometryInstances : Boolean

当true时，原语不保留对输入geometryInstances的引用以保存内存。

Default Value: true

show : Boolean

确定是否显示基元。这会影响基本体中的所有几何体实例。

Default Value: true

(readonly) vertexCacheOptimize : Boolean

当true时，几何体顶点将针对顶点前和顶点后明暗器缓存进行优化。

Default Value: true

Methods

(static) isSupported(scene) → {Boolean}

确定是否支持ClassificationPrimitive呈现。

Parameters:

scene (Scene) 现场。

destroy()

销毁此对象持有的WebGL资源。销毁对象允许确定地释放WebGL资源，而不是依赖垃圾收集器来销毁此对象。

一旦对象被破坏，就不应使用它；调用除isDestroyed以外的任何函数都将导致DeveloperError异常。因此，将返回值（undefined）赋给对象，如示例中所述。

Example

e = e && e.destroy();

Throws

DeveloperError : 此对象已被销毁，即调用destroy（）。

See:

ClassificationPrimitive#isDestroyed

getGeometryInstanceAttributes(id) → {Object}

返回GeometryInstance的每个实例可修改属性。

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 : 必须在调用GetGeometryInstanceAttributes之前调用Update。

isDestroyed() → {Boolean}

如果此对象被破坏，则返回true；否则返回false。

如果此对象被破坏，则不应使用它；调用除isDestroyed以外的任何函数都将导致DeveloperError异常。

See:

ClassificationPrimitive#destroy

update()

当Viewer或BMWidget渲染场景以获取渲染此原语所需的绘制命令时调用。

不要直接调用此函数。这只是为了列出渲染场景时可能传播的异常：

Throws

DeveloperError : 所有实例几何必须具有相同的PrimitiveType。
DeveloperError : 外观和材料有一个统一的名称。
DeveloperError : 并非所有几何体实例都具有相同的颜色属性。