diff --git a/docs/ru/blender-addon.md b/docs/ru/blender-addon.md index 6af6eb8..35b9496 100644 --- a/docs/ru/blender-addon.md +++ b/docs/ru/blender-addon.md @@ -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` - \ No newline at end of file + +* `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` - удаляет аддон (перед установкой новой версии рекомендуется удалить старую)