# icegl-three-vue-tres

**Repository Path**: flashpig8014/icegl-three-vue-tres

## Basic Information

- **Project Name**: icegl-three-vue-tres
- **Description**: 🎉🎉🎊 一款让你的三维可视化项目快速落地の开源框架 🎊🎉🎉
永久开源免费商用 数字孪生 三维可视化 threejs webgl three three.js
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://opensource.icegl.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 772
- **Created**: 2024-07-27
- **Last Updated**: 2024-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🧊🧊🧊 icegl-three-vue-tres 🧊🧊🧊

## 🎉🎉🎊 三维可视化项目快速落地の开源框架 🎊🎉🎉

<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/icegl-three-vue-tres" target="_blank">
      <img src="https://img.shields.io/github/stars/hawk86104/icegl-three-vue-tres" />
    </a>
    <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/hawk86104/icegl-three-vue-tres">
    <img src="https://img.shields.io/github/license/hawk86104/icegl-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://afdian.net/@tvt_js">
      <img src="https://img.shields.io/badge/爱发电-ICEGL-blue.svg?style=flat-square&color=027afd&logo=github-sponsors" alt="爱发电" />
    </a>

</p>

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

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

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

<a href="https://www.bilibili.com/video/BV1LH4y1p7Yn"><img src="./preview/bilibili.gif" alt="tres.js webgl"></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)

-   如果访问太慢，请访问镜像站点：[🌏 http://myhome.217dan.com:8899](http://myhome.217dan.com:8899/)
-   如果有条件翻墙，也可直接访问 github 的镜像站:[🌏 https://hawk86104.github.io](https://hawk86104.github.io/)

```shell
因项目经常更新编译，如发现访问错误，请清空浏览器缓存。
```

![展示](./public/plugins/simpleGIS/preview/mapBuildings.gif)
![展示](./preview/数字城市3.gif)
![展示](./preview/models.gif)
![展示](./preview/incar.gif)
![展示](./preview/工业2.gif)
![展示](./preview/艺术效果.gif)
![展示](./preview/shadertoyMaterial.gif)

更多演示请进入预览页面

# 优势

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

-   🌠 像写 Vue3.x 一样写三维可视化项目[点击详情](https://tresjs.org/guide)

![npm](https://img.shields.io/npm/v/%40tresjs%2Fcientos?label=%40tresjs%2Fcientos)全功能版本追溯保持 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>
```

-   🧩 丰富的插件应用市场<br/>
    插件中心包含各式各样的项目场景和功能。插件是 ICE 社区生态中重要的一环，在应用市场中完整应用和普通插件统一称为插件。

### 我们将会逐一把落地的项目以插件的形式加入到此开源框中...

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

# ✅ 快速开始

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

2、cd 到项目根目录

3、yarn	//安装依赖

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

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

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

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

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

# 📖 文档

## 使用说明：[🌏docs.icegl.cn](https://docs.icegl.cn/)

## 三维编辑器：[📊 原生编辑器＋插件生成器](https://docs.icegl.cn/docs/three-vue-tres/editor/threeeditor.html)

![展示](https://docs.icegl.cn/editor.png)

## UI 编辑器：[📊 GoView 导出＋配置导入组件](https://docs.icegl.cn/docs/three-vue-tres/editor/goview.html)

![展示](./public/plugins/goView/preview/goViewPlugin.png)

# ❓ 问题反馈

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

-   问答社区: [图形学社区 icegl.cn](https://www.icegl.cn/ask)
<p align = "left">   
<img src="https://icegl-1314935952.cos.ap-beijing.myqcloud.com/uploads/20230421/QQ20230421-121209.png" width="680" />
</p>

-   欢迎大家也加入微信群，已有几个群已满，一起学习讨论 webgl。加微信我拉进群
<p align = "left">    
<img src="https://icegl-1314935952.cos.ap-beijing.myqcloud.com/uploads/20230731/17d59bab46815cce1f4f1e09dcbb6ccc.png" width="300" />
</p>

# ⭐ 点星历史

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

# ™️ 版权信息

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

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

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

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

关注我们的公众号获得最新讯息
<p align = "left">    
<img src="https://icegl-1314935952.cos.ap-beijing.myqcloud.com/uploads/20240619/de51c5e66dd5a8647100cc3b61171223.jpg" width="300" />
</p>

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

All rights reserved。