• IPO level control
  
  The first step in Blender/Python integration is providing the same capabilities that IPO's have to scripts. This means scripts can read and write the same properties that can be controlled by IPO's, allowing for procedural animation.
  
  Simple examples might included making a ball bounce along a sine curve, or adding random jitter to a camera movement.
  
  
• Vertice-level control
  
  The second stage of integration is proving script access to the data found in Meshes, Curves, and Surfaces. Not only does this involve the reading/adding/deleting of vertices but also an interface for generation of fully procedural objects - allowing the user to manipulate a mesh, and a non-destructive transformation to be applied by the script.
  
  
• And more...
  
  Other things in consideration or planning include more adding more Blender API calls, letting scripts execute commands just like the user would, scripts could then automate frequent or complex actions.
  
  We are also interested in providing the functionality necessary to write complete applications that run embedded inside a Blender window with access to the Blender UI elements.
  
  

• Blender Main API module
  
  • Int: Blender.bylink Used to test if the script was executed by a scriptlink - see the ScriptLink section below
    
    
  • Method: Blender.Get(request) General data access function, used with the constants in Blender.Const
    
    
  • Module: Blender.Object Object object and functions
    
    • Method: Blender.Object.Get([name])
      
    
    
  • Module: Blender.Material Material object and functions
    
    • Method: Blender.Material.Get([name])
      
    
    
  • Module: Blender.Camera Camera object and functions
    
    • Method: Blender.Camera.Get([name])
      
    
    
  • Module: Blender.World World object and functions
    
    • Method: Blender.World.Get([name])
      Method: Blender.World.GetActive() Returns the active World
      
    
    
  • Module: Blender.Lamp Lamp object and functions
    
    • Method: Blender.Lamp.Get([name])
      
    
    
  • Module: Blender.Const Constant definitions for Blender.Get
    
    • Int: Blender.Const.BP_CURFRAME Request the current frame
      
    • Float: Blender.Const.BP_CURTIME Request the current time (includes field and motion blur calculations)
      
    
    

• Object.parent The parent of the object
• Object.data The object data (ie. mesh, lamp, camera)
• Object.mat The 4x4 matrix for the object
  
  
• Object.loc A 3 member vector for location
• Object.dloc A 3 member vector for delta location
  
  
• Object.rot A 3 member vector for rotation
• Object.drot A 3 member vector for delta rotation
  
  
• Object.size A 3 member vector for size
• Object.dsize A 3 member vector for delta size

• Blender.NMesh Low-level mesh editing module
  
  • Method: NMesh.GetRaw([name]) Get a NMesh from Blender
    
    • If name is not specified a new empty mesh is returned, otherwise Blender returns an existing mesh.
    • On reading Blender sets the NMesh has_col and has_uvco flags based on what data was filled
    
    
  • Method: NMesh.PutRaw(mesh, [name, renormal]) Return a NMesh to Blender
    • (mesh) The NMesh object to store
    • [name] The mesh to replace
    • [renormal] Flag to control vertex normal recalculation (True==recalculate)
    • If the name of a mesh to replace is not given a new object is created and returned.
    • On writing Blender uses the NMesh has_col and has_uvco flags to determine what data should be allocated and set. You need to manual set these to 1 if you want colors of UV coordinates to be set.
    
    
  • Method: NMesh.Vert([x, y, z]) Create a new vertice
    • [x=0.0, y=0.0, z=0.0] Specify new coordinates
    
    
  • Method: NMesh.Face() Create a new face
    
    
  • Method: NMesh.Col([r,g,b,a]) Create a new mesh color
    • [r=255, g=255, b=255, a=255] Specify the color components
  
  
  
• NMesh object
  • verts List of vertices
  • faces List of faces
  • has_col Flag for whether mesh has mesh colors
  • has_uvco Flag for whether mesh has UV coordinates
    
    
  • Face object
    • v List of Vert's that form face
    • col List of vertex Col's (always size 4), matches to verts in v
    • mat Material index number for face
    
    
  • Vert object
    • co Vertex coordinate vector
    • uvco UV coordinate vector (element [2] (Z) is unused)
    • no Normal vector
    
    
  • Col object
    • r Red component
    • g Green component
    • b Blue component
    • a Alpha component

• Worlds - Available when the current scene contains a World
• Lamps - Available when the active Object is a Lamp
• Materials - Available when the active Object has a Material
• Cameras - Available when the active Object is a Camera
• Objects - Available when an Object is active

• FrameChanged - This event is executed everytime the user changes frames, and during rendering and animation playback. To provide greater user interaction this script is also executed continuously during editing for Objects.
• Thats all? - Only for now! In the future we will provide more events as integration progresses.

# Keeps objects above the floor!

import Blender

if (Blender.bylink):
	ob= Blender.link
	
	if (ob.LocZ < 0.0): ob.LocZ= 0.0

• FrameChanged - This event is executed everytime the user changes frames, and during rendering and animation playback.
• Thats all? - See "Thats all?" above!