. DirectXtras Home
        Home

DirectCommunication Xtra
DirectConnection Xtra
DirectControl Xtra
DirectEmail Xtra
DirectFTP Xtra
DirectImage Xtra
DirectInteraction Xtra
DirectOS Xtra
DirectSMS Xtra
DirectSound Xtra
DirectTransition Xtra
DirectTransition3D Xtra Set I
DirectTransition3D Xtra Set II
DirectTransition3D Xtra Set III
Documentation
License Agreement
Licensing Fees
Order Form
DirectTTS Xtra
XtrAgent
DirectXport Xtra

SpeechPlugin

Special Discounted Bundles

The Gallery
How To Order
Order Form
Check for Upgrades

Sign in
Change Your Profile

Contact Us
















    .
DirectXtras
Xtra Power for Director & Authorware



 3D Transitions Set 3!

Authorware 4.x Compatible Authorware 5.x CompatibleAuthorware 6.x CompatibleAuthorware 7.x CompatibleDirector 5.x Compatible Director 6.x CompatibleDirector 7.x Compatible Director 8.x CompatibleDirector MX CompatibleDirector MX 2004 Compatible Director Shockwave Compatible and Safe     MacOS 8.x and 9.x CompatibleMacOS X CompatibleWindows Compatible   

DirectTransition3D Xtra™ Set III  Version 2.0.1 Documentation

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

  • Blinds: Simulates the before image opening in a blinds style to reveal the after image.
  • Blur: Simulates the before image fading into the after image while losing focus.
  • Confetti: Simulates the before image exploding into confetti pieces to reveal the after image.
  • Flying Carpet: Simulates the before image flying away as a flying carpet to reveal the after image.
  • Oscillate: Simulates the before image fading into the after image while oscillating.
  • Paint: Simulates the before image being painted over with the after image.
  • Paper Airplane: Simulates the before image flying away as a paper airplane to reveal the after image.
  • Radial Wipe 180: Simulates the after image being radially wiped over 180 degrees to obscure the before image.
  • Radial Wipe 360: Simulates the after image being radially wiped over 360 degrees to obscure the before image.
  • Radial Wipe 90: Simulates the after image being radially wiped over 90 degrees to obscure the before image.
  • Shutter: Simulates the before image spreading out from a center point to reveal the after image.
  • Sticky Bubbles: Simulates bubbles forming, expanding and sticking together to obscure the before image.
  • Waves: Simulates the before image fading into the after image while oscillating in 3D waves.

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

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

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

Blinds Transition

Description: Simulates the before image opening in a blinds style to reveal the after image.
Type Symbol: "DT3DSetIII_Blinds"
Performance Properties Type: 3D 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"
  • Blind Count
    • Description: Controls the number of blinds.
    • Scripting Property: "blind_count"
    • Scripting Type: Integer
    • Minimum Value: 1
    • Maximum Value: 100
    • Default Value: 10
    • Performance Note: Smaller values yield slightly higher frame rates.
  • Blind Duration Variation
    • Description: Controls the variation in the time duration between each blind that it takes to open or close.
    • Scripting Property: "blind_duration_variation"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 20
    • Default Value: 0.0
  • Blind Size Variation
    • Description: Controls the variation in size between each blind.
    • Scripting Property: "blind_size_variation"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 20.0
    • Default Value: 0.0
  • Blind Start Time Variation
    • Description: Controls the variation in the opening or closing start time between each blind.
    • Scripting Property: "blind_start_time_variation"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 20
    • Default Value: 0.0
  • Direction
    • Description: Controls the direction of the blinds opening.
    • Scripting Property: "direction"
    • Scripting Type: String
    • Possible Values:
      • "Down": The blinds open down.
      • "Left": The blinds open left.
      • "Right": The blinds open right.
      • "Up": The blinds open up.
    • Default Value: "Up"
  • 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

Blur Transition

