Technical Note: Script Error / Handler Not Defined / Xtra Not Found Error

Updated: 4/19/04
Products: PrintOMatic Lite Xtra 1.6.5, PrintOMatic Lite MX Xtra, PrintOMatic Xtra 1.6.5, PrintOMatic MX Xtra
Platforms: all

Symptom:

When trying to use/register the Xtra, Director displays an "Xtra Not Found Error". This may also appear as a generic "Script Error".

Is the Xtra Installed?

Have you properly placed the Xtra file in Director’s Xtras folder? At authoring time, all the Xtras you use need to be located in the Xtras folder, which is in the same folder as the Director. In projectors, the location is different: read on.

Have you created an XTRAS folder for your PROJECTOR?

Each projector you create needs its own Xtras folder. Projectors do not "share" Xtras with the Director application. Whenever you create a projector, you need to create an Xtras folder in the same folder as the projector, and place copies of all your third-party Xtras in this folder.

Or, did you include the Xtra in your projector file?

An alternative to creating an Xtras folder for your projector is to select the Xtra file(s) you are using in the file list when you build your projector. Simply locate the Xtra files you are using, and add them right along with your .DIR and .CST files when you build your projector.

Another way to include the Xtra with your projector is to select the Xtra under Modify->Movie->Xtras in Director, and check "include in projectors". However, this method may crash projectors in Mac OS X 10.3 (Panther). Click here to read our tech note about this problem.

Are you using the correct Xtra file for your platform?

Macintosh and Windows Xtra files cannot be inter-changed across platforms. Each platform requires a completely different Xtra file.

Windows Xtra files end with a ".X32" extension. These files will NOT work on a Macintosh.

Macintosh Xtra files generally don’t have extensions. They have an "X" shaped icon, and if you do a "Get Info" in the Finder on these files, they will be described as Director documents. These Xtra files cannot be used on Windows platforms.

Is the right PrintOMatic Xtra installed?

The PrintOMatic Xtra comes in Lite and Full versions. These versions are NOT interchangeable. If you have a serial number for the Lite version, make sure you have the Lite version installed. If you are using a version of the Xtra prior to 1.7, the file name is "PMLITE.X32" on Windows, and "PrintOMatic Lite Xtra" on the Macintosh. If you are using PrintOMatic Lite MX, the file name is "PrintOMatic Lite MX.x32" on Windows, and "PrintOMatic Lite MX" on Macintosh.

If you have a serial number for the full version, make sure you have the full version installed. If you are using a version of the xtra prior to 1.7, file name is "PMATIC.X32" on Windows, and "PrintOMatic Xtra" on the Macintosh. If you are using PrintOMatic MX, the file name is "PrintOMatic MX.x32" on Windows, and "PrintOMatic MX" on Macintosh.

To view this and other technical notes on-line, visit http://www.printomatic.com/tech.cfm.