Настройка кадрирования камеры и диапазона анимации в Blender с помощью Python

Что вы узнаете из этого руководства?

Управление настройками камеры и таймингом архитектурной визуализации через Python API Blender помогает создать воспроизводимый рабочий процесс. В этом руководстве мы рассмотрим, как найти активную камеру, изменить фокусное расстояние, включить направляющую кадрирования и задать начальный и конечный кадры анимации. В заключительной части покажем, как установить более короткий диапазон предпросмотра и проверить типичные ошибки.

Примеры основаны на свойствах Scene и Camera, описанных в актуальной документации Blender. Цель — не автоматизировать все настройки рендера, а контролируемо задавать в сцене ключевые параметры, такие как кадрирование камеры и временной диапазон.

Требования

Запускайте примеры в среде, где доступен Python API Blender. В коде предполагается, что в Blender доступны модуль bpy и контекст активной сцены. Согласно документации, получить доступ к сцене можно через bpy.context.scene, а активная камера сцены хранится в свойстве scene.camera.

Это актуальные страницы документации API. Отдельно указано, что свойство Scene.use_nodes считается устаревшим начиная с Blender 5.0, а его удаление запланировано для версии 6.0. Поскольку это руководство не посвящено настройке композитных узлов, в примерах с камерой и диапазоном кадров это свойство не требуется. Источники не указывают требований к учётной записи.

Перед применением кода полезно сохранить копию файла проекта и проверить значения в небольшой тестовой сцене. Это поможет избежать непреднамеренного изменения существующих параметров, особенно в проектах с несколькими настройками камеры или диапазонами анимации.

1. Проверьте активную камеру

Сначала проверьте, назначена ли в сцене активная камера. Scene.camera указывает активную камеру, используемую для рендера. Приведённый ниже код выводит её имя, если камера есть, или сообщает, что в сцене нет активной камеры. Такая проверка позволяет безопасно начать работу до обращения к данным камеры в следующих примерах.

scene = bpy.context.scene
camera = scene.camera

if camera is None:
    print("Сцене не назначена активная камера.")
else:
    print("Активная камера:", camera.name)

Наличие камеры в сцене и её назначение активной камерой — не одно и то же. Через scene.camera код получает только активную камеру. Если проверка показывает, что камеры нет, назначьте камеру для сцены, прежде чем переходить к настройке объектива и кадрирования.

2. Настройте значение объектива и направляющую кадрирования

Настройки объекта камеры хранятся в блоке данных камеры, доступном через camera.data. Для перспективной камеры свойство lens задаёт фокусное расстояние в миллиметрах. Документированное значение по умолчанию — 50,0 мм; в этом примере оно устанавливается на 35,0 мм. Это изменение числового параметра через API, но оно не гарантирует определённого архитектурного результата. Проверяйте изображение и подбирайте подходящее значение.

scene = bpy.context.scene
camera = scene.camera

if camera is not None:
    camera.data.lens = 35.0

Чтобы включить сетку третей в режиме просмотра камеры, установите свойство show_composition_thirds в том же блоке данных. Сетка помогает оценивать расположение элементов в кадре, но сама по себе не меняет геометрию или положение камеры.

scene = bpy.context.scene
camera = scene.camera

if camera is not None:
    camera.data.show_composition_thirds = True

Если направляющая не отображается, проверьте, что вы находитесь в режиме просмотра камеры и используете активную камеру. В API это свойство входит в настройки отображения композиционных направляющих камеры. Документация также перечисляет центральную направляющую, золотое сечение и другие варианты; здесь пример ограничен сеткой третей для оценки архитектурного кадрирования.

3. Задайте диапазон кадров анимации

Начальный и конечный кадры диапазона воспроизведения и рендера сцены задаются свойствами frame_start и frame_end. В приведённом примере диапазон устанавливается от кадра 1 до кадра 120, а текущий кадр сцены перемещается на начальный. Это примерные значения — измените их с учётом длительности своей анимации.

scene = bpy.context.scene

scene.frame_start = 1
scene.frame_end = 120
scene.frame_set(scene.frame_start)

При изменении текущего кадра с помощью frame_set() также обновляются объекты и слои вида. Поэтому этот метод можно использовать для обновления кадра сцены вместо того, чтобы просто хранить номер кадра в переменной. В документации API указано, что метод frame_set() также принимает значение субкадра; в этом руководстве мы ограничимся базовым примером с целыми кадрами.

Для предпросмотра можно задать отдельный начальный и конечный кадры, не меняя основной диапазон. Свойство use_preview_range включает использование альтернативного диапазона, а frame_preview_start и frame_preview_end задают его границы.

scene = bpy.context.scene

scene.use_preview_range = True
scene.frame_preview_start = 20
scene.frame_preview_end = 40

В этом примере диапазон предпросмотра — кадры 20–40. Согласно описанию API, альтернативный диапазон можно использовать для воспроизведения анимации и рендера в окне просмотра. Это может быть удобно, если вы не хотите менять основной диапазон анимации. Убедитесь в сцене, что диапазон предпросмотра работает ожидаемым образом.

Типичные ошибки

• Не проверили, назначена ли активная камера: если scene.camera пуст, обратиться к блоку данных камеры не получится. Сначала выполните проверку из первого примера.

• Ищете настройку не у того объекта: объектив и композиционные направляющие камеры находятся в разделе data объекта камеры. Диапазон кадров задаётся в свойствах сцены.

• Путаете диапазон предпросмотра с основным: frame_preview_start и frame_preview_end отличаются от основных значений frame_start и frame_end. Также проверьте параметр use_preview_range, включающий альтернативный диапазон.

• Используете устаревшую настройку композитинга: в документации сказано, что свойство Scene.use_nodes считается устаревшим начиная с Blender 5.0, его настройка не влияет на результат, а удаление запланировано для версии 6.0. Для включения и отключения композитинга используйте свойство scene.render.use_compositing.

• Без изменений переносите примерные значения в проект: 35 мм или 120 кадров подходят не для каждой сцены. Оценивайте кадрирование и длительность анимации с учётом требований проекта.

Следующие шаги в архитектуре и визуализации

Этот подход может быть полезен командам визуализации, которые повторно применяют разные настройки кадрирования и тайминга в одной сцене, а также студентам, осваивающим работу с камерой. Например, эти короткие фрагменты кода могут стать основой для возврата к заданному диапазону сцены или повторного включения композиционной сетки. Однако примеры не ускоряют рендер и не содержат сведений о требованиях к оборудованию. В крупных проектах сначала проверяйте изменения на рабочей станции и копии проекта.

В качестве следующего шага примените фрагменты кода в своей сцене и проверьте кадрирование камеры и диапазон кадров. Если затем понадобится превратить настройки в общий для команды рабочий процесс, изучите соответствующие объекты и свойства Blender API. Если требуется изменить настройки композитинга, используйте актуальное свойство API scene.render.use_compositing; не пишите новый код на основе устаревшего scene.use_nodes.

Источники и лицензия

Это руководство адаптировано на основе свойств из документации Blender API для Scene и Camera. Оба источника доступны по лицензии CC BY-SA 4.0: bpy.types.Scene и bpy.types.Camera. Примеры кода написаны для этого руководства с использованием имён API, описанных в документации.