Description: Simulates the before image fading into the after image while losing focus.
Type Symbol: "DT3DSetIII_Blur"
Performance Properties Type: 2D Distortion
Properties:

  • Blur Radius
    • Description: Controls the radius of the blurry area, higher values yield a fuzzier look, lower values yield a sharper look.
    • Scripting Property: "blur_radius"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 1.0
    • Default Value: 0.25
  • Layer Count
    • Description: Controls the number of layers to approximate the blur with.
    • Scripting Property: "layer_count"
    • Scripting Type: Integer
    • Minimum Value: 2
    • Maximum Value: 16
    • Default Value: 3
    • High Performance And Low Quality Value: 2
    • Medium Performance And Medium Quality Value: 3
    • Low Performance And High Quality Value: 6
    • Performance Note: Smaller values yield higher frame rates.
    • Visual Quality Note: Higher values yield larger inaccuracies in color due to floating point error limitations in color channel depth. This is much more noticeable in 16 bit color mode as opposed to 32 bit color mode. Enabling dither in the performance properties may improve visual quality.

Confetti Transition

Description: Simulates the before image exploding into confetti pieces to reveal the after image.
Type Symbol: "DT3DSetIII_Blinds"
Performance Properties Type: 3D Distortion
Properties:

  • Action
    • Description: Controls whether the before image should explode into confetti pieces to reveal the after image (true) or the after image should form from confetti pieces (false).
    • Scripting Property: "action"
    • Scripting Type: String
    • Possible Values:
      • "Break Apart": The before image should explode into confetti pieces to reveal the after image.
      • "Form Together": The after image should form from confetti pieces.
    • Default Value: "Break Apart"
  • 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
  • Piece Count
    • Description: Controls the number of confetti pieces.
    • Scripting Property: "piece_count"
    • Scripting Type: Integer
    • Minimum Value: 2
    • Maximum Value: 30000
    • Default Value: 5000
  • Piece Shape Randomness
    • Description: Controls the randomness in shape of each confetti piece.
    • Scripting Property: "piece_shape_randomness"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0 (orderly)
    • Maximum Value: 1.0 (random)
    • Default Value: 0.0 (orderly)
  • Rotation Speed
    • Direction: Controls the range of speed of rotation.
    • Scripting Property: "rotation_speed"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: 0.0
    • Maximum Value: 1.0
    • Default Range Minimum Value: 0.1
    • Default Range Maximum Value: 0.25
  • Wind Resistance
    • Description: Controls the range of force applied by wind resistance. Higher values yield a lower terminal velocity and more deceleration. Smaller values yield a higher terminal velocity and less deceleration.
    • Scripting Property: "wind_resistance"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: 0.0
    • Maximum Value: 1.0
    • Default Range Minimum Value: 0.5
    • Default Range Maximum 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: -2.0
    • Maximum Value: 2.0
    • Default Range Minimum Value: -0.5
    • Default Range Maximum Value: 0.5
  • 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: 2.0
    • Default Range Minimum Value: 0.5
    • Default Range Maximum Value: 1.5
  • 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: -2.0
    • Maximum Value: 2.0
    • Default Range Minimum Value: -0.5
    • Default Range Maximum Value: 0.5

Flying Carpet Transition

