Scene
中的几何图形。几何图形可以来自单个
GeometryInstance
,如下面的示例 1 所示,或者来自一个实例数组,即使几何图形来自不同的几何类型,例如代码示例 2 中所示的
RectangleGeometry
和
EllipsoidGeometry
。
图元将几何实例与描述完整着色的
Appearance
组合在一起,包括
Material
和
RenderState
。粗略地说,几何实例定义了结构和位置,外观定义了视觉特征。解耦几何和外观允许我们混合和匹配它们中的大多数,并相互独立地添加新的几何或外观。
将多个实例组合成一个原语称为批处理,它显着提高了静态数据的性能。可以单独选择实例;
Scene#pick
返回他们的
GeometryInstance#id
。使用
PerInstanceColorAppearance
类的每个实例外观,每个实例也可以具有唯一的颜色。
Geometry
可以在 web worker 或主线程上创建和批处理。前两个示例显示了将使用几何描述在 Web Worker 上创建的几何。第三个示例显示了如何通过显式调用
createGeometry
方法在主线程上创建几何图形。
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options
|
Object |
具有以下属性的
可选
对象:
|
Examples:
// 1. Draw a translucent ellipse on the surface with a checkerboard pattern
const instance = new Cesium.GeometryInstance({
geometry : new Cesium.EllipseGeometry({
center : Cesium.Cartesian3.fromDegrees(-100.0, 20.0),
semiMinorAxis : 500000.0,
semiMajorAxis : 1000000.0,
rotation : Cesium.Math.PI_OVER_FOUR,
vertexFormat : Cesium.VertexFormat.POSITION_AND_ST
}),
id : 'object returned when this instance is picked and to get/set per-instance attributes'
});
scene.primitives.add(new Cesium.Primitive({
geometryInstances : instance,
appearance : new Cesium.EllipsoidSurfaceAppearance({
material : Cesium.Material.fromType('Checkerboard')
})
}));
// 2. Draw different instances each with a unique color
const rectangleInstance = new Cesium.GeometryInstance({
geometry : new Cesium.RectangleGeometry({
rectangle : Cesium.Rectangle.fromDegrees(-140.0, 30.0, -100.0, 40.0),
vertexFormat : Cesium.PerInstanceColorAppearance.VERTEX_FORMAT
}),
id : 'rectangle',
attributes : {
color : new Cesium.ColorGeometryInstanceAttribute(0.0, 1.0, 1.0, 0.5)
}
});
const ellipsoidInstance = new Cesium.GeometryInstance({
geometry : new Cesium.EllipsoidGeometry({
radii : new Cesium.Cartesian3(500000.0, 500000.0, 1000000.0),
vertexFormat : Cesium.VertexFormat.POSITION_AND_NORMAL
}),
modelMatrix : Cesium.Matrix4.multiplyByTranslation(Cesium.Transforms.eastNorthUpToFixedFrame(
Cesium.Cartesian3.fromDegrees(-95.59777, 40.03883)), new Cesium.Cartesian3(0.0, 0.0, 500000.0), new Cesium.Matrix4()),
id : 'ellipsoid',
attributes : {
color : Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.AQUA)
}
});
scene.primitives.add(new Cesium.Primitive({
geometryInstances : [rectangleInstance, ellipsoidInstance],
appearance : new Cesium.PerInstanceColorAppearance()
}));
// 3. Create the geometry on the main thread.
scene.primitives.add(new Cesium.Primitive({
geometryInstances : new Cesium.GeometryInstance({
geometry : Cesium.EllipsoidGeometry.createGeometry(new Cesium.EllipsoidGeometry({
radii : new Cesium.Cartesian3(500000.0, 500000.0, 1000000.0),
vertexFormat : Cesium.VertexFormat.POSITION_AND_NORMAL
})),
modelMatrix : Cesium.Matrix4.multiplyByTranslation(Cesium.Transforms.eastNorthUpToFixedFrame(
Cesium.Cartesian3.fromDegrees(-95.59777, 40.03883)), new Cesium.Cartesian3(0.0, 0.0, 500000.0), new Cesium.Matrix4()),
id : 'ellipsoid',
attributes : {
color : Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.AQUA)
}
}),
appearance : new Cesium.PerInstanceColorAppearance(),
asynchronous : false
}));
See:
Members
-
Default Value:
true
appearance : Appearance
Appearance
。每个几何实例都以相同的外观着色。某些外观,例如
PerInstanceColorAppearance
允许为每个实例赋予唯一的属性。
-
Default Value:
undefined
-
Default Value:
true
true
时,几何顶点被压缩,这将节省内存。
-
Default Value:
true
true
时,渲染器视锥体剔除和地平线根据其边界体积剔除基元的命令。如果您手动剔除原语,请将其设置为
false
以获得较小的性能增益。
-
Default Value:
true
为基元中的每个绘制命令绘制边界球体。
-
Default Value:
false
depthFailAppearance : Appearance
Appearance
。每个几何实例都以相同的外观着色。某些外观,例如
PerInstanceColorAppearance
允许为每个实例赋予唯一的属性。
当使用需要颜色属性的外观(如 PerInstanceColorAppearance)时,请改为添加每个实例的 depthFailColor 属性。
需要 EXT_frag_depth WebGL 扩展才能正确呈现。如果不支持扩展,则可能存在工件。
-
Default Value:
undefined
readonly geometryInstances : Array.< GeometryInstance >| GeometryInstance
options.releaseGeometryInstances
为
true
,则这可能是
undefined
的。
在渲染图元后更改此属性无效。
-
Default Value:
undefined
-
Default Value:
false
modelMatrix : Matrix4
Transforms.eastNorthUpToFixedFrame
返回的那样。
此属性仅在 3D 模式下受支持。
-
Default Value:
Matrix4.IDENTITY
Example:
const origin = Cesium.Cartesian3.fromDegrees(-95.0, 40.0, 200000.0);
p.modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(origin);
Primitive#update
时呈现。
readonly readyPromise : Promise.< Primitive >
true
时,图元不会保留对输入
geometryInstances
的引用以节省内存。
-
Default Value:
true
shadows : ShadowMode
-
Default Value:
ShadowMode.DISABLED
-
Default Value:
true
true
时,几何顶点针对顶点着色器前后缓存进行优化。
-
Default Value:
true
Methods
一旦一个对象被销毁,它就不应该被使用;调用
isDestroyed
以外的任何函数都将导致
DeveloperError
异常。因此,如示例中所做的那样,将返回值 (
undefined
) 分配给对象。
Throws:
-
DeveloperError : 该对象被销毁,即调用了destroy()。
Example:
e = e && e.destroy();
See:
GeometryInstance
的可修改的每实例属性。
Name | Type | Description |
---|---|---|
id
|
* |
GeometryInstance
的 ID。
|
Returns:
Throws:
-
DeveloperError :必须在调用 getGeometryInstanceAttributes 之前调用 update。
Example:
const attributes = primitive.getGeometryInstanceAttributes('an id');
attributes.color = Cesium.ColorGeometryInstanceAttribute.toValue(Cesium.Color.AQUA);
attributes.show = Cesium.ShowGeometryInstanceAttribute.toValue(true);
attributes.distanceDisplayCondition = Cesium.DistanceDisplayConditionGeometryInstanceAttribute.toValue(100.0, 10000.0);
attributes.offset = Cesium.OffsetGeometryInstanceAttribute.toValue(Cartesian3.IDENTITY);
如果这个对象被破坏了,它就不应该被使用;调用
isDestroyed
以外的任何函数都将导致
DeveloperError
异常。
Returns:
true
;否则,
false
。
See:
Throws:
-
DeveloperError :所有实例几何必须具有相同的primitiveType。
-
DeveloperError : 外观和材质有同名的制服。
-
DeveloperError : Primitive.modelMatrix 仅在 3D 模式下受支持。
-
RuntimeError :需要顶点纹理获取支持来渲染具有每个实例属性的图元。顶点纹理图像单元的最大数量必须大于零。