An interface for animations that can be run by Animator.
Inheritance Hierarchy
Remarks
Instances of classes implementing this interface change their state according to a relative animation time. The animation time is a double between 0 for the start of the animation and 1 for the end of the animation.
An animated object is first created using the constructor of a subclass.
Immediately before the animation a client calls initialize.
To change the state of the animated object a client does a series of calls to animate, usually with an increasing relative time parameter.
If the animation is done, the client calls cleanUp once.
While animate uses a relative time scheme, there might be an absolute time value for the preferred duration of the whole sequence of animation steps. Since an IAnimation instance has no control on the number of animate calls or the intervals between them, the preferred duration is only a hint on how long the animation should take. Clients can ask for that hint using preferredDuration and try to find a suitable sequence of animate calls in order to fulfill the preference.
Creates an eased animation for the given base animation.
The animation speed linearly increases up to a easeIn and linearly decreases from easeOut. Between those two points, the animation speed is constant.
The duration of the ease in and ease out is determined by a mapping [0,1] → [0,1]. The mapping has to be increasing to preserve the order of the frames in the decorated animation. In general, we consider continuously differentiable functions f where integral of f′ equals 1 a suitable choice for the mapping.
Parameters
easeIn?: number
The ratio for the ease-in time [0,1] where 0 is the start of the animation and 1 the end. 0.5 is the default value.
easeOut?: number
The ratio for the ease-out time [0,1] where 0 is the start of the animation and 1 the end. 0.5 is the default value.
Creates a new IAnimation that animates the given edge's bends from its current shape linearly to the shape given by the endBends and final port locations.
The bends of the edge layout are animated from their current location to their target locations. It is assumed that the edge style is a polyline style and the control points are the bends accordingly. The animation works for other styles too, but the effect might not be as expected. The number of bends in endBends can be different to the current number of bends. This will result in the animation automatically removing bends at the end of the animation or inserting new bends accordingly at the beginning of the animation.
The source and target points are also animated to new locations. However, the ports will not be moved by this animation. Instead a separate animation for the ports is needed to actually move IPorts at the ends of the edge if desired.
Creates a new IAnimation instance that animates the current graph to the layout given by the layoutGraph instance of the given adapter.
The returned instance is suitable for animating the transition of an IGraph to a layout computed by one of the layout algorithms.
This method is not available unless the module view-layout-bridge is loaded. Either load the module 'view-layout-bridge' explicitly or ensure that the LayoutExecutor type is available at runtime.
A new IAnimation instance that animates the current graph to the layout of the given layoutGraph.
Examples
While it is usually recommended to use LayoutExecutor to handle layout calculation and subsequent animation, the IAnimation produced by this method can be used manually, as well:Using manually created layout animations
const adapter = new LayoutGraphAdapter(graph)const layoutGraph = adapter.layoutGraphconst layout = new OrthogonalLayout()layout.applyLayout(layoutGraph)const layoutAnimation = IAnimation.createLayoutAnimation( graph, adapter, TimeSpan.fromSeconds(1),)
Creates a new IAnimation for the given table that animates the table and its stripes.
Note that only the sizes of leaf stripes, i.e. those without child stripes, are considered. The size of a stripe with children is implicitly determined by its contents.