Vue 3 + Three.js 实战:5分钟搞定TIFF地形渲染(附完整代码)

使用three.js/webgl实现简易地形 在three.js中使用mapbox地形瓦片的方法 阅读详情

Vue 3 + Three.js 实战:5分钟搞定TIFF地形渲染(附完整代码)

最近在做一个智慧城市项目,需要把无人机采集的高程数据实时呈现在Web端。甲方要求既要能三维立体展示地形起伏,又要能快速加载,最好还能和现有的Vue 3技术栈无缝集成。我一开始尝试用传统GIS平台,发现要么太重,要么定制化太麻烦。后来把目光转向了Three.js,配合Vue 3的响应式特性,居然在5分钟内就搞定了TIFF地形的渲染,效果还出奇的好。

如果你也在做类似的地理信息可视化项目,特别是需要处理DEM(数字高程模型)数据,那么这篇文章就是为你准备的。我会从零开始,手把手带你搭建一个完整的Vue 3 + Three.js项目,实现TIFF文件的快速加载、解析和三维渲染。整个过程不需要复杂的配置,也不需要依赖庞大的GIS框架,用最轻量的方式解决实际问题。

1. 环境搭建与项目初始化

1.1 创建Vue 3 + TypeScript项目

我习惯用Vite作为构建工具,它的启动速度和热更新体验都相当不错。打开终端,执行以下命令:

npm create vue@latest vue3-threejs-tiff

创建过程中,选择TypeScript、Vue Router和Pinia(可选),ESLint和Prettier根据个人习惯选择。项目创建完成后,进入目录并安装基础依赖:

cd vue3-threejs-tiff
npm install

1.2 安装Three.js核心依赖

Three.js是WebGL的封装库,让我们能用更简单的方式操作3D图形。安装核心包和类型定义:

npm install three
npm install -D @types/three

提示:虽然Three.js本身是用JavaScript写的,但@types/three提供了完整的TypeScript类型支持,能极大提升开发体验,避免低级错误。

1.3 安装TIFF处理库

TIFF文件格式比较复杂,特别是地理空间TIFF(GeoTIFF)还包含了坐标系统、高程值等元数据。我们需要专门的库来解析:

npm install geotiff
npm install -D @types/geotiff

geotiff是目前最成熟的JavaScript TIFF解析库,支持多波段、压缩、坐标系等特性。对于DEM数据,它还能直接提取高程矩阵,非常方便。

1.4 项目结构设计

在开始编码前,先规划一下项目结构。我的习惯是这样的:

src/
├── components/
│   ├── TerrainViewer.vue    # 主渲染组件
│   └── ControlPanel.vue     # 控制面板组件
├── utils/
│   ├── tiffLoader.ts        # TIFF文件加载器
│   └── terrainGenerator.ts  # 地形生成器
├── assets/
│   └── dem/                 # 存放TIFF文件
└── views/
    └── HomeView.vue         # 主页面

这种结构清晰明了,业务逻辑和工具函数分离,后期维护起来也方便。

2. TIFF文件解析与数据提取

2.1 理解DEM TIFF的数据结构

在开始写代码之前,有必要了解一下DEM TIFF文件里到底存了什么。DEM(Digital Elevation Model)本质上是一个二维矩阵,每个像素值代表该位置的海拔高度。比如一个1000×1000的TIFF文件,就有100万个高程点。

地理空间TIFF比普通图片TIFF多了几个关键信息:

  • 地理变换参数(GeoTransform):定义了像素坐标如何映射到真实世界坐标
  • 坐标系(CRS):比如WGS84、UTM等
  • NoData值:表示无效数据的特殊值
// 一个典型的地理变换参数数组
const geoTransform = [
  topLeftX,   // 左上角X坐标
  pixelWidth, // 像素宽度(经度方向)
  0,          // 旋转参数(通常为0)
  topLeftY,   // 左上角Y坐标
  0,          // 旋转参数(通常为0)
  -pixelHeight // 像素高度(纬度方向,通常为负值)
];

2.2 实现TIFF加载器

创建src/utils/tiffLoader.ts文件,实现TIFF文件的加载和解析:

import { fromUrl, fromBlob, GeoTIFF } from 'geotiff';

export interface TerrainData {
  width: number;
  height: number;
  elevation: Float32Array;  // 高程数据
  bounds: {
    minX: number;
    maxX: number;
    minY: number;
    maxY: number;
  };
  noDataValue: number | null;
}

