Макет каталога Blender#

На этой странице описаны различные каталоги, используемые Blender (что может быть полезно при устранении неполадок).

Существует три разных каталога, которые может использовать Blender, их точное расположение зависит от платформы.

LOCAL (локальный):

Расположение данных конфигурации и работы программы (для автономного пакета).

USER (пользовательский):

Расположение файлов конфигурации (обычно в домашнем каталоге пользователя).

SYSTEM (системный):

Расположение данных работы программы для общесистемной установки (могут быть доступны только для чтения).

Для установки Blender необходимо наличие как СИСТЕМНОГО, так и ПОЛЬЗОВАТЕЛЬСКОГО каталогов.

Для локально извлеченных дистрибутивов Blender, пользовательская конфигурация и данные времени выполнения (run-time data) хранятся в одном и том же подкаталоге, что позволяет нескольким версиям Blender работать без конфликтов, игнорируя файлы USER и SYSTEM. Для этого вам необходимо создать папку с именем config в каталоге LOCAL.

Пути файлов, в зависимости от ОС#

Здесь перечислены пути, определённые по умолчанию для каждой операционной системы:

Linux#

LOCAL (локальный):
./4.2/
USER (пользовательский):
$HOME/.config/blender/4.2/
SYSTEM (системный):
/usr/share/blender/4.2/

Примечание

Путь ./4.2/ относится к исполняемому файлу Blender и используется для автономных пакетов, распространяемых официальными сборками blender.org.

Примечание

Путь USER будет использовать $XDG_CONFIG_HOME, если установлено:

$XDG_CONFIG_HOME/blender/4.2/

macOS#

LOCAL (локальный):
./4.2/
USER (пользовательский):
/Users/$USER/Library/Application Support/Blender/4.2/
SYSTEM (системный):
/Library/Application Support/Blender/4.2/

Примечание

macOS хранит двоичный файл Blender в ./Blender.app/Contents/MacOS/Blender. Локальный путь к данным и конфигурация:

./Blender.app/Contents/Resources/4.2/

Windows#

LOCAL (локальный):
.\4.2\
USER (пользовательский):
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.2\
SYSTEM (системный):
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.2\

Примечание

При установке из Window’s Store каталоги USER и SYSTEM находятся внутри специальной папки, напоминающей:

%ProgramFiles%\WindowsApps\BlenderFoundation.Blender<HASH>\Blender\4.2\

Где «HASH» – это строка, характерная для каждой установки.

Схема путей#

Это макет путей, который используется в описанных выше каталогах.

Например, путь ./config/startup.blend откроется в ~/.blender/4.2/config/startup.blend.

./autosave/ ...

Расположение blend-файла автосохранения. (Только для Windows, временный каталог используется для других систем.)

Порядок поиска: LOCAL, USER.

./config/ ...

Значения по умолчанию и информация о сеансе.

Порядок поиска: LOCAL, USER.

./config/startup.blend

Файл, загружаемый по умолчанию при запуске программы.

./config/userpref.blend

Параметры, загружаемые по умолчанию при запуске программы.

./config/bookmarks.txt

Закладки файлового браузера.

./config/recent-files.txt

Список недавно открытых файлов.

./datafiles/ ...

Файлы работы программы (runtime).

Порядок поиска: LOCAL, USER, SYSTEM.

./datafiles/locale/{language}/

Статически скомпилированные языковые файлы для перевода интерфейса программы.

./scripts/ ...

Скрипты Python для пользовательского интерфейса и инструментов.

Порядок поиска: LOCAL, USER, SYSTEM.

./scripts/addons/*.py

Аддоны Python, которые можно включить в настройках, включают поддержку формата импорта/экспорта, интеграцию с механизмом рендера и множество удобных утилит.

./scripts/addons/modules/*.py

Модули для использования аддонов (добавлены в sys.path Python).

./scripts/addons_contrib/*.py

Ещё один каталог, который используется для аддонов, поддерживаемых сообществом (должен быть создан вручную).

./scripts/addons_contrib/modules/*.py

Модули для использования addons_contrib (добавлены в sys.path Python).

./scripts/modules/*.py

Модули Python’а, содержащие наши основные функции API, а также вспомогательные функции для других скриптов, предназначенных для импорта (добавляются к sys.path Python’а).

./scripts/startup/*.py

Скрипты, которые автоматически импортируются при запуске.

./scripts/presets/{preset}/*.py

Пресеты, используемые для хранения пользовательских параметров ткани, форматов рендера и т.д.

./scripts/templates_py/*.py

Примеры скриптов, к которым можно получить доступ из меню Редактор текста ‣ Шаблоны ‣ Python.

./scripts/templates_osl/*.osl

Примеры шейдеров OSL, доступ к которым можно получить из Текстовый редактор ‣ Шаблоны ‣ Open Shading Language.

./python/ ...

Пакетный дистрибутив Python.

Порядок поиска: LOCAL, SYSTEM.

Каталог локального кэша#

Каталог кэша используется для локального хранения постоянных (persistent) кэшей. В настоящее время он используется только для индексации библиотеки ассетов. Очевидно, что операционная система не очистит их автоматически.

Будет использован следующий путь:

  • Linux:

    $XDG_CACHE_HOME/blender/, если установлен $XDG_CACHE_HOME, в противном случае $HOME/.cache/blender/

  • macOS:

    /Library/Caches/Blender/

  • Windows:

    %USERPROFILE%\AppData\Local\Blender Foundation\Blender\Cache\

Каталог для временных файлов#

Каталог временных файлов используется для хранения различных временных файлов во время работы Blender’а (включая: слои визуализации, кэш физики, буфер копирования-вставки и журналы аварийного завершения программы).

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

  • Установленный в пользовательских настройках (смотрите раздел File Paths).

  • Переменные среды (environment variables) (TEMP в Windows, TMP и TMP_DIR на других платформах).

  • Каталог /tmp/.

Переопределение каталогов «по умолчанию»#

Можно переопределить каталоги «по умолчанию» USER и SYSTEM, используя переменные среды.

Хотя для обычного использования это не требуется, в некоторых специализированных случаях это может быть полезно, например:

  • Использование общих сетевых дисков для определённых путей.

  • Изоляция экземпляра от пользовательских файлов «по умолчанию», чтобы предотвратить доступ автоматизированным задачам к пользовательской конфигурации.

Подробности см. в разделе Переменные среды (Environment Variables).