Module Effect
[frames | no frames]

Module Effect

The Blender.Effect submodule

INTRODUCTION

The module effect allows you to access all the data of an effect. An effect can modify an object (typically a mesh) in three different ways.

a) the build effect : makes the mesh appear progressivly.

b) the wave effect : waves appear on the mesh (which should be fine-grained)

c) the particle effect : every vertex of the mesh emits particles, which can themselves emit new particles. This effect is the most parametrizable.

In the blender internals, the effect object is just a placeholder for the "real" effect, which can be a wave, particle or build effect. The python API follows this structure : the Effect module grants access to (the few) data which are shared between all effects. It has three submodules : Wave, Build, Particle , which grant r/w access to the real parameters of these effects.

Example:
 import Blender
       listffects = Blender.Effect.Get()
       print listeffects
       eff = listeffects[0]
       #we suppose the first effect is a build effect
       print eff.getLen()
       eff.setLen(500)

Classes
Effect This object gives access to generic data from all effects in Blender.

Function Summary
Blender Effect or a list of Blender Effects Get(objname, position)
Get an Effect from Blender.
Blender Effect New(type)
Creates a new Effect.

Function Details

Get(objname, position)

Get an Effect from Blender.
Parameters:
objname - The name of object to which is linked the effect.
           (type=string)
position - The position of the effect in the list of effects liked to the object.
           (type=string)
Returns:
It depends on the 'objname,position' parameters:
  • (objname,position): The Effect linked to the given object at the given position;
  • (): A list with all Effects in the current scene.

           (type=Blender Effect or a list of Blender Effects)

New(type)

Creates a new Effect.
Parameters:
type - Effect type. Can be "wave", "particle" or "build"
           (type=string)
Returns:
The created Effect.
           (type=Blender Effect)

Generated by Epydoc 1.1 on Wed Aug 13 19:17:14 2003 http://epydoc.sf.net