You can set the following authoring parameters for each 3DImageChanger component instance in the Component inspector or the Property inspector:

Change Effect: Sets the type of 3D rotation effect that is used for changing an image. This parameter can be one of five predefined values: "prismatic quadrangular", "prismatic triangular", "cylindrical convex", "cylindrical concave", or "plane rectangular"; the default value is "prismatic quadrangular". For more information, see 3D effects creation system.

Delay (seconds): A number that indicates (in seconds) how long each image "holds" before automatically displaying the next image in que. This parameter accepts any positive number or 0 (including fractional values) and is enabled at Display Mode parameter set to "auto-forward" or "auto-backward". If Delay is equal to 0, the images are displayed continuously. The default value is 3.

Display Mode: This controls the automatic playback of your "Images Collection" when first loaded by a user. By default, it is set to "manual," which means 3DImageChanger will display the first image, but will not set the Delay timer (see above). It will simply stop and await user input. Changing this to "auto-forward" or "auto-backward" will instruct 3DImageChanger to automatically display the next image in que after the Delay timer has expired.

Granularity (pixels): Defines the degree of detail and the rendering quality while rotating an image. In numerical expression, it is the height or the width (depending on whether the Rotation Plane parameter is set to "vertical" or "horizontal") of segments into which the image is split when rotating.

The smaller the segments, the more the image is smoothed and anti-aliased, and vice versa. At the same time, reducing the value of Granularity, you slow down the speed of rotation by increasing the time of rendering. This parameter can be an integer between 1 and 100 pixels. The default value is 10.

Images Collection: An object type parameter that contains two values to be set: imageLinkage and imageType. It allows adding, modifying, moving, and deleting the "Images Collection" items in the Values dialog box while authoring. The "Images Collection" is the array of images you can manipulate within 3DImageChanger.

To define a collection item click the Add (+) button. To add, modify, move and delete collection items click the Add (+), Delete (-), and arrow buttons.

The image type must correspond to the image linkage value. Otherwise, the image will not be loaded to 3DImageChanger.

Keyboard Control: Determines whether 3DImageChanger uses default keyboard handling to navigate through the images in collection when the component instance has focus (see Navigation system for more information). This parameter can be either "true" or "false". The default value is "false".

Lock Mode: Turns on/off the component's ability to "store" user interactions ("true" or "false"). That means 3DImageChanger can react differently to navigation commands (such as "gotoNextImage", etc.) while changing (rotating) images:

The default value is "false".

Preloader Alpha: The transparency percentage for the preloader animation. The parameter accepts any number at or between 0 and 100. The default value is 100.

Preloader Color: The color of the preloader animation. This parameter accepts hex values. The default value is "#FFFFFF".

Preloader Location: Specifies the location of the preloader in relation to the static image borders. This parameter can be one of five predefined values: "center", "top-left", "top-right", "bottom-left", or "bottom-right"; the default value is "center".

Preloader Mode: Indicates whether the preloader is visible or hidden when loading images. This parameter can be one of two predefined values: "always visible" or "always hidden". The default value is "always visible".

Preloader Type: Specifies the preloader appearance. This parameter can be one of four predefined values: (a) "spiral", (b) "progress bar", (c) "progress circle", (d) "text string". The default value is "progress circle".

   a)            b)            c)            d)

Repeat Mode: This parameter instructs 3DImageChanger how to behave when reaching the final image in the "Images Collection". There are two values available:

The default value is "true".

Rotation Angle: This parameter specifies the degree of rotation of images while their 3-dimensional rotation. The smaller the angle, the more the rotation is smooth, and vice versa. At the same time, reducing the value of Rotation Angle, you slow down the speed of rotation by increasing the time of rendering.

You can select any number from the list of predefined values for this parameter; but the real value of rotation angle will be the one from the table below that is the closest to the selected number for correspondent Change Effect.

The default value for Rotation Angle is 10.

