XML Flash Slideshow v4 Help    |    Support Home    |    DWUser.com Home  Download Help PDF (29MB)    |    Search:

Advanced Properties - Ken Burns Effects

The Ken Burns Effects tab of the Gallery Properties dialog appears as follows:

This is where you can specify a default Ken Burns effect for all images in the gallery.    Ken Burns effects (KB effects) are packages which incorporate both panning and zooming.  You can learn more about KB effects in the topic on using the KB Effect Editor (there is a link to this topic below).  If you specify an effect in this panel, it will be used by each image in the gallery unless you override it on an individual image with an image-specific effect.    

To be able to select an effect, you must first create (define) effects using the KB Effect Editor.  This dialog is accessed by clicking the 'Edit KB Effects...' button:

This will launch the KB Effect Editor.  To learn about how to use this window to define effects, see Using The Ken Burns Effect (Panning / Zooming) Editor.    After creating an effect and returning to the Gallery Properties dialog, you'll be able to select the effect you just created from the dropdown list:

After defining multiple KB effects, you can also choose the (Random Effect) option from the dropdown (this option is not shown in the above screenshot).  When this option is selected, an effect will randomly be selected from among all defined effects each time an effect is needed.  Or, you can also choose the (Cycle All Effects) option from the dropdown (this option is not shown in the above screenshot).  When this option is selected, all created effects will be cycled through as KB effects are displayed.

In the Pro version, the Enable Mouse Control for Ken Burns Effects setting allows for a user to take control of the panning, and explore the image by moving his or her mouse around.  When enabled and a user hovers over a photo, the photo will magnify to either the start or end magnification for the associated KB effect (whichever is greater).  Then, the mouse's position will determine the position of the photo within the visible area.  If you enable this setting, it will be applied to each image in the gallery unless you override it on an individual image.  You can learn more about using this setting for panorama viewing in this topic.

Removing Image-Specific Effect Overrides

The 'Remove All Image-Specific KB Effect Overrides' button allows you to remove any KB effects which have been set on a per-image basis.  This ensures that the gallery-wide default established above is always used for all images in the gallery.

XML Equivalents (for Advanced Users and Developers)

The settings above map to the following XML attributes on each <gallery ... > ... </gallery> node:

Property Equivalent Gallery Attribute Notes
Default Ken Burns Effect @kbEffect In the XML, you can specify multiple KB effect ID values; when doing this, separate each ID with a comma (no spaces).    One of these multiple effects will be randomly chosen each time an effect is to be applied.   Specifying Random will cause a random effect to be selected from among all defined effects each time an effect is needed.  Specifying Cycle will cause all defined effects to be cycled through as effects are needed.
Enable Mouse Control for Ken Burns Effects @kbMouseControlEnabled A boolean true or false value.

Note that the '@' is part of customary syntactical representation, and is not part of each attribute name.

For more detailed XML information, see the Developer Reference.