The Object object

buildParts()

clearIpo()

Returns:

True if there was an ipo linked or False otherwise.

clrParent(mode=0, fast=0)

Parameters:

mode - A mode flag. If mode flag is 2, then the object transform will be kept. Any other value, or no value at all will update the object transform.
           (type=Integer)

fast - If the value is 0, the scene hierarchy will not be updated. Any other value, or no value at all will update the scene hierarchy.
           (type=Integer)

getAction()

Returns:

a python action.
           (type=Py_Action)

getBoundBox()

Returns:

The coordinates of the 8 corners of the bounding box.
           (type=list of 8 (x,y,z) float coordinate vectors)

getData()

Returns:

Depending on the type of the Object, it returns a specific object for the data requested.
           (type=Object type specific)

getDeltaLocation()

Returns:

(x, y, z)
           (type=A vector triple)

getDrawMode()

Returns:

a sum of the following:

• 2 - axis
• 4 - texspace
• 8 - drawname
• 16 - drawimage
• 32 - drawwire

           (type=Integer)

getDrawType()

Returns:

One of the following:

• 1 - Bounding box
• 2 - Wire
• 3 - Solid
• 4 - Shaded
• 5 - Textured

           (type=Integer)

getEuler()

Returns:

A python euler
           (type=Py_Euler)

getInverseMatrix()

Returns:

A python matrix 4x4
           (type=Py_Matrix)

getIpo()

Returns:

the wrapped ipo or None.
           (type=Ipo)

getLocation()

Returns:

(x, y, z)

Example:

The example below works on the default scene. It retrieves all objects in the scene and prints the name and location of each object:

 import Blender

 objects = Blender.Object.Get()

 for obj in objects:
     print obj.getName()
     print obj.getLocation()

getMaterials()

Returns:

list of Material Objects assigned to the object.
           (type=list of Material Objects)

getMatrix()

Returns:

a python matrix 4x4
           (type=Py_Matrix)

getName()

Returns:

The name of the object

Example:

The example below works on the default scene. It retrieves all objects in the scene and prints the name of each object:

 import Blender

 objects = Blender.Object.Get()

 for obj in objects:
     print obj.getName()

getParent()

Returns:

The parent object of the object. If not available, None will be returned.
           (type=Object)

getSize()

Returns:

(SizeX, SizeY, SizeZ)

getTimeOffset()

Returns:

TimeOffset

getTracked()

Returns:

The tracked object of the object. If not available, None will be returned.
           (type=Object)

getType()

Returns:

The type of object.

Example:

The example below works on the default scene. It retrieves all objects in the scene and updates the location and rotation of the camera. When run, the camera will rotate 180 degrees and moved to the oposite side of the X axis. Note that the number 'pi' in the example is an approximation of the true number 'pi':

   import Blender

   objects = Blender.Object.Get()

   for obj in objects:
       if obj.getType() == 'Camera':
           obj.LocY = -obj.LocY
           obj.RotZ = 3.141592 - obj.RotZ

   Blender.Redraw()

link(object)

Parameters:

object - A Blender Object.
           (type=Blender Object)

makeDisplayList()

bject = Blender.Object.Get("Sphere")

nmesh = object.getData() nmesh.setMode("SubSurf") nmesh.update() # don't forget to update! object.makeDisplayList() Blender.Window.RedrawAll() # and don't forget to redraw

Warning: If after running your script objects disappear from the screen or are not displayed correctly, try this method function. But if the script works properly without it, there's no reason to use it.

makeParent(objects, noninverse=0, fast=0)

Parameters:

objects - A Blender Object.
           (type=Blender Object)

noninverse - 0 - make parent with inverse 1 - make parent without inverse
           (type=Integer)

fast - 0 - update scene hierarchy automatically 1 - don't update scene hierarchy (faster). In this case, you must explicitely update the Scene hierarchy.
           (type=Integer)

setDeltaLocation(delta_location)

Parameters:

delta_location - A vector triple (x, y, z) specifying the new location.
           (type=A vector triple)

setDrawMode(drawmode)

Parameters:

drawmode - A sum of the following:

• 2 - axis
• 4 - texspace
• 8 - drawname
• 16 - drawimage
• 32 - drawwire

           (type=Integer)

setDrawType(drawtype)

Parameters:

drawtype - One of the following:

• 1 - Bounding box
• 2 - Wire
• 3 - Solid
• 4 - Shaded
• 5 - Textured

           (type=Integer)

setEuler(euler)

Parameters:

euler - a python euler or x,y,z rotations as floats
           (type=Py_Euler or a list of floats)

setIpo(ipo)

Parameters:

ipo - an object type ipo.
           (type=Blender Ipo)

setLocation(x, y, z)

Parameters:

x - The X coordinate of the new location.
           (type=float)

y - The Y coordinate of the new location.
           (type=float)

z - The Z coordinate of the new location.
           (type=float)

setMaterials(materials)

Parameters:

materials - A list of Blender material objects.
           (type=Materials list)

setMatrix(matrix)

Parameters:

matrix - a python matrix 4x4.
           (type=Py_Matrix 4x4)

setName(name)

Parameters:

name - The new name for the object.
           (type=String)

setSize(x, y, z)

Parameters:

x - The X size multiplier.
           (type=float)

y - The Y size multiplier.
           (type=float)

z - The Z size multiplier.
           (type=float)

setTimeOffset(timeOffset)

Parameters:

timeOffset - The new time offset for the object's animation.
           (type=float)

shareFrom(object)

Parameters:

object - A Blender Object of the same type.
           (type=Blender Object)