DirectTransition3D Xtra™ Set II  Version 2.0.1 Documentation

Developed by Omri Kalinsky and Tomer Berda, DirectXtras Inc.
(C) Copyright 1998-2009.
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 II features the following customizable transitions:

• Black Hole: Simulates the before image sucked in to or blown out of a point.
• Circular Wipe: Simulates the before image being wiped in a circular shape to reveal the after image.
• Color Fade: Simulates the before image fading in to a color and fading out to the after image.
• Four Part Door: Simulates the before image opening in a four part door to reveal the after image.
• One Part Door: Simulates the before image opening in a one part door to reveal the after image.
• Ripples: Simulates circular ripples oscillating, expanding and wiping to reveal the after image.
• Rotating Boxes: Simulates boxes with the before image on one side and after image one another rotating.
• Simple Fade: Simulates a simple fade from the before image to the after image.
• Simple Wipe: Simulates a simple wipe in any direction from the before image to the after image.
• Squeeze: Simulates the before image squeezing into an outer edge to reveal the after image.
• Three Part Door: Simulates the before image opening in a three part door to reveal the after image.
• Twist: Simulates a plane with the before image on one side and the after image on the other twisting to reveal the after image.
• Two Part Door: Simulates the before image opening in a two part door to reveal the after image.
• Two Way Wipe: Simulates a wipe from any two opposite direction converging to reveal the after image.
• Zoom: Simulates the before image zooming in and the after image zooming out while the images fade.

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 II 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 II 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:

"DirectTransition3DSetII.w32" - Shockwave safe package for Windows
"DirectTransition3DSetII.ppc" - Shockwave safe package for MacOS 8.x and 9.x
"DirectTransition3DSetII.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:"DirectTransition3DSetII", #nameW32:"DirectTransition3DSetII.x32", #package:"http://www.myserver.com/packs/DirectTransition3DSetII"]

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 II. From the Modify->Movie->Xtras dialog in Director, select the "DirectTransition3DSetII" 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 II 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 II 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 II 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 II 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 II transition cast member has a write only property named "serial_number". Setting this property of any DirectTransition3D Set II transition cast member to a valid serial number registers the Xtra for all instances. For example, if there exists a DirectTransition3D Set II 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 II transition instances that will be created, loaded from or saved to disk will be registered. In order to register any DirectTransition3D Set II 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 II 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 II 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 II 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 II 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 II 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 II 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 II 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 II 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

Black Hole Transition

Description: Simulates the before image sucked in to or blown out of a point.
Type Symbol: "DT3DSetII_Black_Hole"
Performance Properties Type: 2D Distortion
Properties:

• Suction Effect
• Description: Controls the amount of suction into (positive values) or blowing out of (negative values) the point.
• Scripting Property: "suction_effect"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (full blowing out of the point)
• Maximum Value: 1.0 (full suction into the point)
• Default Value: 0.5
• Longitude Detail
• Description: Controls the detail of the polygon approximation in the longitude direction.
• Scripting Property: "longitude_detail"
• Scripting Type: Integer
• Minimum Value: 16
• Maximum Value: 1024
• 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: 16
• Maximum Value: 1024
• 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.
• Horizontal Position
• Description: Controls the range of horizontal positions to randomly pick a horizontal position from.
• Scripting Property: "horizontal_position"
• Scripting Type: Floating Point Number Range
• Minimum Value: -0.99 (full left)
• Maximum Value: 0.99 (full right)
• Default Range Minimum Value: -0.99
• Default Range Maximum Value: 0.99
•  
• Vertical Position
• Description: Controls the range of vertical positions to randomly pick a vertical position from.
• Scripting Property: "vertical_position"
• Scripting Type: Floating Point Number Range
• Minimum Value: -0.99 (full down)
• Maximum Value: 0.99 (full up)
• Default Range Minimum Value: -0.99
• Default Range Maximum Value: 0.99
•  

Circular Wipe Transition

Description: Simulates the before image being wiped in a circular shape to reveal the after image.
Type Symbol: "DT3DSetII_Circular_Wipe"
Performance Properties Type: No Distortion
Properties:

