Installation

Данная страница содержит инструкции по установке аддона blender-xray.

Оглавление

• Установка для пользователей
  • Краткое руководство
  • Полное руководство
• Установка для тестеров
• Удаление аддона
• Обновление аддона
  
  

Установка для пользователей
В этом разделе описано, как пользователям установить аддон.

• Краткое руководство

1. скачиваем последнюю версию аддона
2. скачиваем, устанавливаем и запускаем blender
3. открываем окно настроек blender
4. переходим на вкладку с аддонами
5. нажимаем кнопку для установки аддонов
6. выбираем файл аддона
7. активируем аддон
8. настраиваем аддон
9. сохраняем настройки

• Полное руководство

1. Скачиваем последнюю версию аддона со страницы релизов. Подробнее: Download. Аддон - это архив с именем blender-xray-X.X.X.zip. Ссылки Source code (zip) и Source code (tar.gz) дают возможность скачать исходники аддона, которые не предназначены для конечных пользователей. Для скачивания более ранних версий, понадобиться развернуть свиток Assets на странице релиза.

2. Скачиваем, устанавливаем и запускаем blender. Список поддерживаемых версий находится здесь: поддерживаемые версии blender. Скачать последнюю версию blender можно со страницы: blender.org/download. Для скачивания более ранних версий воспользуйтесь этой ссылкой: download.blender.org/release. Можно скачать как установщик, так и автономный zip-архив.

3. Открываем окно настроек blender. В версии 2.7x настройки находятся в меню File > User Preferences (Ctrl + Alt + U), а в версии 2.80 и выше в меню Edit > Preferences.

4. Переходим на вкладку Add-ons.

5. Нажимаем кнопку для установки аддона. В 2.7x это Install Add-on from File... (внизу окна), а в 2.8x-2.9x - Install... (справа вверху окна).

6. После этих действий откроется файловый браузер, в котором нужно выбрать файл аддона (blender-xray-X.X.X.zip), скачанный на этапе 1.

7. Когда установка завершится, blender отфильтрует список аддонов так, что в списке будет только один аддон blender-xray. Если по каким либо причинам фильтрация удалена, то аддон нужно найти вручную. Для этого нужно вписать в поиск слово xray. Поле поиска имеет иконку лупы и в 2.7x находится слева вверху, а в 2.8x-2.9x справа вверху.

8. Когда аддон найден, нужно его активировать, поставив у него галочку рядом с названием. После этого название аддона перестанет быть серым и станут доступны его настройки.

9. Сохраняем настройки. Для этого нужно нажать кнопку (слева внизу окна). В версии 2.7x эта кнопка Save User Settings, а в 2.8x-2.9x - Save Preferences.

Установка для тестеров
Тестерам желательно устанавливать не зарелизеную версию аддона. Для этого нужно скачать исходный код из самого последнего коммита ветки develop.

1. Скачиваем исходный код из последнего коммита ветки develop. См. Download.

2. Скачиваем и устанавливаем blender. Более подробно описано выше, в разделе Complete guide. После установки blender, нужно его запустить, чтобы создались директории для файлов blender (в windows директории будут находится здесь: C:\Users\<USER_NAME>\AppData\Roaming\Blender Foundation\Blender\<BLENDER-VERSION>\).

3. Распаковываем архив с исходным кодом аддона.

4. Копируем папку io_scene_xray в папку аддонов blender. В windows путь к аддонам выглядит примерно так: C:\Users\<USER_NAME>\AppData\Roaming\Blender Foundation\Blender\<BLENDER_VERSION>\scripts\addons\, где <BLENDER_VERSION> является версией blender (например, 2.83), а <USER_NAME> - имя пользователя windows (например, Admin). В итоге путь к аддону будет таким (если имя пользователя Admin, а версия blender 2.83): C:\Users\Admin\AppData\Roaming\Blender Foundation\Blender\2.83\scripts\addons\io_scene_xray\.

5. Далее выполняем 3, 6, 7, 8, 9 пункты раздела Complete guide

Удаление аддона
TODO

Обновление аддона
Автоматическое обновление аддона на данный момент отсутствует. Чтобы вручную обновить аддон, нужно его удалить и установить новую версию, как описано выше.