Actor intervals allow actor animations to be played as an interval, which allows them to be combined with other intervals through sequences and parallels.
The subrange of the animation to be played may be specified via frames (
startFrame up to and including
endFrame) or seconds (
startTime up to and including
endTime). It may also be specified with a
startTime in conjunction with the duration, in seconds. If none of these is specified, then the default is to play the entire range of the animation.
endFrame is before
startFrame, or if the play rate is negative, then the animation will be played backwards.
You may specify a subrange that is longer than the actual animation, but if you do so, you probably also want to specify either
constrainedLoop=1; see below.
The loop parameter is a boolean value. When it is true, it means that the animation restarts and plays again if the interval extends beyond the animation's last frame. When it is false, it means that the animation stops and holds its final pose when the interval extends beyond the animation's last frame. Note that, in neither case, will the ActorInterval loop indefinitely: all intervals always have a specific, finite duration, and the duration of an ActorInterval is controlled by either the duration parameter, the
endTime parameters, or the
endFrame parameters. Setting
loop=1 has no effect on the duration of the ActorInterval, it only controls what the actor does if you try to play past the end of the animation.
constrainedLoop works similarly to loop, but while
loop=1 implies a loop within the entire range of animation,
constrainedLoop=1 implies a loop within
endFrame only. That is, if you specify
loop=1 and the animation plays past
endFrame, in the next frame it will play beginning at frame 0; while if you specify
constrainedLoop=1 instead, then the next frame after
endFrame will be
All parameters other than the animation name are optional.
from direct.interval.ActorInterval import ActorInterval
myInterval = myactor.actorInterval(
loop=<0 or 1>,
constrainedLoop=<0 or 1>,