mirror of
https://github.com/CopterExpress/clever-show.git
synced 2026-06-04 11:09:33 +00:00
docs: Update blender-addon article
This commit is contained in:
@@ -1,30 +1,33 @@
|
||||
# Установка и настройка аддона
|
||||
## Установка
|
||||
1. Скачайте [аддон](https://github.com/artem30801/blender-csv-animation) для экспорта анимации из Blender в полётные пути для коптеров.
|
||||
2. Скачайте и установите согласно инструкциям последнюю версию Blender 2.8 (beta) с [оффициального сайта](https://builder.blender.org/download/) или при использовании OS Linux через команду терминала:
|
||||
```bash
|
||||
snap install blender --channel=beta --classic
|
||||
```
|
||||
3. Откройте Blender, в верхнем меню выберите `Edit > Preferences`. В открывшемся окне настроек в боковой панели выберите пункт `Add-ons`. Нажмите на кнопку `Install...` в верхнем правом углу окна. В диалоговом окне откройте путь к папке со склонированным репозиторием проекта и выберите файл `addon.py` по пути [`blender-csv-animation/addon.py`](https://github.com/artem30801/blender-csv-animation/blob/master/addon.py). Нажмите `Install Add-on from file...`. Аддон установлен.
|
||||
## Активация
|
||||
В выпадающем списке `All` выберите пункт `User`. Поставьте "галочку" напротив аддона `Import-Export: Export > CSV Drone Swarm Animation Exporter` для активации аддона. Аддон активирован и готов к работе. Выполнение этих операций не понадобится при дальнейших запусках Blender.
|
||||
## Дополнительно
|
||||
Для деактивации аддона уберите "галочку" напротив имени аддона, как описано в предыдущем пункте. Для получения дополнительных сведений (версия, путь к файлу...) нажмите знак стрелочки слева от поля активации. В развернувшемся блоке так же есть кнопки: `Documentation` - ведет на страницу документации аддона (вы тут); `Report a bug` - ведет на страницу багтрекера на репозитории аддона; `Remove` - удалят (деинсталлирует) аддон (перед установокой новой версии рекомендуется удалить старую).
|
||||
# Подготовка и создание анимации дронов
|
||||
## Взлёт
|
||||
...
|
||||
## Посадка
|
||||
**Внимание!** В анимации НЕ нужно отображать процесс посадки коптера до момента касания с полом. Снижение (с любой высоты) и посадка будут совершены автоматически из последней точки анимации данного дрона.
|
||||
# Аддон для экспорта анимации из Blender
|
||||
|
||||
Аддон для Blender предназначен для преобразования анимации полёта коптеров, нарисованной в Blender, в полётные пути для каждого коптера анимации, с учётом цвета объектов в каждый момент времени.
|
||||
|
||||
## Установка и настройка
|
||||
|
||||
* Скачайте и установите согласно инструкциям последнюю версию Blender 2.81 с [оффициального сайта](https://www.blender.org/download/).
|
||||
* Откройте Blender, в верхнем меню выберите `Edit > Preferences`. В открывшемся окне настроек в боковой панели выберите пункт `Add-ons`. Нажмите на кнопку `Install...` в верхнем правом углу окна. В диалоговом окне откройте путь к папке с аддоном [clever-show/blender-addon](../../blender-addon/) и выберите файл `addon.py`. Нажмите `Install Add-on from file...`. Аддон установлен.
|
||||
* После установки аддона поставьте "галочку" напротив аддона `Import-Export: Export > CSV Drone Swarm Animation Exporter` для активации аддона.
|
||||
|
||||
Аддон активирован и готов к работе. Выполнение этих операций не понадобится при дальнейших запусках Blender.
|
||||
|
||||
## Экпорт при помощи аддона
|
||||
|
||||
[Пример](https://github.com/artem30801/blender-csv-animation/blob/master/Examples/copter_base_animation.blend) можно использовать в качестве шаблона.
|
||||
# Экпорт при помощи аддона
|
||||
Для вызова диалогового окна экспорта нажмите в верхнем меню `File > Export > CSV Drone Swarm Animation Exporter`. В открывшемся окне экспорта необходимо выбрать целевой путь экспорта и название папки, которую создаст аддон в процессе экспорта. В боковом меню доступна панель параметров экспорта:
|
||||
* `Use name filter for objects` - при отключении этого параметра будут экспортированы _все видимые объекты_
|
||||
* `Name identifier`
|
||||
* `Show detailed animation warnings` -
|
||||
* `Speed limit` - при нарушении указанного ограничения по скорости передвижения дронов будут выведены предупреждения
|
||||
* `Distance limit` - при нарушении указанной минимальной дистанции между дронами будут выведены предупреждения
|
||||
После настройки (при необходимости) нужных параметров нажмите кнопку `Export Drone Swarm animation`
|
||||
<!--stackedit_data:
|
||||
eyJoaXN0b3J5IjpbLTE5OTU5ODU3ODJdfQ==
|
||||
-->
|
||||
|
||||
* `Use name filter for objects` - чекбокс, определяет, будет ли использован фильтр объектов при сохранении их путей. При отключении этого параметра будут экспортированы пути всех видимых объектов.
|
||||
* `Name identifier` - фильтр имён объектов. Если активен чекбокс `Use name filter for objects`, будут сохранены только пути объектов, содержащих данное значение в названии.
|
||||
* `Show detailed animation warnings` - чекбокс, определяет, будут ли показаны предупреждения по превышению скоростей и расстояний в анимации.
|
||||
* `Speed limit` - при нарушении указанного ограничения по скорости передвижения дронов будут выведены предупреждения.
|
||||
* `Distance limit` - при нарушении указанной минимальной дистанции между дронами будут выведены предупреждения.
|
||||
|
||||
После настройки нужных параметров нажмите кнопку `Export Drone Swarm animation`. В указанную папку экспортируются анимации указанных объектов из проекта Blender в формате `.csv`.
|
||||
|
||||
## Деактивация и удаление
|
||||
|
||||
Для деактивации аддона уберите "галочку" напротив имени аддона, как описано [выше](#установка-и-настройка).
|
||||
|
||||
Для получения дополнительных сведений нажмите знак стрелочки слева от поля активации. В развернувшемся блоке так же есть кнопки:
|
||||
|
||||
* `Documentation` - ведет на страницу документации аддона
|
||||
* `Report a bug` - ведет на страницу issues репозитория clever-show
|
||||
* `Remove` - удаляет аддон (перед установкой новой версии рекомендуется удалить старую)
|
||||
|
||||
Reference in New Issue
Block a user