• Direction
• Description: Controls whether the wipe happens from inside out or outside in.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Inside Out": The wipe starts from the inside and continues outwards.
• "Outside In": The wipe starts from the outside and continues inwards.
• Default Value: "Inside Out"
• Fade Area
• Description: Controls the size of the fading area.
• Scripting Property: "fade_area"
• Scripting Type: Floating Point Number
• Minimum Value: 0.01
• Maximum Value: 2.0
• Default Value: 0.25
• Horizontal Position
• Description: Controls the horizontal position of the circle center.
• Scripting Property: "horizontal_position"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (full left)
• Maximum Value: 1.0 (full right)
• Default Value: 0.0 (center)
• Vertical Position
• Description: Controls the vertical position of the circle center.
• Scripting Property: "vertical_position"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (full bottom)
• Maximum Value: 1.0 (full top)
• Default Value: 0.0 (center)
• Detail
• Description: Controls the detail of the polygon approximation.
• Scripting Property: "detail"
• Scripting Type: Integer
• Minimum Value: 3
• Maximum Value: 1024
• 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.

Color Fade Transition

Description: Simulates the before image fading in to a color and fading out to the after image.
Type Symbol: "DT3DSetII_Color_Fade"
Performance Properties Type: No Distortion
Properties:

• Color
• Description: Controls the color to fade the before image into and the after image out of.
• Scripting Property: "color"
• Scripting Type: Color
• Default Value: White
• Fade Time
• Description: Controls the relative length of fade in time and fade out time.
• Scripting Property: "fade_time"
• Scripting Type: Floating Point Number
• Minimum Value: 0.01 (fade in is very short, fade out is very long)
• Maximum Value: 0.99 (fade in is very long, fade out is very short)
• Default Value: 0.5 (fade in is as long as the fade out)

Four Part Door Transition

Description: Simulates the before image opening in a four part door to reveal the after image.
Type Symbol: "DT3DSetII_Four_Part_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"
• Outer Pivot Orientation
• Description: Controls the orientation of the pivot of the two outer doors.
• Scripting Type: "outer_pivot_orientation"
• Possible Values:
• "Horizontal": The two outer doors pivot horizontally.
• "Vertical": The two outer doors pivot vertically.
• Default Value: "Horizontal"
• 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
• Inner Center
• Description: Controls the center of where the two inner doors meet.
• Scripting Property: "inner_center"
• Scripting Type: Floating Point Number
• Minimum Value: -0.99 (bottom if outer pivot orientation is horizontal or left if outer pivot orientation is vertical)
• Maximum Value: 0.99 (top if outer pivot orientation is horizontal or right if outer pivot orientation is vertical)
• Default Value: 0.0 (center)
• Inner Position
• Description: Controls the position and size of the two inner doors.
• Scripting Property: "inner_position"
• Scripting Type: Floating Point Number Range
• Minimum Value: -0.99 (left if outer pivot orientation is horizontal or up if outer pivot orientation is vertical)
• Maximum Value: 0.99 (right if outer pivot orientation is horizontal or bottom if outer pivot orientation is vertical)
• Default Range Minimum Value: -0.5
• Default Range Maximum Value: 0.5
• Inner Side One Door
• Description: Controls the properties of the bottom door if outer pivot orientation is horizontal or the left door if outer pivot orientation is vertical.
• Scripting Property "inner_side_one_door"
• Scripting Type: Door Subproperty
• Inner Side Two Door
• Description: Controls the properties of the top door if outer pivot orientation is horizontal or the right door if outer pivot orientation is vertical.
• Scripting Property "inner_side_two_door"
• Scripting Type: Door Subproperty
• Outer Side One Door
• Description: Controls the properties of the left door if outer pivot orientation is horizontal or the top door if outer pivot orientation is vertical.
• Scripting Property "outer_side_one_door"
• Scripting Type: Door Subproperty
• Outer Side Two Door
• Description: Controls the properties of the right door if outer pivot orientation is horizontal or the bottom door if outer pivot orientation is vertical.
• Scripting Property "outer_side_two_door"
• Scripting Type: Door Subproperty

One Part Door Transition

Description: Simulates the before image opening in a one part door to reveal the after image.
Type Symbol: "DT3DSetII_One_Part_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"
• Pivot Side
• Description: Controls the direction from which to pivot the door from.
• Scripting Property: "pivot_side"
• Scripting Type: String
• Possible Values:
• "Left": The door should pivot from the left.
• "Top": The door should pivot from the top.
• "Right": The door should pivot from the right.
• "Bottom": The door should pivot from 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.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
• Door Direction
• Description: Controls whether the door swings towards or away from the user.
• Scripting Property: "door_direction"
• Scripting Type: String
• Possible Values:
• "Towards": The door swings towards the user.
• "Away": The door swings away from the user.
• Default Value: "Away"

