ShadowEditor

影子编辑

英语 /中文| Windows Server | Ubuntu服务器| 网络演示| 官方网站

注意：该服务器是带有内置的MongoDB的编译版本，执行start.bat或start.sh启动，然后访问http://localhost:2020在Google Chrome中。 Windows版本需要Visual C++ Redistributable for Visual Studio 2015 。

好消息！基于Vite4 + Vue3 + TS5 + Ant-Design-Vue7的版本即将推出。单击此处查看更多详细信息。

• 名称：影子编辑器
• 版本：v0.6.1（即将推出）
• 描述：基于三个，Golang和MongoDB的跨平台3D场景编辑器。
• 资料来源：Github Gitee |文档：Gitee |演示：Github Gitee |视频：微博比利比利|资产：Baidunetdisk（RFJA）
• 技术堆栈：HTML，CSS，JavaScript，lolup，react.js，WebGl，three.js，Golang，MongoDB，Nodejs，nodejs，electron，“协议缓冲区”。
• 如果对您有帮助，请捐款以支持我们。谢谢你！

开源版本

Pro版本

V0.6.1即将推出

从v0.6.1开始，Shadoweditor仅提供核心功能和扩展API，并且在扩展中将提供其他功能，就像Vscode一样。我们将在dev分支机构中发展。

1. 修复某些版本的GO字体管理列表报告错误的错误。
2. 隐藏模型历史版本选项卡。
3. 选择精灵时，不再显示边框。
4. 修复搜索field下拉式样式错误。

V0.6.0已发布

• 发布日期：2021年7月24日
• 更新日志：

1. 修复当要求时创建新的mongo连接的错误。
2. 在状态栏中检查VR以启用VR。
3. 设定场景变换。
4. 单击对象时如何弹出窗口：https：//gitee.com/tengge1/shadoweditor/issues/i3apgi
5. 您可以在config.toml中启用https 。
6. 将移动浏览器中的事件添加到脚本： onTouchStart ， onTouchEnd ， onTouchMove 。
7. 升级three.js升至R130。
8. 将VR事件添加到脚本中： onVRConnected ， onVRDisconnected ， onVRSelectStart ， onVRSelectEnd 。
9. VR多合一的手柄控制器支持，例如：HTC Vive。
10. 修复删除脚本的错误。
11. 修复由于three.js的升级而无法序列化Geometry的错误。
12. 添加材料polygonOffset ， polygonOffsetFactor ， polygonOffsetUnits参数可视化设置，以解决深度冲突的问题。
13. 修复网格中组件的错误无法保存visible属性。
14. Bin类型模型不再支持。
15. 修复了立方体纹理错误。
16. 将所有prototype重写为源代码中的ES6 class 。
17. 删除视觉模块。
18. 修复导出场景时不会复制肯球纹理的错误。
19. 修复雨水和雪虫。
20. 修改背景颜色和照明，以免添加与背景相同的颜色，并使很难清楚地看到。
21. 修复粒子发射器错误。
22. 修复布错误。
23. 修复动态设置阴影的错误。

功能列表

• 一般的
  • 跨平台
    • Windows，Linux，Mac
    • 桌面，网络
  • 多语言支持
    • 英语、中文、繁体中文、日本语、한국어、
  • 资产管理
    • 场景，网格，纹理，材料，音频，动画，屏幕截图，视频，字体
  • 权威管理
    • 组织，用户
    • 角色，权威
    • 注册，登录，密码修改
  • 版本管理
    • 场景历史记录
    • 撤消，重做，自动保存
  • 球员
    • 实时在场景中播放动画，并且可以在全屏和新窗口中播放动画
  • 设置
    • 显示，渲染器，助手，过滤器，天气，控制模式，选择模式，添加模式，语言
