QQ 交流群： 1040320579
\n![\"QQ](\"/images/qq_qrcode.jpg\")
您在使用过程中遇到任何问题，欢迎通过 issue 反馈。也欢迎加入我们的 QQ 交流群一起讨论。
\n\n\n🔥 4核8G 200兆服务器，仅需49元/月，点击这里购买
\n
\n专属优惠码：Astral3D
QQ 交流群： 1040320579
\n
您在使用过程中遇到任何问题，欢迎通过 issue 反馈。也欢迎加入我们的 QQ 交流群一起讨论。
\n\n\n🔥 4核8G 200兆服务器，仅需49元/月，点击这里购买
\n
\n专属优惠码：Astral3D
QQ 交流群： 1040320579
\n
您在使用过程中遇到任何问题，欢迎通过 issue 反馈。也欢迎加入我们的 QQ 交流群一起讨论。
\n\n\n🔥 4核8G 200兆服务器，仅需49元/月，点击这里购买
\n
\n专属优惠码：Astral3D
404 Not Found
---假设在
-模型类型下我先选择了一个飞机模型，然后点击按钮通过预览截图
--默认解析为PBR材质。
-
-上传的ZIP包内文件应依照特定规则（以下两种之一）：-
-- -
-一. zip包中包含一个 material.json的文件，其中指明各类贴图使用的纹理文件及材质属性，示例如下：-{ - textures: { - baseColor: xxx.[png/jpg/webp/tga/hdr/exr], - normal: xxx.[png/jpg/webp/tga/hdr/exr], - bump: xxx.[png/jpg/webp/tga/hdr/exr], - displacement: xxx.[png/jpg/webp/tga/hdr/exr], - roughness: xxx.[png/jpg/webp/tga/hdr/exr], - metalness: xxx.[png/jpg/webp/tga/hdr/exr], - ao: xxx.[png/jpg/webp/tga/hdr/exr], - emissive: xxx.[png/jpg/webp/tga/hdr/exr], - alpha: xxx.[png/jpg/webp/tga/hdr/exr], - env: xxx.[png/jpg/webp/tga/hdr/exr], - light: xxx.[png/jpg/webp/tga/hdr/exr], - }, - properties: { - metalness: 1, - roughness: 0.5, - ... - } -}-
-- 二. zip包中不包含
-material.json文件，此时包中的各纹理文件应语义化命名，如下(文件名均为按照关键字模糊匹配)： -::: file-tree-
-- *.zip -
--
-- %baseColor%.[png/jpg/webp/tga/hdr/exr] // 基础颜色贴图(高光反射/光泽度工作流:diffuse, 金属/粗糙度工作流:baseColor)
-- %normal%.[png/jpg/webp/tga/hdr/exr] // 法线贴图
-- %bump%.[png/jpg/webp/tga/hdr/exr] // 凹凸贴图,如果定义了法线贴图，则将忽略该贴图
-- %displacement%.[png/jpg/webp/tga/hdr/exr] // 置换贴图(位移贴图)
-- %roughness%.[png/jpg/webp/tga/hdr/exr] // 粗糙度贴图(使用该纹理的绿色通道)
-- %metalness%.[png/jpg/webp/tga/hdr/exr] // 金属度贴图(使用该纹理的蓝色通道)
-- %ao%.[png/jpg/webp/tga/hdr/exr] // 环境遮挡贴图(该纹理的红色通道)
-- %emissive%.[png/jpg/webp/tga/hdr/exr] // 自发光贴图(放射贴图)
-- %alpha%.[png/jpg/webp/tga/hdr/exr] // 透明贴图(一张灰度纹理，用于控制整个表面的不透明度：黑色：完全透明；白色：完全不透明)
-- %env%.[png/jpg/webp/tga/hdr/exr] // 环境贴图(一般不会设置，因为会使用scene.environment)
-- %light%.[png/jpg/webp/tga/hdr/exr] // 光照贴图(需要第二组UV) -:::
-
---
Astral 3D Engine是一个基于ThreeJS的三维快速开发引擎。
-Astral 3D Editor是一个以Astral 3D作为底层的三维可视化编辑器。
-从诞生之初，其定位便是快捷、轻量、可扩展的3D低代码创作工具，意在解决Web3D产品开发难，迭代速度慢，并且视觉效果不达标的行业痛点，推动Web3D的发展。
本项目二开及与服务器交互需要一定前端基础知识，建议在开发前先学习一下以下内容，会对项目理解非常有帮助:
- -拖入(双击) 添加至场景中的图纸会自动占据中心视口一半的位置，其与3D视图中间的 垂直分割线 可以左右拖动以改变占据视口的大小。
-图纸可以与3D视图联动，提供更直观的设计体验。
-这一功能不仅提升了图纸的可视化效果，还为设计和协作提供了极大的便利。
主要亮点：
---主要面相于开发人员，主要功能有：
--
-- 编写脚本逻辑，并将其挂载于实体模型上；
-- 脚本组件使用
-JavaScript编程语言；- 脚本组件由事件驱动，在对应生命周期内执行；
-- 脚本组件可以访问实体模型的属性和方法；
-- 运行时执行脚本逻辑，并获取脚本执行结果；
-
在脚本中已经内置了以下变量：
-| 变量 | -描述 | -类型 | -
|---|---|---|
| this | -当前实体模型的引用 | -THREE.Object3D |
-
| THREE | -THREE对象 | -THREE |
-
| helper | -辅助类函数集合 | -Helper | -
| renderer | -当前渲染器的引用 | -THREE.WebGLRenderer |
-
| scene | -当前场景的引用 | -THREE.Scene |
-
| camera | -当前场景相机的引用 | -THREE.PerspectiveCamera |
-
| controls | -当前场景控制器的引用 | -CameraControls | -
| timer | -场景运行时间跟踪 | -three/addons/misc/Timer.js |
-
在脚本中已经内置了以下方法：
-| 方法 | -描述 | -传入参数 | -
|---|---|---|
| render | -驱动场景渲染一帧。 | -{delta?:number} |
-
支持以下几个基本生命周期：
-| 生命周期 | -描述 | -参数 | -
|---|---|---|
| loaded | -场景加载完成时执行，仅执行一次 | -- | -
| beforeAnimation | -场景当前动画帧循环开始之前触发，每一帧执行一次 | -{"delta":number} |
-
| afterAnimation | -场景当前动画帧循环完成之后立即触发，每一帧执行一次 | -{"delta":number,"toBeRender":(_needRender: boolean) => void} |
-
| beforeRender | -场景当前动画帧循环完成之后渲染之前触发，每一次渲染执行一次 | -{"delta":number} |
-
| afterRender | -场景当前帧渲染完成之后触发，每一次渲染执行一次 | -{"delta":number} |
-
| beforeDestroy | -场景销毁前调用，仅执行一次 | -- | -
| afterDestroy | -场景销毁后调用，仅执行一次 | -- | -
--Tips:
----
toBeRender:由于本系统默认为事件驱动渲染，而非持续渲染，故提供此方法以便在脚本中实现自定义的逻辑。推荐用法：-afterAnimation(delta,toBeRender){ - // 传入true则下一帧一定渲染 - toBeRender(true); -}
支持以下几个基本事件：
-| 事件 | -描述 | -参数 | -
|---|---|---|
| onPick | -模型单击事件 | -intersect:THREE.Intersection |
-
| onDoubleClick | -模型双击事件 | -intersect:THREE.Intersection |
-
| onKeydown | -键盘按下事件(全局) | -event:KeyboardEvent |
-
| onKeyup | -键盘抬起事件(全局) | -event:KeyboardEvent |
-
| onPointerDown | -指针按下事件(全局) | -event:PointerEvent |
-
| onPointerUp | -指针抬起事件(全局) | -event:PointerEvent |
-
| onPointerMove | -指针移动事件(全局) | -event:PointerEvent |
-
| onTouchStart | -触屏按下事件(全局) | -event:TouchEvent |
-
| onTouchEnd | -触屏释放事件(全局) | -event:TouchEvent |
-
| 成员 | -描述 | -类型 | -
|---|---|---|
| scene | -当前场景的引用，内置变量scene的引用 | -THREE.Scene |
-
| Animation | -未实例化的动画类 | -Animation | -
| 方法 | -描述 | -参数 | -返回值 | -
|---|---|---|---|
| objectByUuid | -通过uuid获取场景中的Object3D对象 | -uuid:string |
-THREE.Object3D |
-
| moveObject | -移动3D对象到指定位置 | -object: Object3Dparent: Object3Dbefore: Object3D |
-- | -
| removeObject | -从场景中移除3D对象 | -object: THREE.Object3D |
-- | -
const animation = new helper.Animation(this); new helper.Animation(object:THREE.Object3D)| 成员 | -描述 | -类型 | -
|---|---|---|
| object | -构造函数形参值，动画绑定的对象。 如果实例化时传入参数this(如上)，则指向内置变量this |
-THREE.Object3D |
-
| actions | -动画动作集合 | -THREE.AnimationAction[] |
-
| actionsMap | -动画动作映射表，key为动作名称，value为THREE.AnimationAction对象 | -Map<string, THREE.AnimationAction> |
-
| lastPlayAction | -正在播放的动作名称 | -THREE.AnimationAction | undefined |
-
| repetitions | -动画重复次数 | -number |
-
| ActionLoop (static) | -动画循环模式枚举： LoopOnce - 只执行一次 LoopRepeat - 重复次数为repetitions的值, 且每次循环结束时候将回到起始动作开始下一次循环。 LoopPingPong - 重复次数为repetitions的值, 且像乒乓球一样在起始点与结束点之间来回循环。 |
-Enum |
-
| 方法 | -描述 | -参数 | -返回值 | -
|---|---|---|---|
| getAction | -获取指定名称的动画动作,用于用户直接调用THREE.AnimationAction的方法 | -name:string |
-THREE.AnimationAction | undefined |
-
| play | -播放指定名称的动画动作,支持链式调用 | -name:string loop:AnimationActionLoopStyles = helper.Animation.ActionLoop.LoopRepeat timeScale:number = 1 |
-this(helper.Animation) |
-
| pause | -暂停动画,支持链式调用 | -name:string | undefined |
-this(helper.Animation) |
-
| stop | -停止动画,支持链式调用 | -name:string | undefined |
-this(helper.Animation) |
-
完整结构：
-/**
- * 场景加载完成时执行，仅执行一次
- */
-function loaded() {
- console.group('loaded');
- console.log(this);
- console.log(renderer);
- console.log(scene);
- console.log(camera);
- console.log(controls);
- console.log(timer);
- console.groupEnd()
-}
-
-/**
- * 场景当前动画帧循环开始之前触发，每一帧执行一次
- * @param {number} delta
- */
-function beforeAnimation(delta) {}
-
-/**
- * 场景当前动画帧循环完成之后立即触发，每一帧执行一次
- * @param {number} delta
- * @param {(_needRender: boolean) => void} toBeRender 设置下一帧是否将渲染
- */
-function afterAnimation(delta,toBeRender) {}
-
-/**
- * 场景当前动画帧循环完成之后渲染之前触发，每一次渲染执行一次
- * @param {number} delta
- */
-function beforeRender(delta) {}
-
-/**
- * 场景当前帧渲染完成之后触发，每一次渲染执行一次
- * @param {number} delta
- */
-function afterRender(delta) {}
-
-/**
- * 场景销毁前调用，仅执行一次
- */
-function beforeDestroy() {}
-
-/**
- * 场景销毁后调用，仅执行一次
- */
-function afterDestroy() {}
-
-/**
- * 模型单击事件
- * @param {THREE.Intersection} intersect
- */
-function onPick(intersect) {}
-
-/**
- * 模型双击事件
- * @param {THREE.Intersection} intersect
- */
-function onDoubleClick(intersect) {}
-
-/**
- * 键盘按下事件(全局)
- * @param {KeyboardEvent} event
- */
-function onKeyDown(event) {}
-
-/**
- * 键盘抬起事件(全局)
- * @param {KeyboardEvent} event
- */
-function onKeyUp(event) {}
-
-/**
- * 指针按下事件(全局)
- * @param {PointerEvent} event
- */
-function onPointerDown(event) {}
-
-/**
- * 指针抬起事件(全局)
- * @param {PointerEvent} event
- */
-function onPointerUp(event) {}
-
-/**
- * 指针移动事件(全局)
- * @param {PointerEvent} event
- */
-function onPointerMove(event) {}
-
-/**
- * 触屏按下事件(全局)
- * @param {TouchEvent} event
- */
-function onTouchStart(event) {}
-
-/**
- * 触屏释放事件(全局)
- * @param {TouchEvent} event
- */
-function onTouchEnd(event) {}function afterAnimation(delta,toBeRender){
- toBeRender(true)
-}
-
-const DEG2RAD = Math.PI / 180;
-function beforeRender(delta) {
- const t = delta * DEG2RAD;
- scene.backgroundRotation.y = t;
-}const anime = new helper.Animation(this);
-
-function loaded() {
- anime.play("01_Run_Armature_0");
-}
-
-function onKeyDown(event) {
- // 按下1则执行 "01_Run_Armature_0" 动画,按下2则执行 "02_walk_Armature_0" 动画，按下3则执行 ""05_site_Armature_0"" 动画,
- switch (event.key) {
- case "1":
- anime.stop();
- anime.play("02_walk_Armature_0");
- break;
-
- case "2":
- anime.stop();
- anime.play("05_site_Armature_0");
- break;
-
- case "3":
- anime.stop();
- anime.play("01_Run_Armature_0");
- break;
- }
-}
-
-function beforeDestroy() {
- anime.stop();
-}在扩展栏左上角下拉菜单中可将扩展面板切换到资源中心模块。
-资源共分为模型、材质、粒子、广告牌、Html面板、灯光、相机。
-编辑器已内置大多通用资源，也可在扩展栏右上角切换资源来源：内置资源/公共资源。
主要亮点：
-搜索框位于扩展栏顶部中间。 -输入搜索内容，将根据当前所选取资源类型进行模糊查询。
-如本页首图，内置了多种类型的模型，用户可通过拖拽/双击方式将模型添加到场景中。
-内置了多类型的PBR材质、Shader材质，用户可通过拖拽/双击方式将材质应用到模型上;
-成功应用的材质可在 右侧边栏-
注意：材质只能应用至Mesh节点，不能应用于Group、广告牌、粒子、Html面板等节点。即材质只能应用于本身就包含材质属性的模型节点。
-内置火焰、烟雾、萤火虫等常见粒子效果模板，用户可通过拖拽/双击方式将粒子添加到场景中;
-成功添加的粒子可在 右侧边栏-
内置图标、文本广告牌，用户可通过拖拽/双击方式将广告牌添加到场景中;
-成功添加的广告牌可在 右侧边栏-
内置多个Html面板模板，用户可通过拖拽/双击方式将Html面板添加到场景中;
-该功能允许用户在场景中嵌入HTML内容，如视频播放器、交互式表单、数据图表等，支持动态更新;
-成功添加的Html面板可在 右侧边栏-
内置环境光、平行光、半球光、点光源、聚光灯五种灯光类型，用户可通过拖拽/双击方式将灯光添加到场景中;
-成功添加的灯光（选中后）可在 右侧边栏-
内置透视相机、正交相机，用户可通过拖拽/双击方式将相机添加到场景中;
-相机添加后可在
-成功添加的相机（选中后）可在 右侧边栏-
说明
-顶栏部分为左中右布局，左侧为基础操作区，中间仅展示场景名称，右侧为多功能区域
--图标/按钮 从左到右依次是 Logo、撤回、重做、删除、清空、拷贝、全屏、导出、导入
-
方寸藏寰宇，虚实映乾坤
-撤销上一步操作。
-恢复被撤销的操作。
-删除当前选中的对象。
-清空场景中的所有内容并重置所有模块。
-复制当前选中的对象。
-切换编辑器的全屏模式，全屏后会变为退出全屏图标，点击可退出全屏。
-导出功能分为两类，一是导出选中的物体，二是导出整个场景。
-两者所支持的导出格式一致，分别是JSON、GLB、GLTF、OBJ、PLY、PLY(二进制)、STL、STL(二进制)、USDZ
从文件系统导入模型/场景文件，允许多选，支持在此处导入的文件格式如下：
---图标/按钮 从左到右依次是 保存、预览、国际化、主题、主色调、设置
-
打包当前场景，并保存至服务器。
-打开新的
切换编辑器的语言，默认支持语言如下：
-切换编辑器的主题风格。
-切换顺序为深色-->跟随系统-->浅色-->深色
-系统默认为深色风格
调整编辑器的主色,系统会自动生成相应的浅色、深色色阶，用于鼠标经过以及选中等效果。
- -打开编辑器的设置面板。
-编辑器的核心视口，展示用户所编辑的场景内容。
-主要亮点：
-提供以下渲染模式：
-变换控制右边的按钮，点击后会在世界坐标/本地坐标之间切换。
-用于表明场景中显示的坐标轴（X、Y、Z）所使用的参考坐标系。
-比如：A模型在世界坐标下Y轴向上，但是本地坐标下却是Z轴向上。确定轴向可以辅助用户快速定位一些矩阵变换错误的原因。
在界面左下角显示场景的实时统计信息，包括：
-在界面右下角提供了视角辅助器，方便用户快速切换视角，共支持22个视角。 -其颜色会跟随编辑器主题变换（深色/浅色）。
-支持以下快捷键操作：
-如果在设置中修改了对应快捷键，则请使用对应快捷键操作。
---此文档尚未更新，请勿参考。
-
--本文档适用于部署 Astral3D 编辑器到服务器上。
-
-以Golang版本后端为例，其他语言版本后端部署方式请参考官方文档。
# 确认 Node.js 版本（≥ 23.x）
-node -v
-
-# 拉取代码
-git clone https://github.com/mlt131220/Astral3D.git
-
-# 安装依赖
-cd Astral3D
-pnpm install
-
-# 打包 Astral 3D Engine SDK
-pnpm run sdk:build
-
-# 打包Astral 3D Editor
-pnpm run editor:build# 确认go环境
-go version
-
-# 拉取代码
-git clone https://github.com/mlt131220/Astral3DEditorGoBack.git
-
-# 安装依赖
-go mod tidy
-
-# 修改数据库等配置（修改 conf/app.conf，详见 https://github.com/mlt131220/Astral3DEditorGoBack/blob/main/README.md）
-edit conf/app.conf
-
-# 安装bee工具
-go get -u github.com/beego/bee/v2
-
-# 编译后端代码
-# Linux
-bee pack -be GOOS=linux -be GOARCH=amd64
-# Windows
-bee pack -be GOOS=windows或者直接使用集成环境，如PHPStudy。
-将Astral 3D Editor打包后的文件放到方便读取的目录下，如 C:\www\Astral3dEditor;
C:\www\Astral3DEditorGoBack;astral3d 的数据库，并导入 Astral3DEditorGoBack/static/sql/astral-3d-editor.sql 文件；Astral3DEditorGoBack.exe 启动后端服务，默认监听 8080 端口；C:\nginx,则配置文件路径为C:\nginx\conf\nginx.conf;http 块中添加以下配置：http {
- # ... 忽略原有其他配置不变更
-
- # 开启gzip
- gzip on;
-
- # 导入所有的server配置
- include vhosts/*.conf;
-}C:\nginx\conf 目录下创建 vhosts 目录(与上方http中增加的配置路径同名，并非一定要为vhost,可以自定义);C:\nginx\conf\vhosts 目录下创建 astral3d.conf 文件，内容如下：server {
- # 监听端口,即前端部署的端口，一般设置为80
- listen 80;
- # 域名/ip/localhost
- server_name 127.0.0.1;
-
- # 访问 server_name:listen 后，请求就会被转发到这个location块中
- location / {
- # 前端部署的目录，即前端打包后的文件所在目录
- root "C:\www\Astral3dEditor";
- # 文件url重写规则，将请求转发到index.html（单页面应用）
- try_files $uri $uri/ index.html;
- # 项目入口文件
- index index.html;
- }
-
- # 后端api接口代理，接口请求匹配 /api 的会走此处转发，下面都同理
- location /api {
- # 后端接口访问地址，上面部署在了本机的8080端口
- proxy_pass http://127.0.0.1:8080/api;
- }
-
- # 前端websocket代理
- location /socket {
- proxy_pass http://127.0.0.1:8080/api/sys/ws;
-
- proxy_http_version 1.1;
- proxy_set_header Upgrade $http_upgrade;
- proxy_set_header Connection "Upgrade";
- proxy_connect_timeout 10s;
- proxy_read_timeout 300s;
- proxy_send_timeout 300s;
- }
-
- # 如果需要使用upyun上传功能，则需要添加以下配置
- # 假设 http://upyun.xxx.com 为你的upyun存储
-
- location /upyun {
- rewrite ^/upyun(.*)$ $1 break;
- proxy_pass http://upyun.xxx.com;
- }
-
- location /static/upload {
- proxy_pass http://upyun.xxx.com/static/upload;
- }
-
- location /static/bim2gltf {
- proxy_pass http://upyun.xxx.com/static/bim2gltf;
- }
-}nginx -s start
-
-# 重启 nginx（如果修改了配置文件）
-nginx -s reload此时访问 http://127.0.0.1 即可访问到 Astral 3D Editor。
Astral3DEditorGoBack/conf/app.conf文件中的runmode = prod;Astral3DEditorGoBack/static/sql/astral-3d-editor.sql 文件；Astral3DEditorGoBack/conf/app.conf中配置的端口httpport ，默认为 8080 ；80 端口；--Astral 3D 内置了插件系统，为其提供了巨大的灵活性和可扩展性。
-
Astral 3D Editor 内置了以下插件：
---开发插件时，插件入口类需要实现以下接口，并以esm方式导出，Astral3D Engine会加载默认导出模块。
-
export interface Plugin {
- // 插件名称，插件的唯一标识
- name: string;
- // 插件版本号
- version:number;
- // 插件图标
- icon:string;
- // 插件安装函数，在插件安装时调用
- install(config?: any): void;
- // 插件卸载函数，在插件卸载时调用
- uninstall(): void;
- // 从插件盒子面板点击插件时的运行方法
- run(): void;
-}// 暂未发布到npm，请自行将代码拷贝到项目中
-// import { Plugin } from 'msy3d';
-
-class ExamplePlugin implements Plugin {
- name = 'example-plugin';
- version = 1.0;
- icon = 'https://example.com/icon.png';
-
- install(config?: any): void {
- console.log('ExamplePlugin installed');
- }
-
- uninstall(): void {
- console.log('ExamplePlugin uninstalled');
- }
-
- run(): void {
- console.log('ExamplePlugin run');
- }
-}
-
-export default ExamplePlugin;-- -此插件提供了在 Web 端处理 glTF 文件的能力，主要能力如下：
--
-- 优化 glTF 文件： -
--
-- a. 压缩模型数据(包括贴图材质与几何数据)，减少文件大小;
-- b. 网格顶点优化，减少顶点数量，提升渲染性能;
-- c. 实例化网格，减少渲染 DrawCall，提升渲染性能;
-- d. 压缩裁剪纹理贴图，减少内存占用，提升渲染性能;
-
| 配置项 | -描述 | -值 | -
|---|---|---|
| 压缩方式 | -网格浮点压缩方法 Draco 压缩 geometry; Meshopt & Quantization 压缩 geometry 和 animation; |
-Draco|Meshopt|Quantization|None |
-
| Meshopt 压缩级别 | -压缩方式选择Meshopt时需要选择压缩级别 |
-low|medium|high |
-
| 实例化网格 | -使用 GPU 实例化技术共享网格引用，即生成THREE.InstancedMesh对象，减少 DrawCall |
-true|false |
-
| 实例化网格界限 | -实例化网格所需的实例数,实例数低于该值的网格将不会实例化 | -min:2,max:Infinity |
-
| 展平场景树 | -将场景内子模型对象全部展平到场景根节点。 开启合并网格时此项无法关闭 |
-true|false |
-
| 合并网格 | -合并网格以减少渲染调用，合并后的网格无法单独选中。 前置条件：开启展平场景树 |
-true|false |
-
| 合并纹理 | -创建调色板纹理并合并材质 | -true|false |
-
| 合并纹理界限 | -合并纹理所需的纹理数,纹理数低于该值将不会合并 | -min:2,max:Infinity |
-
| 修剪 | -从文件中删除未被场景引用的属性 | -true|false |
-
| 修剪顶点 | -是否修剪未使用的顶点属性 | -true|false |
-
| 修剪子节点 | -是否修剪空的叶子节点 | -true|false |
-
| 修剪纹理 | -是否修剪实体(单色)纹理，将其转换为材质元素 | -true|false |
-
| 合并同位顶点 | -合并按位相同的顶点。合并和索引后，顶点之间的数据共享效率更高。文件大小可以减小，GPU 可以更高效地使用顶点缓存。 开启简化网格时此项无法关闭 |
-true|false |
-
| 简化网格 | -基于meshoptimizer的简化算法，生成具有较少三角形和顶点的网格。简化是有损的，但该算法旨在针对给定的参数尽可能地保持视觉质量。前置条件：开启合并同位顶点 |
-true|false |
-
| 简化误差界限 | -简化网格误差容忍度，以网格尺寸的百分比表示 | -min:0.01,max:100 |
-
| 简化锁定边界 | -是否锁定网格的拓扑边界，拓扑结构（尤其是分割顶点）会限制简化器 | -true|false |
-
| 简化比率 | -要保留的顶点的比率（0-1） | -min:0,max:1 |
-
| 纹理压缩 | -AVIF和WebP优化传输大小;Auto按原始格式进行压缩; |
-WebP|AVIF|Auto|None |
-
| 纹理最大尺寸 | -超过该尺寸的纹理将被压缩,值一般为 2 的 N 次方 | -min:2,max:Infinity |
-
通过编辑器的BIM轻量化功能，您可以将复杂的BIM工程文件（如.rvt）转换为轻量化的.glTF文件。
-转换过程中保留了BIM构件的属性信息，同时对模型进行了压缩优化，方便在Web端进行高效解析与展示。
主要亮点：
-.rvt、.rfa按名称并输入视图名称以转换；否则将自动以默认3D视图为目标转换；
--视觉样式：此设置影响最终输出的模型材质。着色模式基本不包含任何材质贴图，以纯色材质方式输出；真实模式会包含用户建模时的材质贴图，输出材质更真实；场景树是 Astral3D 编辑器中用于管理场景中所有对象的工具。它以树状结构展示场景中的层级关系，便于用户快速定位和操作对象。
-F）。Del）。说明
-整个编辑界面分为 顶栏,左侧边栏,场景视口,扩展栏,右侧边栏 五个区域
通过编辑器的CAD解析预览功能，您可以轻松上传并查看多种格式的CAD图纸。
-无论是.dwg还是.dxf，都能快速解析并在三维视口中直观展示。
-这一功能不仅提升了图纸管理的效率，还为三维设计和协作提供了极大的便利。
主要亮点：
-让您的设计流程更加流畅，体验前所未有的便捷与高效！
-.dwg、.dxf、.png、.jpg(jpeg).dwg格式图纸由于无法在前端直接解析，会在上传后通过WebSocket发起图纸解析请求。.dwg图纸中包含缩略图，会自动解析为封面图，在图纸列表中展示。.dwg,.dxf 图纸解析预览\"},{\"title\":\"BIM\",\"description\":\"支持 .rvt,.ifc,.rva 模型轻量化解析\"},{\"title\":\"Future\",\"description\":\"PDMS、VTU\"}]},{\"type\":\"custom\"}],\"description\":\"⚡ 快速开始 Tips: Node >= 23.0.0; 更新记录\",\"head\":[[\"script\",{\"type\":\"application/ld+json\"},\"{\\\"@context\\\":\\\"https://schema.org\\\",\\\"@type\\\":\\\"Article\\\",\\\"headline\\\":\\\"\\\",\\\"image\\\":[\\\"\\\"],\\\"dateModified\\\":null,\\\"author\\\":[]}\"],[\"meta\",{\"property\":\"og:url\",\"content\":\"https://docs.astraljs.com/\"}],[\"meta\",{\"property\":\"og:site_name\",\"content\":\"Astral3D\"}],[\"meta\",{\"property\":\"og:description\",\"content\":\"⚡ 快速开始 Tips: Node >= 23.0.0; 更新记录\"}],[\"meta\",{\"property\":\"og:type\",\"content\":\"article\"}],[\"meta\",{\"property\":\"og:locale\",\"content\":\"zh-CN\"}]]},\"readingTime\":{\"minutes\":1.71,\"words\":514},\"git\":{},\"autoDesc\":true,\"filePathRelative\":\"README.md\",\"headers\":[],\"categoryList\":[],\"bulletin\":true}")
-export { comp, data }
diff --git a/packages/docs/src/.vuepress/.temp/pages/index.html.vue b/packages/docs/src/.vuepress/.temp/pages/index.html.vue
deleted file mode 100644
index 97e0b4e..0000000
--- a/packages/docs/src/.vuepress/.temp/pages/index.html.vue
+++ /dev/null
@@ -1,23 +0,0 @@
- git clone https://github.com/mlt131220/Astral3D.git
-
- cd Astral3D
- pnpm install
- pnpm run sdk:build
- pnpm run editor:devNode >= 23.0.0;作者的话
-Astral 3D 是一款基于 Three.js 的完全开源且免费的三维引擎。
如果使用起来觉得还不错，欢迎通过 Star 支持。
-它源于个人的兴趣与曾经的工作需求，我将会长期维护它。
-如果它对你产生了帮助，那我也深感荣幸。
-如果你想，可以捐助我。
-一切都是自由的，愿大家，平安喜乐。
-岁岁平，岁岁安，岁岁平安。
-| 支付宝 | -微信 | -
|---|---|
 |
- |
-
--本页面为各种大网站的推广链接，在此处购买您将会受到一定的优惠，而我收到一部分提成
-
🔥 4核8G 200兆服务器，仅需49元/月，点击这里购买
-🔥 专属优惠码：Astral3D
2核2G 轻量应用服务器 ￥38.00/年
-从此链接购买享 9折优惠！！
云服务器、云数据库、COS、CDN、短信等云产品特惠热卖中
-本文主要包含了Astral3D过程中可能会遇到的常见问题与解决方法。
-如果您遇到任何问题，您可以先在以下内容中寻找是否有相关的问题和解决方法。
-如果没有找到，您可以先通过 Github Discussions 与我们讨论。
-如果您确定某处确实存在问题，请在 Github Open an issue, -在 Issue 中说明该问题的具体细节，我们会尽快解决。
-XXXXXXXXXXXXXXXXXXX
-这个月的任务突然就很繁重
-而且还要兼顾其他工作，真是一件很辛苦的事情。
-提示
-重点功能实现
-又摆烂到月底
-不能怪LOL，也不能怪剑网情缘3，要怪就怪我的狗友吧。
-月底了，just do it！
提示
-重点功能实现
-TypeScript重写Viewport;ToolBar 加入 Shading 渲染模式选择；ThreeJS 版本升级至r163;.encoding 替换为 .colorSpace;
-WebGLRenderTarget: 将 .outputEnding 替换为 .outputColorSpace;Scene Background 为 Equirectangular 类型时，增加 Intensity && Rotation数值设置项；ktx2Loader.setTranscoderPath对应所需文件存储至又拍云；ThreeJS 升级 r163 后CAD文件加载报错的BUG(r163版本OrbitControls调用了新函数getRootNode,需要在使用OffscreenCanvas渲染CAD文件的虚拟dom元素代理上实现);Couldn't load texture blob:http://xxxx 的问题（GLTFLoader参数manager需要为THREE.LoadingManager || undefined,不能为null）；材质资源；--移植重构过程中产生如下功能变更：
--
-- 脚本功能变化： -
--
-- 生命周期
-init更名为loaded;- 新增
-onPick,onDoubleClick,onTouchStart,onTouchEnd事件;- 新增编辑态支持脚本运行；
-- 脚本支持热更新运行；
-- 新增帧率上限控制能力（默认上限60FPS）；
-- 由GoLang后端迁移至Java后端；
-- 其他忘了。
-
Capsule、Circle、Cylinder、Dodecahedron、Extrude、Tube、Icosahedron、Lathe、Octahedron、Plane;Ring、Shape、Sphere;Teapot、Tetrahedron、Torus、TorusKnot;UserData(自定义数据)的录入改用 monaco-editor;
WebSocket连接信息;Player预览场景;
Billboard资源(1)；Billboard资源(2);HtmlPanel资源;HtmlPlane支持;loader用法；monaco-editor用法；HtmlPanel配置面板;HtmlPanel Zip解析;HtmlPanel Zip解析;cad\bim上传按钮点击无响应的bug;monorepo(pnpm workspace)方式管理此项目(商用版本);