Module NLA :: Class Action
[hide private]
[frames] | no frames]

Class Action

source code

The Action object

This object gives access to Action-specific data in Blender.

Instance Methods [hide private]
string
getName()
Get the name of this Action.
source code
 
setName(name)
Set the name of this Action.
source code
 
setActive(object)
Set this action as the current action for an object.
source code
PyIpo or None
getChannelIpo(channel)
Get the Ipo for the named channel in this action
source code
PyList
getFrameNumbers()
Gets the frame numbers at which a key was inserted into this action
source code
 
removeChannel(channel)
Remove a named channel from this action
source code
Dictionary [channel : PyIpo or None]
getAllChannelIpos()
Get the all the Ipos for this action
source code
list
getChannelNames()
Returns a list of channel names
source code
 
renameChannel(nameFrom, nameTo)
rename an existing channel to a new name.
source code
Instance Variables [hide private]
bool fakeUser
When set to True, this datablock wont be removed, even if nothing is using it.
string or None lib
path to the blend file this datablock is stored in (readonly).
string name
unique name within each blend file.
IDGroup properties
Returns an IDGroup reference to this datablocks's ID Properties.
bool tag
A temporary tag that to flag data as being used within a loop.
int users
The number of users this datablock has.
Method Details [hide private]

setName(name)

source code 

Set the name of this Action.

Parameters:
  • name (string) - The new name

setActive(object)

source code 

Set this action as the current action for an object.

Parameters:
  • object (PyObject) - The object whose action is to be set

getChannelIpo(channel)

source code 

Get the Ipo for the named channel in this action

Parameters:
  • channel (string) - The name of a channel in this action
Returns: PyIpo or None
the Ipo for the channel

getFrameNumbers()

source code 

Gets the frame numbers at which a key was inserted into this action

Returns: PyList
a list of ints

removeChannel(channel)

source code 

Remove a named channel from this action

Parameters:
  • channel (string) - The name of a channel in this action to be removed

getAllChannelIpos()

source code 

Get the all the Ipos for this action

Returns: Dictionary [channel : PyIpo or None]
the Ipos for all the channels in the action

getChannelNames()

source code 

Returns a list of channel names

Returns: list
the channel names that match bone and constraint names.

renameChannel(nameFrom, nameTo)

source code 

rename an existing channel to a new name.

if the nameFrom channel dosnt exist or the nameTo exists, an error will be raised.

Returns:
None

Instance Variable Details [hide private]

fakeUser

When set to True, this datablock wont be removed, even if nothing is using it. All data has this disabled by default except for Actions.
Type:
bool

lib

path to the blend file this datablock is stored in (readonly).

lib will be None unless you are using external blend files with (File, Append/Link)

Note: the path may be relative, to get the full path use Blender.sys.expandpath

Type:
string or None

name

unique name within each blend file.

The name is case sensitive and 21 characters maximum length.

Note: a blend file may have naming collisions when external library data is used, be sure to check the value of lib.

Note: Setting a value longer then 21 characters will be shortened

Type:
string

tag

A temporary tag that to flag data as being used within a loop. always set all tags to True or False before using since blender uses this flag for its own internal operations.
Type:
bool

users

The number of users this datablock has. (readonly) Zero user datablocks are de-allocated after reloading and saving.
Type:
int