Ripples Transition

Description: Simulates circular ripples oscillating, expanding and wiping to reveal the after image.
Type Symbol: "DT3DSetII_Ripples"
Performance Properties Type: 3D Distortion
Properties:

• Direction
• Description: Controls the ripples move inside out (forward time) or outside in (backwards time).
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Inside Out": The ripples move inside out (forward time).
• "Outside In": The ripples move outside in (backwards time).
• Default Value: "Inside Out"
• Coloring Mode
• Description: Controls how much to fade between the before and after images relative to the ripple positions.
• Scripting Property: "coloring_mode"
• Scripting Type: String
• Possible Values:
• "Blend": Fade each pixel gradually towards the after image as each ripple passes over it.
• "Minimum": Fade each pixel to the after image once the last ripple has passed over it.
• "Maximum: Fade each pixel to the after image once the first ripple has passed over it.
• Default Value: "Blend"
• Ripple Time Displacement
• Description: Controls the maximum amount of time between when ripples start expanding
• Scripting Property: "ripple_time_displacement"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 2.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.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
• Wave Height
• Description: Controls the height or amplitude of each ripple wave.
• Scripting Property: "wave_height"
• Scripting Type: Floating Point Number
• Minimum Value: 0.05
• Maximum Value: 1.0
• Default Value: 0.25
• Ripple Radius
• Description: Controls the range of radius of the affected area each ripple wave.
• Scripting Property: "ripple_radius"
• Scripting Type: Floating Point Number Range
• Minimum Value: 0.05
• Maximum Value: 2.0
• Default Range Minimum Value: -0.5
• Default Range Maximum Value: 1.0
• Ripple Count
• Description: Controls the number of ripples.
• Scripting Property: "ripple_count"
• Scripting Type: Integer
• Minimum Value: 1
• Maximum Value: 10
• Default Value: 4
• Performance Note: Smaller values yield higher frame rates.
• Longitude Detail
• Description: Controls the detail of the polygon approximation in the longitude direction.
• Scripting Property: "longitude_detail"
• Scripting Type: Integer
• Minimum Value: 16
• 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: 100
• 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: 16
• Maximum Value: 512
• Default Value: 64
• High Performance And Low Quality Value: 16
• Medium Performance And Medium Quality Value: 32
• Low Performance And High Quality Value: 100
• Performance Note: Smaller values yield higher frame rates.
• Horizontal Position
• Description: Controls the range of horizontal positions to randomly pick a ripple's horizontal center from.
• Scripting Property: "horizontal_position"
• Scripting Type: Floating Point Number Range
• Minimum Value: -0.99 (full left)
• Maximum Value: 0.99 (full right)
• Default Range Minimum Value: -0.99
• Default Range Maximum Value: 0.99
•  
• Vertical Position
• Description: Controls the range of vertical positions to randomly pick a ripple's vertical center from.
• Scripting Property: "vertical_position"
• Scripting Type: Floating Point Number Range
• Minimum Value: -0.99 (full down)
• Maximum Value: 0.99 (full up)
• Default Range Minimum Value: -0.99
• Default Range Maximum Value: 0.99
•  

Rotating Boxes Transition

Description: Simulates boxes with the before image on one side and after image one another rotating.
Type Symbol: "DT3DSetII_Rotating_Boxes"
Performance Properties Type: 3D Distortion
Properties:

• Orientation
• Description: Controls the orientation of the rotation of the boxes.
• Scripting Property: "orientation"
• Scripting Type: String
• Possible Values:
• "Horizontal": The boxes rotate horizontally.
• "Vertical": The boxes rotate vertically.
• Default Value: "Horizontal"
• 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.5
• Box Time Displacement
• Description: Controls the maximum amount of time between when each box starts rotating.
• Scripting Property: "box_time_displacement"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 0.5
• Box Size Variation
• Description: Controls the maximum amount of variation in size between each rotating box.
• Scripting Property: "box_size_variation"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 10.0
• Default Value: 1.0
• Background Color
• Description: Controls the background color.
• Scripting Property: "background_color"
• Scripting Type: Color
• Default Value: White
• Box Side Color
• Description: Controls the color of the sides of the boxes.
• Scripting Property: "box_side_color"
• Scripting Type: Color
• Default Value: White
• Rotation Direction
• Description: Controls the probability of the direction of rotation of each box.
• Scripting Property: "rotation_direction"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (all boxes will rotate left if orientation is horizontal or all boxes will rotate up if orientation is vertical)
• Maximum Value: 1.0 (all boxes will rotate right if orientation is horizontal or all boxes will rotate down if orientation is vertical)
• Default Value: 0.0 (boxes have an equal chance of rotating either way)
• Box Count
• Description: Controls the number of boxes.
• Scripting Property: "box_count"
• Scripting Type: Integer
• Minimum Value: 1
• Maximum Value: 100
• Default Value: 4
• Performance Note: Smaller values yield higher frame rates.