export class TiffLoader {
  /**
   * 从URL加载TIFF文件
   */
  static async loadFromUrl(url: string): Promise<TerrainData> {
    try {
      const tiff = await fromUrl(url);
      const image = await tiff.getImage();
      
      // 读取栅格数据
      const raster = await image.readRasters();
      const elevation = raster[0] as Float32Array;
      
      // 获取地理信息
      const bbox = image.getBoundingBox();
      const geoKeys = image.getGeoKeys();
      
      return {
        width: image.getWidth(),
        height: image.getHeight(),
        elevation,
        bounds: {
          minX: bbox[0],
          minY: bbox[1],
          maxX: bbox[2],
          maxY: bbox[3]
        },
        noDataValue: geoKeys.GDAL_NODATA || null
      };
    } catch (error) {
      console.error('TIFF加载失败:', error);
      throw error;
    }
  }
  
  /**
   * 从文件对象加载TIFF
   */
  static async loadFromFile(file: File): Promise<TerrainData> {
    const arrayBuffer = await file.arrayBuffer();
    const tiff = await fromBlob(new Blob([arrayBuffer]));
    return this.loadFromGeoTIFF(tiff);
  }
  
  /**
   * 数据归一化处理
   * 将高程值映射到0-1范围,便于Three.js渲染
   */
  static normalizeElevation(data: TerrainData): {
    normalized: Float32Array;
    min: number;
    max: number;
  } {
    let min = Infinity;
    let max = -Infinity;
    
    // 找出有效数据的最大最小值
    for (let i = 0; i < data.elevation.length; i++) {
      const value = data.elevation[i];
      if (data.noDataValue !== null && value === data.noDataValue) {
        continue;
      }
      if (value < min) min = value;
      if (value > max) max = value;
    }
    
    // 归一化到0-1
    const normalized = new Float32Array(data.elevation.length);
    const range = max - min;
    
    for (let i = 0; i < data.elevation.length; i++) {
      const value = data.elevation[i];
      if (data.noDataValue !== null && value === data.noDataValue) {
        normalized[i] = 0;
      } else {
        normalized[i] = (value - min) / range;
      }
    }
    
    return { normalized, min, max };
  }
}

这个加载器做了几件重要的事情:

  1. 解析TIFF文件的栅格数据和地理信息
  2. 处理NoData值(无效数据点)
  3. 提供数据归一化方法,方便后续渲染

2.3 处理大型TIFF文件的技巧

实际项目中经常会遇到几百MB甚至GB级别的TIFF文件,直接全部加载到内存肯定不行。这里有几个优化技巧:

分块加载策略:

// 只加载感兴趣区域(ROI)
async function loadRegion(url: string, bbox: number[]) {
  const tiff = await fromUrl(url);
  const image = await tiff.getImage();
  
  // 计算像素范围
  const [minX, minY, maxX, maxY] = bbox;
  const width = Math.ceil((maxX - minX) / image.getResolution()[0]);
  const height = Math.ceil((maxY - minY) / image.getResolution()[1]);
  
  // 读取指定区域
  const window = [minX, minY, maxX, maxY];
  const raster = await image.readRasters({ window });
  
  return raster;
}

金字塔层级(LOD)处理: 对于超大型文件,可以预先生成多个分辨率版本,根据视图距离动态切换。虽然geotiff库本身支持多分辨率TIFF,但更常见的做法是在服务端预处理。

Web Worker异步处理: 把耗时的TIFF解析放到Web Worker中,避免阻塞主线程:

// 在主线程中
const worker = new Worker('./tiffWorker.js');
worker.postMessage({ type: 'load', url: 'terrain.tif' });
worker.onmessage = (event) => {
  const terrainData = event.data;
  // 更新Three.js场景
};

// 在Web Worker中
importScripts('https://unpkg.com/geotiff/dist-browser/geotiff.js');
// ... 处理TIFF解析

3. Three.js地形网格生成

3.1 从高程数据到三维网格

有了高程数据,下一步就是把它变成Three.js能渲染的几何体。最常用的方法是创建PlaneGeometry,然后根据高程值调整每个顶点的高度:

import * as THREE from 'three';

