Shadow Editor

Английский / Китайский | Сервер для Windows | Сервер для 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 уже работает. Перейти здесь для просмотра подробностей.

Название: Shadow Editor
Версия: v0.6.1 (в разработке)
Описание: Кросс-платформенный 3D редактор сцен на основе three.js, golang и MongoDB.
Исходники: GitHub Gitee | Документация: Gitee | Примеры: GitHub Gitee | Видео: Weibo Bilibili | Ассеты: BaiduNetdisk(rfja)
Технологическая стопка: html, css, javascript, rollup, react.js, webgl, three.js, golang, mongodb, nodejs, electron, протокол буферов.
Если вам помогло это приложение, пожалуйста, помогите нам.

Открытая версия

Профессиональная версия

v0.6.1 в разработке

Начиная с версии v0.6.1, ShadowEditor будет предоставлять основные возможности и расширенные API, а остальные функции будут доступны через расширения, как в VSCode. Мы будем развивать проект в ветке dev.

Устранение ошибки отображения списка типографских символов в некоторых версиях Go.
Скрытие вкладки истории версий модели.
При выборе спрайта граница больше не отображается.
Устранение ошибки стилей выпадающего меню поиска.

v0.6.0 вышла

Дата выхода: 24 июля 2021 года
Журнал обновлений:

Устранение ошибки создания нового соединения с базой данных MongoDB при запросах.
Проверка VR в строке состояния для активации VR.
Настройка преобразования сцены.
Как показывать окно при клике на объект: https://gitee.com/tengge1/ShadowEditor/issues/I3APGI
Можно включить https в конфигурационном файле config.toml.
Добавление событий для мобильных браузеров в скрипт: onTouchStart, onTouchEnd, onTouchMove.
Обновление three.js до версии r130.
Добавление событий VR в скрипт: onVRConnected, onVRDisconnected, onVRSelectStart, onVRSelectEnd.
Поддержка всех типов контроллеров VR, таких как HTC Vive.
Устранение ошибки удаления скриптов.
Устранение ошибки сериализации Geometry после обновления three.js.
Добавление параметров визуализации материала polygonOffset, polygonOffsetFactor, polygonOffsetUnits для решения проблемы конфликта глубины.
Устранение ошибки сохранения атрибута visible компонентов в сетке.
Отказ от поддержки типа модели Bin.
Устранение ошибки кубической текстуры.
Переписывание всех методов prototype на ES6 class в исходном коде.
Удаление модуля визуализации.
Устранение ошибки экспорта сцены без копирования текстуры неба.
Устранение ошибок дождя и снега.
Изменение цвета фона и освещения для лучшей видимости.
Устранение ошибки эмиттера частиц.
Устранение ошибки ткани.
Устранение ошибки динамического настройки тени.

Список функций- [x] Общие

Требования

MongoDB v3.6.8+
Chrome 81.0+ или Firefox 75.0+

Если вам требуется создать исходный код, следующие требования применимы:

GoLang 1.14.2+
NodeJS 14.1+
gcc 9.3.0+ (tdm-gcc, MinGW-w64 или MinGW для Windows, и доступный из командной строки)
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

Веб-версия:

Если вы в Китае, выполните команду npm run set-proxy, чтобы настроить прокси для GoLang и NodeJS.
Выполните команду npm install, чтобы установить зависимости NodeJS.
Выполните команду npm run build, чтобы собрать сервер и веб-приложение.
Измените файл build/config.toml, чтобы задать сервер MongoDB и порт.
Выполните команду npm start, чтобы запустить сервер. Теперь вы можете использовать ShadowEditor по адресу http://localhost:2020.
Если вы включили https в конфигурационном файле, вы можете посетить адрес https://localhost:2020.

Десктопная версия:

Скачайте MongoDB и распакуйте в папку utils/mongodb.
Соберите веб-версию.
Выполните команду npm run build-desktop, чтобы собрать версию для десктопа в папке build/desktop.

Установка как службы Windows

Откройте PowerShell или cmd с правами администратора в папке build.
Выполните команду .\ShadowEditor install, чтобы установить ShadowEditor как службу.
Выполните команду .\ShadowEditor start, чтобы запустить службу ShadowEditor.
Теперь вы можете посетить адрес: http://localhost:2020.
Эта служба также может быть управлена через Управление службами Windows.

Установка как службы Ubuntu

Измените файл ./scripts/service_linux/shadoweditor.service, установив правильный путь.
Выполните команду sudo cp ./scripts/service_linux/shadoweditor.service /etc/systemd/system/.
Выполните команду sudo systemctl daemon-reload, чтобы перезагрузить демона системы.
Выполните команду sudo systemctl start shadoweditor, чтобы запустить службу.
Выполните команду sudo systemctl enable shadoweditor, чтобы автоматически запускать службу при старте системы.

Использование командной строки

PS E:\github\ShadowEditor\build\> .\ShadowEditor
ShadowEditor — это редактор сцен 3D, основанный на three.js, golang и mongodb.
Этот приложение использует mongodb для хранения данных.

Использование:
  ShadowEditor [команда]

Доступные команды:
  debug       Отладка службы на Windows
  help        Помощь по любой команде
  install     Установка службы на Windows
  serve       Запуск сервера
  start       Запуск службы на Windows
  stop        Остановка службы на Windows
  version     Вывод номера версии
