Xtra Developer Kit Examples


About the Examples Folder

This XDK comes with skeleton (template) projects in the Examples folder for Interrogator, Transition, Sprite, Scripting, Filter, and Tool Xtras. These templates include projects for Visual C++ and Xcode. The skeleton projects contain source with comments that briefly describe modifications to make to create your Xtra. All of the sample movies have been updated to D11 format. Older versions of the movies can be found in older XDKs posted on the Adobe Exchange. The Xcode projects are setup to build universal binary targets - for both Intel and PPC processors. Note that xtras built with Xcode will not work with Director MX 2004 since they are Mach-O format rather than CFM format.

There are also a number of working example projects that demonstrate various coding features described in this documentation. An alternate way to begin Xtra development is to start with a working example that implements many of the features you plan to provide, and modify it to include your code. This release of the XDK includes a folder called XDKXtras which contains prebuilt version of the example xtras that are included in the kit. All of the projects have now been setup to place their output into a common folder. There is also an "AllExamples" master project that can be used to build all of the examples.

IMPORTANT: You may freely change source files in the example projects. However, take care in modifying any project settings. These projects provide a number of standard settings required to make Xtras work correctly.

For information about development environments, please see the readme file that comes with the XDK.

Xtra Syntax

The examples include a variety of different coding styles to implement Xtras:

Creating GUIDs

To create globally unique identifiers (GUIDs) for the classes you define in an Xtra, you can use the Windows application GenUID.EXE, which is provided with the Microsoft Visual C++ development environment. For Macintosh OSX, just use the uuidgen command in the terminal window. Copy the GUID created by the utility into the class header file. You need to create a new GUID for each class in a project. Tip: After copying, be sure to correctly redefine the class that existed in the same line the GUID line is on.


Description of Examples


Filter Interrogate Script Sprite Tool Transition