Коротко
- Диапазон сцены, текущий кадр и диапазон симуляции можно настроить через свойства Scene.
- Активная камера, значение объектива и композиционные направляющие относятся к свойствам Camera.
- Разрешение рендера, частота кадров и поведение вывода настраиваются через RenderSettings.
- Некоторые устаревшие свойства композитинга в актуальной документации API помечены как подлежащие удалению.
Что вы узнаете из этого руководства?
Blender Python API позволяет программно изменять такие данные, как временной диапазон сцены и активная камера. Настройки рендера также можно контролировать через данные рендера той же сцены. В этом руководстве мы рассмотрим основные параметры, которые можно повторно использовать в архитектурной визуализации и презентациях интерьеров: диапазоны кадров сцены и симуляции, объектив камеры и направляющие кадрирования, разрешение вывода и частоту кадров.
В примерах предполагается, что существующий блок данных Scene находится в переменной scene, а существующий блок данных камеры — в переменной camera. Фрагменты кода показывают присваивание значений указанным свойствам, а не установочный скрипт, который подготавливает переменные. В документации API описаны имена свойств и допустимые диапазоны значений. Поэтому удобно проверять изменения на копии файла проекта и сравнивать результаты настроек, которые могут не подойти сцене.
Требования
Понадобятся Blender и свойства Scene, RenderSettings и Camera, описанные в документации Python API. В источниках не указаны конкретная версия приложения Blender, тип аккаунта или условия оплаты. Примеры кода следует выполнять в контексте Python, где доступны ссылки на Scene и Camera; в этом руководстве не предполагаются неописанные пути в меню или этапы установки для получения этих ссылок.
Каждая настройка служит своей цели. Свойства Scene определяют диапазон кадров сцены и активную камеру, а RenderSettings управляют выводом и поведением рендера. Свойства камеры хранят такие данные, как объектив и направляющие кадрирования. Если сначала определить, какой блок данных нужно изменить, риск затронуть не то свойство будет ниже.
Шаг 1: настройте диапазон кадров сцены
В блоке данных Scene свойства frame_start и frame_end задают начальный и конечный кадры диапазона воспроизведения и рендера. frame_current указывает текущий кадр. Для анимации или поэтапной архитектурной презентации явное задание этих значений делает временные настройки сцены наглядными в скрипте.
В примере ниже диапазон сцены задан от 1 до 120. Это примеры настроек в пределах допустимого диапазона, указанного в документации, а не обязательное количество кадров для конкретного проекта.
scene.frame_start = 1
scene.frame_end = 120
scene.frame_current = 1Временной диапазон симуляций можно задавать отдельно от общего диапазона сцены. simulation_frame_start и simulation_frame_end определяют начальный и конечный кадры симуляции. Свойство use_custom_simulation_range управляет тем, использовать ли для симуляции диапазон, отличный от диапазона сцены. Эта настройка важна, когда необходимо различать диапазоны сцены и симуляции с разной продолжительностью.
scene.use_custom_simulation_range = True
scene.simulation_frame_start = 1
scene.simulation_frame_end = 120Изменение этих значений само по себе не гарантирует визуальный результат симуляции. Следует также учитывать, не переопределяют ли узлы симуляции в проекте собственный диапазон кадров: в описании API указано, что пользовательский диапазон используется в случаях, когда такие узлы не изменяют его самостоятельно.
Шаг 2: настройте активную камеру и композицию
Свойство camera в сцене хранит активную камеру, используемую для рендера. Свойство lens в блоке данных камеры задаёт фокусное расстояние перспективной камеры в миллиметрах. С помощью lens_unit можно выбрать, чтобы фокусное расстояние в интерфейсе задавалось в миллиметрах или через угол обзора. В примере ниже предполагается, что данные камеры уже доступны в переменной.
camera.lens_unit = 'MILLIMETERS'
camera.lens = 35.0Во вьюпорте камеры можно отображать композиционные направляющие. Например, направляющая по правилу третей включается и отключается свойством show_composition_thirds, а направляющая золотого сечения — свойством show_composition_golden. Эти направляющие помогают оценить кадрирование, но сами по себе не меняют геометрию сцены или положение камеры.
camera.show_composition_thirds = TrueПри оценке кадрирования интерьеров важно учитывать соотношение сторон изображения и поле зрения камеры. В Camera API также есть свойства горизонтального и вертикального угла обзора. Кроме того, доступны такие параметры, как ортографический масштаб и тип панорамы, но они связаны с другими типами камер и сценариями использования, поэтому их не следует считать настройками по умолчанию для перспективной камеры интерьера.
Шаг 3: настройте параметры вывода рендера и производительности
RenderSettings содержит горизонтальное и вертикальное разрешение, а также процент разрешения. Частота кадров задаётся свойством fps. В приведённом ниже примере явно указаны значения разрешения и частоты кадров по умолчанию из документации. Если целевой размер изображения и параметры анимации для сдачи проекта отличаются, значения следует выбрать соответственно.
scene.render.resolution_x = 1920
scene.render.resolution_y = 1080
scene.render.resolution_percentage = 100
scene.render.fps = 24Для ускорения предпросмотра можно уменьшить resolution_percentage; перед финальным выводом это значение нужно проверить ещё раз. В документации свойство определяется как процент разрешения рендера. Для использования области рендера предусмотрены use_border и координаты границ; use_crop_to_border управляет обрезкой вывода по заданной области.
В рабочем процессе рендера также следует проверить композитинг. Свойство use_compositing в RenderSettings управляет тем, будет ли результат рендера проходить через назначенную сцене группу узлов композитинга. В документации сказано, что устаревшее свойство Scene.use_nodes больше не действует, а для включения и отключения композитинга следует использовать scene.render.use_compositing. Свойство compositing_node_group также помечено как подлежащее удалению начиная с версии 5.0; в документации указано, что удалить его планируется в версии 6.0. Поэтому имена свойств в старых скриптах нужно сверять с актуальным описанием API.
Частые ошибки и дальнейшие шаги
Одна из наиболее распространённых ошибок — считать диапазон сцены и диапазон симуляции одной и той же настройкой. Другая — изменять свойства блока данных другой камеры вместо активной. Перед финальным выводом также нужно вместе проверить процент разрешения рендера, размеры изображения и частоту кадров. use_persistent_data может хранить данные в памяти для ускорения повторного рендера и рендера анимации; однако, согласно описанию API, это увеличивает потребление памяти.
Для дальнейшей работы проверяйте каждую группу настроек в отдельном фрагменте скрипта: сначала диапазон кадров, затем кадрирование камеры и, наконец, параметры вывода. После каждого изменения создавайте короткий предпросмотр и сравнивайте результаты. Если одни и те же значения нужны для нескольких проектов, объединение присваиваний в один упорядоченный скрипт может повысить воспроизводимость; при этом важно убедиться, что ссылки на активную сцену и камеру верны. Даже если в настройках рендера доступен параметр GPU, источники не обещают совместимость с конкретным оборудованием или определённую производительность; настройки следует проверять на имеющейся системе.
Источник и лицензия
Это руководство переведено и адаптировано по описаниям Scene, RenderSettings и Camera в документации Blender API. Исходная документация распространяется по лицензии CC BY-SA 4.0: страницы Blender API для Scene, RenderSettings и Camera.
Источники
Источников: 3Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.
Для архитектурных бюро и команд визуализации в Турции практическая ценность этих возможностей заключается в том, что они помогают сделать часто повторяющиеся настройки сцены и вывода более последовательными. В частности, управление диапазоном анимации, разрешением и кадрированием камеры с помощью скрипта может упростить отслеживание настроек при передаче проекта.
Однако использование API само по себе не сокращает время рендера; постоянное хранение данных рендера может увеличить потребление памяти, а польза от параметра GPU зависит от конкретной системы. Бюро следует тестировать скрипты на собственных структурах сцен, а использование устаревшего `use_nodes` сверять с актуальными свойствами. Поскольку в источниках не указаны цены на продукты или совместимость с оборудованием, одного этого руководства недостаточно для решения о покупке или оценке производительности.
Частые вопросы
Как изменить диапазон кадров сцены с помощью Blender Python API?
Свойства `frame_start` и `frame_end` блока данных Scene задают начальный и конечный кадры. Текущий кадр можно настроить с помощью `frame_current`.
Можно ли настроить разрешение рендера в Blender с помощью Python?
Да. Свойства `resolution_x`, `resolution_y` и `resolution_percentage` в RenderSettings управляют разрешением и его масштабом.
Следует ли использовать `Scene.use_nodes` в Blender API?
Согласно актуальной документации API, это свойство помечено как подлежащее удалению начиная с версии 5.0, а его изменение не действует. Для управления композитингом указано свойство `scene.render.use_compositing`.



