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