Module Group

Module Group

source code

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)


Classes
  Group
This object gives access to Groups in Blender.
Functions
Blender Group
New(name=None)
Make a new empty group, name optional, default is "Group"
source code
Blender Group or a list of Blender Groups
Get(name=None)
Get the Group object(s) from Blender.
source code
 
Unlink(group)
Unlink (delete) this group from Blender.
source code
Function Details

New(name=None)

source code 
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(name=None)

source code 
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(group)

source code 
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.