Модуль BPY plus для упрощения работы с коллекциями.
Класс Collections
set_active(name, context=bpy.context)
Делает коллекцию активной по имени.
Параметры:
name: имя коллекции которую нужно сделать активной
context: указатель на контекст
1 2 3 4 5 6 |
from bpy_plus.collections import Collections Collections.set_active(name='scene 1') print(bpy.context.collection) # bpy.data.collections['scene 1'] |
layer_collection(name, context=bpy.context)
Возвращает LayerCollection по имени коллекции.
Параметры:
name: имя коллекции
context: указатель на контекст
1 2 3 4 |
from bpy_plus.collections import Collections print(Collections.layer_collection(name='scene 1')) # <bpy_struct, LayerCollection("scene 1") at 0x0000023FE990A258> |
selected()
Возвращает список выделенных в Аутлайнере коллекций.
1 2 3 4 |
from bpy_plus.collections import Collections print(Collections.selected()) # (bpy.data.collections['scene'], bpy.data.collections['camera']) |
active(context=bpy.context)
Возвращает текущую активную коллекцию.
Параметры:
context: указатель на контекст
1 2 3 4 5 |
from bpy_plus.collections import Collections print(Collections.active()) # <bpy_struct, Collection("scene") at 0x0000029A37D84D08> |
all(context=bpy.context)
Возвращает список всех коллекций в сцене.
Параметры:
context: указатель на контекст
1 2 3 4 5 |
from bpy_plus.collections import Collections print(Collections.all()) # [bpy.data.collections['camera'], bpy.data.collections['scene'], bpy.data.scenes['Scene'].collection] |
parent(context=bpy.context, collection=None)
Возвращает родительскую коллекцию.
Параметры:
context: указатель на контекст
collection: коллекция, для которой нужно определить родительскую коллекцию. Если None – берется для текущей активной коллекции.
1 2 3 4 5 6 7 |
import bpy from bpy_plus.collections import Collections print( Collections.parent(collection=bpy.context.collection) ) # <bpy_struct, Collection("Scene Collection") at 0x0000029A37D85008> |
move(collection, to)
Перемещает коллекцию collection в коллекцию to
Параметры:
collection: коллекция, которую нужно переместить
to: коллекция, в котороую нужно переместить.
1 2 3 4 5 6 7 |
import bpy from bpy_plus.collections import Collections Collections.move( collection=Collections.active(), to=bpy.data.collections['Collection 3'] ) |