Object

Parameters:

mesh - When non-zero, mesh object data will be duplicated with the objects.
           (type=bool)

surface - When non-zero, surface object data will be duplicated with the objects.
           (type=bool)

curve - When non-zero, curve object data will be duplicated with the objects.
           (type=bool)

text - When non-zero, text object data will be duplicated with the objects.
           (type=bool)

metaball - When non-zero, metaball object data will be duplicated with the objects.
           (type=bool)

armature - When non-zero, armature object data will be duplicated with the objects.
           (type=bool)

lamp - When non-zero, lamp object data will be duplicated with the objects.
           (type=bool)

material - When non-zero, materials used by the object or its object data will be duplicated with the objects.
           (type=bool)

texture - When non-zero, texture data used by the object's materials will be duplicated with the objects.
           (type=bool)

ipo -

When non-zero, Ipo data linked to the object will be duplicated with the objects.

Example:

The example below creates duplicates the active object 10 times and moves each object 1.0 on the X axis:

 import Blender

 scn = Scene.GetCurrent()
 ob_act = scn.objects.active
 
 # Unselect all
 scn.objects.selected = []
 ob_act.sel = 1
 
 for x in xrange(10):
     Blender.Object.Duplicate() # Duplicate linked
     ob_act = scn.objects.active
     ob_act.LocX += 1
 Blender.Redraw()

           (type=bool)

Parameters:

name - The name of the requested Object.
           (type=string)

Returns:

It depends on the 'name' parameter:

• (name): The Object with the given name;
• (): A list with all Objects in the current scene.

Example 1:

The example below works on the default scene. The script returns the plane object and prints the location of the plane:

 import Blender

 object = Blender.Object.Get ('plane')
 print object.getLocation()

Example 2:

The example below works on the default scene. The script returns all objects in the scene and prints the list of object names:

 import Blender

 objects = Blender.Object.Get ()
 print objects

Note: Get will return objects from all scenes. Most user tools should only operate on objects from the current scene - Blender.Scene.GetCurrent().getChildren()

Returns:

A list of all selected Objects in the current scene.

Example:

The example below works on the default scene. Select one or more objects and the script will print the selected objects:

 import Blender

 objects = Blender.Object.GetSelected()
 print objects

Notes:

• The active object will always be the first object in the list (if selected).
• The user selection is made up of selected objects from Blender's current scene only.
• The user selection is limited to objects on visible layers; if the user's last active 3d view is in localview then the selection will be limited to the objects in that localview.

Parameters:

type - The Object type: 'Armature', 'Camera', 'Curve', 'Lamp', 'Lattice', 'Mball', 'Mesh', 'Surf' or 'Empty'.
           (type=string)

name - The name of the object. By default, the name will be the same as the object type. If the name is already in use, this new object will have a number at the end of the name.
           (type=string)

Returns:

The created Object.

Example:

The example below creates a new Lamp object and puts it at the default location (0, 0, 0) in the current scene:

 import Blender

 object = Blender.Object.New('Lamp')
 lamp = Blender.Lamp.New('Spot')
 object.link(lamp)
 scene = Blender.Scene.GetCurrent()
 scene.link(object)

 Blender.Redraw()

Note: if an object is created but is not linked to object data, and the object is not linked to a scene, it will be deleted when the Python object is deallocated. This is because Blender does not allow objects to exist without object data unless they are Empty objects. Scene.link() will automatically create object data for an object if it has none.