Simple Fade Transition

Description: Simulates a simple fade from the before image to the after image.
Type Symbol: "DT3DSetII_Simple_Fade"
Performance Properties Type: No Distortion
Properties:

• Start Speed
• Description: Controls the speed of the fade at the start.
• Scripting Property: "start_speed"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 2.0
• Default Value: 1.0
• End Speed
• Description: Controls the speed of the fade at the end.
• Scripting Property: "end_speed"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 2.0
• Default Value: 1.0

Simple Wipe Transition

Description: Simulates a simple wipe in any direction from the before image to the after image.
Type Symbol: "DT3DSetII_Simple_Wipe"
Performance Properties Type: No Distortion
Properties:

• Direction
• Description: Controls the direction of the wipe in degrees (0.0 or 360.0 is up, 90.0 is right, 180.0 is down, 270.0 is left).
• Scripting Property: "direction"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0 (up)
• Maximum Value: 360.0 (up)
• Default Value: 0.0 (up)
• Fade Area
• Description: Controls the size of the fading area.
• Scripting Property: "fade_area"
• Scripting Type: Floating Point Number
• Minimum Value: 0.01
• Maximum Value: 2.0
• Default Value: 0.25

Squeeze Transition

Description: Simulates the before image squeezing into an outer edge to reveal the after image.
Type Symbol: "DT3DSetII_Squeeze"
Performance Properties Type: 2D Distortion
Properties:

• Action
• Description: Controls whether the before image should be squeezed into an outer edge or the after image should be unsqueezed from an outer edge.
• Scripting Property: "action"
• Scripting Type: String
• Possible Values:
• "Squeeze": The before image should be squeezed into an outer edge.
• "Unsqueeze": The after image should be unsqueezed from an outer edge.
• Default Value: "Squeeze"
• Direction
• Description: Controls the direction and outer edge to squeeze the before image into or unsqueeze the after image out of.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Down": The before image should be squeezed into the bottom edge or the after image should be unsqueezed from the bottom edge.
• "Left": The before image should be squeezed into the left edge or the after image should be unsqueezed from the left edge.
• "Up": The before image should be squeezed into the top edge or the after image should be unsqueezed from the top edge.
• "Right": The before image should be squeezed into the right edge or the after image should be unsqueezed from the right edge.
• Default Value: "Down"
• From Side Position
• Description: Controls the final positions of the borders on the from side.
• Scripting Property: "from_side_position"
• Scripting Type: Floating Point Number Range
• Minimum Value: -1.0
• Maximum Value: 1.0
• Default Range Minimum Value: -0.8
• Default Range Maximum Value: 0.6
• From Side Curve
• Description: Controls the amount of curvature on the from side.
• Scripting Property: "from_side_curve"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 1.0
• To Side Position
• Description: Controls the final positions of the borders on the to side.
• Scripting Property: "to_side_position"
• Scripting Type: Floating Point Number Range
• Minimum Value: -1.0
• Maximum Value: 1.0
• Default Range Minimum Value: 0.7
• Default Range Maximum Value: 0.9
• To Side Curve
• Description: Controls the amount of curvature on the to side.
• Scripting Property: "to_side_curve"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 1.0
• Default Value: 1.0
• Finish Squeeze Time
• Description: Controls the amount of time required to squeeze or unsqueeze an image.
• Scripting Property: "finish_squeeze_time"
• Scripting Type: Floating Point Number
• Minimum Value: 0.1
• Maximum Value: 0.9
• Default Value: 0.4
• Start Move Time
• Description: Controls the amount of time to wait before starting to move an image.
• Scripting Property: "start_move_time"
• Scripting Type: Floating Point Number
• Minimum Value: 0.1
• Maximum Value: 0.9
• Default Value: 0.1
• 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 significantly higher frame rates.

Three Part Door Transition

