En bref
- Une Collection regroupe des objets et des sous-collections.
- Une Layer Collection gère l’état d’une Collection au sein d’une View Layer.
- Exclude, holdout et indirect_only remplissent des fonctions différentes.
- L’API View Layer propose des réglages pour les couches de scène et les passes de rendu.
Ce que vous allez apprendre dans ce guide
Dans une scène Blender architecturale, regrouper dans un seul ensemble la structure, le mobilier, les éléments d’environnement et les éclairages peut compliquer la lecture de la scène et la gestion de différents besoins de présentation. Les Collections servent à regrouper des objets et des sous-collections. Les View Layers permettent de contrôler la manière dont ces groupes sont traités dans une couche de vue donnée.
Ce guide vous apprend à distinguer Collection et Layer Collection, à comprendre la portée des réglages de visibilité et à examiner la hiérarchie d’une scène via l’API Python. Les exemples utilisent des noms de collections adaptés à un fichier architectural ; ils ne garantissent pas un résultat de rendu particulier.
Prérequis
Blender doit être installé et l’API Python accessible.
Les sources sont la documentation actuelle de l’API Blender. Comme elles ne précisent pas de numéro de version de Blender, aucun numéro de version n’est indiqué ici.
Les sources ne précisent aucune exigence concernant un compte, un abonnement, un service en ligne, du matériel ou des modules complémentaires. La documentation est sous licence CC BY-SA 4.0.
Avant d’exécuter du code qui modifie la structure de la scène, enregistrez une copie du fichier. Les modifications des propriétés d’une View Layer peuvent affecter le contenu de la couche active.
Étape par étape : utiliser Collection et View Layer
1. Comprendre la différence entre Collection et Layer Collection
Une Collection est une structure de scène qui regroupe des objets et des sous-collections. La propriété objects d’une Collection correspond aux objets directement présents dans ce groupe ; all_objects inclut également les objets des sous-collections. Ainsi, si vous ne vérifiez que le groupe parent, vous risquez de ne pas voir les objets des sous-collections.
Une Layer Collection est la représentation d’une Collection dans une View Layer donnée. Le groupe auquel appartiennent les objets et le comportement de ce groupe dans la View Layer concernée sont deux aspects différents. Des réglages comme exclude, hide_viewport, holdout et indirect_only se trouvent sur la Layer Collection.
2. Créer une Collection et la rattacher à la scène
L’exemple ci-dessous crée une Collection nommée Mobilya et l’ajoute aux enfants de la collection principale de la scène. Cette opération crée le groupe, mais n’y déplace pas automatiquement les objets existants. Utilisez des noms cohérents et adaptés à leur fonction dans l’ensemble du projet.
import bpy
collection = bpy.data.collections.new('Mobilya')
bpy.context.scene.collection.children.link(collection)Une fois la collection créée, déplacer des objets dans le groupe et mettre en place une hiérarchie de sous-collections sont des opérations distinctes. La documentation de l’API présente séparément les fonctions de création d’une collection et de rattachement de collections enfants. Ce code ne réorganise donc pas automatiquement le reste de la scène.
3. Examiner la hiérarchie de la View Layer active
L’exemple suivant parcourt les groupes enfants en partant de la Layer Collection racine de la View Layer active. Chaque ligne affiche le nom de la Collection ainsi que les valeurs de exclude, hide_viewport et is_visible. Vous pouvez ainsi vérifier la place des groupes dans la hiérarchie et leur état de visibilité.
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 tient également compte de l’état des collections parentes. Il ne suffit donc pas d’interpréter isolément le réglage du groupe enfant. La documentation décrit aussi visible_get() comme une vérification de visibilité tenant compte de la hiérarchie parente et de l’état du viewport. Pour effectuer un contrôle fiable, mieux vaut examiner toute la chaîne.
4. Exclure une Collection de la View Layer active
Pour retirer un groupe uniquement de la View Layer active, vous pouvez utiliser la propriété exclude de la Layer Collection. L’exemple recherche la collection indiquée dans la hiérarchie et modifie cette propriété si elle est trouvée.
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ı.')Dans l’exemple, True exclut la Layer Collection correspondante de la View Layer. Pour la réinclure, utilisez la valeur False. Des noms de collections cohérents facilitent la recherche du groupe voulu.
5. Choisir les réglages de visibilité et de rendu selon l’objectif
Masquer temporairement une collection dans le viewport et la désactiver globalement pour les rendus ne sont pas la même opération. hide_viewport sur une Layer Collection affecte temporairement la visibilité dans le viewport. hide_viewport sur une Collection désactive cette dernière de manière générale dans les viewports. La propriété hide_render d’une Collection sert à la désactiver dans les rendus, tandis que exclude sur une Layer Collection permet de la retirer de la View Layer concernée.
Les autres options de Layer Collection ont également des rôles distincts :
holdoutpermet de masquer les objets de la collection dans la View Layer.indirect_onlyfait en sorte que les objets contribuent uniquement de manière indirecte, par les ombres et les réflexions.excludemaintient la collection en dehors de la View Layer concernée.hide_viewportaffecte la visibilité de la collection dans le viewport.
La propriété use de la View Layer active ou désactive le rendu de la couche concernée. Il existe également des substitutions de matériau et de monde au niveau de la couche, ainsi que différents réglages de passes de rendu. Ces fonctionnalités permettent d’adapter les mêmes données de scène à divers besoins visuels ; elles ne garantissent pas à elles seules un résultat d’image particulier.
Qu’est-ce que cela change dans un flux de travail d’architecture et de visualisation ?
Les architectes et architectes d’intérieur peuvent rendre la hiérarchie du fichier plus lisible en plaçant les éléments structurels, le mobilier et l’aménagement paysager dans des Collections séparées. Les artistes de visualisation peuvent utiliser les réglages des Layer Collections pour contrôler les groupes présents dans une View Layer donnée et ceux qui contribuent indirectement. Cette approche peut faciliter la gestion du contenu de la scène selon les besoins de présentation.
Dans les scènes volumineuses, il est particulièrement important de nommer les groupes et de construire des relations parent-enfant cohérentes. Les sources ne précisent aucune exigence en matière de matériel ou de modules complémentaires. Aucun numéro de version n’étant indiqué, vérifiez les exemples de l’API dans une copie de test sur l’installation Blender utilisée avant de les intégrer au projet.
Erreurs fréquentes
Confondre Collection et Layer Collection : la première regroupe les objets, tandis que la seconde représente l’état de ces groupes dans une View Layer.
Considérer
hide_renderetexcludecomme équivalents : le premier s’applique au niveau Collection, le second au niveau Layer Collection.Ne vérifier que la valeur
objects: cette propriété renvoie les objets directement présents dans le groupe, tandis queall_objectsinclut aussi les sous-collections.Interpréter une valeur de visibilité sans tenir compte de la hiérarchie : l’état des groupes parents peut affecter la visibilité d’une sous-collection.
Utiliser le code sans vérifier la correspondance du nom de la collection : dans l’exemple, un message distinct s’affiche si le nom n’est pas trouvé.
Modifier les réglages sans sauvegarder le fichier : les exemples de code peuvent affecter l’état de la scène active et de la View Layer.
Étapes suivantes
Commencez par créer une hiérarchie de Collections dans un petit fichier de test, puis exécutez le code d’inspection pour vérifier les noms affichés. Essayez ensuite l’exemple exclude avec vos propres noms de collections et observez son effet sur la View Layer active. Pour aller plus loin, consultez dans la documentation View Layer les propriétés liées aux AOV, aux passes de rendu, au nombre d’échantillons et aux substitutions de matériau ou de monde. Travailler sur une copie du fichier à chaque étape contribue à préserver l’organisation du projet.
Sources et licence
Ce guide a été adapté en turc à partir des informations figurant dans la documentation de l’API Blender pour Collection, LayerCollection et ViewLayer. Les trois sources sont sous licence CC BY-SA 4.0. Les exemples de code ont été écrits pour ce guide à partir des propriétés de l’API documentées.
Sources
3 sourcesLes textes sources ne sont pas republiés ; les courtes citations sont signalées, le reste est notre propre résumé et commentaire.
Bien distinguer Collection et View Layer peut rendre plus lisibles les fichiers architecturaux comportant de nombreux éléments de mobilier, d’environnement et de présentation. L’approche consistant à examiner la hiérarchie via l’API Python constitue également un bon point de départ pour les équipes de visualisation qui effectuent des contrôles répétitifs.
Pour les bureaux et les étudiants en Turquie, les sources ne signalent pas de besoin matériel supplémentaire ; il reste toutefois important de tester le code sur l’installation Blender utilisée avant de l’intégrer à un fichier de production. Standardiser les noms de collections au sein de l’équipe et vérifier la différence entre `hide_render` et `exclude` avant la livraison peut être utile en pratique.
Questions fréquentes
Quelle est la différence entre Collection et Layer Collection dans Blender ?
Une Collection regroupe des objets et des sous-collections. Une Layer Collection gère l’état de ce groupe dans une View Layer donnée.
Quel réglage permet d’exclure une Collection d’une seule View Layer dans Blender ?
Utilisez la propriété `exclude` de la Layer Collection. La propriété `hide_render` d’une Collection sert à la désactiver globalement pour les rendus.
Peut-on examiner la hiérarchie des collections avec l’API Blender ?
Oui. En partant de la Layer Collection racine de la View Layer et en parcourant ses `children`, il est possible d’examiner les noms des collections et leurs valeurs de visibilité.



