一个 3D 模型。这是一个比旧
Model
更加解耦的新架构。这门课仍然是实验性的。
不要直接调用此函数，而是使用 `from` 函数从源数据类型创建模型。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options
|
Object |
具有以下属性的对象:
|
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
Members
readonly activeAnimations : ModelExperimentalAnimationCollection
当前播放的 glTF 动画。
是否剔除背面几何体。当为 true 时，背面剔除由材质的 doubleSided 属性决定；如果为 false，则禁用背面剔除。如果
ModelExperimental#color
为半透明或
ModelExperimental#silhouetteSize
大于 0.0，则不剔除背面。
-
Default Value:
true
readonly boundingSphere : BoundingSphere
获取模型在世界空间中的边界球体。这不考虑 glTF 动画、皮肤或变形目标。它也不考虑
ModelExperimental#minimumPixelSize
。
确定模型的动画是否应在未指定关键帧的帧上保持姿势。
-
Default Value:
true
clippingPlanes : ClippingPlaneCollection
ClippingPlaneCollection
用于选择性地禁用渲染模型。
与模型的渲染颜色混合的颜色。
当
colorBlendMode
为
MIX
时用于确定颜色强度的值。值 0.0 会导致模型的渲染颜色，而值 1.0 会导致纯色，介于两者之间的任何值都会导致两者混合。
-
Default Value:
0.5
colorBlendMode : Cesium3DTileColorBlendMode | ColorBlendMode
定义颜色如何与模型混合。
-
Default Value:
ColorBlendMode.HIGHLIGHT
readonly credit : Credit
获取将为模型显示的信用
customShader : CustomShader
模型的自定义着色器（如果存在）。使用带有
Cesium3DTileStyle
的自定义着色器可能会导致未定义的行为。
该属性仅用于调试；它不是用于生产用途，也不是优化的。
为模型中的每个绘制命令绘制边界球体。
-
Default Value:
false
该属性仅用于调试；它不是用于生产用途，也不是优化的。
在线框中绘制模型。
-
Default Value:
false
distanceDisplayCondition : DistanceDisplayCondition
获取或设置距离显示条件，该条件指定该模型将在距相机的距离处显示。
-
Default Value:
undefined
用于拾取和样式设置的特征 ID 集的标签。
对于 EXT_mesh_features，这是特征 ID 的标签属性，如果未指定，则为'featureId_N'（其中 N 是 featureIds 数组中的索引）。 EXT_feature_metadata 没有标签字段，因此此类特征 ID 集始终标记为'featureId_N'，其中 N 是所有特征 ID 列表中的索引，其中特征 ID 属性列在特征 ID 纹理之前。
如果 featureIdLabel 设置为整数 N，它会自动转换为字符串'featureId_N'。如果每个基元和每个实例的功能 ID 都存在，则实例功能 ID 优先。
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
heightReference : HeightReference
模型的高度参考，它决定了模型相对于地形的绘制方式。
-
Default Value:
{HeightReference.NONE}
拾取模型时返回的用户定义对象。
-
Default Value:
undefined
See:
imageBasedLighting : ImageBasedLighting
用于管理此模型上基于图像的照明的属性。
用于拾取和样式设置的实例特征 ID 集的标签。
如果 instanceFeatureIdLabel 设置为整数 N，它会自动转换为字符串'instanceFeatureId_N'。如果每个基元和每个实例的功能 ID 都存在，则实例功能 ID 优先。
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
为模型着色时的浅色。当
undefined
时，将使用场景的浅色。
通过设置
model.imageBasedLighting.imageBasedLightingFactor = new Cartesian2(0.0, 0.0)
禁用其他光源将使模型更暗。在这里，增加光源的强度将使模型更亮。
-
Default Value:
undefined
模型的最大比例大小。这可用于为
Model#minimumPixelSize
提供上限，确保模型永远不会是不合理的比例。
无论缩放如何，模型的近似最小像素大小。这可用于确保模型即使在查看器缩小时也是可见的。当
0.0
时，不强制执行最小大小。
-
Default Value:
0.0
pointCloudShading : PointCloudShading
用于控制点云衰减和照明的点云着色设置。对于 3D Tiles，这是从
Cesium3DTileset
继承的。
当为
true
时，此模型已准备好渲染，即下载了外部二进制文件、图像和着色器文件并创建了 WebGL 资源。在解决
ModelExperimental#readyPromise
之前将其设置为
true
。
-
Default Value:
false
readonly readyPromise : Promise.< ModelExperimental >
获取当该模型准备好渲染时将被解析的承诺，即当外部资源已下载并创建 WebGL 资源时。
这个承诺在模型渲染的第一帧之前的帧结束时解决。
-
Default Value:
1.0
确定模型是投射还是接收来自光源的阴影。
-
Default Value:
ShadowMode.ENABLED
是否渲染模型。
-
Default Value:
true
获取或设置模型的学分是否显示在屏幕上
-
Default Value:
false
silhouetteColor : Color
剪影颜色。
-
Default Value:
Color.RED
轮廓的大小（以像素为单位）。
-
Default Value:
0.0
splitDirection : SplitDirection
应用于此模型的
SplitDirection
。
-
Default Value:
SplitDirection.NONE
应用于模型中特征的样式。如果同时应用了
CustomShader
，则无法应用。
Methods
static Cesium.ModelExperimental.fromGltf (options) → ModelExperimental
从 glTF 资产创建模型。当模型准备好渲染时，即下载外部二进制文件、图像和着色器文件并创建 WebGL 资源时，
Model#readyPromise
被解析。
该模型可以是具有 .gltf 扩展名的传统 glTF 资产或使用 .glb 扩展名的二进制 glTF。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options
|
Object |
具有以下属性的对象:
|
Returns:
新创建的模型。
将任何修改后的发音阶段应用于参与任何发音的每个节点的矩阵。请注意，这将覆盖参与节点上的任何节点转换。
Throws:
-
DeveloperError : 模型未加载。使用 ModelExperimental.readyPromise 或等待 ModelExperimental.ready 为真。
销毁此对象持有的 WebGL 资源。销毁一个对象允许确定性地释放 WebGL 资源，而不是依赖垃圾收集器来销毁这个对象。
一旦一个对象被销毁，它就不应该被使用；调用
一旦一个对象被销毁，它就不应该被使用；调用
isDestroyed
以外的任何函数都将导致
DeveloperError
异常。因此，如示例中所做的那样，将返回值 (
undefined
) 分配给对象。
Throws:
-
DeveloperError : 该对象被销毁，即调用了destroy()。
Example:
model = model && model.destroy();See:
Returns:
如果此对象被销毁，则为
true
；否则，
false
。
设置清晰度阶段的当前值。设置一个或多个阶段值后，调用 ModelExperimental.applyArticulations() 以重新计算节点矩阵。
| Name | Type | Description |
|---|---|---|
articulationStageKey
|
String | 关节名称、空格和舞台名称。 |
value
|
Number | 关节的这个阶段的数值。 |
Throws:
-
DeveloperError : 模型未加载。使用 ModelExperimental.readyPromise 或等待 ModelExperimental.ready 为真。
Example:
// Sets the value of the stage named "MoveX" belonging to the articulation named "SampleArticulation"
model.setArticulationStage("SampleArticulation MoveX", 50.0);See:
Throws:
-
RuntimeError : 无法加载外部参考。