DirectTransition3D Xtra™ Set I  Version 2.0.1 Documentation

Developed by Omri Kalinsky and Tomer Berda, DirectXtras Inc.
(C) Copyright 1998-2010.
Last updated: December 12th, 2003.

DirectTransition3D Xtra is a collection of high quality, hardware accelerated, platform independent transitions for Macromedia Director, Authorware and Shockwave.

DirectTransition3D Xtra Set I features the following customizable transitions:

• Accordion: Simulates the before image folding or unfolding to reveal the after image.
• Bubbles: Simulates the before image bubbling and popping to reveal the after image.
• Curtain: Simulates a curtain opening or closing to reveal the after image.
• Flipboards: Simulates boards with the before image on the front and the after image on the back flipping.
• Flush: Simulates the before image flushing to reveal the after image.
• Fractal Fade: Simulates the before image randomly and unevenly fading into the after image.
• Fractal Morph I: Simulates the before image randomly morphing into the after image with an unclearly defined center.
• Fractal Morph II: Simulates the before image randomly morphing into the after image with a clearly defined center.
• Fracture: Simulates the before image exploding into spinning fractures to reveal the after image.
• Headline: Simulates a movie style spinning newspaper headline moving towards the viewer with the after image projected on it.
• Layers: Simulates the after image zooming in layers.
• Page Turn: Simulates the before image turning to reveal the after image.
• Peel: Simulates the before image peeling or unpeeling to reveal the after image.
• X Door: Simulates the before image opening or closing in an X shaped door to reveal the after image.

Virtually unlimited variations can be created from each transition. Many transitions feature real time random generation so that the same transition will never look exactly the same twice.

The Xtra is Shockwave safe, so it can also be used with Shockwave 7 and above and when Director safety features are turned on.

An auto downloadable Shockwave safe package of the Xtra is also available. It is a compressed, small sized (about 150K) version of the Xtra that can be downloaded automatically from a web site to the user's local machine whenever needed, and once installed provides Shockwave applications on the web with the transitions that the Xtra provides.

The Xtra supports 8 bit color and higher.

The Xtra is available for Director 5 and above, Authorware 4 and above, and is compatible with Windows 9X and newer (including 2000, ME, NT, XP) as well as MacOS 8, 9 and X.

DirectTransition3D Xtra Set I requires an implementation of OpenGL 1.1 or higher to be installed on the host computer.

Installation

Registration

OpenGL Installation

OpenGL Info

Variations And Properties

Performance Tuning

Transition Properites

Troubleshooting

Known Issues

History

Installation

DirectTransition3D Xtra Set I has an authoring version, a run time version and an auto downloadable Shockwave safe package. The trial version only includes the authoring version.

The authoring version is used by the Director and/or Authorware authoring environment while developing your movie/presentation. It should be placed in your Director and/or Authorware "Xtras" folder.

The run time version is used when running your movie/presentation as a stand-alone application. It should be placed in a folder named "Xtras" that is inside the folder that contains the host projector/package. Alternatively, the run time version can be bundled in projectors/packages (in a similar way you bundle other Director\Authorware files).

When creating Director projectors please note that if the Xtra is listed in the Modify->Movie->Xtras dialog  then the "Include in Projector" checkbox must be unchecked otherwise Director will bundle the Authoring version of the Xtra in the projector, which will not work outside the authoring environment. Instead, add the run time version of the Xtra in the "Create Projector" dialog or include it in the projector "Xtras" folder.

The run time version is also used with the Authorware web player and can be bundled in the web package. When creating web packages in Authorware, please note that by default, Authorware will attempt to bundle the authoring version of the Xtra. You'd have to modify the application "Publish Settings" in order to instruct Authorware to bundle the run time version instead of the authoring version.

The auto downloadable Shockwave safe package is used by Shockwave for Director. The package should be uploaded to your server from which it will automatically get downloaded and installed by your Shockwave movie, if needed.

The auto downloadable Shockwave safe package consists of the following files:

"DirectTransition3DSetI.w32" - Shockwave safe package for Windows
"DirectTransition3DSetI.ppc" - Shockwave safe package for MacOS 8.x and 9.x
"DirectTransition3DSetI.carb" - Shockwave safe package for MacOS X

Please note that Director requires that all the above files are uploaded to your server even if you're only using the Xtra on one platform.

Once you have decided the location on your server where the auto downloadable packages will be placed, you should modify the "xtrainfo.txt" file in the Director 7 or above folder accordingly. For example, if you upload the downloadable package to "http://www.myserver.com/packs" you should add the following line to "xtrainfo.txt".

