Пользовательские свойства (custom properties)#

../_images/files_data-blocks_add.png

Панель „Custom Properties“.#

Пользовательские свойства – это способ хранения собственных данных в блоках данных Blender’а. Их можно использовать для риггинга (где кости и объекты могут иметь пользовательские свойства, управляющие другими свойствами) и скриптов Python, где обычно определяют новые настройки, недоступные в Blender’е. Также получить доступ к пользовательским свойствам можно из материалов через ноду Attribute.

Только определённые данные поддерживают пользовательские свойства:

Чтобы добавить пользовательское свойство, найдите панель „Custom Properties“, которая находится в нижней части большинства „панелей cвойств“ или в области боковой панели, и нажмите „New“. Свойства можно удалить из того же места с помощью значка удаления (:bl-icon:`x`). После добавления свойств их можно настраивать с помощью значка редактирования для работы с конкретным случаем использования; для получения дополнительной информации см. раздел «Редактирование свойств» ниже.

Редактирование свойств#

Интерфейс пользователя#

../_images/files_data-blocks_edit.png

Всплывающее окно редактирования пользовательских свойств.#

Пользовательские свойства можно редактировать с помощью панели, доступной для типов данных, которые это поддерживают. Редактирование свойств позволяет вам настраивать такие вещи, как значения «по умолчанию», диапазоны и даже добавлять пользовательскую подсказку.

Тип (type)

Тип данных свойства; различные типы данных могут иметь только определённые свойства данных.

Нецелое (float):

Числовое значение с десятичными дробями, например, 3.141, 5.0 или 6.125.

Массив нецелых чисел (float array):

Коллекция нескольких типов данных „float“, например [3.141, 5.0, 6.125] . Этот тип данных также может использоваться для данных, которые могут быть представлены в качестве „массива из нецелых чисел“, такого, как цвета. Эти специальные float-массивы могут быть установлены в селекторе подтипа.

Целое число (integer):

Числовое значение без десятичных дробей, например, 1, 2, 3 или 4.

Массив целых чисел (integer array):

Коллекция нескольких целочисленных типов данных, например [1, 2, 3, 4] .

Логический (boolean):

Тип данных, который имеет два возможных значения, например, Истинно или Ложно.

Логический массив (boolean array):

Коллекция логических значений, например [Истинно, Ложно, Истинно]

Строка (string):

Последовательность символов, например «Какой-то текст».

Блок данных (data-block):

Ссылка на объект Blender’а, см. раздел «Блоки данных».

Python:

Редактировать тип данных Python напрямую, используется для неподдерживаемых типов данных.

Длина массива (array length)

Количество элементов в массиве. Обратите внимание, что если длина массива больше 7, вы не можете напрямую редактировать его элементы, необходимо нажать „Изменить значение“, чтобы редактировать элементы массива.

Имя свойства (property name)

Текст, который отображается слева от значения. Это имя также используется для доступа к свойству через Python.

Значение по умолчанию (default value)

Здесь устанавливается значение по умолчанию для свойства, используемого оператором „Cброса до значений «по умолчанию»“.

Предупреждение

Значения по умолчанию используются в качестве основы для смешивания NLA, и при бессмысленном значении по умолчанию (например, 0 для свойства, используемого для масштабирования) для свойства, предназначенного для ключевых кадров, оно, скорее всего, вызовет проблемы.

Мин., Макс. (min, max)

Минимальное/максимальное значение, которое может принимать пользовательское свойство.

Переопределяемая библиотека (library overridable)

Разрешить переопределять свойство при связывании блока данных.

Плавные пределы (soft limits)

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

Плавно - Мин., Макс. (soft min, max)

Минимальное/максимальное значение плавного лимита.

Шаг (step)

Множитель для управления тем, насколько тип данных будет увеличиваться за раз. Внутренний размер шага для чисел с плавающей запятой составляет 0.01, поэтому значение „Step“, равное 5, будет увеличиваться со скоростью 0.05, а значение „Step“, равное 100, будет увеличиваться на 1.0. Для целых чисел внутренний размер шага составляет 1.

Точность (precision)

Количество цифр после запятой, отображаемых в пользовательском интерфейсе для типов данных „float“.

Подтип (subtype)

Указывает тип данных, содержащихся в свойстве, что влияет на то, как оно будет отображаться в пользовательском интерфейсе. Этот параметр доступен только для свойств „float“ и имеет разные параметры для обычных „нецелых“ и для „массивов нецелых чисел“. Обратите внимание, что единица измерения часто зависит от единиц измерения сцены.

Для обычных „нецелых“:

Plane Data:

Значения данных, которые не имеют какого-либо особого поведения.

Пиксель (pixel):

Измерение разрешения цифрового изображения.

Процент (percentage):

Отображаемое значение представляет собой процент, обычно минимальное и максимальное значения равны 0 и 100.

Коэффициент (factor):

Процент между верхней и нижней границей, который обычно имеет числовое значение.

Угол (angle):

Мера между пересекающимися линиями.

Время (time):

Время, указываемое в секундах.

Расстояние (distance):

Измерение расстояния между предметами.

Мощность (power):

Работа в качестве коэффициента времени, измеряемая в ваттах. Используется в Blender’е для измерения интенсивности света.

Температура (temperature):

Интенсивность тепла.

Длина волны (wavelength):

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

Для „массивов нецелых чисел“:

Plane Data:

Значения данных, которые не имеют какого-либо особого поведения.

Линейный цвет (linear color):

Цвет в линейном цветовом пространстве.

Цвет с гамма-коррекцией (gamma-corrected color):

Цвет в цветовом пространстве с гамма-коррекцией.

Углы Эйлера (Euler angles):

Углы вращения Эйлера.

Вращение по кватерниону (quaternion rotation):

Углы вращения по кватерниону.

Примечание

Чтобы любой из подтипов цвета работал должным образом, значение свойства должно быть вектором с тремя или четырьмя значениями в зависимости от доступности альфа-канала.

ID-Тип (ID type) Блок данных (data-block)

Тип ID-блока. Например: ключ, изображение, объект, материал. Полный список см. в разделе «Типы блоков данных».

Описание (description)

Позволяет вам написать пользовательскую подсказку для вашего свойства.

Доступ Python#

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

Подробную информацию см. в документации по API.