Model

Members

Default Value: true

Default Value: true

Default Value: undefined

Experimental

此功能使用的是 3D Tiles 规范的一部分，该规范不是最终版本，并且可能会在没有 Cesium 标准弃用策略的情况下进行更改。

Default Value: undefined

Default Value: 0.5

Default Value: ColorBlendMode.HIGHLIGHT

Experimental

此功能使用的是 3D Tiles 规范的一部分，该规范不是最终版本，并且可能会在没有 Cesium 标准弃用策略的情况下进行更改。

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:

// 将用于模型环境贴图的地面颜色更改为森林绿色
const environmentMapManager = model.environmentMapManager;
environmentMapManager.groundColor = Cesium.Color.fromCssColorString("#203b34");

Experimental

此功能使用的是 3D Tiles 规范的一部分，该规范不是最终版本，并且可能会在没有 Cesium 标准弃用策略的情况下进行更改。

Default Value: {HeightReference.NONE}

Default Value: undefined

See:

• Scene#pick

Experimental

此功能使用的是 3D Tiles 规范的一部分，该规范不是最终版本，并且可能会在没有 Cesium 标准弃用策略的情况下进行更改。

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 : Unsupported glTF version.
• RuntimeError : 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 : The model is not loaded. Use Model.readyEvent or wait for Model.ready to be true.

Throws:

• DeveloperError : 这个物体被摧毁了,destroy().

Example:

model = model && model.destroy();

See:

• Model#isDestroyed

Returns:

Throws:

• DeveloperError : 模型未加载。使用 Model.readyEvent 或等待 Model.ready 为 true。

Experimental

此功能不是最终的，在没有 Cesium 的标准弃用政策的情况下可能会发生变化。

Returns:

Throws:

• DeveloperError : 模型未加载。 使用 Model.readyEvent 或等待 Model.ready 为 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 : 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