[#namePPC:"DirectTransition3DSetI", #nameW32:"DirectTransition3DSetI.x32", #package:"http://www.myserver.com/packs/DirectTransition3DSetI"]

Note that the above entry should consist of a single line in the "xtrainfo.txt" file.

Finally, add a reference to the auto downloadable package in your movie. Open a movie that uses the DirectTransition3D Xtra Set I. From the Modify->Movie->Xtras dialog in Director, select the "DirectTransition3DSetI" Xtra in the list of Xtras. The "Download if Needed" check box should now be enabled. (If it's not enabled, make sure the filename in "xtrainfo.txt" matches the actual filename of the Xtra). Click on the check box and Director will load information from the package file for each platform and add it to the current movie.

IMPORTANT: The authoring, run time and Shockwave versions can not coexist in the same "Xtras" folder, so be sure to place the appropriate version in the appropriate folder.

You can freely distribute the run time version and Shockwave safe package of DirectTransition3D Xtra Set I with any application developed by you, and you alone. You can not redistribute the authoring version. Please refer to the license agreement for further information.

Registration

The Xtra must be registered before it becomes fully functional. Without registering the Xtra, a trial warning will be displayed after the first time a DirectTransition3D Set I transition is played, saving to disk will be disabled and the Xtra may not be used in projectors/packages or Shockwave. Under authoring, the Xtra needs to be registered only once for each host authoring application that will use it. Under run time, the host projector/package must be created by a host authoring application that is registered with the Xtra in order to work. Under Shockwave, the Shockwave movie/package must be saved/created by a host authoring application that is registered with the Xtra in order to work. The Xtra is registered by entering the serial number given at the time of purchase. Note that valid serial numbers differ between the Windows and MacOS versions of the Xtra.

There are 2 ways of registering the Xtra.

The Xtra may be registered through the host authoring application's graphical user interface. In order to register this way under Director, create a DirectTransition3D Set I transition cast member, go to the cast member properties dialog, click "About...", enter the serial number given to you at the time of purchase and click "OK". In order to register this way under Authorware, associate a DirectTransition3D Set I transition with an icon, click "About..." in the "Transition" dialog, enter the serial number given to you at the time of purchase and click "OK".

Under Director, the Xtra may also be registered through the host scripting language when authoring. Every DirectTransition3D Set I transition cast member has a write only property named "serial_number". Setting this property of any DirectTransition3D Set I transition cast member to a valid serial number registers the Xtra for all instances. For example, if there exists a DirectTransition3D Set I transition cast member named "MyTransition" and the serial number given to you is 5, the line "set the serial_number of member "MyTransition" to 5" will register the Xtra. This would typically be done in the message window.

After registering, any DirectTransition3D Set I transition instances that will be created, loaded from or saved to disk will be registered. In order to register any DirectTransition3D Set I transition instances that existed before registration, you will need to save your movie/presentation and reload it. The Xtra will remain registered under the host authoring application until it is uninstalled. Registering registers all DirectTransition3D Set I transitions. Also note that any transitions created through the host scripting language under the run time or Shockwave environments will need to be registered using the host scripting language as described in the previous paragraph regardless if the Xtra has been registered with the host authoring application.

If you are creating a movie/presentation that is intended to run under both Windows and MacOS, you must save your movie/presentation on a host authoring application that is registered with the Xtra on Windows and on a host authoring application that is registered with the Xtra on MacOS. If you create any more instances of the Xtra on a specific platform you will have to resave your movie/presentation on the opposite platform. By doing this you register the Xtra instances in your movie for both Windows and MacOS. Saving a movie/presentation on a host authoring application registered with the Xtra will only register your movie's/presentation's DirectTransition3D Set I instances for the platform that it was saved, it does not change the registration status of the instances for the opposite platform. As a general rule of thumb, when creating movies/presentations intended to run under both Windows and MacOS you may author under any platform, when you are finished make sure to resave your movie on both platforms with host authoring applications registered with the Xtra.

OpenGL Installation

The OpenGL dynamically linked library must be present on the host computer in order for the transitions to load properly.

On Windows, OpenGL exists as a dynamically linked library (.dll) file. Windows 95B, Windows 98, Windows NT 4, Windows 2000, Windows ME and Windows XP include OpenGL as a standard operating system component. Windows 95A users may download OpenGL free of charge from ftp://ftp.microsoft.com/Softlib/MSLFILES/Opengl95.exe. This provides the generic Microsoft software renderer implementation. Hardware accelerated OpenGL drivers are usually provided by the vendor of the 3D hardware accelerator. Alternatively, the GLSetup utility may be used to install proper drivers. GLSetup is a user friendly utility which automatically detects the type of 3D hardware accelerator present and installs appropriate drivers. GLSetup supports most popular 3D hardware accelerators. GLSetup can be downloaded free of charge from http://www.glsetup.com/where.htm.

On MacOS, OpenGL exists as a system extension file. Apple OpenGL 1.0 is a complete OpenGL 1.1 implementation. All 1999 and later model Apple Macintosh computers include the OpenGL software renderer as a standard operating system component. Hardware accelerated OpenGL drivers may be provided by the vendor of the 3D hardware accelerator or Apple.

OpenGL Info

Every DirectTransition3D Set I transition has a read only scripting property named "opengl_info" which can be used to query the capabilities of the OpenGL implementation to be used when displaying the corresponding transition. It returns information in the form of a linear list.

The first element is a string indicating the OpenGL implementation vendor. The second element is a string indicating the OpenGL implementation renderer. The third element is a string indicating the OpenGL implementation version. The fourth element is a string with either the value "Hardware" indicating a hardware accelerated OpenGL implementation or "Software" indicating a purely software based OpenGL implementation. The fifth, sixth and seventh elements indicate the number of red, green and blue bits per pixel, respectively. The eighth element indicates the number of depth bits per pixel. The ninth, tenth and eleventh elements indicate the number of red, green and blue accumulation bits per pixel, respectively. The twelfth element indicates the number of stencil bits per pixel.

Note that different transitions may return slightly different values through "opengl_info", since certain transitions require capabilities that others do not and therefore chose the implementation that meets and most closely matches the minimum capabilities required for that particular transition, this is especially true in relation to depth buffer precision since certain transitions do not require a depth buffer while other that do attempt to find the most precise available depth buffer. Also note that using "opengl_info" you can determine whether an implementation is hardware accelerated or software based but you can not determine the actual performance of the implementation or whether a hardware implementation supports transform and lighting in hardware or not.

Variations And Properties

Each of the DirectTransition3D Set I transitions has customizable properties which affect the transition's appearance. These are represented as read and write properties and are editable through the transition options dialog or through the host scripting language. These properties are saved with it's corresponding transition cast member/icon. Under the host scripting language these properties can be read and written to as properties of the corresponding cast member/icon.

Single selection properties are represented as case insensitive strings under the host scripting language and as a radio button group under the transition options dialog.

Boolean on/off properties are represented as case insensitive strings under the host scripting language with either the value "True" or "False" and as a check box under the transition options dialog.

Integral number properties are represented as integers under the host scripting language and as sliders under the transition options dialog and will be automatically clamped if the value specified is out of range.

Non integer numbers are represented as floating point numbers under the host scripting language and as sliders under the transition options dialog and will be automatically clamped if the value specified is out of range.

Sub properties are represented under the host scripting language by being followed by "_of_" parent property (for example the "dither" property of the "performance_properties" property would be accessed as the "dither_of_performance_properties" scripting property) and represented as a push button that opens up a sub dialog under the transition options dialog. Note that the scripting property naming access scheme also applies to color properties and range properties.

Non integer number ranges are represented as "minimum" and "maximum" sub properties in the host scripting language and as a pair of sliders under the transition options dialog and will be automatically clamped if the value specified is out of range and will automatically adjust the opposite slider or sub property if the range becomes negative.

Color properties are represented as "red", "green" and "blue" non integer number sub properties ranging from 0.0 to 1.0  in the host scripting language and will be automatically clamped if the value specified is out of range and as a push button which opens up a color picker dialog under the transition options dialog. Color properties may also be set to a string representing a preset color, the accepted values are "red", "green", "blue", "black", "grey", "gray", "white", "yellow", "orange", "purple" and "brown".

In general, all scripting property names are the names of the corresponding transition options dialog control except that they use underscores in place of spaces (for example use "longitude_detail" under the host scripting language for the "Longitude Detail" property). In general, all scripting string values of single selection properties are the exact names of the corresponding radio buttons in the transition options dialog.

Performance Tuning

DirectTransition3D Xtra Set I uses OpenGL to provide high quality, high performance graphics. OpenGL provides a built in software renderer on computers not equipped with 3D hardware accelerators supporting OpenGL. On computers equipped with 3D hardware accelerators supporting OpenGL, the hardware accelerator will automatically be detected and the hardware renderer will be used for improved performance. In general, default transition properties are designed for an optimum balance of performance and visual quality on mid range or older hardware accelerated OpenGL implementations.

All DirectTransition3D Set I transitions have write only properties "performance" and "quality" which allow you to control all properties of a transition that affect the performance/visual quality tradeoff in one step. These can be set to the values "low", "medium" or "high". The two properties are opposites of each other so setting "performance" to "low" is equivalent to setting "quality" to "high". Generally these affect the performance properties and all detail properties of transitions but do not affect properties that would greatly alter the transition variation (such as timing properties or properties affecting the count of on screen objects) and do not alter properties that have no effect on performance (such as direction properties). Setting the "performance" property to "high" or the "quality" property to "low" will increase frame rate and lower visual quality and is recommended for software OpenGL implementations. Setting either "performance" or "quality" properties to "medium" will set properties for a reasonable balance of visual quality and frame rate and is recommended for midrange or older hardware accelerated OpenGL implementations. Setting the "performance" property to "low" or the "quality" property to "high" will lower frame rate in favor of high visual quality and is only recommended for modern hardware accelerated OpenGL implementations that support hardware transform and lighting.

The DirectTransition3D Set I sample Director movie includes a lingo function called "OptimizeTransitions" that automatically sets the performance/visual quality tradeoff of each transition in the movie based on the OpenGL implementation capabilities. You may use this function at the beginning of your movies to fine tune the performance/visual quality tradeoff at run time, based on the user's OpenGL implementation capabilities.

All DirectTransition3D Set I transitions have performance properties that affect performance and visual quality without affecting the transition variation, timing, direction, etc... There are 3 variations of performance properties: no distortion (for transitions that do not distort images but only transition through mixing of colors between the before and after images), 2D distortion (for transitions that distort the before and/or after images in 2 dimensional space) and 3D distortion (for transitions that distort the before and/or after images in 3 dimensional space). The documentation of each individual transition indicates which variation of performance properties it has. The performance properties are a sub property of every transition and can be accessed through the "Performance Properties" button in the property editor options dialog which will bring up a sub dialog or through the "performance_properties" property in the host scripting language. The following are the sub properties of the various variations of performance properties:

No Distortion, 2D Distortion and 3D Distortion Properties

• Dither
• Description: Controls whether colors rendered on the screen should be approximated by the closest color or by a dither pattern consisting of the closest colors.
• Scripting Property: "dither"
• Scripting Type: String
• Possible Values:
• "False": Colors rendered on the screen are approximated by the closest color. This is usually good for 24 and 32 bit color depths.
• "True": Colors rendered on the screen are approximated by a dither pattern consisting of the closest colors. This is usually only need for color depths lower than 24 bit and makes visual quality significantly better on 8 bit color.
• Default Value: "False"
• Performance Note: "False" usually yields higher frame rates.

2D Distortion and 3D Distortion Properties

• Texture Minification Filter
• Description: Controls whether images distorted onto an area smaller than the original area should be rendered using nearest neighbor or linear interpolation rasterization. Generally this is applied to image fragments that seem farther away from the user then they did when the transition began.
• Scripting Property: "texture_minification_filter"
• Scripting Type: String
• Possible Values:
• "Nearest Neighbor": The distorted image is rasterized by approximating the closest pixel on the original image. This yields a more pixelated, less smooth animation of moving objects.
• "Linear Interpolation": The distorted image is rasterized by combining the colors of the closest pixels on the original image. This yields a more fluid animation of moving objects.
• Default Value: "Linear Interpolation"
• High Performance And Low Quality Value: "Nearest Neighbor"
• Medium Performance And Medium Quality Value: "Linear Interpolation"
• Low Performance And High Quality Value: "Linear Interpolation"
• Performance Note: "Nearest Neighbor" generally yields higher frame rates. On software OpenGL implementations the change in frame rate is usually very dramatic. On hardware accelerated OpenGL implementations the change in frame rate is usually barely noticeable since most 3D hardware accelerators contain hardware to accelerate linear interpolation.
• Texture Magnification Filter
• Description: Controls whether images distorted onto an area larger than the original area should be rendered using nearest neighbor or linear interpolation rasterization. Generally this is applied to image fragments that seem closer to the user then they did when the transition began.
• Scripting Property: "texture_magnification_filter"
• Scripting Type: String
• Possible Values:
• "Nearest Neighbor": The distorted image is rasterized by approximating the closest pixel on the original image. This yields a more pixelated, boxy look to close objects.
• "Linear Interpolation": The distorted image is rasterized by combining the colors of the closest pixels on the original image. This yields a smooth, more natural look to close objects.
• Default Value: "Linear Interpolation"
• High Performance And Low Quality Value: "Nearest Neighbor"
• Medium Performance And Medium Quality Value: "Linear Interpolation"
• Low Performance And High Quality Value: "Linear Interpolation"
• Performance Note: "Nearest Neighbor" generally yields higher frame rates. On software OpenGL implementations the change in frame rate is usually very dramatic. On hardware accelerated OpenGL implementations the change in frame rate is usually barely noticeable since most 3D hardware accelerators contain hardware to accelerate linear interpolation.

3D Distortion Properties

• Perspective Correction Hint
• Description: Controls whether images not orthogonal to the viewer should be rendered by a mathematically accurate function, a mathematically inaccurate approximation function or the OpenGL implementation's default function of the 2 above choices. Certain OpenGL implementations may only have one function in which case this property has no effect.
• Scripting Property: "perspective_correction_hint"
• Scripting Type: String
• Possible Values:
• "Fastest": The image is rasterized by a mathematically inaccurate approximation function. This is usually a pretty decent approximation and will usually suffice.
• "Nicest": The image is rasterized by a mathematically accurate function. This is usually only needed on transitions with a very three dimensional look.
• "Don't Care": The image is rasterized using the OpenGL implementation's default function of the 2 above choices. This usually corresponds to fastest on software implementations and usually corresponds to nicest on hardware accelerated implementations.
• Default Value: "Don't Care"
• High Performance And Low Quality Value: "Fastest"
• Medium Performance And Medium Quality Value: "Don't Care"
• Low Performance And High Quality Value: "Nicest"
• Performance Note: "Fastest" usually yields higher frame rates. "Nicest" usually yields lower frame rates. If an OpenGL implementation has only one function this has no effect. On software OpenGL implementations the change in frame rate is usually very dramatic.

The following are tips to help you optimize performance and visual quality:

• Use update changing area only mode instead of update full stage/presentation mode to decrease the transition area and increase frame rates.
• Under update changing area only mode, smaller changing area dimensions yield higher frame rates.
• Under update full stage/presentation mode, smaller stage/presentation dimensions yield higher frame rates.
• 8 bit color depth generally yield low frame rates due to palette operations.
• With the exception of 8 bit color depth, the optimal color depth varies from one OpenGL implementation to the next.
• Certain transitions have numerical properties that affect detail, generally lower values yield higher frame rates.
• Certain transitions have numerical properties that affect amounts of on screen objects (for example, number of pieces under fracture), generally lower values yield higher frame rates.
• Performance properties affect the frame rates especially on software implementations of OpenGL.
• 3D hardware accelerated implementations of OpenGL usually yield significantly higher frame rates than software implementations of OpenGL.
• Faster processors and faster 3D hardware accelerators yield higher frame rates.
• Use "opengl_info" to detect hardware or software implementations and modify properties accordingly.
• Set "performance" to "high" or "quality" to "low" for software based OpenGL implementations.
• Set "performance" or "quality" to "medium" for hardware accelerated OpenGL implementations.
• Set "performance" to "low" or "quality" to "high" for modern hardware accelerated OpenGL implementations that support transform and lighting in hardware.

Transition Properties

Accordion Transition

Description: Simulates the before image folding or unfolding to reveal the after image.
Type Symbol: "DT3DSetI_Accordion"
Performance Properties Type: 3D Distortion
Properties:

• Direction
• Description: Controls whether the before image should open or the after image should close.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Open": The before image should open to reveal the after image.
• "Close": The after image should close covering the before image.
• Default Value: "Open"
• Stationary Side
• Description: Controls which side is the stationary side when folding or unfolding.
• Scripting Property: "stationary_side"
• Scripting Type: String
• Possible Values:
• "Left": The left will be the stationary side.
• "Top": The top will be the stationary side.
• "Right": The right will be the stationary side.
• "Bottom": The bottom will be the stationary side.
• Default Value: "Left"
• Fold Count
• Description: Controls the number of folds.
• Scripting Property: "fold_count"
• Scripting Type: Integer
• Minimum Value: 1
• Maximum Value: 100
• Default Value: 6
• Performance Note: Smaller values yield slightly higher frame rates.
• From Stationary Side Lighting Effect
• Description: Controls the amount of light from the stationary side.
• Scripting Property: "from_stationary_side_lighting_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.5
• To Stationary Side Lighting Effect
• Description: Controls the amount of light to the stationary side.
• Scripting Property: "to_stationary_side_lighting_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.25
• Perspective Effect
• Description: Controls the three dimensional effect, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "perspective_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.5
• Fold Direction
• Description: Controls whether the image folds towards or away from the user.
• Scripting Property: "fold_direction"
• Scripting Type: String
• Possible Values:
• "Away": The image folds away from the user.
• "Towards": The image folds towards the user.
• Default Value: "Away"

Bubbles Transition

Description: Simulates the before image bubbling and popping to reveal the after image.
Type Symbol: "DT3DSetI_Bubbles"
Performance Properties Type: 3D Distortion
Properties:

• Direction
• Description: Controls whether the bubbles pop (forward time) or unpop (backwards time).
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Pop": The bubbles pop (forward time).
• "Unpop": the bubbles unpop (backwards time).
• Default Value: "Pop"
• Order
• Description: Controls the relative shapes and sizes of bubbles. Smaller values yield more randomly shaped and sized bubbles. Larger values yield more ordered, evenly shaped and sized bubbles.
• Scripting Property: "order"
• Scripting Type: Floating Point Number
• Minimum Value: 1.0
• Maximum Value: 10.0
• Default Value: 5.0
• Perspective Effect
• Description: Controls the three dimensional effect, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "perspective_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.9
• Bubble Count
• Description: Controls the number of bubbles.
• Scripting Property: "bubble_count"
• Scripting Type: Integer
• Minimum Value: 1
• Maximum Value: 100
• Default Value: 20
• Performance Note: Smaller values yield slightly higher frame rates.
• Bubble Completion Time
• Description: Controls the time it takes for a bubble to complete forming and start popping.
• Scripting Property: "bubble_completion_time"
• Scripting Type: Floating Point Number Range
• Minimum Value: 0.1
• Maximum Value: 0.9
• Default Range Minimum Value: 0.25
• Default Range Maximum Value: 0.75
• Bubble Creation Time Variation
• Description: Controls the maximum time variation between when bubbles start forming.
• Scripting Property: "bubble_creation_time_variation"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 0.9
• Default Value: 0.5
• Bubble Destruction Time Variation
• Description: Controls the maximum time variation between when bubbles finish popping.
• Scripting Property: "bubble_destruction_time_variation"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 0.9
• Default Value: 0.5
• Bubble Height
• Description: Controls the depth of bubbles relative to their width and height. Smaller values yield a more flat look. Larger value yield a more three dimensional look.
• Scripting Property: "bubble_height"
• Scripting Type: Floating Point Number
• Minimum Value: 0.1
• Maximum Value: 1.0
• Default Value: 1.0
• Lighting Effect
• Description: Controls the intensity of lighting highlights, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "lighting_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.75
• Longitude Detail
• Description: Controls the detail of the polygon approximation in the longitude direction.
• Scripting Property: "longitude_detail"
• Scripting Type: Integer
• Minimum Value: 8
• Maximum Value: 128
• Default Value: 32
• High Performance And Low Quality Value: 16
• Medium Performance And Medium Quality Value: 32
• Low Performance And High Quality Value: 64
• Performance Note: Smaller values yield higher frame rates.
• Latitude Detail
• Description: Controls the detail of the polygon approximation in the latitude direction.
• Scripting Property: "latitude_detail"
• Scripting Type: Integer
• Minimum Value: 2
• Maximum Value: 32
• Default Value: 8
• High Performance And Low Quality Value: 2
• Medium Performance And Medium Quality Value: 8
• Low Performance And High Quality Value: 16
• Performance Note: Smaller values yield higher frame rates.

Curtain Transition

Description: Simulates a curtain opening or closing to reveal the after image.
Type Symbol: "DT3DSetI_Curtain"
Performance Properties Type: 2D Distortion
Properties:

• Action
• Description: Controls whether the before image should open or the after image should close.
• Scripting Property: "action"
• Scripting Type: String
• Possible Values:
• "Open": The before image should open to reveal the after image.
• "Close": The after image should close covering the before image.
• Default Value: "Open"
• Direction
• Description: Controls which side to open the curtain to.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Up": The curtain should open up.
• "Right": The curtain should open right.
• "Down": The curtain should open down (like a zipper).
• "Left": The curtain should open left.
• Default Value: "Up"
• Center Position
• Description: Controls the center position of the curtain.
• Scripting Property: "center_position"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (left when "direction" is "up", up when "direction" is "right", right when "direction" is "down" and down when "direction" is "left")
• Maximum Value: 1.0 (right when "direction" is "up", down when "direction" is "right", left when "direction" is "down" and up when "direction" is "left")
• Default Value: 0.0 (center)
• Curve Effect
• Description: Controls the amount of curviness of the curtain.
• Scripting Property: "curve_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.95
• Squeeze Effect
• Description: Controls the balance between squeezing the curtain and moving it.
• Scripting Property: "squeeze_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.75
• Detail
• Description: Controls the detail of the polygon approximation.
• Scripting Property: "detail"
• Scripting Type: Integer
• Minimum Value: 4
• Maximum Value: 4096
• Default Value: 512
• High Performance And Low Quality Value: 128
• Medium Performance And Medium Quality Value: 512
• Low Performance And High Quality Value: 2048
• Performance Note: Smaller values yield slightly higher frame rates.

Flipboards Transition

Description: Simulates boards with the before image on the front and the after image on the back flipping.
Type Symbol: "DT3DSetI_Flipboards"
Performance Properties Type: 3D Distortion
Properties:

• Spin Orientation
• Description: Controls the probabilities of whether the flipboards spin horizontally (about the y axis) or vertically (about the x axis).
• Scripting Property: "spin_orientation"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (all flipboards spin horizontally)
• Maximum Value: 1.0 (all flipboards spin vertically)
• Default Value: 0.0 (every flipboard has an equal chance of spinning horizontally or vertically)
• Horizontal Direction
• Description: Controls the probabilities of whether horizontally spinning flipboards will spin left or right.
• Scripting Property: "horizontal_direction"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (all horizontally spinning flipboards spin left)
• Maximum Value: 1.0 (all horizontally spining flipboards spin right)
• Default Value: 0.0 (every horizontally spinning flipboards has an equal chance of spinning left or right)
• Vertical Direction
• Description: Control the probabilities of whether vertically spinning flipboards will spin up or down.
• Scripting Property: "vertical_direction"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (all vertically spinning flipboards spin down)
• Maximum Value: 1.0 (all vertically spinning flipboards spin up)
• Default Value: 0.0 (every vertically spinning flipboard has an equal chance of spinning up or down)
• Disorder
• Description: Controls the amount of disorder in the size and shape of the flipboards.
• Scripting Property: "disorder"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.5
• Flipboard Count
• Description: Controls the number of flipboards.
• Scripting Property: "flipboard_count"
• Scripting Type: Integer
• Minimum Value: 1
• Maximum Value: 200
• Default Value: 20
• Performance Note: Smaller values yield slightly higher frame rates
• Background Color
• Description: Controls the background color.
• Scripting Property: "background_color"
• Scripting Type: Color
• Default Value: White
• Lighting Effect
• Description: Controls the intensity of lighting highlights, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "lighting_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.75
• Perspective Effect
• Description: Controls the three dimensional effect, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "perspective_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.9
• Start Flip Variation
• Description: Controls the variation in time between when different flipboards start flipping.
• Scripting Property: "start_flip_variation"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 0.9
• Default Value: 0.5
• End Flip Variation
• Description: Controls the variation in time between when different flipboards stop flipping.
• Scripting Property: "end_flip_variation"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 0.9
• Default Value: 0.5

Flush Transition

Description: Simulates the before image flushing to reveal the after image.
Type Symbol: "DT3DSetI_Flush"
Performance Properties Type: 2D Distortion
Properties:

• Direction
• Description: Controls whether the before image flushes or the after image unflushes.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Flush": The before image flushes.
• "Unflush": The after image unflushes.
• Default Value: "Flush"
• Longitude Detail
• Description: Controls the detail of the polygon approximation in the longitude direction.
• Scripting Property: "longitude_detail"
• Scripting Type: Integer
• Minimum Value: 8
• Maximum Value: 512
• Default Value: 64
• High Performance And Low Quality Value: 32
• Medium Performance And Medium Quality Value: 64
• Low Performance And High Quality Value: 128
• Performance Note: Smaller values yield higher frame rates.
• Latitude Detail
• Description: Controls the detail of the polygon approximation in the latitude direction.
• Scripting Property: "latitude_detail"
• Scripting Type: Integer
• Minimum Value: 4
• Maximum Value: 256
• Default Value: 32
• High Performance And Low Quality Value: 16
• Medium Performance And Medium Quality Value: 32
• Low Performance And High Quality Value: 64
• Performance Note: Smaller values yield higher frame rates.
• Radius
• Description: Controls the radius of the swirl.
• Scripting Property: "radius"
• Scripting Type: Floating Point Number
• Minimum Value: 1.5
• Maximum Value: 10.0
• Default Value: 2.0
• Inner Clockwise Revolutions
• Description: Controls the amount of spin on the inside of the swirl in clockwise revolutions per transition.
• Scripting Property: "inner_clockwise_revolutions"
• Scripting Type: Floating Point Number
• Minimum Value: -10.0
• Maximum Value: 10.0
• Default Value: 3.0
• Outer Clockwise Revolutions
• Description: Controls the amount of spin on the outside of the swirl in clockwise revolutions per transition.
• Scripting Property: "outer_clockwise_revolutions"
• Scripting Type: Floating Point Number
• Minimum Value: -10.0
• Maximum Value: 10.0
• Default Value: 2.0
• Flush Exponent
• Description: Controls the acceleration of flushing. Higher values will yield faster acceleration. Values above 1 will yield positive acceleration. A value of 1 will yield no acceleration. Values below 1 will yield negative acceleration.
• Scripting Property: "flush_exponent"
• Scripting Type: Floating Point Number
• Minimum Value: 0.1
• Maximum Value: 10.0
• Default Value: 2.0
• Inner Spiral Exponent
• Description: Controls the acceleration of spiraling on the inside of the swirl. Values above 1 will yield positive acceleration. A value of 1 will yield no acceleration. Values below 1 will yield negative acceleration.
• Scripting Type: Floating Point Number
• Minimum Value: 0.1
• Maximum Value: 10.0
• Default Value: 2.0
• Outer Spiral Exponent
• Description: Controls the acceleration of spiraling on the outside of the swirl. Values above 1 will yield positive acceleration. A value of 1 will yield no acceleration. Values below 1 will yield negative acceleration.
• Scripting Type: Floating Point Number
• Minimum Value: 0.1
• Maximum Value: 10.0
• Default Value: 4.0
• Distortion Correction Time
• Description: Controls the amount of time required to distort the before image from it's original state to a state from which the image can start flushing.
• Scripting Type: Floating Point Number
• Minimum Value: 0.05
• Maximum Value: 0.25
• Default Value: 0.1

Fractal Fade Transition

Description: Simulates the before image randomly and unevenly fading into the after image.
Type Symbol: "DT3DSetI_Fractal_Fade"
Performance Properties Type: No Distortion
Properties:

• Disordered Edges
• Description: Controls whether the left, top, right and bottom edges fade colors evenly or unevenly.
• Scripting Property: "disordered_edges"
• Scripting Type: String
• Possible Values:
• "False": The left, top, right and bottom edges fade colors evenly.
• "True": The left, top, right and bottom edges fade colors unevenly.
• Default Value: "True"
• Detail
• Description: Controls the detail of the polygon approximation.
• Scripting Property: "detail"
• Scripting Type: Integer
• Minimum Value: 1
• Maximum Value: 10
• Default Value: 6
• High Performance And Low Quality Value: 5
• Medium Performance And Medium Quality Value: 6
• Low Performance And High Quality Value: 8
• Performance Note: Smaller values yield significantly higher frame rates.
• Disorder
• Description: Controls how randomly and chaotically colors will fade.
• Scripting Property: "disorder"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 5.0
• Default Value: 0.5
• Bottom Left
• Description: Controls when the bottom left corner should start fading. Higher values fade this corner later relative to corners with lower values.
• Scripting Property: "bottom_left"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 10.0
• Default Value: 0.0
• Top Left
• Description: Controls when the top left corner should start fading. Higher values fade this corner later relative to corners with lower values.
• Scripting Property: "top_left"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 10.0
• Default Value: 0.0
• Top Right
• Description: Controls when the top right corner should start fading. Higher values fade this corner later relative to corners with lower values.
• Scripting Property: "top_right"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 10.0
• Default Value: 0.0
• Bottom Right
• Description: Controls when the bottom right corner should start fading. Higher values fade this corner later relative to corners with lower values.
• Scripting Property: "bottom_right"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 10.0
• Default Value: 0.0
• Maximum Value
• Description: Controls the maximum possible time value for an area to fade relative to the maximum of the values of the 4 corners.
• Scripting Property: "maximum_value"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value 10.0
• Default Value: 1.0

Fractal Morph I Transition

Description: Simulates the before image randomly morphing into the after image with an unclearly defined center.
Type Symbol: "DT3DSetI_Fractal_Morph_I"
Performance Properties Type: 2D Distortion
Properties:

• Disordered Edges
• Description: Controls whether the left, top, right and bottom edges fade or morph.
• Scripting Property: "disordered_edges"
• Scripting Type: String
• Possible Values:
• "False": The left, top, right and bottom edges fade.
• "True": The left, top, right and bottom edges morph.
• Disorder
• Description: Controls the intensity of the morph deformation.
• Scripting Property: "disorder"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.5
• Detail
• Description: Controls the detail of the polygon approximation.
• Scripting Property: "detail"
• Scripting Type: Integer
• Minimum Value: 1
• Maximum Value: 10
• Default Value: 5
• High Performance And Low Quality Value: 4
• Medium Performance And Medium Quality Value: 5
• Low Performance And High Quality Value: 6
• Performance Note: Smaller values yield significantly higher frame rates.

Fractal Morph II Transition

Description: Simulates the before image randomly morphing into the after image with a clearly defined center.
Type Symbol: "DT3DSetI_Fractal_Morph_II"
Performance Properties Type: 2D Distortion
Properties:

• Disorder
• Description: Controls the intensity of the morph deformation.
• Scripting Property: "disorder"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.5
• Detail
• Description: Controls the detail of the polygon approximation.
• Scripting Property: "detail"
• Scripting Type: Integer
• Minimum Value: 1
• Maximum Value: 10
• Default Value: 6
• High Performance And Low Quality Value: 5
• Medium Performance And Medium Quality Value: 6
• Low Performance And High Quality Value: 7
• Performance Note: Smaller values yield significantly higher frame rates.

Fracture Transition

Description: Simulates the before image exploding into spinning fractures to reveal the after image.
Type Symbol: "DT3DSetI_Fracture"
Performance Properties Type: 3D Distortion
Properties:

• Direction
• Description: Controls whether the before image should fracture or the after image should unfracture.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Fracture": The before image should fracture.
• "Unfracture": The after image should unfracture.
• Default Value: "Fracture"
• Evenly Sized Pieces
• Description: Controls whether pieces should be randomly sized or evenly sized.
• Scripting Property: "evenly_sized_pieces"
• Scripting Type: String
• Possible Values:
• "False": Pieces should be randomly sized.
• "True": Pieces should be evenly sized.
• Default Value: "True"
• Piece Count
• Description: Controls the number of pieces.
• Scripting Property: "piece_count"
• Scripting Type: Integer
• Minimum Value: 2
• Maximum Value: 1024
• Default Value: 128
• Performance Note: Smaller values yield slightly higher frame rates.
• Disorder
• Description: Controls the relative shapes and sizes of the pieces. Smaller values yield more evenly shaped and sized pieces. Larger values yield more randomly shaped and sized pieces.
• Scripting Property: "disorder"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.5
• Lighting Effect
• Description: Controls the intensity of lighting highlights, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "lighting_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.75
• X Force
• Description: Controls the range of force in the x axis. Values above 0.0 indicate right. Values below 0.0 indicate left. The Value 0.0 indicates no movement in the x axis.
• Scripting Property: "x_force"
• Scripting Type: Floating Point Number Range
• Minimum Value: -5.0
• Maximum Value: 5.0
• Default Range Minimum Value: -1.0
• Default Range Maximum Value: 1.0
• Y Force
• Description: Controls the range of force in the y axis. Values above 0.0 indicate up. The Value 0.0 indicates no movement in the y axis.
• Scripting Property: "y_force"
• Scripting Type: Floating Point Number Range
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Range Minimum Value: 0.0
• Default Range Maximum Value: 1.0
• Z Force
• Description: Controls the range of force in the z axis. Values above 0.0 indicate towards the user. Values below 0.0 indicate away from the user. The Value 0.0 indicates no movement in the z axis.
• Scripting Property: "z_force"
• Scripting Type: Floating Point Number Range
• Minimum Value: -5.0
• Maximum Value: 5.0
• Default Range Minimum Value: -5.0
• Default Range Maximum Value: 5.0
• Spin Force
• Direction: Controls the range of spin in degrees per transition.
• Scripting Property: "spin_force"
• Scripting Type: Floating Point Number Range
• Minimum Value: 0.0
• Maximum Value: 3600.0
• Default Range Minimum Value: 0.0
• Default Range Maximum Value: 720.0

Headline Transition

Description: Simulates a movie style spinning newspaper headline moving towards the viewer with the after image projected on it.
Type Symbol: "DT3DSetI_Headline"
Performance Properties Type: 2D Distortion
Properties:

• Direction
• Description: Controls whether the after image zooms in or the before image zooms out.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Zoom In": The after image zooms in.
• "Zoom Out": The before image zooms out.
• Default Value: "Zoom In"
• Clockwise Revolutions
• Description: Controls the amount of clockwise revolutions per transition.
• Scripting Property: "clockwise_revolutions"
• Scripting Type: Floating Point Number
• Minimum Value: -20.0
• Maximum Value: 20.0
• Default Value: 4.0
• End Rotation Speed
• Description: Controls the speed of rotation when the image is fully zoomed. Values below 1.0 indicate rotational deceleration. Values above 1.0 indicate rotational acceleration. The value 1.0 indicates no rotational acceleration.
• Scripting Property: "end_rotation_speed"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 2.0
• Default Value: 0.0
• End Zoom Speed
• Description: Controls the speed of zooming when the image is fully zoomed. Values below 1.0 indicate deceleration. Values above 1.0 indicate acceleration. The value 1.0 indicates no acceleration.
• Scripting Property: "end_zoom_speed"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 2.0
• Default Value: 0.0
• Off Screen Angle
• Description: Controls the angle off screen from which the spinning image appears (0.0 or 360.0 is up, 90.0 is right, 180.0 is down, 270.0 is left).
• Scripting Property: "off_screen_angle"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0 (up)
• Maximum Value: 360.0 (up)
• Default Value: 0.0 (up)
• Note: This property has no effect unless the Start Off Screen property is on.
• Off Screen Center Time
• Description: Controls the time at which the spinning image centers in the middle of the screen.
• Scripting Property: "off_screen_center_time"
• Scripting Type: Floating Point Number
• Minimum Value: 0.05 (just past the beginning)
• Maximum Value: 0.95 (just before the end)
• Default Value: 0.5 (right in the middle)
• Note: This property has no effect unless the Start Off Screen property is on.
• Off Screen Zoom
• Description: Controls the zoom of the spinning image when it first starts off screen.
• Scripting Property: "off_screen_zoom"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0 (infinitely small)
• Maximum Value: 1.0 (full size)
• Default Value: 0.5 (half size)
• Note: This property has no effect unless the Start Off Screen property is on.
• Start Off Screen
• Description: Controls whether the spinning image starts off screen (true) or in the center (false).
• Scripting Property: "start_off_screen"
• Scripting Type: String
• Possible Values:
• "False": The spinning image starts in the center.
• "True": The spinning image starts off screen.
• Default Value: "False"
• Note: The Off Screen Angle, Off Screen Center Time and Off Screen Zoom properties have no effect unless this property is on.

Layers Transition

Description: Simulates the after image zooming in layers.
Type Symbol: "DT3DSetI_Layers"
Performance Properties Type: 3D Distortion
Properties:

• Direction
• Description: Controls whether the after image should zoom in or the before image should zoom out.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Zoom In": The after image should zoom in.
• "Zoom Out": The before image should zoom out.
• Default Value: "Zoom In"
• Fade Time
• Description: Controls the amount of time to fade the before image to black.
• Scripting Property: "fade_time"
• Scripting Type: Floating Point Number
• Minimum Value: 0.1
• Maximum Value: 0.9
• Default Value: 0.2
• Layer Count
• Description: Controls the number of layers.
• Scripting Property: "layer_count"
• Scripting Type: Integer
• Minimum Value: 2
• Maximum Value: 32
• Default Value: 8
• Performance Note: Smaller values yield slightly higher frame rates.
• Spacing
• Description: Controls the spacing between layers.
• Scripting Property: "spacing"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 0.9
• Default Value: 0.1
• Fog Start
• Description: Controls the distance of the start of the fog effect from the user.
• Scripting Property: "fog_start"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 0.9
• Default Value: 0.5
• Zoom Distance
• Description: Controls the distance each layer must zoom to reach it's destination. Smaller values yield a more three dimensional look. Larger values yield a more flat look.
• Scripting Property: "zoom_distance"
• Scripting Type: Floating Point Number
• Minimum Value: 0.1
• Maximum Value: 10.0
• Default Value: 4.0

Page Turn Transition

Description: Simulates the before image turning to reveal the after image.
Type Symbol: "DT3DSetI_Page_Turn"
Performance Properties Type: 3D Distortion
Properties:

• Direction
• Description: Controls the direction to which the page turns.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Left": The page turns left.
• "Up": The page turns up.
• "Right": The page turns right.
• "Down": The page turns down.
• Default Value: "Left"
• Lighting Effect
• Description: Controls the intensity of lighting highlights, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "lighting_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.75
• Perspective Effect
• Description: Controls the three dimensional effect, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "perspective_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.9
• Start Fold Angle
• Description: Controls the angle to fold to on the starting half of the transition in degrees.
• Scripting Property: "start_fold_angle"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 90.0
• Default Value: 90.0
• End Fold Angle
• Description: Controls the angle to fold to on the ending half of the transition in degrees.
• Scripting Property: "end_fold_angle"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 90.0
• Default Value: 90.0
• Detail
• Description: Controls the detail of the polygon approximation.
• Scripting Property: "detail"
• Scripting Type: Integer
• Minimum Value: 2
• Maximum Value: 256
• Default Value: 32
• High Performance And Low Quality Value: 16
• Medium Performance And Medium Quality Value: 32
• Low Performance And High Quality Value: 128
• Performance Note: Smaller values yield higher frame rates.

Peel Transition

Description: Simulates the before image peeling or unpeeling to reveal the after image.
Type Symbol: "DT3DSetI_Peel"
Performance Properties Type: 3D Distortion
Properties:

• Action
• Description: Controls whether the before image should peel or the after image should unpeel.
• Scripting Property: "action"
• Scripting Type: String
• Possible Values:
• "Peel": The before image should peel to reveal the after image.
• "Unpeel": The after image should unpeel covering the before image.
• Default Value: "Peel"
• Direction
• Description: Controls the direction from which to start peeling from or end unpeeling to.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Left": Start peeling from or end unpeeling to the left.
• "Top": Start peeling from or end unpeeling to the top.
• "Right": Start peeling from or end unpeeling to the right.
• "Bottom": Start peeling from or end unpeeling to the bottom.
• Default Value: "Left"
• Lighting Effect
• Description: Controls the intensity of lighting highlights, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "lighting_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.75
• Perspective Effect
• Description: Controls the three dimensional effect, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "perspective_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.9
• Diameter
• Description: Controls the diameter of the peel.
• Scripting Property: "diameter"
• Scripting Type: Floating Point Number
• Minimum Value: 0.1
• Maximum Value: 1.0
• Default Value: 0.25
• Detail
• Description: Controls the detail of the polygon approximation.
• Scripting Property: "detail"
• Scripting Type: Integer
• Minimum Value: 8
• Maximum Value: 256
• Default Value: 32
• High Performance And Low Quality Value: 16
• Medium Performance And Medium Quality Value: 32
• Low Performance And High Quality Value: 128
• Performance Note: Smaller values yield higher frame rates.

X Door Transition

Description: Simulates the before image opening or closing in an X shaped door to reveal the after image.
Type Symbol: "DT3DSetI_X_Door"
Performance Properties Type: 3D Distortion
Properties:

• Direction
• Description: Controls whether the before image should open or the after image should close.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Open": The before image should open to reveal the after image.
• "Close": The after image should close covering the before image.
• Default Value: "Open"
• Lighting Effect
• Description: Controls the intensity of lighting highlights, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "lighting_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.5
• Perspective Effect
• Description: Controls the three dimensional effect, higher values yield a more three dimensional look, lower values yield a flatter look.
• Scripting Property: "perspective_effect"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.9
• Horizontal Center
• Description: Controls the horizontal position of the X door center.
• Scripting Property: "horizontal_center"
• Scripting Type: Floating Point Number
• Minimum Value: -0.99 (full left)
• Maximum Value: 0.99 (full right)
• Default Value: 0.0 (center)
• Vertical Center
• Description: Controls the vertical position of the X door center.
• Scripting Property: "vertical_center"
• Scripting Type: Floating Point Number
• Minimum Value: -0.99 (full bottom)
• Maximum Value: 0.99 (full top)
• Default Value: 0.0 (center)
• Left Door
• Description: Controls the properties of the left door.
• Scripting Property: "left_door"
• Scripting Type: Door Subproperty
• Right Door
• Description: Controls the properties of the right door.
• Scripting Property: "right_door"
• Scripting Type: Door Subproperty
• Bottom Door
• Description: Controls the properties of the bottom door.
• Scripting Property: "bottom_door"
• Scripting Type: Door Subproperty
• Top Door
• Description: Controls the properties of the top door.
• Scripting Property: "top_door"
• Scripting Type: Door Subproperty

Door Subproperty

• Direction
• Description: Controls whether the door swings towards or away from the user.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Towards": The door swings towards the user.
• "Away": The door swings away from the user.
• Default Value: "Away"
• Duration
• Description: Controls the amount of time it takes for the door to fully open or fully close.
• Scripting Property: "duration"
• Scripting Type: Floating Point Number
• Minimum Value: 0.01
• Maximum Value: 1.0
• Default Value: 1.0
• Start Time
• Description: Controls when the door starts opening.
• Scripting Property: "start_time"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0 (as early as possible on open, as late as possible on close)
• Maximum Value: 1.0 (as late as possible on open, as early as possible on close)
• Default Value: 0.0 (as early as possible on open, as late as possible on close)

Troubleshooting

• Problem: OpenGL hardware accelerator is not detected and a software renderer is used instead yielding low frame rates.
• Likely Reasons: OpenGL hardware accelerator does not support current color bit depth, OpenGL hardware accelerator drivers are not installed or OpenGL hardware accelerator drivers are not fully OpenGL 1.1 compliant.
• Solutions: Ensure that the latest drivers for your video card are properly installed. These may usually be downloaded from the graphics chip manufacturer's web site. Switch the color bit depth to a different value.

• Problem: On Windows 95A, Xtra is installed in the appropriate folder but the authoring application, projector/package or Shockwave states the the Xtra does not exist or failed to initialize properly.
• Likely Reasons: OpenGL is not installed.
• Solutions: Install OpenGL.

• Problem: Transition is skipped and the frame advances immediately.
• Likely Reasons: The system is out of heap or OpenGL texture memory. On classic MacOS, OpenGL may not be installed.
• Solutions: Decrease the size of the transition area and/or the window. On classic MacOS, increasing the preferred memory requirements size of the authoring application, projector/package or browser for Shockwave may fix the problem. On classic MacOS, ensure that OpenGL is installed.

Known Issues

• Under Director MX on MacOS X, transition icons do not appear in the proper place under the property editor.
• Under MacOS X, the Xtra does not function under 8 bit color mode. 8 bit color mode is not recommend in MacOS X in general for all applications.
• Under MacOS X, the initial frame may flicker white under software implementations of OpenGL. Macintoshes that ship with MacOS X are equipped with hardware accelerated OpenGL implementations by default so it is unlikely that you will encounter this situation.

History

• 12/16/2003 - Version 2.0.1 released.
• Headline improved with extra properties.
• 1/13/2003 - Version 2.0 released.
• The name of the Xtra has been changed to DirectTransition3D Xtra Set I as DirectXtras plans to release future sets.
• The Xtra now natively supports MacOS X.
• 3 new transitions have been added to the Xtra - X Door, Curtain and Headline from the original DirectTransition Xtra.
• New properties and variations have been added to most transitions.
• Many of the transitions can now run in reverse.
• Automated performance tuning has been added to greatly improve performance when there is no hardware support for OpenGL. Please refer to the "OptimizeTransitions" function in the sample Director movie.
• The Xtra now functions properly in 8 bit color mode under Windows 2000 and XP.
• A sample application for Authorware has been added.
• Version 2.0 is not backwards compatible with version 1.x. If you upgrade existing applications to use version 2.0 from version 1.x, you will have to recreate the transitions.
• The OpenGLInfo Utility Xtra is no longer available. The same functionality has been added as a property of each transition.
• All transitions are now included in a single file.
• Color properties can now be edited using a color picker dialog.
• The Xtra no longer requires the MUI Xtra in authoring mode.
• Minor improvements and bug fixes.

• 3/24/2000 - Version 1.0 released.

Copyright © 1996-2004 DirectXtras Inc. All Rights Reserved.
WebMaster: tamar@directxtras.com
Last Updated: 12/18/2003 4:08:50 AM.