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:

// 将地形夸大 2 倍，但防止模型夸大
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 : 模型加载失败。
• RuntimeError : 不支持的 glTF 版本。
• RuntimeError : 不支持的 glTF 扩展。

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。

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 : 模型尚未加载。请使用 Model.readyEvent 或等待 Model.ready 为 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 : 加载外部引用失败。

Type Definitions