• 小场景编辑
  • 添加网格
    • 3DS，3MF，AMF，Assimp，AWD，Babylon，BVH，Collada，CTM
    • Draco，FBX，GCODE，GLTF，GLB，JS，KMZ，LMESH，MD2，PMD，PMX
    • NRRD，OBJ，PCD，PDB，PLY，PRWM，SEA3D，STL，VRM，VRML，VRML，VTK，X
  • 内置对象
    • 团体
    • 飞机，立方体，圆，圆柱，球体，二十面体，圆环，圆环，茶壶，车床
    • 未量表的文字，3D文本
    • 线段，CATMULLROM曲线，二次BEZIER曲线，立方Bezier曲线，椭圆曲线
    • 点标记
    • 箭头助手，轴助手
    • 精灵
  • 内置灯
    • 环境光线，定向光，点光，聚光灯，半球灯，矩形灯光光
    • 点灯，半球灯，矩形区域轻辅助器
  • 内置组件
    • 背景音乐，粒子发射极
    • 天空，火，水，烟，布
    • 柏林地形，天空球
  • 材料编辑
    • LineBasicMaterial，排列的材料，网状材料，网格材料，元素材料
    • Meshlambertmaterial，Meshphongmaterial，Pointmaterial，网格标准材料，网状物理材料
    • 植物材料，浅色材料，生膜材料
  • 后处理
    • 后图，散景，点屏幕，fxaa，小故障
    • 半径，像素，RGB班次，SAO
    • SMAA，SSAA
    • ssao，taa
  • 文字编辑
    • 智力的JavaScript编辑
    • 着色器编辑
    • JSON文件编辑
  • 网格出口
    • gltf，obj ply stl stl，collada，draco
  • 场景出版
    • 将场景作为静态资源发布，可以嵌入iframe中
  • 例子
    • Arkanoid，相机，粒子，乒乓球，着色器
  • 一般工具
    • 选择，锅，旋转，变焦
    • 透视图，前视图，侧视图，顶视图，线框模式
    • 屏幕截图，记录
    • 绘制点，绘制线，绘制多边形，喷雾
    • 测量距离
  • 其他的
    • VR：纸板，HTC Vive，Chrome，Firefox
    • 子弹物理引擎
• UI控件
  • 帆布
  • 表格：按钮，复选框，表单，FormControls，Iconbutton，IconMenubutton，ImageButton，Intup，Label，LinkButton，Radio，SearchField，Select Field，Select，select，textarea，toggle
  • 图标
  • 图像：图像，成像师，ImageSelector，ImageuPloader
  • 布局：absolutelayout，concarylayout，borderlayout，hboxlayout，tableLayout，vboxlayout
  • 菜单：ContextMenu，Menubar，Menubarfiller，Menuitem，Menuitemseparator，Menutab。
  • 控制板
  • 进度：LoadMask
  • 属性：buttroperty，buttonsproperty，chackboxproperty，colorproperty，displayproperty，integerproperty，numberProperty，propertyGroperty，propertyGroup，propertyGroup，selectproperty，textproperty，textproperty，textureProperty，textureProperty
  • SVG
  • 表：datagrid，表格，表机构，tablecell，Tablehead，tablerow
  • 时间表
  • 工具栏：工具栏，工具栏，工具BarseParator
  • 树
  • 窗口：警报，确认，消息，照片，提示，吐司，视频，窗口

要求

1. MongoDB v3.6.8+
2. Chrome 81.0+或Firefox 75.0+

仅在要从源构建时才需要以下内容。

1. Golang 1.14.2+
2. Nodejs 14.1+
3. GCC 9.3.0+（ tdm-gcc ， MinGW-w64或Windows上的MinGW ，并确保可以通过命令行访问gcc ）
4. git 2.25.1+

注意：版本号仅用于参考。

下载并编译

您可以使用git下载源代码。

git clone https://github.com/tengge1/ShadowEditor.git

在中国， github确实很慢，您可以使用gitee 。

git clone https://gitee.com/tengge1/ShadowEditor.git

