Campbell Barton
e8da6131fd
Move copyright text to SPDX-FileCopyrightText or set to the Blender Foundation so "make check_licenses" now runs without warnings.
84 lines
3.0 KiB
Python
84 lines
3.0 KiB
Python
# SPDX-FileCopyrightText: 2019-2022 Blender Foundation
|
|
#
|
|
# SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
import bpy
|
|
|
|
from typing import Optional, Sequence
|
|
from bpy.types import LayerCollection, Collection, Object, Context
|
|
|
|
|
|
##############################################
|
|
# Collection management
|
|
##############################################
|
|
|
|
def find_layer_collection_by_collection(layer_collection: LayerCollection,
|
|
collection: Collection) -> Optional[LayerCollection]:
|
|
if collection == layer_collection.collection:
|
|
return layer_collection
|
|
|
|
# go recursive
|
|
for child in layer_collection.children:
|
|
layer_collection = find_layer_collection_by_collection(child, collection)
|
|
if layer_collection:
|
|
return layer_collection
|
|
|
|
|
|
def list_layer_collections(layer_collection: LayerCollection,
|
|
visible=False, selectable=False) -> list[LayerCollection]:
|
|
"""Returns a list of the collection and its children, with optional filtering by settings."""
|
|
|
|
if layer_collection.exclude:
|
|
return []
|
|
|
|
collection = layer_collection.collection
|
|
is_visible = not (layer_collection.hide_viewport or collection.hide_viewport)
|
|
is_selectable = is_visible and not collection.hide_select
|
|
|
|
if (selectable and not is_selectable) or (visible and not is_visible):
|
|
return []
|
|
|
|
found = [layer_collection]
|
|
|
|
for child in layer_collection.children:
|
|
found += list_layer_collections(child, visible, selectable)
|
|
|
|
return found
|
|
|
|
|
|
def filter_layer_collections_by_object(layer_collections: Sequence[LayerCollection],
|
|
obj: Object) -> list[LayerCollection]:
|
|
"""Returns a subset of collections that contain the given object."""
|
|
return [lc for lc in layer_collections if obj in lc.collection.objects.values()]
|
|
|
|
|
|
def ensure_collection(context: Context, collection_name: str, hidden=False) -> Collection:
|
|
"""Check if a collection with a certain name exists.
|
|
If yes, return it, if not, create it in the scene root collection.
|
|
"""
|
|
view_layer = context.view_layer
|
|
active_layer_coll = bpy.context.layer_collection
|
|
active_collection = active_layer_coll.collection
|
|
|
|
collection = bpy.data.collections.get(collection_name)
|
|
if not collection or collection.library:
|
|
# Create the collection
|
|
collection = bpy.data.collections.new(collection_name)
|
|
collection.hide_viewport = hidden
|
|
collection.hide_render = hidden
|
|
|
|
layer_collection = None
|
|
else:
|
|
layer_collection = find_layer_collection_by_collection(view_layer.layer_collection, collection)
|
|
|
|
if not layer_collection:
|
|
# Let the new collection be a child of the active one.
|
|
active_collection.children.link(collection)
|
|
layer_collection = [c for c in active_layer_coll.children if c.collection == collection][0]
|
|
|
|
layer_collection.exclude = True
|
|
|
|
# Make the new collection active.
|
|
view_layer.active_layer_collection = layer_collection
|
|
return collection
|