指南

概述

Fantasy 3D是基于three.js开发的三维可视化解决方案，采用ECS（Entity Component System）架构，使用Typescript编写。通过Fantasy 3D提供的渲染、动画、物理和交互功能，可以在浏览器中创建出绚丽的3D可视化应用。该解决方案适用于数字孪生、数字城市、数字工厂、三维GIS、创意广告等多个领域的可视化开发。

组成

Fantasy 3D由以下几个功能模块组成：

功能包	描述	状态	API
@fantasy3d/core	核心架构逻辑和核心功能	开发中	API
@fantasy3d/addons	非核心功能和偏业务逻辑定制功能	开发中	API
@fantasy3d/postprocessing	基于postprocessing封装的后期效功能	开发中	API
@fantasy3d/particlesystem	可配置粒子系统	开发中	API
@fantasy3d/physics	物理引擎	规划中	API
@fantasy3d/gis	GIS可视化功能	规划中	API

使用

开发时必须安装@fantasy3d/core模块，其它功能模块根据需求选择安装。

npm

// 安装核心包
npm i @fantasy3d/core

// 安装插件包
npm i @fantasy3d/addons

yarn

// 安装核心包
yarn add @fantasy3d/core

// 安装插件包
yarn add @fantasy3d/addons

注意

由于three.js被当做peerDependencies依赖，而yarn不会自动安装peerDependencies中的依赖， 所以需要手动安装three.js依赖且版本需要>=0.168.0。

yarn add three@0.168.0

鸣谢

Fantasy 3D开发过程中除了使用three.js，也参考借鉴了其它一些开源项目，在此特表感谢（排名不分先后）：

• three.js

• postprocessing

• drei

• troika

• galacean