<     > 

TimeControl

Object Hierarchy | Related C++ Class: TimeControl | Supported Parameter List: timectrl

Inheritance

SIObject
   ProjectItem
       Property
          TimeControl

Introduced

4.0

Description

The TimeControl object represents the clip's Time Control property, which is used to specify the time reference for a given Clip object. For example, this property may be used to add extra clip effects like cycling, bouncing, or holding for fractions of the clip length. Like ClipEffects, the time control effects applied to a specific clip do not alter the original source, nor any other clip instantiated on that source.

This object provides convenience accessors to some of the time control parameters (under the General and Extrapolation tabs on the property page). However, there are certain clip types which do not nest a time control property under them: for example, the audio clip and the animation mixer. For these, the TimeControl object returned by the Clip disables the access to parameters.

All scripting properties of the TimeControl object are read-only; however, you can still use the pointer to the TimeControl object to write to its parameters by going via the ParameterCollection (since the TimeControl object is a specialized kind of Property object).

Methods

Properties

Examples

Python Example

#
# This example illustrates how to use the time control to trim an instantiated clip.
#
from win32com.client import constants as c
oRoot = Application.ActiveSceneRoot
oNull = oRoot.AddNull("myNull")
oPosX = oNull.Parameters("Posx")

# Create and connect a function curve to the position x
oFCurve = oPosX.AddFCurve2([1, 10, 50, 0, 100, 10], c.siUnknownFCurve)

# This value should be 10;
Application.LogMessage("The animated value at frame 1 is %f " % (oPosX.Value))

# Create the animation source
oSource = Application.StoreAction(oRoot,"myNull.kine.local.posx",2,"StoredFcvPose", 1, 1, 100, 0,0)

# Create the first clip
oClip = Application.AddClip(oRoot, oSource)

# Use the ClipIn read-only scripting property to print the inital ClipIn value
oTimeControl = oClip.TimeControl
Application.LogMessage("The clip in value is %f " % (oTimeControl.ClipIn))

# Now use access the ClipIn parameter via the ParameterCollection (Property.Parameters) to change 
# the ClipIn value and print the new value
oTimeControl.Parameters("ClipIn").Value = 50
Application.LogMessage("The clip in value is now %f " % (oTimeControl.ClipIn))

# Now the value should be 0.
Application.LogMessage("The value after the clip manipulation is %f " % (oPosX.Value))

# Expected results:
#INFO : The animated value at frame 1 is 10.000000 
#INFO : The clip in value is 1.000000 
#INFO : The clip in value is now 50.000000 
#INFO : The value after the clip manipulation is 0.000000 

See Also

Autodesk Softimage v7.5     <     >