Model

成员 Members

默认值： Default Value: true

默认值： Default Value: true

默认值： Default Value: undefined

实验性 Experimental

此功能使用的是 3D Tiles 规范的一部分，该规范不是最终版本，并且可能会在没有 Cesium 的标准弃用政策的情况下进行更改。 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.

默认值： Default Value: undefined

默认值： Default Value: 0.5

默认值： Default Value: ColorBlendMode.HIGHLIGHT

实验性 Experimental

此功能使用的是 3D Tiles 规范的一部分，该规范不是最终版本，并且可能会在没有 Cesium 的标准弃用政策的情况下进行更改。 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.

默认值： Default Value: false

默认值： Default Value: false

默认值： Default Value: undefined

默认值： Default Value: true

示例： Example:

// Exaggerate terrain by a factor of 2, but prevent model exaggeration
scene.verticalExaggeration = 2.0;
model.enableVerticalExaggeration = false;

示例： Example:

// Change the ground color used for a model's environment map to a forest green
const environmentMapManager = model.environmentMapManager;
environmentMapManager.groundColor = Cesium.Color.fromCssColorString("#203b34");

实验性 Experimental

此功能使用的是 3D Tiles 规范的一部分，该规范不是最终版本，并且可能会在没有 Cesium 的标准弃用政策的情况下进行更改。 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.

默认值： Default Value: {HeightReference.NONE}

默认值： Default Value: undefined

另见： See:

• Scene#pick

实验性 Experimental

此功能使用的是 3D Tiles 规范的一部分，该规范不是最终版本，并且可能会在没有 Cesium 的标准弃用政策的情况下进行更改。 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.

默认值： Default Value: undefined

默认值： Default Value: 0.0

默认值： Default Value: Matrix4.IDENTITY

示例： Example:

const origin = Cesium.Cartesian3.fromDegrees(-95.0, 40.0, 200000.0);
m.modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(origin);

默认值： Default Value: Color.BLACK

默认值： Default Value: false

默认值： Default Value: 1.0

默认值： Default Value: ShadowMode.ENABLED

默认值： Default Value: true

默认值： Default Value: false

默认值： Default Value: true

默认值： Default Value: Color.RED

默认值： Default Value: 0.0

默认值： Default Value: SplitDirection.NONE

方法 Methods

返回： Returns:

抛出： Throws:

• RuntimeError : The model failed to load.
• RuntimeError : 不支持的 glTF 版本。 : Unsupported glTF version.
• RuntimeError : 不支持 glTF 扩展 : Unsupported glTF Extension

示例： Examples:

// Load a model and add it to the scene
try {
 const model = await Cesium.Model.fromGltfAsync({
   url: "../../SampleData/models/CesiumMan/Cesium_Man.glb"
 });
 viewer.scene.primitives.add(model);
} catch (error) {
 console.log(`Failed to load model. ${error}`);
}

// Position a model with modelMatrix and display it with a minimum size of 128 pixels
const position = Cesium.Cartesian3.fromDegrees(
  -123.0744619,
  44.0503706,
  5000.0
);
const headingPositionRoll = new Cesium.HeadingPitchRoll();
const fixedFrameTransform = Cesium.Transforms.localFrameToFixedFrameGenerator(
  "north",
  "west"
);
try {
 const model = await Cesium.Model.fromGltfAsync({
   url: "../../SampleData/models/CesiumAir/Cesium_Air.glb",
   modelMatrix: Cesium.Transforms.headingPitchRollToFixedFrame(
     position,
     headingPositionRoll,
     Cesium.Ellipsoid.WGS84,
     fixedFrameTransform
   ),
   minimumPixelSize: 128,
 });
 viewer.scene.primitives.add(model);
} catch (error) {
 console.log(`Failed to load model. ${error}`);
}

// Load a model and play the last animation at half speed
let animations;
try {
 const model = await Cesium.Model.fromGltfAsync({
   url: "../../SampleData/models/CesiumMan/Cesium_Man.glb",
   gltfCallback: gltf => {
     animations = gltf.animations
   }
 });
 viewer.scene.primitives.add(model);
 model.readyEvent.addEventListener(() => {
   model.activeAnimations.add({
     index: animations.length - 1,
     loop: Cesium.ModelAnimationLoop.REPEAT,
     multiplier: 0.5,
   });
 });
} catch (error) {
 console.log(`Failed to load model. ${error}`);
}

抛出： Throws:

• DeveloperError : 模型未加载。使用 Model.readyEvent 或等待 Model.ready 为 true。 : The model is not loaded. Use Model.readyEvent or wait for Model.ready to be true.

抛出： Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

示例： Example:

model = model && model.destroy();

另见： See:

• Model#isDestroyed

返回： Returns:

抛出： Throws:

• DeveloperError : 模型未加载。使用 Model.readyEvent 或等待 Model.ready 为 true。 : The model is not loaded. Use Model.readyEvent or wait for Model.ready to be true.

实验性 Experimental

此功能不是最终版本，可能会在没有 Cesium 标准弃用政策的情况下进行更改。 This feature is not final and is subject to change without Cesium's standard deprecation policy.

返回： Returns:

抛出： Throws:

• DeveloperError : 模型未加载。使用 Model.readyEvent 或等待 Model.ready 为 true。 : The model is not loaded. Use Model.readyEvent or wait for Model.ready to be true.

示例： Example:

// Apply non-uniform scale to node "Hand"
const node = model.getNode("Hand");
node.matrix = Cesium.Matrix4.fromScale(new Cesium.Cartesian3(5.0, 1.0, 1.0), node.matrix);

返回： Returns:

另见： See:

• Model#destroy

抛出： Throws:

• DeveloperError : 模型未加载。使用 Model.readyEvent 或等待 Model.ready 为 true。 : The model is not loaded. Use Model.readyEvent or wait for Model.ready to be true.

示例： Example:

// Sets the value of the stage named "MoveX" belonging to the articulation named "SampleArticulation"
model.setArticulationStage("SampleArticulation MoveX", 50.0);

另见： See:

• Model#applyArticulations

抛出： Throws:

• RuntimeError : 加载外部参考失败。 : Failed to load external reference.

类型定义 Type Definitions