Для кастомных свойств в Blender Python API можно задать определенные максимальное и минимальное значения. В этом случае пользователь, вводя нужное значение в поле, не сможет указать для него величину, выходящую за указанные пределы.
Content on PatreonДля того, чтобы задать минимальное и максимальное ограничения нужно указать в создаваемом свойстве параметры «min» и «max» и присвоить им нужные ограничивающие значения.
Например, при создании целочисленного свойства «limited_value» ему можно задать ограничения на ввод от 0 до 25 следующим образом:
|
1 2 3 4 5 6 7 |
import bpy bpy.types.Scene.limited_value = bpy.props.IntProperty( name='limited_value', min=0, max=25 ) |
Теперь, если попытаться задать для этого свойства значение вне указанного промежутка, например «50», свойству будет присвоено только максимально возможное значение — «25».
Значения «max» и «min» задаются статически. Однако иногда бывает нужно в процессе работы аддона изменить указанные пределы.
Если вместо статического значения попробовать указать функцию, динамически возвращающую нужные ограничения, например для максимального значения:
|
1 2 3 4 5 6 7 8 |
def dynamic_max(): return bpy.context.scene.frame_current bpy.types.Scene.limited_value = bpy.props.IntProperty( name='limited_value', default=0, max=dynamic_max ) |
Blender вернет сообщение об ошибке:
TypeError: an integer is required (got type function)
ValueError: bpy_struct registration error: IntProperty could not register
Это происходит потому, что параметры «max» и «min» при определении свойства IntPropert требуется задавать только числовыми значениями.
Задать напрямую динамические параметры «max» и «min» нельзя, однако, мы все же можем добиться нужного нам поведения свойства, переопределив для него функции «set» и «get».
Для начала определим два дополнительных кастомных свойства, в которых будем хранить нужные нам максимальное и минимальное значения:
|
1 2 3 4 5 6 7 8 9 |
bpy.types.Scene.dynamic_max = bpy.props.IntProperty( name='dynamic_max', default=15 ) bpy.types.Scene.dynamic_min = bpy.props.IntProperty( name='dynamic_min', default=0 ) |
Они динамические, и мы можем их легко менять, вынеся на панель интерфейса, или напрямую в коде:
|
1 |
bpy.context.scene.dynamic_min = 5 |
Определим функции «get_limited_value» и «set_limited_value». Внутри функции «set_limited_value», которая отвечает за присваивание свойству значения будем контролировать, не выходил ли оно за заданные пределы и, если выходит, корректировать его.
|
1 2 3 4 5 6 7 8 9 |
def set_limited_value(self, new_value): if new_value > bpy.context.scene.dynamic_max: new_value = bpy.context.scene.dynamic_max if new_value < bpy.context.scene.dynamic_min: new_value = bpy.context.scene.dynamic_min self['limited_value'] = new_value def get_limited_value(self): return self.get('limited_value', 0) |
Функция «get_limited_value» просто возвращает значение свойства.
При определении самого свойства, переопределим его функции «get» и «set» нашими:
|
1 2 3 4 5 6 |
bpy.types.Scene.limited_value = bpy.props.IntProperty( name='limited_value', default=0, get=lambda self: get_limited_value(self), set=lambda self, value: set_limited_value(self, value) ) |
Теперь при каждом присваивании значения свойству «limited_value» будет вызываться переопределенная нами функция «set_limited_value» в которой это значение будет корректироваться в соответствии с указанными в «dynamic_min» и «dynamic_max» лимитами.
Вынесем все три наших свойства на UI-панель в окне «3D Viewport»:
|
1 2 3 4 5 6 7 8 9 10 11 |
class test_PT_Panel(bpy.types.Panel): bl_idname = 'TEST_PT_panel' bl_label = 'DYNAMIC MAX-MIN' bl_space_type = 'VIEW_3D' bl_region_type = 'UI' bl_category = 'TEST' def draw(self, context): self.layout.prop(bpy.context.scene, 'limited_value') self.layout.prop(bpy.context.scene, 'dynamic_max') self.layout.prop(bpy.context.scene, 'dynamic_min') |
Теперь мы можем задавать значения для свойства «limited_value», которые всегда будут лежать в указанных в «dynamic_min» и «dynamic_max» пределах, и в тоже время свободно изменять эти пределы по своему усмотрению.
Полный код:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 |
import bpy class test_PT_Panel(bpy.types.Panel): bl_idname = 'TEST_PT_panel' bl_label = 'DYNAMIC MAX-MIN' bl_space_type = 'VIEW_3D' bl_region_type = 'UI' bl_category = 'TEST' def draw(self, context): self.layout.prop(bpy.context.scene, 'limited_value') self.layout.prop(bpy.context.scene, 'dynamic_max') self.layout.prop(bpy.context.scene, 'dynamic_min') # functions for get/set value with dynamic limits def set_limited_value(self, new_value): if new_value > bpy.context.scene.dynamic_max: new_value = bpy.context.scene.dynamic_max if new_value < bpy.context.scene.dynamic_min: new_value = bpy.context.scene.dynamic_min self['limited_value'] = new_value def get_limited_value(self): return self.get('limited_value', 0) def register(): bpy.types.Scene.dynamic_max = bpy.props.IntProperty( name='dynamic_max', default=15 ) bpy.types.Scene.dynamic_min = bpy.props.IntProperty( name='dynamic_min', default=0 ) bpy.context.scene.dynamic_min = 5 bpy.types.Scene.limited_value = bpy.props.IntProperty( name='limited_value', default=0, get=lambda self: get_limited_value(self), set=lambda self, value: set_limited_value(self, value) ) bpy.utils.register_class(test_PT_Panel) register() |