export class TerrainGenerator {
  /**
   * 生成地形几何体
   */
  static createTerrainGeometry(
    elevation: Float32Array,
    width: number,
    height: number,
    options: {
      maxHeight?: number;      // 最大高度缩放
      widthSegments?: number;  // 宽度分段数
      heightSegments?: number; // 高度分段数
    } = {}
  ): THREE.BufferGeometry {
    const {
      maxHeight = 100,
      widthSegments = width - 1,
      heightSegments = height - 1
    } = options;
    
    // 创建平面几何体
    const geometry =
【一览无余】Vue框架下Cesium加载遥感地图使用GeoServer切割TIF大文件对外发布WMS服务进行地图绘制(科普篇1/2) Shapefile文件属于矢量数据。与栅格数据不同,矢量数据以点、线、面等几何要素的形式来表示地理现象,具有精度高、数据量小、易于编辑和更新等优点,可以精确表示地理现象的形状、位置、方向等信息。需要注意的是,虽然Shapefile文件可以包含地理坐标系和投影信息等元数据,但它本身并不具备栅格数据的特性,不能用于存储连续的地理现象,如高程、气温、降雨量等。遥感数据是通过卫星、飞机等遥感平台获取的,具有广阔的覆盖范围、高精度和多时相等特点,可以提供多种地表信息,如地形、植被、土地利用、水体等。 阅读详情

相关推荐

three-tile: 从头编写一套三维瓦片地图框架,大家是否有兴趣?

对标cesium,从头写一套三维瓦片地图框架,大家是否有兴趣?

老郭的专栏 3541

260:vue+openlayers 通过webgl方式加载矢量图层

本示例介绍如何在vue+openlayers中通过webgl方式加载矢量图层。在做这个示例的时候,采用vite的方式而非webpack的方式。这里的基础设置需要改变一下。 ol的版本7.5.2或者更高。

大剑师兰特的GIS世界 1862

258:vue+openlayers加载mapbox-style的地图

本示例的目的是介绍演示如何在vue+openlayers中添加mapbox地图,跟之前的不同处理方式是,这里采用了ol-mapbox-style插件来加载mapbox地图。具体请参考源代码和API。

大剑师兰特的GIS世界 874

218:vue+openlayers 加载geotiff文件,显示图形

第218个本示例的目的是介绍演示如何在vue+openlayers中加载geotiff文件,显示图形,具体的加载方式参考源代码。这里的tif文件有25MB多,加载出来的时间会有点小长。

大剑师兰特的GIS世界 2765

Three.js实现逼真的3D地形与水体效果

Three.js 是一个基于WebGL的JavaScript库,它简化了在浏览器中创建和显示3D图形的过程。Three.js 凭借其简洁的API和丰富的功能集合,在WebGL之上建立了一个更加容易理解和操作的3D图形层。将理论知识应用到实际的3D项目中时,需要考虑地形的规模、细节级别和性能优化等多个方面。例如,在一个大型的开放世界游戏中,可能需要生成数公里范围的复杂地形,同时要保持稳定的帧率和流畅的用户交互体验。这不仅需要精心设计的地形生成逻辑,还需要灵活运用各种优化技术。创建基础网格,使用。

weixin_42181686的博客 1456

geo-three:基于Threejs的基于图块的地理世界地图可视化库

地理三 用于使用three.js显示地图的three.js 。 允许使用基于图块的块对地理数据进行全球范围的可视化。 可以使用软件生成的图块或GPU位移图根据地形高度数据为地形生成3D几何。 支持多个地图服务提供商( , , , , , , )。 这些地图提供者中的每一个都需要使用开发者帐户和API配置。 使用MapProvider接口可以实现新的提供。 提供者应具有要由图书馆支持的基于图块的地图系统。 您可以从GitHub页面的。 用法 要将库添加到您的项目中,请通过NPM和three.js一起获取库,并将其用作ES模块。 您也可以直接在您的网页中包含该库,但首先请确保三个在全球可用。 // Create a map tiles provider object var provider = new OpenStreetMapsProvider ( ) ;

ShanHeShui:使用threejs的地形和水

山河水 使用threejs的地形和水

RK3588上rknn_toolkit_lite2报错解决:手把手教你更新librknnrt.so的正确姿势

本文针对在RK3588平台上使用rknn_toolkit_lite2时遇到的“Invalid RKNN model version”等常见错误,提供了完整的诊断与解决方案。文章深入剖析了RKNN生态系统各组件(如librknnrt.so、RKNN Server)版本不兼容的根源,并手把手指导如何安全、正确地更新librknnrt.so运行时库,确保AI模型在RK3588 NPU上实现高效推理。

weixin_29189003的博客 522

DPABINet保姆级教程:零代码完成脑网络分析与图论计算

本文提供DPABINet的零代码脑网络分析全流程指南。该工具通过图形化界面集成时间序列提取、连接矩阵构建、图论指标计算及统计分析,大幅降低技术门槛。重点解析了阈值选择、二值化与小世界属性计算等关键步骤,帮助研究者快速掌握脑网络分析与图论计算,提升科研效率与可重复性。

j2k3l4的博客 674

SpringBoot实现电子发票生成

电子发票是近年来比较流行的一种票据形式,它取代了以往传统的纸质发票,具有减少纸张浪费、方便有效查验等优点。本文将介绍如何使用Spring Boot和Vue.js构建一个仿真电子发票生成应用程序,借助微信二维码扫描功能和第三方库,实现用户扫描二维码获取发票信息并填写相关开票信息,最后生成电子发票。在本文中,我们介绍了如何使用Spring Boot和Vue.js构建一个仿真电子发票生成应用程序,借助微信二维码扫描功能和第三方库,实现用户扫描二维码获取发票信息并填写相关开票信息,最后生成电子发票。

不愧是暮言的博客 6094

第十六届蓝桥杯大赛软件赛(编程类)知识点大纲

难度:[1-3]难度:[1-5]难度:[1-3]难度:[2-5]难度:[1-5]

Future_yzx的博客 4115

C语言|深入浅出讲解int转换为float全过程(附2017年统考大题案例)

int转换为float类型为什么会发生精度损失? 精度损失的详细过程究竟是什么样的? 什么样情况float会发生精度损失?没有弄懂2017年浮点数统考大题? 这一篇用2017年统考大题案例帮你更深的理解浮点数的存储规则。

DADONGOOO的博客 1万+

让 RAP 弹窗参数真正变成必填:Excel Upload Action 的两种实现路径

摘要 在RAP应用中,action弹窗参数经常缺乏必填校验,导致用户体验差。本文提出两种解决方案:1)在action实现中手动校验,简单但交互不流畅;2)通过root abstract entity和abstract BDEF建模,利用field(mandatory)实现框架级校验,推荐此长期方案。后者将约束集中到模型层,使UI与执行期校验一致,特别适合ABAP Cloud环境。以Excel导入为例,强制填写备注和明确选择试运行,可避免审计问题,提升系统可靠性。

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 200

