Slideshow lets you quickly and easily animate image files, adding transition effects between each slide.

Effect Parameters

Presets
Presets contain a snapshot of the plug-in parameters. The Presets control lets you choose among one of the presets built into the plug-in, save current parameter values to a preset file, or load an existing preset file from disk.
A preset file saved to disk via the "Save As" button can be loaded from another instance of the same plug-in by clicking the "Open" button. Presets generated in one host can also be loaded from the same plug-in when used in a different host.

Images

Image Files
This parameter lets you choose the image files that will be animated by the plug-in. When you first apply the generator, clicking the “Choose” button will bring up a file selection window. Once you have selected the files you want to animate, you will be able to make further adjustments through the following user interface:


The above window can be used to add or remove files from the slideshow. You can also perform the following actions:

  • Reorder images by dragging them up or down the list to the desired location.
  • Double-click the “Title” column value to enter a new image title. By default, the title starts out as the file name (stripped of its extension).
  • Select a file and click the “Relink” button to link the image to a different file. This option is helpful in fixing missing media errors.
  • Select a file and click the “Reveal in Finder” button to navigate to the location of the file in a Finder window.

The “Placement” column lets you control the image fitting method for each image. On its “Default” setting, the plug-in will use the value of the “Default Placement” parameter, which is set globally for the entire slideshow.

Default Placement
The default method used to position images inside the frame.
  • Fit: each image is scaled proportionally until it is entirely visible within the frame. If the image does not have the same aspect ratio as your project, some letterboxing will occur.
  • Fill: each image is scaled proportionally until the entire frame is covered. No regions of the frame are left empty, unless the image itself file has transparent regions.
  • Stretch: each image is scaled to the dimensions of the frame, irrespective of its aspect ratio.
  • Center: each image is drawn at its natural dimensions at the center of the frame.
The value of this parameter can be overridden on a per-image bases through the “Placement” option available when you click the “Choose” button in the the “Image Files” parameter.

Loop Through Images
Controls whether the slideshow will loop continuously through the images in the folder, or if it stops at the last image in the folder. For example, when looping through three images, the order will be: Image 1 > Image 2 > Image 3 > Image 1 > Image 2 > Image 3 > Image 1 etc.

Slide Duration
The duration (in seconds) that each image will remain on screen.

Transition

Transition Duration
The duration (in seconds) of the transition from one image to the next. To disable transitions betwen each slide, set the Transition Duration to zero.

Animation Curve
This parameter controls the interpolation function used to drive the animation. The animation curve determines how fast (or slow) the animation will progress from its beginning to its end. The basic option, "Linear" translates to a uniform progression from the beginning to the end. All other options cover a wide range of common animation styles.


Linear

Quadratic In

Quadratic Out

Quadratic In-Out

Cubic In

Cubic Out

Cubic In-Out

Exponential In

Exponential Out

Exponential In-Out

Sinusoidal In

Sinusoidal Out

Sinusoidal In-Out


Animation Type
Lets you pick one of the built-in transition effects:
  • Dissolve: a simple cross-dissolve
  • Overexpose: the current image is gradually overexposed to reveal the next image.
  • Blur: the current image is gradually blurred and overexposed to reveal the next image.
  • Cube: the current image is placed on one of the faces of a 3D cube, which rotates to reveal the next image on a different face.
  • Origami (Square): the next image in the slideshow is revealed by unfolding one its corners over the current image.
  • Origami (Triangle): the next image in the slideshow is revealed by unfolding one its sides over the current image.
  • Accordion: the next image in the slideshow is revealed by unfolding it over the current image.
  • Page Flip: the next image in the slideshow is revealed through an animation that simulates a page turn.

Peak Exposure
When the current Animation Type is Overexpose, this parameter lets you choose an exposure shift reached during the transition.

Blur Type
Lets you control the type of blur applied when the Animation Type parameter is set to Blur.

Blur Radius
Lets you control the blur radius, relative to the size of the frame. This parameter is only available when the Animation Type parameter is set to Blur.

Blur Angle
Lets you control the angle of the directional blur. This parameter is only available when the Animation Type parameter is set to Blur, and the Blur Type parameter is set to Directional.

Blur Exposure
Lets lets you choose an exposure shift reached during the transition. This parameter is only available when the Animation Type parameter is set to Blur.

Cube Direction
The direction of the spinning 3D cube. This parameter is only available when the Animation Type parameter is set to Cube.

Corner / Side / Direction / Flip Selection
These parameters allow you to customize the origin of the current transition. Each parameter is available when the current transition is “Origami (Square)”, “Origami (Triangle)”, “Accordion” or “Page Turn”, respectively. The available options are:
  • Single selection: the origin of the transition effect is fixed, and equal for all images in the slideshow. An additional parameter will let you picked a fixed Corner / Side / Direction / Flip direction.
  • Randomize: the origin of the transition effect is randomized, among all the options available. An additional parameter named “Random Seed” will let you vary the current animation.
  • Cycle through: the origin of the transition effect will change with each image, going through all the available options sequentially.

Folds
This parameter is only available when the current transition effect is “Accordion”. It determines the number of folds simulated by the effect.

Curl
This parameter is only available when the current transition effect is “Page Turn”. It determines the curve formed by each page as it turns to reveal the next image in the slideshow.

Titles

Show Titles
Enable this parameter to display the name of the file as part of the slideshow animation.

Text Position / Alignment / Color
The position, alignment and color of the file name text.

Font Name / Size / Kerning
The name, size and kerning shift of the font used to display the file name.

Drop Shadow

Drop Shadow
Enable this parameter to add a drop shadow to the file name text.

Shadow Radius / Color
The radius and color applied to the shadow.

Shadow Offset X / Y
The offset (measured in pixels) of the drop shadow with respect to the file name text.

Motion Blur

Quality

Enables motion blur at different quality settings. The higher the quality, the more samples are used to render the final scene.

  • Off - the scene is rendered without motion blur.
  • Low - render a few samples per frame.
  • Medium
  • High - render with the highest number of samples (slowest setting, highest quality)

Motion Blur Diagram
Figure: motion blur with four samples per frame, a shutter angle
of 180 degrees and a shutter offset of 0.

Shutter Angle

When motion blur is enabled, this parameter controls the size of the shutter used to simulate motion blur. The size of the shutter determines how frequently light is allowed to pass through the lens. A shutter angle of 360 degrees means that samples are collected for the entire duration of one frame. Setting a shutter value of zero means that you want to collect light only once, which is equivalent to turning motion blur off.

Shutter Offset

When motion blur is enabled, this parameter determines the time when the shutter will open and close, relative to the current frame time.
An offset of zero means the shutter is open an equal amount of time before and after the current frame time.