# 🧊🧊🧊 TvT.js 🧊🧊🧊
简体中文 | [English](./README.md)
## 🎉🎉🎊 三维可视化项目快速落地的开源框架 🎊🎉🎉

<p align="center">
		<a target="_black" href="https://space.bilibili.com/410503457">
			 <img alt="bilibili" src="https://img.shields.io/badge/dynamic/json?url=https://api.bilibili.com/x/relation/stat?vmid=410503457&query=data.follower&color=282c34&label=冰哥B站&labelColor=FE7398&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAGAAAABgCAYAAADimHc4AAAD7ElEQVR4nO2dW9WrMBCFK6ESkFAJSKiESqgEHCABCZWAhEpAAhL2ecik5dDc%2FpXLBDLfWnlqy0xmJ5BMQnq5CIIgCIIgCIIgCIIgCEIBAHQAemYfrgCunD6wAKAHsEKxALgx+bCQD8%2FS9tmgVqeDr1lLigDgZvDhXso+K9TyTBQRwRJ8AHjntl0Flh5QRAQK%2FmKxPeayWx2OXpBNBKiHvi34b7T2MC4pAvW6twR%2FRwkRKPizBN8CgEcuESj4Lwm+BwBjahEk+H8EwJRKhOaCDzW8e1JLfkUUH1NgmR3XmHffHR1l+72BSs8d7w8U+JDAnZERQMcV+CtUi7dNqFqibB4J7vtrq7xKCuAasbTMXCL4T+5aVk6+2xHUrWdhruAR6HIJcOeu2UHI8zyAe2ytWfEdWz9PVvQ8YAmIQ5dDAB9LFsMVAv8oMO2zAGrC5WNIarRiAuKR9jYEd9pY08aa6uUzIHGRdkgKd8pY0yc1WjEBAqypDYoAG0QAZkQAZkQAZkQAZk4vANQenjsSzS3I%2FwcSbXU5jQBUkRtdf4Rar90v8kSv3+I3ffCCSpk8I%2Fw+lgDkdI%2Fv2rEp2CaiWm1AsDQLlDAD+dlFXLMeAaCSeLZdaSFE5VUQNot38cKuEeBgAsSuG0flVZBmEanbXfNQAsS0fgBYIn2fIu3%2FBBMHEyBmDXlFfA8IzeHb+Ems4WAChKykrVA9ZfsQTL57jXzRg4A5wC%2FA8N4ADiZAZwm2XjW75Qh2KOTfA0p4kygPw28OJcCVgn3nDnYo2EwEYRgGH0qAMyICMCMCMCMCMCMCMCMCMCMCfP3qwHDOQ4AAUekTk8FaBRihJnZdYbvtCGC7LvmkM63GjVDINPFrQgCq5ETXfmMzI90FXzPvfqt7x4rEu%2FZaEcCUxFvgz2zO+BUn6UkoaEEAsptiMSX5e8FoRYCN7cVgb4Vq7U%2FH50Pq4JNP7Qiw8UFnJwcK+tXy+Wj6PLEvPgHSHv5UgwA1IQIwwyFAyLJin9RoxYgAzAQIkPwNmf26busC+OIx5TDqo5nDT+F%2FSS%2F9CYzwb+No49zNy2evkYv0LywGGAXUvp6eSneycqOic0w20k7CNgKE7jJunSGLACTCxF27ylmQc98T5MQUH49swd+I0HPXslLKnT0N+wnkrTKi9JZL%2FL9i1SorMmdeQ4TQQ7OFMxIMzGD45w8nUL1im7efENZLJpgPSw0pfz0cdt4U3230Td%2FTvx2R6d2FrHhEWLkq5PELOMsRPHCPnAZGv1xJteL7jbJiaW3sB2nDvPC%2FosSYvjRQz4cJ6n7KO3rYQL7M+L6nVtfDVRAEQRAEQRAEQRAEIZ5%2FSAXmdfXaoQsAAAAASUVORK5CYII%3D&cacheSeconds=3600">
		</a>
		<a href="https://github.com/hawk86104/three-vue-tres" target="_blank">
			<img src="https://img.shields.io/github/stars/hawk86104/three-vue-tres" />
		</a>
		<img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/hawk86104/three-vue-tres">
		<img src="https://img.shields.io/github/license/hawk86104/three-vue-tres" />
		<a target="_black" href="https://gitee.com/ice-gl/icegl-three-vue-tres">
			<img src="https://gitee.com/ice-gl/icegl-three-vue-tres/badge/star.svg?theme=dark" alt="gitee-starts" />
		</a>
			<a target="_black" href="https://gitcode.com/hawk86104/icegl-three-vue-tres">
			<img src="https://gitcode.com/hawk86104/icegl-three-vue-tres/star/badge.svg?theme=dark" alt="gitcode-starts" />
		</a>
		<a target="_black" href="https://space.bilibili.com/384558900">
			 <img alt="bilibili" src="https://img.shields.io/badge/dynamic/json?url=https://api.bilibili.com/x/relation/stat?vmid=384558900&query=data.follower&color=282c34&label=地虎B站&labelColor=FE7398&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAGAAAABgCAYAAADimHc4AAAD7ElEQVR4nO2dW9WrMBCFK6ESkFAJSKiESqgEHCABCZWAhEpAAhL2ecik5dDc%2FpXLBDLfWnlqy0xmJ5BMQnq5CIIgCIIgCIIgCIIgCEIBAHQAemYfrgCunD6wAKAHsEKxALgx+bCQD8%2FS9tmgVqeDr1lLigDgZvDhXso+K9TyTBQRwRJ8AHjntl0Flh5QRAQK%2FmKxPeayWx2OXpBNBKiHvi34b7T2MC4pAvW6twR%2FRwkRKPizBN8CgEcuESj4Lwm+BwBjahEk+H8EwJRKhOaCDzW8e1JLfkUUH1NgmR3XmHffHR1l+72BSs8d7w8U+JDAnZERQMcV+CtUi7dNqFqibB4J7vtrq7xKCuAasbTMXCL4T+5aVk6+2xHUrWdhruAR6HIJcOeu2UHI8zyAe2ytWfEdWz9PVvQ8YAmIQ5dDAB9LFsMVAv8oMO2zAGrC5WNIarRiAuKR9jYEd9pY08aa6uUzIHGRdkgKd8pY0yc1WjEBAqypDYoAG0QAZkQAZkQAZkQAZk4vANQenjsSzS3I%2FwcSbXU5jQBUkRtdf4Rar90v8kSv3+I3ffCCSpk8I%2Fw+lgDkdI%2Fv2rEp2CaiWm1AsDQLlDAD+dlFXLMeAaCSeLZdaSFE5VUQNot38cKuEeBgAsSuG0flVZBmEanbXfNQAsS0fgBYIn2fIu3%2FBBMHEyBmDXlFfA8IzeHb+Ems4WAChKykrVA9ZfsQTL57jXzRg4A5wC%2FA8N4ADiZAZwm2XjW75Qh2KOTfA0p4kygPw28OJcCVgn3nDnYo2EwEYRgGH0qAMyICMCMCMCMCMCMCMCMCMCMCfP3qwHDOQ4AAUekTk8FaBRihJnZdYbvtCGC7LvmkM63GjVDINPFrQgCq5ETXfmMzI90FXzPvfqt7x4rEu%2FZaEcCUxFvgz2zO+BUn6UkoaEEAsptiMSX5e8FoRYCN7cVgb4Vq7U%2FH50Pq4JNP7Qiw8UFnJwcK+tXy+Wj6PLEvPgHSHv5UgwA1IQIwwyFAyLJin9RoxYgAzAQIkPwNmf26busC+OIx5TDqo5nDT+F%2FSS%2F9CYzwb+No49zNy2evkYv0LywGGAXUvp6eSneycqOic0w20k7CNgKE7jJunSGLACTCxF27ylmQc98T5MQUH49swd+I0HPXslLKnT0N+wnkrTKi9JZL%2FL9i1SorMmdeQ4TQQ7OFMxIMzGD45w8nUL1im7efENZLJpgPSw0pfz0cdt4U3230Td%2FTvx2R6d2FrHhEWLkq5PELOMsRPHCPnAZGv1xJteL7jbJiaW3sB2nDvPC%2FosSYvjRQz4cJ6n7KO3rYQL7M+L6nVtfDVRAEQRAEQRAEQRAEIZ5%2FSAXmdfXaoQsAAAAASUVORK5CYII%3D&cacheSeconds=3600">
		</a>