在Windows和Ubuntu上构建

网络版本：

1. 如果您在China ，则运行npm run set-proxy以将Golang和Nodejs代理设置。
2. 运行npm install以安装nodejs依赖关系。
3. 运行npm run build以构建服务器和Web。
4. 编辑build/config.toml ，然后修改蒙哥德主机和端口。
5. 运行npm start启动服务器。您现在可以访问： http://localhost:2020 。
6. 如果在配置文件中启用https 。请访问： https://localhost:2020 。

桌面版本：

1. 下载MongoDB并在utils/mongodb文件夹中解压缩。
2. 构建Web版本。
3. 运行npm run build-desktop ，以在文件夹build/desktop上构建桌面应用程序。

安装作为Windows服务

1. 作为管理员，在build文件夹中打开PowerShell或cmd 。
2. 运行.ShadowEditor install以安装Shadoweditor作为服务。
3. 运行.ShadowEditor start启动Shadoweditor服务。
4. 现在，您可以访问： http://localhost:2020 。
5. 您还可以在Windows Services Manager中管理此服务。

作为Ubuntu服务安装

1. 编辑./scripts/service_linux/shadoweditor.service ，设置正确的路径。
2. 运行sudo cp ./scripts/service_linux/shadoweditor.service /etc/systemd/system/ 。
3. 运行sudo systemctl daemon-reload以重新加载服务守护程序。
4. 运行sudo systemctl start shadoweditor开始服务。
5. 运行sudo systemctl enable shadoweditor自动启动服务。

命令行的用法

 PS E:githubShadowEditorbuild> .ShadowEditor
ShadowEditor is a 3D scene editor based on three.js, golang and mongodb.
This application uses mongodb to store data.

Usage:
  ShadowEditor [command]

Available Commands:
  debug       Debug service on Windows
  help        Help about any command
  install     Install service on Windows
  serve       Start server
  start       Start service on Windows
  stop        Stop service on Windows
  version     Print the version number

Flags:
      --config string   config file (default "./config.toml")
  -h, --help            help for ShadowEditor

Use "ShadowEditor [command] --help" for more information about a command.

开发指南

1. 下载并安装NodeJs ， golang ， MongoDB和Visual Studio Code 。
2. 建议安装以下Vscode扩展名，这可能有用。

 ESLint, Go, Shader languages support for VS Code, TOML Language Support.

NPM脚本的用法：

 npm install:            install nodejs dependencies.
npm run build:          build the server and web client.
npm run build-server:   build only the server. (For development)
npm run build-web:      build only the web client. (For development)
npm run build-desktop:  build the desktoop version.
npm run dev:            build the web client automatically when files changes.(For development)
npm run copy:           Copy assets from web folder to build folder.
npm run start:          start the web server.
npm run set-proxy:      set golang and nodejs proxy. (In China only)
npm run unset-proxy:    unset golang and nodejs proxy.
npm run install-dev:    install golang development tools.
npm run eslint:         check js files and fix errors automatically.
npm run clean:          delete the web and desktop builds.
npm run clear:          delete useless nodejs packages.

贡献

扩展到查看详细信息

Shadoweditor是用户和开发人员的项目。您可以在此项目上做出贡献并尝试您的想法。没有退休金，但是很有趣。为了做出贡献，您应该：

1. 分叉存储库。
2. 创建Feats_xxx分支。
3. 提交您的代码。
4. 创建拉请请求。

注意：请勿提交大型二进制文件，否则可能会拒绝Pull Request 。如果需要，您可以将文件或目录添加到.gitignore文件中。

常见问题

扩展到查看详细信息

1. 上传模型时失败。

您需要将模型资产压缩到zip文件中，并且条目文件不能嵌套在文件夹中。该服务器将解压缩并将其放入./build/public/Upload/Model文件夹中，并在MongoDB _Mesh Collection中添加记录。

2. 如何将多个模型结合在一起？