Description: Simulates the before image flying away as a flying carpet to reveal the after image.
Type Symbol: "DT3DSetIII_Flying_Carpet"
Performance Properties Type: 3D Distortion
Properties:

  • Flight Direction
    • Description: Controls whether the flying carpet flies away from the user or towards the user.
    • Scripting Property: "flight_direction"
    • Scripting Type: String
    • Possible Values:
      • "Towards": The flying carpet flies towards from the user.
      • "Away": The flying carpet flies away from the user.
    • Default Value: "Away"
  • Flight Properties
    • Description: Controls the flight path properties.
    • Scripting Property: "flight_properties"
    • Scripting Type: Flight Subproperty
  • 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: 2048
    • 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.
  • 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
  • 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: 2048
    • 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.
  • 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
  • Wave Amplitude
    • Description: Controls the amplitude of the waves moving along the flying carpet.
    • Scripting Property: "wave_amplitude"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 1.0
    • Default Value: 0.1
  • Wave Angle
    • Description: Controls the angle at which the waves move along the flying carpet (0.0 or 360.0 is up, 90.0 is right, 180.0 is down, 270.0 is left).
    • Scripting Property: "wave_angle"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0 (up)
    • Maximum Value: 360.0 (up)
    • Default Value: 30.0
  • Wave Full Amplitude Time
    • Description: Controls the time at which the waves reach full amplitude.
    • Scripting Property: "wave_full_amplitude_time"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 1.0
    • Default Value: 0.25
  • Wave Length
    • Description: Controls the wave length of the waves moving along the flying carpet.
    • Scripting Property: "wave_length"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 10.0
    • Default Value: 1.0
  • Wave Movement
    • Description: Controls how much the waves move along the flying carpet.
    • Scripting Property: "wave_movement"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 10.0
    • Default Value: 2.0

Oscillate Transition

Description: Simulates the before image fading into the after image while oscillating.
Type Symbol: "DT3DSetIII_Oscillate"
Performance Properties Type: 2D Distortion
Properties:

  • Amplitude
    • Description: Controls the amplitude of the oscillations.
    • Scripting Property: "amplitude"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 5.0
    • Default Value: 0.5
  • Cycle Movement Per Transition
    • Description: Controls the number of oscillation cycles movement per transition.
    • Scripting Property: "cycle_movement_per_transition"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 20.0
    • Default Value: 4.0
  • Cycles Per Screen
    • Description: Controls the number of oscillation cycles per transition area.
    • Scripting Property: "cycles_per_screen"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 20.0
    • Default Value: 2.0
  • Detail
    • Description: Controls the detail of the polygon approximation.
    • Scripting Property: "detail"
    • Scripting Type: Integer
    • Minimum Value: 8
    • Maximum Value: 4096
    • Default Value: 256
    • High Performance And Low Quality Value: 128
    • Medium Performance And Medium Quality Value: 256
    • Low Performance And High Quality Value: 1024
    • Performance Note: Smaller values yield higher frame rates.
  • Direction
    • Description: Controls the direction of the oscillations.
    • Scripting Property: "direction"
    • Scripting Type: String
    • Possible Values:
      • "Down": The oscillations move down.
      • "Left": The oscillations move left.
      • "Right": The oscillation move right.
      • "Up": The oscillations move up.
    • Default Value: "Down"

Paint Transition

