Kurz gesagt
- Collection fasst Objekte und untergeordnete Collections zusammen.
- Layer Collection steuert den Status einer Collection innerhalb eines View Layers.
- Exclude, Holdout und Indirect Only erfüllen unterschiedliche Funktionen.
- Die View-Layer-API bietet Einstellungen für Szenen-Layer und Render-Passes.
Was Sie in diesem Leitfaden lernen
In einer architektonischen Blender-Szene kann es schwierig sein, Struktur, Möbel, Umgebungselemente und Lichtquellen in einer einzigen Gruppe zusammenzufassen und zugleich die Szenenorganisation übersichtlich zu halten und unterschiedliche Präsentationsanforderungen zu erfüllen. Collections dienen dazu, Objekte und untergeordnete Collections zu gruppieren. Mit View Layer lässt sich steuern, wie diese Gruppen in einer bestimmten Ansichtsebene der Szene behandelt werden.
In diesem Leitfaden lernen Sie den Unterschied zwischen Collection und Layer Collection kennen, erfahren, für welche Bereiche Sichtbarkeitseinstellungen gelten, und untersuchen die Szenenhierarchie über die Python-API. Die Beispiele verwenden Collection-Namen, die sich für eine Architekturdatei eignen; sie versprechen kein bestimmtes Render-Ergebnis.
Voraussetzungen
Blender muss installiert und der Zugriff auf die Python-API möglich sein.
Als Quellen dient die aktuelle API-Dokumentation von Blender. Da darin keine konkrete Blender-Versionsnummer angegeben ist, wird auch hier keine genannt.
Die Quellen erläutern keine Anforderungen an Konto, Abonnement, Online-Dienst, Hardware oder Add-on. Die Dokumentation steht unter der Lizenz CC BY-SA 4.0.
Speichern Sie eine Kopie der Datei, bevor Sie Code ausführen, der die Szenenstruktur verändert. Änderungen an den Eigenschaften eines View Layers können sich auf den Inhalt des aktiven Layers auswirken.
Schritt für Schritt: Collection und View Layer verwenden
1. Den Unterschied zwischen Collection und Layer Collection verstehen
Eine Collection ist eine Szenenstruktur, die Objekte und untergeordnete Collections zusammenfasst. Die Eigenschaft objects einer Collection umfasst nur die Objekte direkt in dieser Gruppe, während all_objects zusätzlich die Objekte in untergeordneten Collections einschließt. Wenn Sie die Hierarchie prüfen, können Ihnen daher Objekte in untergeordneten Collections entgehen, wenn Sie nur die übergeordnete Gruppe berücksichtigen.
Eine Layer Collection ist das Gegenstück einer Collection innerhalb eines bestimmten View Layers. Welche Gruppe die Objekte enthält und wie sich diese Gruppe im jeweiligen View Layer verhält, sind zwei unterschiedliche Fragen. Einstellungen wie exclude, hide_viewport, holdout und indirect_only befinden sich auf der Layer Collection.
2. Eine neue Collection erstellen und mit der Szene verknüpfen
Das folgende Beispiel erstellt eine Collection namens Mobilya und fügt sie den untergeordneten Collections der Haupt-Collection der Szene hinzu. Dadurch wird die Gruppe angelegt; vorhandene Objekte werden nicht automatisch in sie verschoben. Verwenden Sie im Projekt durchgehend aussagekräftige und einheitliche Namen.
import bpy
collection = bpy.data.collections.new('Mobilya')
bpy.context.scene.collection.children.link(collection)Nach dem Erstellen der Collection sind das Verschieben von Objekten in die passende Gruppe und der Aufbau einer Hierarchie mit untergeordneten Collections separate Schritte. In der API-Dokumentation sind das Erstellen von Collections und das Verknüpfen untergeordneter Collections als getrennte Funktionen aufgeführt. Dieser Code organisiert also nicht automatisch den Rest der Szene.
3. Die Hierarchie des aktiven View Layers untersuchen
Das folgende Beispiel durchläuft die untergeordneten Gruppen ausgehend von der Root-Layer-Collection des aktiven View Layers. Jede Zeile zeigt den Namen der Collection sowie die Werte von exclude, hide_viewport und is_visible. So können Sie die Position der Gruppen in der Hierarchie und ihren Sichtbarkeitsstatus überprüfen.
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 berücksichtigt auch den Status übergeordneter Collections. Daher reicht es möglicherweise nicht aus, die Einstellung einer untergeordneten Gruppe isoliert zu betrachten. Die Dokumentation beschreibt auch visible_get() als Sichtbarkeitsabfrage, die die übergeordnete Hierarchie und den Viewport-Status berücksichtigt. Für eine zuverlässige Prüfung sollten Sie die gesamte Hierarchie untersuchen.
4. Eine Collection aus dem aktiven View Layer ausschließen
Wenn eine Gruppe nur aus dem aktiven View Layer ausgeschlossen werden soll, können Sie die Eigenschaft exclude der Layer Collection verwenden. Das Beispiel sucht die benannte Collection in der Hierarchie und ändert den Wert der Eigenschaft, falls sie gefunden wird.
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 schließt die passende Layer Collection aus dem View Layer aus. Um sie wieder einzubeziehen, setzen Sie den Wert auf False. Einheitliche Collection-Namen erleichtern es, bei der Suche die gewünschte Gruppe zu finden.
5. Sichtbarkeits- und Rendereinstellungen passend zum Zweck wählen
Eine Collection vorübergehend im Viewport auszublenden ist nicht dasselbe, wie sie generell von Renderings auszuschließen. hide_viewport auf der Layer Collection beeinflusst vorübergehend die Sichtbarkeit im Viewport. hide_viewport auf der Collection deaktiviert die Collection generell in Viewports. Die Eigenschaft hide_render der Collection ist für das Deaktivieren in Renderings vorgesehen, während exclude auf der Layer Collection die Gruppe aus dem betreffenden View Layer ausschließt.
Auch die anderen Optionen der Layer Collection haben unterschiedliche Aufgaben:
holdoutmaskiert Objekte in der Collection im View Layer.indirect_onlysorgt dafür, dass Objekte nur indirekt über Schatten und Reflexionen beitragen.excludehält die Collection aus dem betreffenden View Layer heraus.hide_viewportbeeinflusst die Sichtbarkeit der Collection im Viewport.
Mit der Eigenschaft use eines View Layers lässt sich das Rendern des betreffenden Layers ein- und ausschalten. Auf Layer-Ebene stehen außerdem Material- und Welt-Überschreibungen sowie verschiedene Render-Pass-Optionen zur Verfügung. Mit diesen Funktionen können Sie dieselben Szenendaten für unterschiedliche visuelle Anforderungen verwalten; ein bestimmtes Bildresultat wird dadurch allein nicht garantiert.
Was ändert sich im Architektur- und Visualisierungs-Workflow?
Architektinnen und Architekten sowie Innenarchitektinnen und Innenarchitekten können die Szenenhierarchie übersichtlicher gestalten, indem sie Bauteile, Möbel und Außenanlagen in separaten Collections organisieren. Visual Artists können mit den Einstellungen der Layer Collections steuern, welche Gruppen in einem bestimmten View Layer enthalten sind und welche Gruppen indirekt beitragen. Dieser Ansatz kann die Verwaltung der Szeneninhalte für unterschiedliche Präsentationsanforderungen erleichtern.
Gerade in großen Szenen sind eine einheitliche Benennung der Gruppen und konsistente Beziehungen zwischen über- und untergeordneten Collections wichtig. Die Quellen nennen keine bestimmten Hardware- oder Add-on-Anforderungen. Da auch keine Versionsnummer angegeben ist, sollten Sie die API-Beispiele zunächst in einer kleinen Kopie mit der verwendeten Blender-Installation überprüfen, bevor Sie sie in ein Projekt übernehmen.
Häufige Fehler
Collection und Layer Collection für dasselbe halten: Die eine repräsentiert Objektgruppen, die andere deren Status innerhalb eines View Layers.
hide_renderundexcludeals gleichwertig ansehen: Ersteres gilt auf Collection-, Letzteres auf Layer-Collection-Ebene.Nur den Wert
objectsprüfen: Diese Eigenschaft liefert die Objekte direkt in der Gruppe;all_objectsumfasst auch untergeordnete Collections.Sichtbarkeitswerte unabhängig von der Hierarchie interpretieren: Der Status übergeordneter Gruppen kann die Sichtbarkeit einer untergeordneten Collection beeinflussen.
Den Code verwenden, ohne die Übereinstimmung des Collection-Namens zu prüfen: Im Beispiel wird eine separate Meldung ausgegeben, wenn der Name nicht gefunden wird.
Einstellungen ändern, ohne zuvor eine Sicherungskopie der Datei anzulegen: Die Codebeispiele können den Status der aktiven Szene und des View Layers beeinflussen.
Nächste Schritte
Erstellen Sie zunächst in einer kleinen Testdatei eine Collection-Hierarchie und führen Sie den Prüfcode aus, um die Namen in der Ausgabe zu kontrollieren. Testen Sie anschließend das Beispiel mit exclude und Ihren eigenen Collection-Namen und beobachten Sie die Auswirkungen auf den aktiven View Layer. Für weiterführende Arbeiten können Sie in der View-Layer-Dokumentation die Eigenschaften für AOVs, Render-Passes, Sample-Anzahl sowie Material- und Welt-Überschreibungen untersuchen. Wenn Sie bei jedem Schritt mit einer Kopie der Datei arbeiten, bleibt die Projektstruktur erhalten.
Quelle und Lizenz
Dieser Leitfaden wurde auf Grundlage der API-Dokumentation von Blender zu Collection, LayerCollection und ViewLayer ins Türkische übertragen. Alle drei Quellen stehen unter der Lizenz CC BY-SA 4.0. Die Codebeispiele wurden für diesen Leitfaden unter Verwendung der dokumentierten API-Eigenschaften geschrieben.
Quellen
3 QuellenQuelltexte werden nicht neu veröffentlicht; kurze Zitate sind gekennzeichnet, der Rest ist eigene Zusammenfassung und Einordnung.
Eine klare Trennung zwischen Collection und View Layer kann Architekturdateien mit vielen Möbeln, Umgebungselementen und Präsentationsoptionen übersichtlicher machen. Auch die Möglichkeit, die Hierarchie über die Python-API zu untersuchen, bietet Visualisierungsteams mit wiederkehrenden Prüfaufgaben einen hilfreichen Einstieg.
Für Büros und Studierende in der Türkei nennen die Quellen keine zusätzlichen Hardwareanforderungen. Dennoch ist es wichtig, den Code zunächst mit der verwendeten Blender-Installation zu testen, bevor man ihn in eine Produktionsdatei übernimmt. Eine einheitliche Benennung der Collections im Team und eine abschließende Prüfung des Unterschieds zwischen `hide_render` und `exclude` können sich in der Praxis auszahlen.
Häufige Fragen
Was ist der Unterschied zwischen einer Blender Collection und einer Layer Collection?
Eine Collection gruppiert Objekte und untergeordnete Collections. Eine Layer Collection verwaltet den Status dieser Gruppe innerhalb eines bestimmten View Layers.
Welche Einstellung schließt eine Collection in Blender nur aus einem View Layer aus?
Dafür wird die Eigenschaft `exclude` der Layer Collection verwendet. Die Eigenschaft `hide_render` der Collection ist für das generelle Deaktivieren in Renderings vorgesehen.
Lässt sich eine Collection-Hierarchie mit der Blender-API untersuchen?
Ja. Ausgehend von der Root-Layer-Collection eines View Layers können Sie über `children` die Collection-Namen und Sichtbarkeitswerte untersuchen.