基本几何形状支持多个嵌套的层次。您可以添加一个group （在几何菜单中），然后将多个型号拖到Hierachy面板中的group中。

3. 如何实现权威？

编辑config.toml并true authority.enabled 。默认管理员用户名是admin ，密码为123456 。

4. asm.js has been disabled because the script debugger is connected. Please disconnect the debugger to enable asm.js.错误。

完全错误：ASM.JS已被禁用，因为脚本调试器已连接。请断开调试器以启用ASM.J。 ammo.js（1,1）Script1028：Script1028：预期标识符，字符串或编号Shadoweditor.js（3948,8）Script5009：未定义“ Shadow”。

解决方案：Tencent浏览器不支持与Emscripten编译的ammo.js （WebAssembly），建议使用Chrome或Firebox 。

5. 如何从C＃升级到Golang版本？

数据结构和Web客户端没有更改，只需复制./ShadowEditor.Web/Upload/文件夹即可build/public/Upload/ 。

6. 桌面版本无法打开。

Windows需要Visual C++ Redistributable for Visual Studio 2015 。您可以从以下安装：https：//www.microsoft.com/en-us/download/details.aspx?id=48145
如果无法打开桌面版本，则可以查看logs.txt ;如果端口发生冲突，您可以在resources/app/config.toml中修改MongoDB和网站端口。

7. 如何创建HTTPS证书？

安装openssl ，Git客户端已经包含一个；打开cmd ， Powershell或shell ，并运行以下命令：

openssl genrsa -out privatekey.pem 1024
openssl req -new -key privatekey.pem -out certrequest.csr
openssl x509 -req -in certrequest.csr -signkey privatekey.pem -out certificate.pem

在生成的文件中， certificate.pem是证书， privatekey.pem是关键。

执照

麻省理工学院许可证

开源项目

扩展到查看详细信息

多亏了以下开源项目。

https://github.com/golang/go
https://github.com/burntsushi/toml
https://github.com/dgrijalva/jwt-go
https://github.com/dimfeld/httptreemux
https://github.com/inconshrevable/mousetrap
https://github.com/json-iterator/go
https://github.com/mozillazg/go-pinyin
https://github.com/otiai10/copy
https://github.com/sirupsen/logrus
https://github.com/spf13/cobra
https://github.com/spf13/viper
https://github.com/urfave/negroni
https://go.mongodb.org/mongo-driver

https://github.com/facebook/reaect
https://github.com/mrdoob/three.js
https://github.com/rollup/rollup
https://github.com/babel/babel
https://github.com/eslint/eslint
https://github.com/rollup/rollup-plugin-babel
https://github.com/rollup/rollup-plugin-commonjs
https://github.com/rollup/rollup-plugin-json
https://github.com/rollup/rollup-plugin-node-rasolve
https://github.com/egoist/rollup-plugin-postcss
https://github.com/rollup/rollup-plugin-replace
https://github.com/mjeanroy/rollup-plugin-strip-banner
https://github.com/andyearnshaw/rollup-plugin-bundle-worker

https://github.com/teinijs/twien.js
https://github.com/jedwatson/classnames
https://github.com/d3/d3-dispatch
https://github.com/i18next/i18next
https://github.com/js-cookie/js-cookie
https://github.com/facebook/prop-types
https://github.com/codemirror/codemirror
https://github.com/jquery/esprima
https://github.com/tschw/glslprep.js
https://github.com/zaach/jsonlint
https://github.com/acornjs/acorn
https://github.com/kripken/ammo.js
https://github.com/dataarts/dat.gui
https://github.com/toji/gl-matrix
https://github.com/squarefeet/shaderparticleengine
https://github.com/mrdoob/stats.js
https://github.com/mrdoob/texgen.js
https://github.com/yomotsu/volumetricfire
https://github.com/jonbretman/amdto-to-as6
https://github.com/chandlerprall/threecsg