Detailed Description

A take is a container for animation in a scene.

A take stores data about animation for objects. The transport controls (FBPlayerControl) act on the current take.

In the UI transport controls, a take's start and end determine when the Timeline indicator starts and stops.

You get the current take with FBSystem.CurrentTake, as in the following Python sample:

    for myTake in FBSystem().Scene.Takes:
        print myTake.Name

To create a take and have it accessible in the Transport control you should use CopyTake (called Duplicate in the UI):

Python sample code:

    from pyfbsdk import *    
    newTake = FBSystem().CurrentTake.CopyTake("my new take name")

C++ sample code:

    FBSystem lSystem;
    HFBTake lTake = lSystem.CurrentTake->CopyTake( "my new take" );

Examples: Tasks/ExportAnimationLibrary.py, Tasks/GoToNextTake.py, Tasks/GoToPreviousTake.py, Tasks/MirrorPoseOverTime.py, Tasks/MultiLayerKeying.py, Tasks/RenameFirstTakeOnMultipleFiles.py, Tasks/SaveOneTakePerFile.py

Inheritance diagram for FBTake:

[legend]

List of all members.

Public Member Functions
	__init__ (str pName, object pObject=None)
	Constructor.
	FBDelete ()
	Deletion method.
HFBTake	CopyTake (str pNewTakeName)
	Copy the take.
	PlotAllTakesOnSelected (FBTime pPlotPeriod)
	Plot the animation on selected models for all takes.
	CreateNewLayer ()
	Create a new layer.
	RemoveLayer (int pLayerIndex)
	Remove a layer.
FBAnimationLayer	GetLayer (int pLayerIndex)
	Get the layer object that have the specified ID.
FBAnimationLayer	GetLayerByName (str pName)
	Get the layer object that have the specified name.
	SetCurrentLayer (int pLayerIndex)
	Set the current layer for the take.
int	GetCurrentLayer ()
	Get the current layer for the take.
int	GetLayerCount ()
	Get the layer count.
bool	MoveCurrentLayerUp ()
	Move the current layer up, similar to using the button to move the layer in the Animation Layer tool.
bool	MoveCurrentLayerDown ()
	Move the current layer down, similar to using the button to move the layer in the Animation Layer tool.
	DuplicateSelectedLayers ()
	Duplicate the selected layers.
	MergeLayers (FBAnimationLayerMergeOptions pMergeOptions, bool pDeleteMergedLayers, FBMergeLayerMode pMergeMode)
	Merge the selected layers.
	PlotTakeOnSelected (FBTime pPlotPeriod)
	Plot the animation on selected models.
	PlotAllTakesOnSelectedProperties (FBTime pPlotPeriod)
	Plot the animation on selected properties for all takes.
	PlotTakeOnSelectedProperties (FBTime pPlotPeriod)
	Plot the animation on selected properties.
	ClearAllProperties (bool pOnSelectedObjectsOnly)
	Clear the animation on all the properties.
Public Attributes
FBPropertyBase	ReferenceTimeSpan
	Read Write Property: Reference time span.
FBPropertyBase	LocalTimeSpan
	Read Write Property: Local time span.
FBPropertyString	Comments
	Read Write Property: Take comments.

Member Function Documentation

__init__	(	str	pName,
		object	pObject = `None`
	)

Search for all occurrences

Constructor.

A user who wants its take to be available in Transport control should use the CopyTake method on the Current Take instead.

Parameters:

pName	Name of take.
pObject	For internal use only (default is NULL).

Examples: Tasks/ExportAnimationLibrary.py, Tasks/GoToNextTake.py, Tasks/GoToPreviousTake.py, Tasks/MirrorPoseOverTime.py, Tasks/MultiLayerKeying.py, Tasks/RenameFirstTakeOnMultipleFiles.py, Tasks/SaveOneTakePerFile.py

FBDelete ( )

Search for all occurrences

Deletion method.

Using this method to delete the take insure that the destruction process follows the same path as if the GUI had been used.

Examples: Tasks/DeleteHierarchy.py

Reimplemented from FBComponent.

HFBTake CopyTake ( str pNewTakeName )

Search for all occurrences

Copy the take.

Will create a copy of the current take, with the current take data. This is analogous to creating a new take, and copying the current take data into it. The Layers data and the TimeWarp date will be copied. The newly created take will be set as the current take. The newly created take is automatically added to the scene and available in the Transport control.

Parameters:

pNewTakeName The name for the new take.

Returns:: Handle to the newly created take.

PlotAllTakesOnSelected ( FBTime pPlotPeriod )

Search for all occurrences

Plot the animation on selected models for all takes.

Will plot the animation for all takes on the selected models in the scene.

Parameters:

pPlotPeriod Period for the plot.

CreateNewLayer ( )

Search for all occurrences

Create a new layer.

RemoveLayer ( int pLayerIndex )

Search for all occurrences

Remove a layer.

Parameters:

pLayerIndex Layer with at the specified index will be removed.

FBAnimationLayer GetLayer ( int pLayerIndex )

Search for all occurrences

Get the layer object that have the specified ID.

Parameters:

pLayerIndex The index of the layer that will be returned.

Returns:: Layer with the specified ID.

FBAnimationLayer GetLayerByName ( str pName )

Search for all occurrences

Get the layer object that have the specified name.

Parameters:

pName The name of the animation layer to get.

Returns:: Layer with the specified name or NULL if no layer has been found.

SetCurrentLayer ( int pLayerIndex )

Search for all occurrences

Set the current layer for the take.

Parameters:

pLayerIndex The layer index to be set as the current one.

int GetCurrentLayer ( )

Search for all occurrences

Get the current layer for the take.

Returns:: The current layer index.

int GetLayerCount ( )

Search for all occurrences

Get the layer count.

Returns:: The layer count.

bool MoveCurrentLayerUp ( )

Search for all occurrences

Move the current layer up, similar to using the button to move the layer in the Animation Layer tool.

Use the SetCurrentLayer to specify the current layer.

Returns:: True if successful.

bool MoveCurrentLayerDown ( )

Search for all occurrences

Move the current layer down, similar to using the button to move the layer in the Animation Layer tool.

Use the SetCurrentLayer to specify the current layer.

Returns:: True if successful.

DuplicateSelectedLayers ( )

Search for all occurrences

Duplicate the selected layers.

This is equivalent of doing a copy-paste.

MergeLayers	(	FBAnimationLayerMergeOptions	pMergeOptions,
		bool	pDeleteMergedLayers,
		FBMergeLayerMode	pMergeMode
	)

Search for all occurrences

Merge the selected layers.

This is equivalent of pressing the merge button in the Animation Layer editor.

Parameters:

pMergeOptions	Indicate which objects, layers and properties (selected or all) should be merged.
pDeleteMergedLayers	The source layer will be deleted after the merge if no animation is left on those layers, or if those layers are not parent of another layer.
pMergeMode	Set the layer mode of the resulting layer, if possible (the BaseAnimation layer cannot be modified).