前端调用Cesium加载三维模型全攻略

2024-08-01 09:14:38 浏览数 (1)

想象一下,地球在你眼前旋转,上面还有各种3D模型,是不是很酷?Cesium是一个超酷的库,专门用来创建超炫的3D地球和地图。好,言归正传,今天这篇文章就分享一下前端如何使用Cesium加载三维模型。

# 一:准备工作

首先,确保你已经安装了Cesium库。可以从Cesium官网下载最新版本的库文件,或者使用npm进行安装:

```javascript

npm install cesium

或者

yarn add cesium

```

然后,找一个舒服的地方坐下,准备好开始你的3D之旅

# 二:加载模型

要加载一个3D模型,你需要知道模型在哪里,然后告诉Cesium去哪里找它。就像你告诉外卖小哥你的地址一样。然后,你就可以把这个模型加到你的地球上了!

```javascript

// 创建你的Cesium Viewer

let viewer = new Cesium.Viewer('cesiumContainer');

// 定义模型的坐标和大小

let modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(

Cesium.Cartesian3.fromDegrees(-75.628982, 40.028194),

new Cesium.HeadingPitchRoll()

);

// 定义模型的路径和其他选项

let modelOptions = {

uri: 'path/to/your/model.gltf',

scale: 1.0,

minimumPixelSize: 128,

maximumScale: 20000,

modelMatrix: modelMatrix

};

// 把模型加到场景里!

viewer.scene.primitives.add(new Cesium.Model(modelOptions));

```

我们首先创建了一个Cesium Viewer实例,然后定义了模型的路径和选项。其中,modelMatrix参数用于定义模型的变换矩阵,包括位置、方向、俯仰和偏航角度等。然后,我们使用new Cesium.Model()构造函数创建一个模型实例,并将模型添加到场景中。

当然别忘了把'path/to/your/model.gltf'替换成你自己的GLTF模型文件路径哦!如果你有Blender或者其他的3D建模软件,你可以导出为GLTF格式,然后放到你的项目里。建议用blender免费而且还比较好用。

# 三:交互和动画

当然,加载模型只是第一步。你还可以和模型互动哦!比如你可以给模型添加碰撞检测,这样你就可以知道哪些地方可以“撞”到模型。就像玩虚拟现实游戏一样!

首先,你需要定义一个碰撞器的形状和大小。然后,你可以把这个碰撞器加到场景里,和你的模型一起显示出来。就像给你的模型穿上盔甲一样!

```javascript

// 定义碰撞器的位置和尺寸

var boxGeometry = new Cesium.BoxGeometry({

length: 100000, // 长度(单位:米)

width: 100000, // 宽度(单位:米)

height: 100000 // 高度(单位:米)

});

var boxMaterial = new Cesium.Material({

fabric: {

type: 'Grid', // 使用网格材质类型

unlit: true // 不进行光照计算,仅显示碰撞器轮廓线

}

});

var boxPrimitive = new Cesium.Primitive({ // 创建碰撞器实体对象

geometryInstances: new Cesium.GeometryInstance({ // 定义碰撞器几何体实例

geometry: boxGeometry, // 使用BoxGeometry作为几何体类型

modelMatrix: modelMatrix, // 设置模型变换矩阵,使其与模型对齐

id: 'box' // 设置碰撞器标识符,方便后续查找和识别碰撞事件

}),

asynchronous: false, // 是否异步加载碰撞器几何体数据,这里选择同步加载以提高性能和效率

material: boxMaterial // 设置碰撞器材质属性,这里使用网格材质类型显示轮廓线效果

});

viewer.scene.primitives.add(boxPrimitive); // 将碰撞器添加到场景中显示出来。

```

# 四:其他api实例

就写几个我用到的吧。

**1.地理信息查询**

当你想要查找某个地点的具体信息时,可以使用Cesium的地理信息查询功能。例如,你可以通过经纬度坐标或地名来查询相关的地理信息

```javascript

viewer.geocoder.geocode({

text: '北京',

view: Cesium.ScreenSpaceEventType.LEFT_CLICK

}).then(function(results) {

// 查询成功,获取查询结果

var entity = results[0].entity;

console.log(entity); // 输出查询到的实体信息

});

```

**2.轨迹绘制**

如果你想要在地图上绘制轨迹,可以使用Cesium提供的轨迹绘制工具。通过定义一系列的经纬度坐标,你可以轻松地绘制出轨迹。

```javascript

// 定义轨迹的坐标点数组

var waypoints = [

Cesium.Cartesian3.fromDegrees(116.407, 39.904), // 北京

Cesium.Cartesian3.fromDegrees(121.473, 31.230), // 上海

Cesium.Cartesian3.fromDegrees(104.065, 30.574) // 成都

];

// 创建轨迹实体

var polyline = viewer.entities.add({

polyline: {

positions: waypoints,

width: 5,

material: Cesium.Color.RED,

leadTime: 0,

trailTime: 0

}

});

```

定义一个包含经纬度坐标的数组waypoints,表示轨迹上的点。然后,我们使用viewer.entities.add()方法创建了一个红色的轨迹实体,并将其添加到地图上。通过调整width参数可以改变轨迹的宽度,而leadTime和trailTime参数则分别控制轨迹的前导和尾迹时间

**3.地理编码**

如果你有一系列的地名或地址,并想要获取其对应的经纬度坐标,可以使用Cesium的地理编码功能。通过地理编码,你可以将地址转换为准确的坐标位置

```javascript

var viewer = new Cesium.Viewer('cesiumContainer');

var encodedAddress = '北京市朝阳区'; // 需要地理编码的地址或地名

var request = {

address : encodedAddress, // 地址或地名字符串

resource : 'address' // 地理编码资源类型,这里使用地址编码资源类型(address)进行示范。如果使用地名编码资源类型(geocode),需要传递地名相关的参数。例如:{ name : '北京' }。此外,还可以选择其他资源类型(例如:postalCode、intersection等)。具体可参考Cesium官方文档。

};

viewer.geocoder.geocode(request).then(function(results) {

// 地理编码成功,获取地理编码结果(包含经纬度坐标等)

var position = results[0].position; // 获取第一个结果的经纬度坐标位置信息,返回一个Cesium.Cartesian3对象。如果有多于一个结果,可以根据实际需求进行筛选或处理。例如:results[0].entity 等。可以参考Cesium官方文档了解更多关于地理编码结果的信息。使用经纬度坐标信息进行后续操作,例如:绘制标记点、添加轨迹等。

});

```

```

0 人点赞