Module Group
The Blender.Group submodule.
Group
This module provides access to Group data in Blender.
Example:
# Make Dupli's Real, as a python script.
from Blender import *
scn= Scene.GetCurrent()
for ob in scn.objects:
print 'Object Group Settings'
print ob.name, ob.type
print 'enableDupVerts:', ob.enableDupVerts
print 'enableDupFrames:', ob.enableDupFrames
print 'enableDupGroup:', ob.enableDupGroup
print 'DupGroup:', ob.DupGroup
dupe_obs= ob.DupObjects
print 'num dup obs:', len(dupe_obs)
for dup_ob, dup_matrix in dupe_obs:
print ' DupOb', dup_ob.name
scn.objects.new(dup_ob.data)
new_ob.setMatrix(dup_matrix)
new_ob.sel= 1 # select all real instances.
ob.sel=0 # Desel the original object
Window.RedrawAll()
Example:
# Make a new group with the selected objects, and add an instance of this group.
from Blender import *
scn= Scene.GetCurrent()
# New Group
grp= Group.New('mygroup')
grp.objects= scn.objects
# Instance the group at an empty using dupligroups
ob= scn.objects.new(None)
ob.enableDupGroup= True
ob.DupGroup= grp
Window.RedrawAll()
Example:
# Remove all non mesh objects from a group.
from Blender import *
scn= Scene.GetCurrent()
# New Group
grp= Group.Get('mygroup')
for ob in list(grp.objects): # Convert to a list before looping because we are removing items
if ob.type != 'Mesh':
grp.objects.unlink(ob)
|
Group
This object gives access to Groups in Blender.
|
Blender Group
|
New(name=None)
Make a new empty group, name optional, default is "Group" |
|
|
Blender Group or a list of Blender Groups
|
Get(name=None)
Get the Group object(s) from Blender. |
|
|
|
Unlink(group)
Unlink (delete) this group from Blender. |
|
|
Make a new empty group, name optional, default is
"Group"
- Parameters:
name (string) - The name of the new group.
- Returns: Blender Group
- A Empty Blender Group object
|
Get the Group object(s) from Blender.
- Parameters:
name (string) - The name of the Group object.
- Returns: Blender Group or a list of Blender Groups
- It depends on the name parameter:
-
(name): The Group object called name, Exception if it
is not found.
-
(): A list with all Group objects in the current blend file.
|
Unlink (delete) this group from Blender.
- Parameters:
group (group) - A group to remove from this blend file, does not remove objects
that this group uses.
Note:
No objects will be removed, just the group that references them.
|