</p>

## 🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊🧊

```shell
如果对您有帮助，您可以点右上角 “Star⭐” 收藏一下 ，您的star就是我开发的动力，感谢！
```

> B 站上对此项目的视频说明点击下方 👇🏻 跳转

<a style="display:block;width:800px;max-width:100%;" href="https://www.bilibili.com/video/BV1mfCcYeE9E"><img src="./preview/bilibili.gif" alt="tres.js webgl three.js"></a>

# 生态 `@ThreeJS @Vue3.x @TresJS`

> icegl 出品，永久开源且免费商用，持续更新 ing，请点击右上角 start⭐ 关注

本项目融合于三大生态系统中：

-   🎲 ThreeJS \* [点击详情](https://threejs.org)
		<a href="https://www.npmjs.com/package/three">
		<img src="https://img.shields.io/npm/v/three?label=three">
		</a>
		ThreeJS 大名鼎鼎的基于浏览器渲染，JavaScript 语言的 3D 库。<br/><br/>

-   🍀 Vue3.x \* [点击详情](https://cn.vuejs.org)
		<a href="https://www.npmjs.com/package/vue">
		<img src="https://img.shields.io/npm/v/vue?label=vue&color=%2342b883">
		</a>
		易学易用，性能出色，适用场景丰富的 Web 前端框架。<br/><br/>

-   ⚡ TresJS \* [点击详情](https://tresjs.org)
		<a href="https://www.npmjs.com/package/@tresjs/core">
		<img src="https://img.shields.io/npm/v/@tresjs/core?color=%2382DBCA&label=%40tresjs%2Fcore&logo=data:image/svg%2bxml;base64,PHN2ZyB3aWR0aD0iMzIiIGhlaWdodD0iMzIiIHZpZXdCb3g9IjAgMCAzMiAzMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTExLjY4NTQgMy40MjkxNkMxMi4wNzM4IDIuNzgxODIgMTMuMDEyIDIuNzgxODIgMTMuNDAwNCAzLjQyOTE1TDE5LjE3NzEgMTMuMDU2OUMxOS41NzcgMTMuNzIzNSAxOS4wOTY5IDE0LjU3MTQgMTguMzE5NiAxNC41NzE0SDYuNzY2MjRDNS45ODg5NCAxNC41NzE0IDUuNTA4ODMgMTMuNzIzNSA1LjkwODc1IDEzLjA1NjlMMTEuNjg1NCAzLjQyOTE2WiIgZmlsbD0iIzgyREJDNSIvPgo8cGF0aCBkPSJNMTUuNjg1NyAxMC41NDI5QzE1LjY4NTcgOS45OTA1OSAxNi4xMzM0IDkuNTQyODggMTYuNjg1NyA5LjU0Mjg4SDI2QzI2LjU1MjIgOS41NDI4OCAyNyA5Ljk5MDU5IDI3IDEwLjU0MjlWMTkuODU3MkMyNyAyMC40MDk0IDI2LjU1MjIgMjAuODU3MiAyNiAyMC44NTcySDE2LjY4NTdDMTYuMTMzNCAyMC44NTcyIDE1LjY4NTcgMjAuNDA5NCAxNS42ODU3IDE5Ljg1NzJWMTAuNTQyOVoiIGZpbGw9IiM0RjRGNEYiLz4KPGNpcmNsZSBjeD0iMTYiIGN5PSIyMiIgcj0iNiIgZmlsbD0iI0VGQUMzNSIvPgo8L3N2Zz4K" alt="npm package">
		</a>
		使用 Vue3.x 组件实现声明式的 ThreeJS，做属于前端的三维项目。<br/><br/>

## 🏕 点击预览：[🌏 opensource.icegl.cn](https://opensource.icegl.cn)

-   如果访问太慢，请访问镜像站点1：[🌏 oss.icegl.cn](http://oss.icegl.cn/)
-   如果访问太慢，请访问镜像站点2：[🌏 myhome.217dan.com:8899](http://myhome.217dan.com:8899/)
-   如果有条件翻墙，也可直接访问 github 的镜像站:[🌏 https://hawk86104.github.io](https://hawk86104.github.io/)
-   全案例微信小程序生态：[🌏 微信内打开](#小程序://三维开源/456pgpJZBiTctdK)
-   全案例微信小程序扫码：<img src="./preview/miniqr.jpg" width="166" alt="tres.js webgl three.js">

```shell
因项目经常更新编译，如发现访问错误，请清空浏览器缓存。
```
<a href="https://opensource.icegl.cn"><img src="./preview/p1.gif" alt="three.js tres.js webgl tvt.js"></a>
<a href="https://opensource.icegl.cn"><img src="./preview/p2.gif" alt="three.js tres.js webgl tvt.js"></a>
<a href="https://opensource.icegl.cn"><img src="./preview/p3.gif" alt="three.js tres.js webgl tvt.js"></a>
<a href="https://opensource.icegl.cn"><img src="./preview/p4.gif" alt="three.js tres.js webgl tvt.js"></a>

更多演示请进入预览页面

# 优势

-   🌈 前端の基本素养 \* FesJS [点击详情](https://fesjs.mumblefe.cn)<br/>
<a href="https://www.npmjs.com/package/@fesjs/fes">
<img src="https://img.shields.io/npm/v/%40fesjs%2Ffes?label=%40fesjs%2Ffes">
</a><br/>
集成封装项目落地的常用库：图标、多语言、API 接口调用、Vuex/Pinia、model 数据封装、页面 layout/权限 access、路由管理等。<br/>

-   🌠 像写 Vue3.x 一样写三维可视化项目[点击详情](https://tresjs.org/guide)<br/>
![npm](https://img.shields.io/npm/v/%40tresjs%2Fcientos?label=%40tresjs%2Fcientos)<br/>
全功能版本追溯保持 threeJS 最新版本 \* TresJS
最新 Vue3.x 的语法糖写法，TS/JS 通吃，让你以最新最爽快的方式构建三维可视化项目

```html
<template>
		<TresCanvas window-size>
				<TresPerspectiveCamera />
				<TresMesh>
						<TresTorusGeometry :args="[1, 0.5, 16, 32]" />
						<TresMeshBasicMaterial color="orange" />
				</TresMesh>
		</TresCanvas>
</template>
<script setup lang="ts">
		import { useRenderLoop, useTexture } from '@tresjs/core'
		//读取材质
		const pTexture = await useTexture(['./**.jpg', './**.png'])
		const { onLoop } = useRenderLoop()
		onLoop(({ delta }) => {
				//循环render
		})
</script>
```

### 敬请右上角一键三连: 关注 💛 点赞 ⭐ fork👣

# ✅ 快速开始

```js
1、git clone 或者 直接下载 本项目

2、cd 到项目根目录

3、yarn	// 安装依赖

4、yarn pre.dev	// 预览 下的调试模式

5、yarn dev	// 自己项目 下的调试模式

6、yarn pre.build	// 预览 下的编译打包

7、yarn build	// 自己项目 下的编译打包

8、yarn pre.dev.one	// 只展示某一个案例/插件

9、yarn pre.build.one // 针对某一个案例/插件打包，会根据配置下的依赖插件项保留资源，其余资源删除

10、yarn both  // 同时启动 dev 和 pre.dev 可以边调试自己得项目，边对照移植样例和插件
```

![展示](./preview/compileMode.png)

# 📖 文档

## 使用说明：[🌏docs.icegl.cn](https://docs.icegl.cn/)
<table style="border: none; width: 100%; text-align: center;">
  <tr>
    <td style="padding:10px;font-size:1.2em;">
			<a href="https://docs.icegl.cn/docs/three-vue-tres/editor/threeeditor.html">
				三维编辑器：[ 📊原生编辑器＋插件生成器 ]
			</a>
		</td>
    <td style="padding:10px;font-size:1.2em;">
			<a href="https://docs.icegl.cn/docs/three-vue-tres/editor/goview.html">
				UI 编辑器：[ 📊GoView导出＋配置导入组件 ]
			</a>
		</td>
  </tr>
  <tr>
    <td style="padding: 10px;">
			<a href="https://docs.icegl.cn/docs/three-vue-tres/editor/threeeditor.html" style="display:block;max-width:100%;">
				<img src="https://docs.icegl.cn/editor.png" alt="tres.js webgl">
			</a>
		</td>
    <td style="padding: 10px;">
			<a href="https://docs.icegl.cn/docs/three-vue-tres/editor/goview.html" style="display:block;max-width:100%;">
				<img src="./preview/goViewPlugin.png" alt="tres.js webgl">
			</a>
		</td>
  </tr>
</table>

# 🧩 丰富的[插件应用市场🌏tvtstore](https://www.icegl.cn/tvtstore)
#### [🌏www.icegl.cn/tvtstore](https://www.icegl.cn/tvtstore) 包含各式各样的项目场景和功能。插件是 ICE 社区生态中重要的一环，在应用市场中完整应用和普通插件统一称为插件。<br/>
<table style="border: none; width: 100%; text-align: center;">
  <tr>
    <td style="padding:10px;font-size:1.2em;">
			<a href="https://www.icegl.cn/tvtstore">
				插件应用市场
			</a>
		</td>
    <td style="padding:10px;font-size:1.2em;">
			<a href="https://www.icegl.cn/p/tvtdeveloper">
				成为作者，加入我们
			</a>
		</td>
  </tr>
  <tr>
    <td style="padding: 10px;">
			<a href="https://www.icegl.cn/tvtstore" style="display:block;max-width:100%;">
				<img src="./preview/tvtstore.png" alt="tres.js webgl">
			</a>
		</td>
    <td style="padding: 10px;">
			<a href="https://www.icegl.cn/p/tvtdeveloper" style="display:block;max-width:100%;">
				<img src="./preview/findyou.png" alt="tres.js webgl">
			</a>
		</td>
  </tr>
</table>

# ❓ 问题反馈

在使用中有任何问题，请使用以下联系方式联系我们

### 问答社区: [图形学社区 icegl.cn](https://www.icegl.cn/ask)

<a href="https://www.icegl.cn/ask" style="display:block;width:800px;max-width:100%;">
<img src="./preview/ask01.png" alt="图形学问答社区"></a>

#### 社区贡献者以及达人: [向他们提问](https://icegl.cn/ask/experts)
<a href="https://icegl.cn/ask/experts.html" style="display:block;width:800px;max-width:100%;">
<img src="./preview/ask02.png" alt="图形学问答社区"></a>

### 欢迎大家也加入微信群，QQ群，已有几个群已满，一起学习讨论 webgl。加微信我拉进群
<table style="border: none; width: 60%; text-align: center;">
  <tr>
		<td style="padding:10px;font-size:1.2em;">
				微信小程序生态
		</td>
    <td style="padding:10px;font-size:1.2em;">
				微信群
		</td>
    <td style="padding:10px;font-size:1.2em;">
			<a href="https://qm.qq.com/q/34V4hTtvbq">
				QQ群: 795714357
			</a>
		</td>
		<td style="padding:10px;font-size:1.2em;">
				公众号: ICE图形学社区
		</td>
  </tr>
  <tr>
	  <td style="padding: 10px;">
			<p style="display:block;max-width:100%;">
				<img src="./preview/miniqr.jpg" alt="tres.js webgl">
			</p>
		</td>
    <td style="padding: 10px;">
			<p style="display:block;max-width:100%;">
				<img src="./preview/wx.png" alt="tres.js webgl">
			</p>
		</td>
    <td style="padding: 10px;">
			<a href="https://qm.qq.com/q/34V4hTtvbq" style="display:block;max-width:100%;">
				<img src="./preview/qqq.png" alt="tres.js webgl">
			</a>
		</td>
		<td style="padding: 10px;">
			<p style="display:block;max-width:100%;">
				<img src="./preview/wxgzh.jpg" alt="tres.js webgl">
			</p>
		</td>
  </tr>
</table>

# ⭐ 点星历史

[![Star History Chart](https://api.star-history.com/svg?repos=hawk86104/three-vue-tres,hawk86104/vue3-ts-cesium-map-show&type=Date)](https://star-history.com/#hawk86104/three-vue-tres&hawk86104/vue3-ts-cesium-map-show&Date)

# ™️ 版权信息

本项目遵循 Apache2 开源协议发布，并提供永久免费使用以及商用。

> 如果您将此项目用于商业用途，请遵守 Apache2.0 协议并保留作者技术支持声明。

-   二次开发如用于商业性质或开源竞品请不要删除和修改 TvT.js 源码头部的版权与作者声明及出处
-   允许进行商用，但是不允许二次开源出来并进行收费

本项目包含的第三方源码和二进制文件之版权信息另行标注。

版权所有 Copyright © 2022-2026 by 🧊icegl (https://www.icegl.cn)

All rights reserved。