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:

// 加载模型并将其添加到场景中
try {
 const model = await Cesium.Model.fromGltfAsync({
   url: "../../SampleData/models/CesiumMan/Cesium_Man.glb"
 });
 viewer.scene.primitives.add(model);
} catch (error) {
 console.log(`加载模型失败。${error}`);
}

// 使用 modelMatrix 定位模型并以 128 像素的最小尺寸显示它
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(`加载模型失败。${error}`);
}

// 加载模型并以半速播放最后一个动画
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(`加载模型失败。${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 : 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:

Throws:

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

Example:

// 对节点 "Hand" 应用非均匀缩放
const node = model.getNode("Hand");
node.matrix = Cesium.Matrix4.fromScale(new Cesium.Cartesian3(5.0, 1.0, 1.0), node.matrix);

Throws:

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

Example:

// 设置属于名为 "SampleArticulation" 的铰接的名为 "MoveX" 的阶段的值
model.setArticulationStage("SampleArticulation MoveX", 50.0);

See:

• Model#applyArticulations

Throws:

• RuntimeError : 加载外部引用失败。

Type Definitions