1 Star 0 Fork 269

甲人乙路 / ShadowEditor

forked from tengge1 / ShadowEditor 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

Shadow Editor

English / 中文    |    Windows桌面版    |    Ubuntu桌面版    |    Web演示

star fork image image image image image

  • 名称:Shadow Editor
  • 版本:v0.5.5 (开发中)
  • 简介:基于Three.js、Go语言和MongoDB的跨平台的3D场景编辑器。
  • 源码:GitHub Gitee | 文档:Gitee | 示例:GitHub Gitee | 视频:微博 Bilibili | 资源:百度网盘
  • 技术栈:html、css、javascript、rollup、react.js、webgl、three.js、golang、mongodb、nodejs、electron。
  • 如果对您有帮助,请【捐赠】支持项目发展。谢谢!

image

v0.5.5即将发布

v0.5.4发布【更新日志】

  • 发布日期:2020年6月27日
  • 更新日志:
  1. 使用Electron创建桌面应用程序。

Windows桌面版:https://github.com/tengge1/ShadowEditor/releases/download/v0.5.4/ShadowEditor-win32-x64.zip

Ubuntu桌面版:https://github.com/tengge1/ShadowEditor/releases/download/v0.5.4/ShadowEditor-linux-x64.zip

说明:Windows需要Visual C++ Redistributable for Visual Studio 2015。你可以从这安装:https://www.microsoft.com/en-us/download/details.aspx?id=48145

  1. 使用命令行在Windows上安装和启动ShadowEditor服务。

.\ShadowEditor install: 在Windows上安装服务。
.\ShadowEditor remove: 在Windows上移除服务。
.\ShadowEditor start: 在Windows上启动服务。
.\ShadowEditor stop: 在Windows上停止服务。

你也可以在Windows服务管理器中管理这个服务。

  1. 使用nodejs重写脚本,现在你可以使用npm管理这个项目。

功能特点

  1. 跨平台:支持WindowsLinuxMac;支持桌面版和Web版。
  2. 支持多种3D格式:3ds, 3mf, amf, assimp(anim), awd, babylon, binary, bvh(anim), collada, ctm, draco , fbx(anim), gcode, gltf(gltfglb, anim), js(anim), kmz, lmesh(anim), md2, mmd(pmdpmx, anim), nrrd, obj, pcd, pdb, ply, prwm, sea3d(anim), stl, vrm, vrml, vtk, X. (anim)表示支持动画。
  3. 内置物体:组;平面、正方体、圆、圆柱体、球体、二十面体、圆环面、圆环结、茶壶、车床;不缩放文字、三维文字;线段、CatmullRom曲线、二次贝塞尔曲线、三次贝塞尔曲线、椭圆曲线;点标注;箭头帮助器、轴帮助器;精灵。
  4. 内置光源:环境光、平行光、点光源、聚光灯、半球光、矩形光。
  5. 内置组件:背景音乐、粒子发射器、天空、火焰、水、烟、布、柏林地形、天空球。
  6. 支持材质:线条材质、虚线材质、基本材质、深度材质、法向量材质、兰伯特材质、冯氏材质、点云材质、标准材质、物理材质、精灵材质、着色器材质、原始着色器材质。
  7. 编辑javascript着色器程序json,具有智能提示。
  8. 实时播放器可以播放场景中的动画。
  9. 导出gltfobjplystlColladaDRACO模型。
  10. 将场景发布成静态资源,可以嵌入iframe中。
  11. 支持语言:English中文繁體中文日本語한국어русскийLe français
  12. 场景版本管理:支持历史记录和日志、撤销和重做,自动保存。
  13. 权限管理:组织机构、用户、角色、权限、注册、登录、修改密码。
  14. 资源管理:场景、模型、贴图、材质、音频、动画、截图、录制视频、字体。

