Коротко
- Collection объединяет объекты и вложенные коллекции.
- Layer Collection управляет состоянием Collection внутри View Layer.
- Параметры exclude, holdout и indirect_only выполняют разные функции.
- API View Layer предлагает настройки слоёв сцены и render pass.
Что вы узнаете из этого руководства?
Если собрать геометрию, мебель, элементы окружения и источники света архитектурной сцены Blender в одну группу, становится сложнее ориентироваться в сцене и управлять ею для разных задач презентации. Collection позволяют группировать объекты и вложенные коллекции. View Layer помогает задавать, как эти группы будут обрабатываться в определённом слое отображения сцены.
В этом руководстве вы узнаете, чем Collection отличается от Layer Collection, на что распространяются настройки видимости и как изучить иерархию сцены через Python API. В примерах используются названия коллекций, подходящие для архитектурного проекта; они не гарантируют определённый результат рендера.
Требования
Необходимо установить Blender и иметь доступ к Python API.
Источником служит актуальная документация Blender API. Поскольку в документации не указан конкретный номер версии Blender, здесь он также не приводится.
В источниках не описаны требования к учётной записи, подписке, онлайн-сервисам, оборудованию или дополнениям. Документация распространяется по лицензии CC BY-SA 4.0.
Перед запуском кода, изменяющего структуру сцены, сохраните копию файла. Изменение свойств View Layer может повлиять на содержимое активного слоя.
Шаг за шагом: работа с Collection и View Layer
1. Разберитесь в различиях между Collection и Layer Collection
Collection — это структура сцены, объединяющая объекты и вложенные коллекции. Свойство objects коллекции содержит только объекты непосредственно в этой группе, а all_objects — объекты как в самой коллекции, так и во вложенных. Поэтому при проверке иерархии можно упустить объекты во вложенных коллекциях, если смотреть только на верхнюю группу.
Layer Collection — это представление Collection в конкретном View Layer. То, в какой группе хранятся объекты, и то, как эта группа ведёт себя в соответствующем View Layer, — разные вещи. Такие параметры, как exclude, hide_viewport, holdout и indirect_only, задаются для Layer Collection.
2. Создайте Collection и добавьте её в сцену
В примере ниже создаётся Collection с именем Mobilya и добавляется в дочерние коллекции главной коллекции сцены. Это создаёт группу, но автоматически не переносит в неё существующие объекты. Используйте понятные и последовательные названия, соответствующие задачам проекта.
import bpy
collection = bpy.data.collections.new('Mobilya')
bpy.context.scene.collection.children.link(collection)После создания коллекции перенос объектов в нужную группу и построение иерархии вложенных коллекций выполняются отдельно. В документации API функции создания коллекций и связывания дочерних коллекций описаны раздельно. Поэтому этот код сам по себе не упорядочивает остальную часть сцены.
3. Изучите иерархию активного View Layer
Пример ниже обходит дочерние группы, начиная с корневой Layer Collection активного View Layer. Для каждой строки он выводит имя Collection и значения exclude, hide_viewport и is_visible. Так можно проверить положение групп в иерархии и их видимость.
import bpy
def print_layer(layer, depth=0):
collection = layer.collection
indent = ' ' * depth
print(
indent + collection.name,
'exclude=', layer.exclude,
'viewport=', layer.hide_viewport,
'visible=', layer.is_visible,
)
for child in layer.children:
print_layer(child, depth + 1)
print_layer(bpy.context.view_layer.layer_collection)Свойство is_visible учитывает и состояние родительских коллекций. Поэтому оценивать настройку вложенной группы отдельно недостаточно. В документации visible_get() также описан как запрос видимости, учитывающий родительскую иерархию и состояние viewport. Для более надёжной проверки изучите всю цепочку.
4. Исключите Collection из активного View Layer
Если нужно исключить группу только из активного View Layer, можно использовать свойство exclude у Layer Collection. Пример ищет названную коллекцию в иерархии и, если находит её, меняет значение этого свойства.
import bpy
hedef_ad = 'Mobilya'
root = bpy.context.view_layer.layer_collection
def set_excluded(layer, name, value):
if layer.collection.name == name:
layer.exclude = value
return True
for child in layer.children:
if set_excluded(child, name, value):
return True
return False
if set_excluded(root, hedef_ad, True):
print('Collection etkin View Layer\'dan hariç tutuldu.')
else:
print('Adı eşleşen Collection bulunamadı.')Значение True в примере исключает совпавшую Layer Collection из View Layer. Чтобы снова включить её, установите значение False. Последовательные названия коллекций упрощают поиск нужной группы.
5. Выбирайте настройки видимости и рендера в зависимости от задачи
Временно скрыть коллекцию во viewport и отключить её для рендеров в целом — не одно и то же. Свойство hide_viewport у Layer Collection временно влияет на видимость во viewport. Свойство hide_viewport у Collection в целом отключает коллекцию во viewport. Свойство hide_render коллекции предназначено для её отключения при рендере, тогда как exclude у Layer Collection исключает её из соответствующего View Layer.
У остальных параметров Layer Collection также разные задачи:
holdoutпозволяет маскировать объекты коллекции в View Layer.indirect_onlyзадаёт участие объектов только через непрямой вклад — например, тени и отражения.excludeисключает коллекцию из соответствующего View Layer.hide_viewportвлияет на видимость коллекции во viewport.
Свойство use у View Layer включает или отключает рендеринг соответствующего слоя. На уровне слоя также доступны переопределения материалов и мира, а также различные параметры render pass. Эти функции помогают управлять одной и той же сценой для разных визуальных задач, но сами по себе не гарантируют конкретный результат изображения.
Что меняется в архитектурном и визуализационном процессе?
Архитекторы и дизайнеры интерьеров могут сделать иерархию файла более понятной, размещая элементы здания, мебель и благоустройство в отдельных Collection. Специалисты по визуализации могут с помощью настроек Layer Collection управлять тем, какие группы входят в определённый View Layer и какие из них участвуют только косвенно. Такой подход помогает управлять содержимым сцены с учётом задач презентации.
Особенно в больших сценах важно давать группам понятные имена и последовательно выстраивать отношения между родительскими и дочерними коллекциями. В источниках не указаны требования к определённому оборудованию или дополнениям. Поскольку номер версии не приводится, перед использованием примеров API в проекте проверьте их на небольшой копии файла в установленной версии Blender.
Типичные ошибки
Считать Collection и Layer Collection одним и тем же: первая группирует объекты, а вторая представляет состояние этой группы внутри View Layer.
Считать
hide_renderиexcludeравнозначными настройками: первая относится к уровню Collection, вторая — к Layer Collection.Проверять только значение
objects: оно возвращает объекты непосредственно в группе, аall_objectsвключает также вложенные коллекции.Интерпретировать значение видимости вне контекста иерархии: состояние родительских групп может влиять на видимость вложенной коллекции.
Запускать код, не проверив совпадение имени коллекции: если имя не найдено, пример выводит отдельное сообщение.
Менять настройки, не создав резервную копию файла: примеры кода могут повлиять на состояние активной сцены и View Layer.
Следующие шаги
Сначала создайте иерархию Collection в небольшом тестовом файле и запустите код для её просмотра, чтобы проверить имена в выводе. Затем подставьте собственные названия коллекций в пример с exclude и посмотрите, как изменение повлияет на активный View Layer. Для дальнейшего изучения ознакомьтесь с параметрами AOV, render pass, количеством сэмплов, а также переопределением материалов и мира в документации View Layer. Работа с копией файла на каждом этапе поможет сохранить структуру проекта.
Источник и лицензия
Это руководство адаптировано на турецкий язык на основе документации Blender API по Collection, LayerCollection и ViewLayer. Все три источника распространяются по лицензии CC BY-SA 4.0. Примеры кода написаны для этого руководства с использованием задокументированных свойств API.
Источники
Источников: 3Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.
Правильное понимание различий между Collection и View Layer может сделать архитектурные файлы с большим количеством мебели, элементов окружения и вариантов презентации более понятными. Подход с изучением иерархии через Python API также служит полезной отправной точкой для команд визуализации, которым приходится регулярно выполнять одни и те же проверки.
Для офисов и студентов в Турции источники не указывают дополнительных требований к оборудованию; тем не менее перед переносом кода в рабочий файл важно проверить его в установленной версии Blender. Стандартизация названий коллекций в команде и проверка различий между `hide_render` и `exclude` перед сдачей проекта могут принести практическую пользу.
Частые вопросы
В чём разница между Blender Collection и Layer Collection?
Collection группирует объекты и вложенные коллекции. Layer Collection управляет состоянием этой группы в определённом View Layer.
Как исключить Collection только из одного View Layer в Blender?
Используйте свойство `exclude` у Layer Collection. Свойство `hide_render` у Collection предназначено для общего отключения при рендере.
Можно ли изучить иерархию коллекций через Blender API?
Да. Начиная с корневой Layer Collection View Layer, можно пройти по `children` и проверить имена коллекций и значения видимости.