```Флаги:
      --config string   конфигурационный файл (по умолчанию "./config.toml")
  -h, --help            помощь по ShadowEditor

Используйте "ShadowEditor [команда] --help", чтобы получить больше информации о команде.


## Разработчики

1. Скачайте и установите `NodeJs`, `golang`, `MongoDB` и `Visual Studio Code`.
2. Рекомендуется установить следующие расширения для VSCode, которые могут быть полезны.

ESLint, Go, Поддержка шейдерных языков для VS Code, Поддержка TOML.


Использование npm скриптов:

npm install: установка зависимостей NodeJS. npm run build: сборка сервера и веб-клиента. npm run build-server: сборка только сервера. (Для разработки) npm run build-web: сборка только веб-клиента. (Для разработки) npm run build-desktop: сборка версии для десктопа. npm run dev: автоматическая сборка веб-клиента при изменения файла. (Для разработки) npm run copy: копирование активов из папки web в папку build. npm run start: запуск веб-сервера. npm run set-proxy: установка прокси для golang и nodejs. (Только для Китая) npm run unset-proxy: удаление прокси для golang и nodejs. npm run install-dev: установка инструментов разработки для golang. npm run eslint: проверка js файлов и автоматическое исправление ошибок. npm run clean: удаление сборок веб-клиента и версии для десктопа. npm run clear: удаление ненужных пакетов NodeJS.


## Вклад

<details>
  <summary>Развернуть для просмотра деталей</summary>

ShadowEditor — это проект как для пользователей, так и для разработчиков. Вы можете вносить свой вклад и реализовывать свои идеи в этом проекте. Нет зарплаты, но много удовольствия. Для участия вам следует:

1. Создать форк репозитория.
2. Создать ветку Feat_xxx.
3. Применить ваш код.
4. Создать запрос на слияние.

**Примечание:** НЕ отправляйте большие двоичные файлы, иначе запрос на слияние будет отклонён. Если требуется, вы можете добавить файлы или директории, которые должны игнорироваться, в файл `.gitignore`.
</details>

## Часто задаваемые вопросы

<details>
  〈summary〉Развернуть для просмотра деталей〈/summary〉

1. Возникли проблемы при загрузке моделей.

Вы должны сжать ассеты модели в файл `zip`, и входной файл не должен находиться внутри папки. Сервер разархивирует его и помещает в папку `./build/public/Upload/Model`, а затем добавляет запись в коллекцию MongoDB `_Mesh`.

2. Как объединить несколько моделей вместе?

Основная геометрия поддерживает многократное вложенное расположение. Вы можете создать группу (в меню геометрии), а затем перетянуть несколько моделей на группу в панели `Hierachy`.

3. Как включить права доступа?

Отредактируйте файл `config.toml` и установите значение `authority.enabled` равным `true`. По умолчанию имя пользователя администратора — `admin`, пароль — `123456`.

4. Браузер сообщает об ошибке `asm.js был отключен из-за подключения скрипт-дебаггера.`

**Полная ошибка:** asm.js был отключен из-за подключения скрипт-дебаггера. Чтобы включить asm.js, отсоедините дебаггер. ammo.js (1,1) SCRIPT1028: SCRIPT1028: Ожидался идентификатор, строка или число ShadowEditor.js (3948,8) SCRIPT5009: 'Shadow' не определено.

**Решение:** браузер Tencent не поддерживает `ammo.js` (WebAssembly), скомпилированный с помощью `Emscripten`. Рекомендованы браузеры Chrome или Firefox.

5. Как можно обновиться с версии C# до версии на golang?

Структура данных и веб-клиент не изменились, просто скопируйте папку `./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`; если порты заняты, измените порты MongoDB и сайта в файле `resources/app/config.toml`.

7. Как можно создать сертификат HTTPS?

Установите `openssl`, который уже содержится в клиенте git; Откройте `cmd`, `PowerShell` или `shell`, и выполните следующие команды:

```sh
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 — ключом.

Лицензия

Лицензия MIT

Проекты открытого исходного кода

Развернуть для просмотра деталей

Благодарность за следующие проекты открытого исходного кода.

https://github.com/golang/go
https://github.com/BurntSushi/toml
https://github.com/dgrijalva/jwt-go
https://github.com/dimfeld/httptreemux
https://github.com/inconshreveable/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

OSCHINA-MIRROR/ShadowEditor-ShadowEditor

Shadow Editor

v0.6.1 в разработке

v0.6.0 вышла

Список функций- [x] Общие

Требования

Скачивание и сборка

Сборка на Windows и Ubuntu

Установка как службы Windows

Установка как службы Ubuntu

Использование командной строки

Лицензия

Проекты открытого исходного кода

Опубликовать ( 0 )

Введение

Обновления

Участники

Недавние действия

OSCHINA-MIRROR/ShadowEditor-ShadowEditor .gitee-modal { min-width: 500px !important; } .gitee-modal .close { right: 0.6rem !important; }

Shadow Editor

v0.6.1 в разработке

v0.6.0 вышла

Список функций- [x] Общие

Требования

Скачивание и сборка

Сборка на Windows и Ubuntu

Установка как службы Windows

Установка как службы Ubuntu

Использование командной строки

Лицензия

Проекты открытого исходного кода

Опубликовать ( 0 )

Введение

Обновления

Участники

Недавние действия

OSCHINA-MIRROR/ShadowEditor-ShadowEditor