Installation

Описание

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

Установка для пользователей

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

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

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

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

1. Скачиваем последнюю версию аддона со страницы релизов. Подробнее: Скачать. Аддон - это архив с именем 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.80-4.3 - Install... (справа вверху окна).

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

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

8. После активации аддона, его нужно настроить. Все параметры описаны на странице Настройки.

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

Установка для тестеров

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

1. Скачиваем исходный код из последнего коммита ветки develop. Более подробно описано на странице Скачать.

2. Скачиваем и устанавливаем blender. Более подробно описано выше, в разделе Полное руководство. После установки 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, 7, 8, 9 пункты раздела Полное руководство

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

Чтобы удалить аддон, нужно проделать следующие действия:

• Запустить blender и зайти в настройки. В версии 2.7x настройки находятся в меню File > User Preferences (Ctrl + Alt + U), а в версии 2.80 и выше в меню Edit > Preferences.
• Открыть вкладку Add-ons, перейти в раздел Import-Export и найти аддон X-Ray Engine Tools или в поле поиска (имеет иконку лупы) вписать слово xray и среди найденных аддонов найти X-Ray Engine Tools.
• Отключить аддон, если он активирован. Для этого нужно снять галочку возле имени аддона. После чего имя аддона станет серым и не будут доступны настройки аддона.
• Далее нужно нажать кнопку Remove, которая находится в нижней части рамки с описанием аддона (рамка должна быть развёрнута с помощью треугольника рядом с названием аддона).
• Сохранить настройки blender. Для этого нужно нажать кнопку (слева внизу окна). В версии 2.7x это кнопка Save User Settings, а в 2.80-4.3 - Save Preferences.

Обновление аддона

Чтобы обновить аддон, нужно запустить оператор Check for Update, который находится в N-панели окна 3D Viewport, во вкладке X-Ray, панель Update. Если доступна новая версия, то нужно подтвердить установку, нажав кнопку Install Update?. Если новой версии нет, то будет предупреждение. Так же аддон может оповестить о новой версии с помощью сообщения в Status Bar. Это происходит во время запуска blender, если в настройках аддона активирован параметр Others > Check for Updates after Staring Blender.