Description: Simulates the before image being painted over with the after image.
Type Symbol: "DT3DSetIII_Paint"
Performance Properties Type: No Distortion
Properties:

  • Alternate Next Stroke Direction
    • Description: Controls whether the direction to move after a stroke to cover the remaining transition area on each pass is the opposite of the previous and next pass (true) or the same as the first pass (false).
    • Scripting Property: "alternate_next_stroke_direction"
    • Scripting Type: String
    • Possible Values:
      • "False": The direction to move after a stroke to cover the remaining transition area on each pass is the same as the first pass.
      • "True": The direction to move after a stroke to cover the remaining transition area on each pass is the opposite of the previous and next pass.
    • Default Value: "True"
  • Alternate Stroke Direction
    • Description: Controls whether each stroke is in the opposite direction as the previous and next strokes (true) or all strokes are in the same direction as the first stroke (false).
    • Scripting Property: "alternate_stroke_direction"
    • Scripting Type: String
    • Possible Values:
      • "False": All strokes are in the same direction as the first stroke.
      • "True": Each stroke is in the opposite direction as the previous and next strokes.
    • Default Value: "True"
  • Bristle Count
    • Description: Controls the number of bristles on the brush.
    • Scripting Property: "bristle_count"
    • Scripting Type: Integer
    • Minimum Value: 2
    • Maximum Value: 100
    • Default Value: 4
  • Bristle Size Variation
    • Description: Controls the variation in size between each bristle on the brush.
    • Scripting Property: "bristle_size_variation"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 1.0
    • Default Value: 0.5
  • Brush Detail
    • Description: Controls the detail of the polygon approximation of the brush.
    • Scripting Property: "brush_detail"
    • Scripting Type: Integer
    • Minimum Value: 4
    • Maximum Value: 1024
    • Default Value: 128
    • High Performance And Low Quality Value: 32
    • Medium Performance And Medium Quality Value: 128
    • Low Performance And High Quality Value: 512
    • Performance Note: Smaller values yield higher frame rates.
  • First Next Stroke Direction
    • Description: Controls the direction to move after a stroke to cover the remaining transition area on the first pass over the transition area.
    • Scripting Property: "first_next_stroke_direction"
    • Scripting Type: String
    • Possible Values:
      • "Right Or Down": Each stroke on the first pass over the transition area will be to the right (if orientation is 0.0) or down (if orientation is 90.0) of the previous stroke.
      • "Left Or Up": Each stroke on the first pass over the transition area will be to the left (if orientation is 0.0) or down (if orientation is 90.0) of the previous stroke.
    • Default Value: "Right Or Down"
  • First Stroke Direction
    • Description: Controls the direction of the first stroke.
    • Scripting Property: "first_stroke_direction"
    • Scripting Type: String
    • Possible Values:
      • "Down Or Left": The first stroke is down (if orientation is 0.0) or left (if orientation is 90.0).
      • "Up Or Right": The first stroke is up (if orientation is 0.0) or right (if orientation is 90.0).
    • Default Value: "Down Or Left"
  • Orientation
    • Description: Controls the orientation of the paint strokes in degrees (0.0 is up/down, 90.0 is right/left).
    • Scripting Property: "orientation"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0 (
    • Maximum Value: 180.0
    • Default Value: 0.0
  • Repetitions Per Stroke
    • Description: Controls the number of repetitions the entire transition area is painted.
    • Scripting Property: "repetitions_per_stroke"
    • Scripting Type: Integer
    • Minimum Value: 1
    • Maximum Value: 20
    • Default Value: 3
  • Stroke Duration Variation
    • Description: Controls the variation in time duration between each stroke.
    • Scripting Property: "stroke_duration_variation"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 20.0
    • Default Value: 0.0
  • Stroke Size Variation
    • Description: Controls the variation in size of the painted area between each stroke.
    • Scripting Property: "stroke_size_variation"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 20.0
    • Default Value: 0.0
  • Strokes Per Screen
    • Description: Controls the number of strokes per each repetition of painting the entire transition area.
    • Scripting Property: "strokes_per_screen"
    • Scripting Type: Integer
    • Minimum Value: 1
    • Maximum Value: 20
    • Default Value: 4

Paper Airplane Transition

Description: Simulates the before image flying away as a paper airplane to reveal the after image.
Type Symbol: "DT3DSetIII_Paper_Airplane"
Performance Properties Type: 3D Distortion
Properties:

  • Flight Direction
    • Description: Controls whether the flying carpet flies away from the user or towards the user.
    • Scripting Property: "flight_direction"
    • Scripting Type: String
    • Possible Values:
      • "Towards": The flying carpet flies towards from the user.
      • "Away": The flying carpet flies away from the user.
    • Default Value: "Away"
  • Flight Properties
    • Description: Controls the flight path properties.
    • Scripting Property: "flight_properties"
    • Scripting Type: Flight Subproperty
  • Fold Time
    • Description: Controls how long it takes for the paper airplane to fold to it's full shape.
    • Scripting Property: "fold_time"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 0.99
    • Default Value: 0.25
  • Fuselage Fold Size
    • Description: Controls the size of the fold making the fuselage.
    • Scripting Property: "fuselage_fold_size"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 0.99
    • Default Value: 0.25
  • 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
  • Wing Fold Size
    • Description: Controls the size of the wing fold across the leading edge.
    • Scripting Property: "wing_fold_size"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 1.0
    • Default Value: 0.9

Radial Wipe 180 Transition

Description: Simulates the after image being radially wiped over 180 degrees to obscure the before image.
Type Symbol: "DT3DSetIII_Radial_Wipe_180"
Performance Properties Type: No Distortion
Properties:

  • Alternate Rotation Direction
    • Description: Controls whether each wipe is in the opposite direction as the previous and next wipes (true) or all the wipes are in the same direction (false).
    • Scripting Property: "alternate_rotation_direction"
    • Scripting Type: String
    • Possible Values:
      • "False": All the wipes are in the same direction.
      • "True": Each wipe is in the opposite direction as the previous and next wipes.
    • Default Value: "False"
  • Center
    • Description: Controls the range of center positions along the edge to randomly pick a center from.
    • Scripting Property: "center"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: -1.0
    • Maximum Value: 1.0
    • Default Minimum Value: 0.0
    • Default Maximum Value: 0.0
  • Edge
    • Description: Controls the edge which contains the center of the wipe.
    • Scripting Property: "edge"
    • Scripting Type: String
    • Possible Values:
      • "Left": The left edge contains the center of the wipe.
      • "Top": The top edge contains the center of the wipe.
      • "Right": The right edge contains the center of the wipe.
      • "Bottom": The bottom edge contains the center of the wipe.
    • Default Value: "Left"
  • Repetition Count
    • Description: Controls the number of wipes per transition.
    • Scripting Property: "repetition_count"
    • Scripting Type: Integer
    • Minimum Value: 1
    • Maximum Value: 20
    • Default Value: 3
  • Starting Rotation Direction
    • Description: Controls whether the first wipe is clockwise or counterclockwise.
    • Scripting Property: "starting_rotation_direction"
    • Scripting Type: String
    • Possible Values:
      • "Clockwise": The first wipe is clockwise.
      • "Counterclockwise": The first wipe is counterclockwise.
    • Default Value: "Clockwise"

Radial Wipe 360 Transition

Description: Simulates the after image being radially wiped over 360 degrees to obscure the before image.
Type Symbol: "DT3DSetIII_Radial_Wipe_360"
Performance Properties Type: No Distortion
Properties:

  • Alternate Rotation Direction
    • Description: Controls whether each wipe is in the opposite direction as the previous and next wipes (true) or all the wipes are in the same direction (false).
    • Scripting Property: "alternate_rotation_direction"
    • Scripting Type: String
    • Possible Values:
      • "False": All the wipes are in the same direction.
      • "True": Each wipe is in the opposite direction as the previous and next wipes.
    • Default Value: "False"
  • Repetition Count
    • Description: Controls the number of wipes per transition.
    • Scripting Property: "repetition_count"
    • Scripting Type: Integer
    • Minimum Value: 1
    • Maximum Value: 20
    • Default Value: 3
  • Start Angle
    • Description: Controls the starting angle from which the wipe starts (0.0 or 360.0 is up, 90.0 is right, 180.0 is down, 270.0 is left).
    • Scripting Property: "start_angle"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0 (up)
    • Maximum Value: 360.0 (up)
    • Default Value: 0.0 (up)
  • Starting Rotation Direction
    • Description: Controls whether the first wipe is clockwise or counterclockwise.
    • Scripting Property: "starting_rotation_direction"
    • Scripting Type: String
    • Possible Values:
      • "Clockwise": The first wipe is clockwise.
      • "Counterclockwise": The first wipe is counterclockwise.
    • Default Value: "Clockwise"
  • X Center
    • Description: Controls the range of x centers to randomly pick an x center from.
    • Scripting Property: "x_center"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: -1.0 (full left)
    • Maximum Value: 1.0 (full right)
    • Default Range Minimum Value: 0.0
    • Default Range Maximum Value: 0.0
    •  
  • Y Center
    • Description: Controls the range of y centers to randomly pick a y center from.
    • Scripting Property: "y_center"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: -1.0 (full down)
    • Maximum Value: 1.0 (full up)
    • Default Range Minimum Value: 0.0
    • Default Range Maximum Value: 0.0

Radial Wipe 90 Transition

Description: Simulates the after image being radially wiped over 90 degrees to obscure the before image.
Type Symbol: "DT3DSetIII_Radial_Wipe_90"
Performance Properties Type: No Distortion
Properties:

  • Alternate Rotation Direction
    • Description: Controls whether each wipe is in the opposite direction as the previous and next wipes (true) or all the wipes are in the same direction (false).
    • Scripting Property: "alternate_rotation_direction"
    • Scripting Type: String
    • Possible Values:
      • "False": All the wipes are in the same direction.
      • "True": Each wipe is in the opposite direction as the previous and next wipes.
    • Default Value: "False"
  • Corner
    • Description: Controls the which corner is the center of the wipe.
    • Scripting Property: "corner"
    • Scripting Type: String
    • Possible Values:
      • "Bottom Left": The bottom left corner is the center of the wipe.
      • "Top Left": The top left corner is the center of the wipe.
      • "Top Right": The top right corner is the center of the wipe.
      • "Bottom Right": The bottom right corner is the center of the wipe.
    • Default Value: "Bottom Left"
  • Repetition Count
    • Description: Controls the number of wipes per transition.
    • Scripting Property: "repetition_count"
    • Scripting Type: Integer
    • Minimum Value: 1
    • Maximum Value: 20
    • Default Value: 3
  • Starting Rotation Direction
    • Description: Controls whether the first wipe is clockwise or counterclockwise.
    • Scripting Property: "starting_rotation_direction"
    • Scripting Type: String
    • Possible Values:
      • "Clockwise": The first wipe is clockwise.
      • "Counterclockwise": The first wipe is counterclockwise.
    • Default Value: "Clockwise"

Shutter Transition

Description: Simulates the before image spreading out from a center point to reveal the after image.
Type Symbol: "DT3DSetIII_Shutter"
Performance Properties Type: 2D Distortion
Properties:

  • Detail
    • Description: Controls the detail of the polygon approximation.
    • Scripting Property: "detail"
    • Scripting Type: Integer
    • Minimum Value: 3
    • Maximum Value: 3600
    • Default Value: 720
    • High Performance And Low Quality Value: 360
    • Medium Performance And Medium Quality Value: 720
    • Low Performance And High Quality Value: 1440
    • Performance Note: Smaller values yield slightly higher frame rates.
  • 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"
  • Squeeze Effect
    • Description: Controls the balance of moving versus squeezing of the before or after image.
    • Scripting Property: "squeeze_effect"
    • Minimum Value: 0.0 (full movement and no squeeze)
    • Maximum Value: 1.0 (no movement and full squeeze)
    • Default Value: 0.5 (some movement and some squeeze)
  • X Center
    • Description: Controls the range of x centers to randomly pick an x center from.
    • Scripting Property: "x_center"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: -1.0 (full left)
    • Maximum Value: 1.0 (full right)
    • Default Range Minimum Value: 0.0
    • Default Range Maximum Value: 0.0
    •  
  • Y Center
    • Description: Controls the range of y centers to randomly pick a y center from.
    • Scripting Property: "y_center"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: -1.0 (full down)
    • Maximum Value: 1.0 (full up)
    • Default Range Minimum Value: 0.0
    • Default Range Maximum Value: 0.0

Sticky Bubbles Transition

Description: Simulates bubbles forming, expanding and sticking together to obscure the before image.
Type Symbol: "DT3DSetIII_Sticky_Bubbles"
Performance Properties Type: 3D Distortion
Properties:

  • Base Height
    • Description: Controls the base height from which all bubbles start expanding upward.
    • Scripting Property: "base_height"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 10.0
    • Default Value: 0.5
  • Bubble Count
    • Description: Controls the number of bubbles.
    • Scripting Property: "bubble_count"
    • Scripting Type: Integer
    • Minimum Value: 1
    • Maximum Value: 20
    • Default Value: 6
    • Performance Note: Smaller values yield higher frame rates.
  • Bubble Expanding Time
    • Description: Controls the range of bubble expanding time durations to randomly pick from.
    • Scripting Property: "bubble_expanding_time"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: 0.01
    • Maximum Value: 10.0
    • Default Minimum Value: 1.0
    • Default Maximum Value: 2.0
  • Bubble Growing Time
    • Description: Controls the range of bubble growing time durations to randomly pick from.
    • Scripting Property: "bubble_growing_time"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: 0.01
    • Maximum Value: 10.0
    • Default Minimum Value: 1.0
    • Default Maximum Value: 2.0
  • Bubble Height
    • Description: Controls the range of bubble heights to randomly pick a bubble height from.
    • Scripting Property: "bubble_height"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: 0.01
    • Maximum Value: 10.0
    • Default Minimum Value: 1.0
    • Default Maximum Value: 2.0
  • Bubble Off Screen Movement
    • Description: Controls how far off screen bubbles may originate.
    • Scripting Property: "bubble_off_screen_movement"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 1.0
    • Default Value: 0.25
  • Bubble Start Expanding Time
    • Description: Controls the range of bubble start expanding times to randomly pick from.
    • Scripting Property: "bubble_start_expanding_time"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: 0.0
    • Maximum Value: 10.0
    • Default Minimum Value: 4.0
    • Default Maximum Value: 6.0
  • Bubble Start Growing Time Variation
    • Description: Controls the maximum variation between growing start times between bubbles.
    • Scripting Property: "bubble_start_growing_time_variation"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 10.0
    • Default Value: 1.0
  • Bubble Start Radius
    • Description: Controls the range of bubble starting radii to randomly pick from.
    • Scripting Property: "bubble_start_radius"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: 0.01
    • Maximum Value: 1.0
    • Default Minimum Value: 0.1
    • Default Maximum Value: 0.2
  • Bubble Stickiness
    • Description: Controls how much the bubble stick and join together.
    • Scripting Property: "bubble_stickiness"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 1.0
    • Default Value: 0.75
  • Direction
    • Description: Controls whether the bubbles form, expand and stick together to obscure the before image or separate and contract to reveal the after image.
    • Scripting Property: "direction"
    • Scripting Type: String
    • Possible Values:
      • "Forward": The bubbles form, expand and stick together to obscure the before image.
      • "Backward": The bubbles separate and contract to reveal the after image.
    • Default Value: "Forward"
  • 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: 2048
    • 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.
  • 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
  • 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: 2048
    • 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.
  • Meeting Point X
    • Description: Controls the range of meeting point x coordinates to choose from.
    • Scripting Property: "meeting_point_x"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: -1.0 (full left)
    • Maximum Value: 1.0 (full right)
    • Default Minimum Value: -0.5 (slightly left)
    • Default Maximum Value 0.5 (slightly right)
  • Meeting Point Y
    • Description: Controls the range of meeting point y coordinates to choose from.
    • Scripting Property: "meeting_point_y"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: -1.0 (full down)
    • Maximum Value: 1.0 (full up)
    • Default Minimum Value: -0.5 (slightly down)
    • Default Maximum Value: 0.5 (slightly up)
  • 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.95

Waves Transition

Description: Simulates the before image fading into the after image while oscillating in 3D waves.
Type Symbol: "DT3DSetIII_Waves"
Performance Properties Type: 3D Distortion
Properties:

  • Amplitude
    • Description: Controls the amplitude of the oscillations.
    • Scripting Property: "amplitude"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 5.0
    • Default Value: 0.25
  • Cycle Movement Per Transition
    • Description: Controls the number of oscillation cycles movement per transition.
    • Scripting Property: "cycle_movement_per_transition"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 20.0
    • Default Value: 4.0
  • Cycles Per Screen
    • Description: Controls the number of oscillation cycles per transition area.
    • Scripting Property: "cycles_per_screen"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.01
    • Maximum Value: 20.0
    • Default Value: 2.0
  • Detail
    • Description: Controls the detail of the polygon approximation.
    • Scripting Property: "detail"
    • Scripting Type: Integer
    • Minimum Value: 8
    • Maximum Value: 4096
    • Default Value: 256
    • High Performance And Low Quality Value: 128
    • Medium Performance And Medium Quality Value: 256
    • Low Performance And High Quality Value: 1024
    • Performance Note: Smaller values yield higher frame rates.
  • Direction
    • Description: Controls the direction of the oscillations 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)
  • 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.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

