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.