Description: Simulates the before image opening in a three part door to reveal the after image.
Type Symbol: "DT3DSetII_Three_Part_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"
• Side Door Side
• Description: Controls the edge the side door is on.
• Scripting Property: "pivot_side"
• Scripting Type: String
• Possible Values:
• "Left": The side door is on the left.
• "Top": The side door is on the top.
• "Right": The side door is on the right.
• "Bottom": The side door is on 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.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
• Side Door Size
• Description: Controls the size of the side door.
• Scripting Property: "side_door_size"
• Scripting Type: Floating Point Number
• Minimum Value: 0.01
• Maximum Value: 0.99
• Default Value: 0.25
• Side Door Center
• Description: Controls the center of the side door.
• Scripting Property: "side_door_center"
• Scripting Type: Floating Point Number
• Minimum Value: -0.99
• Maximum Value: 0.99
• Default Value: 0.0
• Side Door
• Description: Controls the properties of the side door.
• Scripting Property "side_one_door"
• Scripting Type: Door Subproperty
• Main Door One
• Description: Controls the properties of the first main door.
• Scripting Property "main_door_one"
• Scripting Type: Door Subproperty
• Main Door Two
• Description: Controls the properties of the second main door.
• Scripting Property "main_door_two"
• Scripting Type: Door Subproperty

Twist Transition

Description: Simulates a plane with the before image on one side and the after image on the other twisting to reveal the after image.
Type Symbol: "DT3DSetII_Twist"
Performance Properties Type: 3D Distortion
Properties:

• Direction
• Description: Controls the direction of the twist.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Left To Right": The image twists from left to right.
• "Top To Bottom": The image twists from top to bottom.
• "Right To Left": The image twists from right to left.
• "Bottom To Top": The image twists from bottom to top.
• Default Value: "Left To Right"
• Twist Effect
• Description: Controls the amount of twisting.
• Scripting Property: "twist_effect"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (full twist in one direction)
• Maximum Value: 1.0 (full twist in the opposite direction)
• 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.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
• Background Color
• Description: Controls the background color.
• Scripting Property: "background_color"
• Scripting Type: Color
• Default Value: White
• Longitude Detail
• Description: Controls the detail of the polygon approximation in the longitude direction.
• Scripting Property: "longitude_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.
• 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.
• Revolution Count
• Description: Controls the amount of extra 360 degree revolutions added to the default 180 degree half revolution.
• Scripting Property: "revolution_count"
• Scripting Type: Integer
• Minimum Value: 0 (180 degree rotation)
• Maximum Value 4 (1620 degree rotation)
• Default Value: 0

Two Part Door Transition

Description: Simulates the before image opening in a two part door to reveal the after image.
Type Symbol: "DT3DSetII_Two_Part_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"
• Pivot Orientation
• Description: Controls the orientation of the pivot of the two doors.
• Scripting Type: "pivot_orientation"
• Possible Values:
• "Horizontal": The doors pivot horizontally.
• "Vertical": The doors pivot vertically.
• Default Value: "Horizontal"
• 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.75
• Center
• Description: Controls the position of the meeting point of the two doors.
• Scripting Property: "center"
• Scripting Type: Floating Point Number
• Minimum Value: -0.99 (full left if orientation is horizontal or full up if orientation is vertical)
• Maximum Value: 0.99 (full right if orientation is horizontal or full up if orientation is vertical)
• Default Value: 0.0 (centered)
• Side One Door
• Description: Controls the properties of the left door if orientation is horizontal or top door of orientation is vertical.
• Scripting Property "side_one_door"
• Scripting Type: Door Subproperty
• Side Two Door
• Description: Controls the properties of the right door if orientation is horizontal or bottom door of orientation is vertical.
• Scripting Property "side_two_door"
• Scripting Type: Door Subproperty

Two Way Wipe Transition

Description: Simulates a wipe from any two opposite direction converging to reveal the after image.
Type Symbol: "DT3DSetII_Two_Way_Wipe"
Performance Properties Type: No Distortion
Properties:

• Angular Direction
• Description: Controls the angle in degrees of the axis of the wipe (0.0 is up/down, 90.0 is right/left).
• Scripting Property: "angular_direction"
• Scripting Type: Floating Point Number
• Minimum Value: 0.0
• Maximum Value: 180.0
• Default Value: 0.0
• Direction
• Description: Controls whether the wipe happens from inside out or outside in.
• Scripting Property: "direction"
• Scripting Type: String
• Possible Values:
• "Outside In": The wipe starts from the outside and continues inwards.
• "Inside Out": The wipe starts from the inside and continues outwards.
• Default Value: "Outside In"
• Inside Fade Area
• Description: Controls the size of the fade area when it is on the inside.
• Scripting Property: "inside_fade_area"
• Scripting Type: Floating Point Number
• Minimum Value: 0.01
• Maximum Value: 4.0
• Default Value: 0.25
• Outside Fade Area
• Description: Controls the size of the fade area when it is on the outside.
• Scripting Property: "outside_fade_area"
• Scripting Type: Floating Point Number
• Minimum Value: 0.01
• Maximum Value: 4.0
• Default Value: 0.25
• Meeting Point
• Description: Controls the position of the meeting point of the two wipes from opposite sides.
• Scripting Property: "meeting_point"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (left when angular direction is 0.0 degrees, top when angular direction is 90.0 degrees, right when angular direction is 180.0 degrees)
• Maximum Value: 1.0 (right when angular direction is 0.0 degrees, bottom when angular direction is 90.0 degrees, left when angular direction is 180.0 degrees)
• Default Value: 0.0 (center)
• Time Displacement
• Description: Controls which side's wipe starts first and by how much time.
• Scripting Property: "time_displacement"
• Scripting Type: Floating Point Number
• Minimum Value: -4.0 (right side starts first when angular direction is 0.0 degrees, bottom side starts first when angular direction is 90.0 degrees, left side starts first when angular direction is 180.0 degrees)
• Maximum Value: 4.0 (left side starts first when angular direction is 0.0 degrees, top side starts first when angular direction is 90.0 degrees, right side starts first when angular direction is 180.0 degrees)
• Default Value: 0.0 (both side's wipe start at the same time)

Zoom Transition

Description: Simulates the before image zooming in and the after image zooming out while the images fade.
Type Symbol: "DT3DSetII_Zoom"
Performance Properties Type: 2D Distortion
Properties:

• Fade Time
• Description: Controls the start and end time to fade the before image to the after image.
• Scripting Property: "fade_time"
• Scripting Type: Floating Point Number Range
• Minimum Value: 0.1
• Maximum Value: 0.9
• Default Range Minimum Value: 0.4
• Default Range Maximum Value: 0.6
• Maximum Zoom Time
• Description: Controls the time at which the before and after images are at maximum zoom.
• Scripting Property: "maximum_zoom_time"
• Scripting Type: Floating Point Number
• Minimum Value: 0.1 (maximum zoom is shortly after the beginning of the transition)
• Maximum Value: 0.9 (maximum zoom is shortly before the end of the transition)
• Default Value: 0.5 (maximum zoom is right at the middle of the transition)
• Zoom In Zoom
• Description: Controls the zoom factor to zoom the before image in.
• Scripting Property: "zoom_in_zoom"
• Scripting Type: Floating Point Number
• Minimum Value: 1.0
• Maximum Value: 1000.0
• Default Value: 10.0
• Zoom In X
• Description: Controls the x coordinate of the before image zoom in point.
• Scripting Property: "zoom_in_x"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (full left)
• Maximum Value: 1.0 (full right)
• Default Value: 0.0 (center)
• Zoom In Y
• Description: Controls the y coordinate of the before image zoom in point.
• Scripting Property: "zoom_in_y"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (full down)
• Maximum Value: 1.0 (full up)
• Default Value: 0.0 (center)
• Zoom Out Zoom
• Description: Controls the zoom factor to zoom the after image out.
• Scripting Property: "zoom_out_zoom"
• Scripting Type: Floating Point Number
• Minimum Value: 1.0
• Maximum Value: 1000.0
• Default Value: 10.0
• Zoom Out X
• Description: Controls the x coordinate of the after image zoom out point.
• Scripting Property: "zoom_out_x"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (full left)
• Maximum Value: 1.0 (full right)
• Default Value: 0.0 (center)
• Zoom Out Y
• Description: Controls the y coordinate of the after image zoom out point.
• Scripting Property: "zoom_out_y"
• Scripting Type: Floating Point Number
• Minimum Value: -1.0 (full down)
• Maximum Value: 1.0 (full up)
• Default Value: 0.0 (center)

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.
• Ripples improved with extra properties.
• Simple Fade improved with extra properties.
• 1/13/2003 - Version 2.0 released.

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