Animations

Package	Plugins Main
Category	Effects
First Release: 0.5.2

The Animations plugin provides visual effects for window actions. You can use it to assign different effects to windows for Create, Close, Minimize (and Unminimize), Shade and Focus events. You can also adjust the settings for each effect.

Animation uses Window Matching to display different animations for different windows. (Please see the page on Window Matching for a usage guide.)

Contents

Effects

Effects

Main Effects

The descriptions below are of the effects when set for the window Close event. Unless otherwise noted, the animations are reversed (ie. played backwards) when used for the Create event. Also, if set for the Minimize event, some of them can be set to move to/from the taskbar while animating. The options for each effect are listed in a table under each heading.

Airplane

The window is folded into an airplane before it flies away into the distance.
Airplane Flying Path Length	The distance the airplane flies before disappearing.
Fly to TaskBar on Minimize	Whether or not the window flies to its button in the Window List or Dock when minimizing.

Beam Up

Beams away the window in a manner reminiscent of Star Trek.
Beam Width	The width of the light beams, proportional to the width of the window.
Beam Spacing	The spacing between the beams.
Beam Color	Opens a standard colour selection dialog.
Beam Slowdown	The amount of slowdown on the beam effect.
Beam Life	The lifespan of the beams.

Burn

Burns the window away with fire. (It is listed as Fire in the Effect Settings section.)
Number Of Fire Particles	How many fire particles are rendered.
Fire Particle Size	The size of the fire particles.
Fire Particle Slowdown	The amount of slowdown for the fire effect.
Fire Particle Life	The lifespan of the fire particles.
Fire Particle Color	Opens a standard colour selection dialog.
Fire direction	Automatic causes the fire to burn towards the end closest to the mouse cursor.
Fire constant speed	Make the burning speed the same on all windows, instead of proportional to their size.
Fire Smoke	Add smoke to the fire.
Randomly Colored Fire	Particles are randomly coloured (individually, not all of them the same colour).

Curved Fold

The window is bent into a curve, as opposed to a crease, until it disappears.This is also available as a Shade animation.
Curved Fold Amplitude	The amplitude of the curve.
Zoom to TaskBar on Minimize	Whether or not the window zooms to its button in the Window List or Dock when minimizing.

Domino

The window is broken gradually into rows of 3D blocks which topple into a position perpendicular to the viewer, before fading away.
Domino Piece Falling Direction	Automatic causes the rows to topple in the direction of the mouse cursor (if the window is closing) or away from the mouse cursor (if the window is opening).

Dream

The window becomes wavy and fades away.
Zoom to TaskBar on Minimize	Whether or not the window zooms to its button in the Window List or Dock when minimizing.

Explode

The window explodes towards the viewer in a mass of 3D blocks; the number of blocks is determined by the dimensions of the Window Grid set in the options.
Window Grid Width	The number of columns in the grid.
Window Grid Height	The number of rows in the grid.
Thickness of Exploding Polygons	The thickness, in pixels, of the 3D blocks.
Tessellation Type	The shape of the blocks. The default is Rectangular, although there is a Hexagonal option which is not yet implemented.

Fade

A very simple effect. The window fades out of view. There are no options for this effect.

Fold

The window folds inward on itself like a sheet of paper, shrinking until it disappears. The number of folds is determined in the same way as for the Explode effect.
Window Grid Width	The number of columns in the grid.
Window Grid Height	The number of rows in the grid.
Fold Direction	In (away from the camera), or Out (towards the camera).

Glide 1

Similar to the open and close animations in Windows Vista. The window flies out towards the viewer until it goes past and disappears off the screen.
Away Position	The position of the window at the end of the animation, relative to the camera.
Away Angle	The angle at which the window is tilted at the end of the animation. During the animation, it will tilt until it reaches this angle.
Thickness	The thickness, in pixels, of the window, when viewed from an angle.
Zoom to TaskBar on Minimize	Whether or not the window zooms to its button in the Window List or Dock when minimizing.

Glide 2

Very similar to Glide 1, except the window flies inward (away from the viewer). It has the same options as Glide 1.

Horizontal Folds

Similar to Curved Fold in concept, except the window is creased horizontally (resembling a paper fan or a corrugated sheet), folding flatter until it disappears.This is also available as a Shade animation.
Horizontal Folds Amplitude	The amplitude (size) of the folds.
Number of Horizontal Folds	The number of folds. They will always be evenly spaced, so their size is directly proportional to the size of the window.
Zoom to TaskBar on Minimize	Whether or not the window zooms to its button in the Window List or Dock when minimizing.

Leaf Spread

Starting from the top-left corner, the window gradually disintegrates into 3D blocks that scatter outwards before fading from view. There are no options for this effect.

