Module Bpy_data

source code

The bpy module.

bpy.data (Generic Data Access)

Example:

       # apply the active image to the active mesh
       # this script has no error checking to keep it small and readable.

       sce= bpy.data.scenes.active
       ob_act = sce.objects.active             # assuming we have an active, might be None
       me = ob_act.getData(mesh=1)             # assuming a mesh type, could be any
       img = bpy.data.images.active                    # assuming we have an active image
       
       for f in me.faces:
               f.image = img

       Window.RedrawAll()

Example:

       # make a new object from an existing mesh
       # and make it active
       scn= bpy.data.scenes.active
       me = bpy.data.meshes['mymesh']
       ob = sce.objects.new(me) # new object from the mesh
       sce.objects.active = ob

Example:

       # print the names of any non local objects
       sce= bpy.data.scenes.active
       for ob in sce.objects:
               if ob.lib:
                       print 'external object:', ob.name, ob.lib

Example:

       # add an empty object at each vertex of the active mesh
       scn= bpy.data.scenes.active
       ob_act = sce.objects.active
       matrix = ob_act.matrixWorld
       me = ob_act.getData(mesh=1)
       
       for v in me.verts:
               ob = sce.objects.new('Empty')
               ob.loc = v.co * matrix                  # transform the vertex location by the objects matrix.

Example:

       # load all the wave sound files in a directory
       import os
       sound_dir = '/home/me/soundfiles/'
       sounds_new = []
       for fname in os.listdir(sound_dir):
               if fname.lower().endswith('.wav'):
                       try:
                               snd = bpy.data.sounds.new(filename = sound_dir + fname)
                       except:
                               snd = None
                       
                       if snd:
                               sounds_new.append(snd)
       
       # Print the sounds
       for snd in sounds_new:
               print snd

Example:

       # apply a new image to each selected mesh object as a texface.
       width, height= 512, 512
       scn= bpy.data.scenes.active
       
       for ob in sce.objects.context:
               if not ob.lib and ob.type == 'Mesh':    # object isn't from a library and is a mesh
                       me = ob.getData(mesh=1)
                       me.faceUV = True                                        # add UV coords and textures if we don't have them.
                       
                       # Make an image named after the mesh
                       img = bpy.data.images.new(me.name, width, height)
                       
                       for f in me.faces:
                               f.image = img
       
       Window.RedrawAll()