Flight Subproperty

  • Maximum Bank Angle
    • Description: Controls the maximum bank angle in degrees.
    • Scripting Property: "maximum_bank_angle"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 90.0
    • Default Value: 45.0
  • Off Screen Angle
    • Description: Controls the angle off screen from which the flying object leaves the screen (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: 30.0
  • Off Screen X Speed
    • Description: Controls the X speed when the flying object leaves the screen.
    • Scripting Property: "off_screen_x_speed"
    • Scripting Type: Floating Point Number
    • Minimum Value: -100.0 (moving left very fast)
    • Maximum Value: 100.0 (moving right very fast)
    • Default Value: 20.0
  • Off Screen Y Speed
    • Description: Controls the Y speed when the flying object leaves the screen.
    • Scripting Property: "off_screen_y_speed"
    • Scripting Type: Floating Point Number
    • Minimum Value: -100.0 (moving down very fast)
    • Maximum Value: 100.0 (moving up very fast)
    • Default Value: 20.0
  • Off Screen Z
    • Description: Controls the distance away from the user at which the flying object leaves the screen.
    • Scripting Property: "off_screen_z"
    • Scripting Type: Floating Point Number
    • Minimum Value: 1.0
    • Maximum Value: 100.0
    • Default Value: 10.0
  • Rotation Time
    • Description: Controls the time range when the flying object orients itself for flight.
    • Scripting Property: "rotation_time"
    • Scripting Type: Floating Point Number Range
    • Minimum Value: 0.0
    • Maximum Value: 1.0
    • Default Minimum Value: 0.15
    • Default Maximum Value: 0.5
  • Start Movement Time
    • Description: Controls the time at which the flying object starts moving.
    • Scripting Property: "start_movement_time"
    • Scripting Type: Floating Point Number
    • Minimum Value: 0.0
    • Maximum Value: 0.99
    • Default Value: 0.2
  • Start X Speed
    • Description: Controls the X speed when the flying object starts moving.
    • Scripting Property: "start_x_speed"
    • Scripting Type: Floating Point Number
    • Minimum Value: -100.0 (moving left very fast)
    • Maximum Value: 100.0 (moving right very fast)
    • Default Value: 10.0
  • Start Y Speed
    • Description: Controls the Y speed when the flying object starts moving.
    • Scripting Property: "start_y_speed"
    • Scripting Type: Floating Point Number
    • Minimum Value: -100.0 (moving down very fast)
    • Maximum Value: 100.0 (moving up very fast)
    • Default Value: 10.0

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/18/2003 - Version 2.0.1 released.


DirectXtras Inc.
P.O Box 2645, Menlo Park, CA, 94026, U.S.A
Voice: +1-415-5058249, Fax: +1-801-8585841
Toll Free: 1-800-4453093
E-mail General Information: info@directxtras.com
E-mail Technical Support: support@directxtras.com

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