Magic Lamp

The window bends into a curved and flowing ribbon, with a "tail" which is sucked into a small point. The location of that point differs depending on the event; if the window is being closed, it will be the current position of the cursor. If the window is being minimized, it will be sucked into the window's taskbar button.
Magic Lamp Open/Close Moving End	Whether or not the "tail" moves to follow the mouse cursor during the animation, when used for Open/Close events.
Magic Lamp Grid Y Resolution	The smoothness of the curves. Higher values are more CPU-intensive.
Magic Lamp Max Waves	The maximum number of waves. The actual number of waves is random each time.
Magic Lamp Min Wave Amplitude	The minimum amplitude (size) of the waves.
Magic Lamp Max Wave Amplitude	The maximum amplitude (size) of the waves.
Magic Lamp Open Start Width	The width of the "tail".

Razr

The window peels off the screen in thin rows or columns of 3D blocks which topple and fold in on themselves. The rows/columns move at different rates, so the overall effect is of the window peeling in random strips.
Razr Fold Opening Direction	Automatic causes the blocks to topple in the direction of the mouse cursor.

Sidekick

The window rotates clockwise while shrinking into the distance. If the window is being minimized or unminimized, it will fly to or from the taskbar.
Sidekick Number of Rotations	How many 360° rotations the window makes before disappearing. This does not have to be a whole number.
Sidekick Springiness	How "bouncy" the animation is, ie. whether it moves a bit past its final position before retracting to that position.
Zoom from Center	If Off, the window always zooms from/to the position of the mouse cursor (if created/closed). If On, it will always zoom from the center of the window's final position. This can also be set to Minimize/Unminimize Only or Open/Close Only.

Skewer

The window is cut up into pieces which fly apart. The number of pieces is determined by the width and height of the grid which is used to divide the window. The size of the pieces is directly proportional to the size of the window.
Skewer Direction	The direction in which the pieces move.
Tessellation Type	The shape of the pieces. They can be Rectangular or Hexagonal.
Window Grid Width	The number of columns in the grid.
Window Grid Height	The number of rows in the grid.
Thickness of Animated Polygons	The 3D thickness of the pieces when viewed from an angle.
Rotation Angle	How many degrees the pieces should rotate before disappearing.

Vacuum

This is almost identical toMagic Lamp, except that it does not have customisable waves; whereas Magic Lamp has a fixed minimum of 3 waves, the number of waves in Vacuum is fixed at 1. It is specifically for the Create/Close events and is not available as a Minimize/Unminimized animation. As such, the "tail" of the window will always be at the position of the mouse cursor.
Vacuum Open/Close Moving End	Whether or not the "tail" moves to follow the mouse cursor during the animation.
Vacuum Grid Y Resolution	The smoothness of the curves.
Vacuum Open Start Width	How wide the "tail" is, in pixels.

Zoom

A simple effect, similar to Sidekick but with no rotation. The window shrinks into the distance, or zooms in from the distance (If used for Create or Unminimize events).
Zoom from Center	If Off, the window always zooms from/to the position of the mouse cursor (if created/closed). If On, it will always zoom from the center of the window's final position. This can also be set to Minimize/Unminimize Only or Open/Close Only.
Zoom Springiness	How "bouncy" the animation is, ie. whether it moves a bit past its final position before retracting to that position.

Shade Effects

These effects are for the Shade event, that is, when a window is shaded (that is, shrunken with only the titlebar remaining). The Curved Fold and Horizontal Folds animations from the previous section are also available as Shade animations.

Roll Up

The contents of the window roll up like a curtain, complete with exponential speed (so that it starts slowly, picks up velocity mid-animation, then slows down again at the end).

Rollup Fixed Interior

The contents of the window do not move during the animation. The window simply resizes upward with the "roll up" motion.

Focus Effects

These effects are for the Focus event. When switching focus to another window, this effect is applied to the newly focused window.

Dodge

If part of the newly focused window is underneath other windows, any of those windows "dodge" out of the way as the focused window moves to the forefront.

Dodge Gap Ratio

The time gap between the dodging windows' movements. If set to 0, they all start moving simultaneously; otherwise, this option controls the brief gap between one window starting to dodge and the next window starting to dodge.

Fade

If the newly focused window overlaps with the previous window, the opacity of the new window briefly dims and undims with a smooth fading effect. There are no options for this effect.

Wave

A wave runs through the newly focused window.

Wave Width	The width of the wave, proportional to the window height. Tall windows will have larger waves, so that the wave finishes passing through the window in the same amount of time on differently-sized windows.
Wave Amplitude	The amplitude (size) of the wave, proportional to the window height.

Plugins/Animation (last edited 2008-06-03 01:04:39 by c9345531)