Curve Parameters
Basics
- Parameter.isAnimated() bool
Returns whether this parameter contains keyframes to interpolate its value.
- Parameter.hasKey(time: float) bool
Returns whether this parameter has a keyed value at the given
time
.
- Parameter.getKeys() List[float]
Returns a
list
of key times for this parameter.
- Parameter.setKey(time: float, sendNotifyMessage: bool = True) None
Sets this parameter’s value at the given
time
as an animated key value.
- Parameter.moveKeys(*args, **kwargs)
Overloaded function.
moveKeys(self: NodegraphAPI_cmodule.Parameter, times: List[float], dt: float) -> None
Moves keys at the given
times
, by deleting and recreating them, by the given time offsetdt
.moveKeys(self: NodegraphAPI_cmodule.Parameter, times: Set[float], dt: float) -> None
Move keys at the given
times
, by deleting and recreating them, by the given time offsetdt
.
- Parameter.removeKey(time: float) None
Unsets a keyed value at the given
time
.
- Parameter.removeKeys(*args, **kwargs)
Overloaded function.
removeKeys(self: NodegraphAPI_cmodule.Parameter, times: List[float]) -> None
Unsets keyed values at all given
times
.removeKeys(self: NodegraphAPI_cmodule.Parameter, times: Set[float]) -> None
Unsets keyed values at all given
times
.
- Parameter.makeConstant(time: float) None
Sets this number parameter to a constant value (resetting the curve or expression, if present). The new value will be the previous animated value at
time
.
Auto Key
- Parameter.getAutoKey() bool
Returns whether this parameter’s autokey flag is set; if
True
,setValue()
will automatically create keys as required.
- Parameter.setAutoKey(value: bool) None
Sets this parameter’s autopkey flag; if
True
,setValue()
will automatically create keys as required.
- Parameter.setValueAutoKey(value: object, time: float, final: bool = True) None
Sets the value of this parameter at the given time, automatically adding a keyframe if required. If this is an interactive change, set
final
toFalse
to avoid redundant nodegraph messages.
Floating Curves
Floating curves are used to register temporary value changes that have not yet been committed. These temporary curves are wiped out whenever the user changes the current frame.
- Parameter.hasFloatingCurve() bool
Returns whether this number parameter currently has a floating curve.
- Parameter.resetFloatingCurve() None
Removes any floating curve from this number parameter.
FCurve
- Parameter.getCurve() object
Returns the
FCurve
representing the animated values for this parameter.
- Parameter.setCurve(curve: SPI_FN::FCurveLib::v19::FCurve, final: bool = True) None
Sets the
FCurve
representing the animated values for this number parameter.