Rotation Direction: The conditional parameter that specifies the direction of rotation while changing images. There are two values available:

This is valid for Display Mode parameter set to "auto-forward" or "manual" when moving forward through the "Images Collection" (to every next image). If Display Mode parameter is set to "auto-backward", the directions of rotation are opposite of listed above. Also, if moving backward through the "Images Collection" (to every previous image), the directions of rotation are opposite of listed above.

The default value is "CWW".

Rotation Plane: Defines the plane of rotation while changing images. This parameter can be either "horizontal" or "vertical". The default value is "vertical".

Scale Content: Indicates whether the content scales to fit the changer ("fit changer"), or the changer scales to fit the content ("fit image"). The default value is "fit image".

Keep in mind that setting Scale Content to "fit image" causes the changer scales to fit the first displayed image. This is either the first image from the "Images Collection" (Display Mode set to "auto-forward" or "manual"), or the last image from the "Images Collection" (Display Mode set to "auto-backward"). This matters if the first and the last images in the collection have different size.

Visual Effect: This applies an additional visual effect to the component. You can select from four predefined values: "none", "blur", "grayscale", "brightness". The default value is "none" (no visual effect applied to a 3DImageChanger instance).

The visual effect has 3 phases:

• Fade-in     Increasing — precedes a 3D rotation effect
• Static      Constant, maximum — continues while images rotating
• Fade-out   Falling — follows a 3D rotation effect

Visual Effect Quality: Determines the depth or intensity of the visual effect. This parameter can be one of three predefined values: "low", "medium", "high"; the default value is "medium".

Visual Effect Speed: Determines the speed of increasing and falling of the visual effect. In other words, this parameter specifies the duration of "Fade-in" and "Fade-out" phases of the visual effect. You can select from five predefined values: "minimum", "low", "medium", "high", "maximum"; the default value is "medium".

XML enable: This parameter defines the method that is used for adding graphic objects to internal "Images Collection". There are two options available:

If you choose one method, the other is ignored by the component, and vice versa.

The default value is "false".

XML file Path: The name of configuration XML file. The default value is "images.xml" (in this case, the XML file must be saved in the same directory as the SWF file that contains a 3DImageChanger component).

XML is the glue between 3DImageChanger and your images. This is the basic template of your configuration XML file:

<?xml version="1.0" encoding="UTF-8"?>
<collection path="pictures/" width="300" height="150">
<img src="image1.jpg"/>
<img src="image2.jpg"/>
<img src="image3.jpg"/>
.......................................
</collection>

The XML document can contain an unlimited number of img nodes. Each img node represents an image object and should have one required attribute:

You can also add your own attributes in the img node that can be then easily accessible through the component's xml property. For every additional image you wish to add to the "Images Collection", create another img node and fill it with the file name.

The collection element has the following three optional attributes:

You must specify both width and height attributes for the settings to take effect. Using these attributes disables Scale Content effect.

You can transform a 3DImageChanger component horizontally and vertically while authoring and at runtime. While authoring, select the component on the Stage and use the Free Transform tool or any of the Modify > Transform commands. At runtime, use the setSize() method. The sizing behavior of the 3DImageChanger component is controlled by the scaleContent property. When scaleContent is "fit changer", the content is scaled to fit within the bounds of the changer (and is rescaled when setSize() is called). The "base dimensions" of the component, in this case, are determined by its size on the Stage while authoring. When scaleContent is "fit image", the size of the component is fixed to the size of the content and setSize() has no effect. The "base dimensions", in this case, are determined by the size of the first displayed image.

If you specify the width and height attributes in configuration XML file, the "base dimensions" are set to the values of these attributes, and not depend on scaleContent value.

The images in collection can be different in size. However, when displaying in 3DimageChanger, they are scaled larger or smaller, if needed, to fit the "base dimensions".

The hit area of a 3DImageChanger component is designated by its "base dimensions".