【FPGA教程案例89】编译码2——使用vivado核实现RS信道编译码

RS编码,又称里所码,即Reed-solomon codes,是一种前向纠错的信道编码,对由校正过采样数据所产生的多项式有效。当接收器正确的收到足够的点后,它就可以恢复原来的多项式,即使接收到的多项式上有很多点被噪声干扰失真。

FPGA/MATLAB学习教程/源码/项目合作开发 3545

Spring AI Alibaba实战训练营-13语音生成应用开发指南

本文介绍了如何基于Spring AI Alibaba创建DashScope语音应用,支持文本转语音(TTS)和语音转文本(STT)功能。主要内容包括:1)环境准备要求Java 17+、Maven 3.6+及阿里云DashScope API Key;2)通过Spring Initializr创建项目并配置相关依赖;3)设置API密钥的安全配置方法;4)实现语音合成的同步和流式功能,包括创建控制器类、调用API接口及保存语音文件。文章提供了详细的代码示例和配置说明,帮助开发者快速搭建语音处理应用。

program哲学 406

最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版

Part-E1-SDIO-Specification-Ver4.00-Final-120220.pdf:最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版,包括SDIO 接口的外设,SDIO 接口官方协议等。

迈瑞BS系列全自动生化分析仪LIS协议接口手册(内含HL7和ASTM)

迈瑞BS系列全自动生化分析仪LIS协议接口手册,内含HL7和ASTM)

假人有限元模型

假人模型,车辆碰撞假人有限元模型,适合做乘员安全的研究者利用

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

上一篇: Node.js包管理器全攻略:在Debian 12上同时配置npm/yarn/pnpm/cnpm的正确姿势
下一篇: SQL Server数据库镜像实战:从零配置到故障转移(附常见问题排查)
随身带U盘
博客等级 码龄4年 31粉丝 1526原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值