需求

  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+ (Windows上需要安装tdm-gccMinGW-w64MinGW。请保证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上构建

Web版:

  1. 如果你在国内, 执行npm run set-proxy设置go语言和nodejs代理。
  2. 执行npm install安装nodejs依赖。
  3. 执行npm run build构建服务端和Web端。
  4. 编辑build/config.toml,修改MongoDB的host和port设置。
  5. 执行npm run start启动服务端。现在你可以访问:http://localhost:2020

桌面版:

  1. 下载MongoDB,解压到utils/mongodb文件夹中。
  2. 构建Web版。
  3. 执行npm run build-desktop可以在文件夹build/desktop中创建一个桌面版应用。

安装为Windows服务

  1. 以管理员身份在build文件夹中打开PowerShellcmd
  2. 运行.\ShadowEditor install,将ShadowEditor安装为服务。
  3. 运行.\ShadowEditor start,启动ShadowEditor服务。
  4. 现在你可以访问:http://localhost:2020
  5. 你也可以在Windows服务管理器中管理这个服务。

安装为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:\github\ShadowEditor\build\> .\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, MongoDBVisual Studio Code.
  2. 推荐安装以下VSCode扩展, 它们对开发很有用。
ESLint, Go, Shader languages support for VS Code, TOML Language Support.

npm脚本使用:

npm install:            安装nodejs依赖。
npm run build:          构建服务端和web客户端。
npm run build-server:   只构建服务端。(用于开发)
npm run build-web:      只构建web客户端。(用于开发)
npm run build-desktop:  构建桌面版。
npm run dev-web:        文件改编后自动构建web客户端。(用于开发)
npm run start:          启动web服务端。
npm run set-proxy:      设置golang和nodejs代理。(仅在国内使用)
npm run unset-proxy:    取消设置golang和nodejs代理。
npm run install-dev:    安装golang开发工具。
npm run eslint:         检查js文件,自动修复错误。
npm run clean:          删除构建的web版和桌面版。
npm run clear:          删除没用的nodejs包。

参与贡献

ShadowEditor是一个为用户和开发者而生的项目。在这个项目上,你可以提交代码,尝试你的想法。没有报酬,但是有很多乐趣。提交代码,你需要:

  1. Fork 本仓库。
  2. 新建 Feat_xxx 分支。
  3. 提交代码。
  4. 新建 Pull Request。

注意: 不要提交大的二进制文件,否则可能会被拒绝。如果需要,你可以把想忽略的文件或目录添加到.gitignore文件中。

常见问题

  1. 上传模型失败。

需要把模型贴图等资源压缩成一个zip包,而且入口文件不能嵌套文件夹。服务端会解压上传的zip包到./build/public/Upload/Model文件夹,并在MongoDB _Mesh表里添加一条记录。

  1. 如何将多个模型组合在一起?

基本几何体都支持多层嵌套。可以添加一个(在几何体菜单中),然后在场景树状图上,将多个模型拖动到上。

  1. 如何开启权限系统?

编辑config.toml文件,将authority.enabled设置为true。默认管理员用户名是admin,密码是123456

  1. 前端报asm.js 已被禁用,因为脚本调试程序已连接。请断开调试程序的连接,以启用 asm.js。的错误。

完整错误:asm.js 已被禁用,因为脚本调试程序已连接。请断开调试程序的连接,以启用 asm.js。 ammo.js (1,1) SCRIPT1028: SCRIPT1028: Expected identifier, string or number ShadowEditor.js (3948,8) SCRIPT5009: 'Shadow' is not defined。
解决方法:腾讯浏览器不支持使用Emscripten编译的ammo.js(WebAssembly),建议换成谷歌浏览器或火狐浏览器。

  1. 怎么从C#版本升级到golang版本?

数据结构和客户端都没变,只需要把文件夹./ShadowEditor.Web/Upload/复制到build/public/Upload/即可。

开源项目

点击查看详情。

MIT License Copyright (c) 2017-2020 The ShadowEditor Authors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

基于Three.js、Go语言和MongoDB的跨平台的3D场景编辑器,支持桌面版和Web版。 展开 收起
JavaScript
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
JavaScript
1
https://gitee.com/sk88/ShadowEditor.git
git@gitee.com:sk88/ShadowEditor.git
sk88
ShadowEditor
ShadowEditor
master

搜索帮助

14c37bed 8189591 565d56ea 8189591