Пути к файлам (file paths)

Шаблоны путей

Шаблоны путей заменяют шаблонные выражения (пишутся {abcd}, где «abcd» – это имя переменной) в пути к файлу, когда используется путь.

Например, если в данный момент открытым blend-файлом является dance.blend, а путь вывода рендеринга установлен на:

//my_render_dir/{blend_name}.png

То при рендеринге Blender будет обрабатывать путь следующим образом:

//my_render_dir/dance.png

С осуществлением замены {blend_name} на dance из dance.blend.

Эта замена происходит «внутренне» во время использования (например, во время рендеринга), поэтому синтаксис шаблона останется без изменений в поле самого пути.

Примечание

В настоящее время шаблоны путей поддерживаются только для пути вывода рендеринга в свойствах сцены и для путей вывода в ноде «Вывод в файл (file output)» компо́зитора. Больше путей к файлам будут поддерживаться шаблонами в будущих выпусках.

Доступные переменные

В настоящее время в шаблонах выражений доступны следующие переменные.

Доступно во всех путях, поддерживающих шаблонные выражения:

blend_name:

Имя текущего открытого blend-файла (без расширения .blend).

blend_dir:

Путь до (но не включая) текущего открытого blend-файла.

blend_name_lib:

Подобно blend_name, за исключением того, что для свойств пути в связанных с библиотекой блоках данных, – это будет имя blend-файла-библиотеки, из которой получен блок данных.

blend_dir_lib:

Подобно blend_dir, за исключением того, что для свойств пути в связанных с библиотекой блоках данных, – это будет путь к blend-файлу-библиотеке, из которой получен блок данных.

Доступно только в путях вывода рендера (включая ноду File Output компо́зитора):

fps:

Частота кадров в секунду текущей сцены.

resolution_x / resolution_y:

Разрешение по «x» и «y» отрендеренного изображения. Это также влияет и на масштаб разрешения, так что если разрешение сцены составляет 1000x600, а масштаб составляет 50%, то resolution_x и resolution_y будут равны 500 и 300 соответственно.

scene_name:

Имя текущей сцены.

camera_name:

Имя текущей камеры рендеринга.

Доступно только в свойствах пути на ноде:

node_name:

Имя ноды, на которой находится свойство пути.

Синтаксис

Базовое шаблонное выражение просто заключает имя переменной в фигурные скобки:

dance_{fps}.png

Спецификаторы формата

Шаблонные выражения также могут включать спецификатор формата. Спецификаторы формата указывают Blender’у, как следует форматировать заменяемое значение. Они пишутся после разделительного двоеточия, например:

dance_{fps:FORMAT}.png

Спецификаторы формата в настоящее время могут использоваться только с переменными, представляющими числовые значения, а не строковые. Доступными спецификаторами формата являются:

• dance_{fps:###}.png: формат как целое число, содержащее не менее 3 цифр.

• dance_{fps:.###}.png: формат как число с плавающей запятой, содержащее ровно 3 цифры после запятой.

• dance_{fps:###.##}.png: формат как число с плавающей запятой, содержащее не менее 3 цифр для целой части и ровно 2 цифры для дробной.

Во всех случаях количество хэш-символов (#) указывает на желаемое количество цифр.

Например, если fps равен 29.97, то:

• dance_{fps:###}.png -> dance_030.png

• dance_{fps:.###}.png -> dance_29.970.png

• dance_{fps:###.##}.png -> -> dance_029.97.png

Обратите внимание, что значения в точности округляются для указанного количества цифр.

Если спецификация формата не задана, будет использоваться форматирование по умолчанию для названной переменной (например, плавающая запятая для «fps», целое число для разрешения).

Последовательности экранирования (Escape Sequences)

Поскольку { и } используются для шаблонных выражений в путях, которые их поддерживают, то в случаях когда в таком пути требуется литерал { или }, их необходимо экранировать, записывая их дважды:

• {{ преобразуется в один { в конечном пути.

• }} преобразуется в один } в конечном пути.

Например:

• мой_странный}}_{{путь.png -> мой_странный}_{путь.png

• //мой_рендер_{{dir}}/{blend_name}.png -> //мой_рендер_{dir}/dance.png

• //мой_рендер_dir/{{{blend_name}}}.png -> //мой_рендер_dir/{dance}.png

Ошибки

Пути, поддерживающие шаблоны, могут иметь ошибки шаблона, которые препятствуют обработке пути.

Например, в следующем пути:

//my_render_dir/{blend_name.png

Выражение {blend_name было закрыто неправильно, что приведёт к ошибке.

Если в пути присутствуют ошибки шаблона, поле пути будет выделяться красным цветом в пользовательском интерфейсе:

При наведении курсора на поле пути появится всплывающая подсказка, содержащая список ошибок шаблона, обнаруженных в этом пути:

Примечание

В зависимости от самого пути – ошибки шаблона могут помешать определённым действиям. Например, если будут присутствовать ошибки в пути вывода рендеринга, то рендеринг анимации завершится ошибкой с сообщением о ней же, она будет указывать на ошибки пути.