Model

查阅Mars3D API

成员(属性)

默认值: true

默认值: true

默认值: undefined

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

默认值: 0.5

默认值: ColorBlendMode.HIGHLIGHT

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.

默认值: false

默认值: false

默认值: undefined

默认值: true

使用示例:

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

使用示例:

// 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

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.NONE}

默认值: undefined

参考:

• Scene#pick

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

默认值: 0.0

默认值: Matrix4.IDENTITY

使用示例:

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

默认值: Color.BLACK

默认值: false

默认值: 1.0

默认值: ShadowMode.ENABLED

默认值: true

默认值: false

默认值: true

默认值: Color.RED

默认值: 0.0

默认值: SplitDirection.NONE

方法

返回值:

Throws:

• RuntimeError : The model failed to load.
• RuntimeError : Unsupported glTF version.
• RuntimeError : Unsupported glTF Extension

使用示例s:

// 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 : This object was destroyed, i.e., destroy() was called.

使用示例:

model = model && model.destroy();

参考:

• Model#isDestroyed

返回值:

Throws:

• DeveloperError : The model is not loaded. Use Model.readyEvent or wait for Model.ready to be true.

Experimental

This feature is not final and is subject to change without Cesium's standard deprecation policy.

返回值:

Throws:

• DeveloperError : The model is not loaded. Use Model.readyEvent or wait for Model.ready to be true.

使用示例:

// 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);

返回值:

参考:

• Model#destroy

Throws:

• DeveloperError : The model is not loaded. Use Model.readyEvent or wait for Model.ready to be true.

使用示例:

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

参考:

• Model#applyArticulations

Throws:

• RuntimeError : Failed to load external reference.

定义的类型