Creating
Projectors
DirectMediaXtra icons operate only under Windows 95, 98, ME, Windows
NT 4 and Windows 2000. Please check our web site at http://xtras.tabuleiro.com
for updated information about system requirements for different operational
systems. You should create your Projectors for Windows 95 and Windows NT, and with the
"Animate in Background" option checked. To prevent problems with palettes
you should include with each projector a copy of the modified DIRECTOR.INI
file you created following the instructions in the Getting
Started section. The .ini file should be renamed to match
the name of the Projector, i.e.:
Projector:
myproj.exe
.INI file:
myproj.ini
The Xtra is automatically included in the Projector if your first movie
contains a DirectMediaXtra cast member. If you are creating a "dummy" projector
that will call your .dxr movie, you can include the Xtra in the Projector
using the MODIFY->MOVIE->XTRAS menu, and adding the DirectMediaXtra.x32 file.
TIP: You
can also deliver the DirectMediaXtra.x32 file in a folder named XTRAS, located
in the same directory of your Projector, if you do not want to embed
the file into your projector. This is recommended for faster startup
of your Projector, and for delivery on the NT platform.
We also
recommend including a LINGO.INI file with your Projector. This file
should contain the following code to prevent problems playing sounds
when Intel RSX and DirectSound are installed:
on
startup |
set
the soundkeepdevice to 0
|
end
startup |
The final structure of files should look like:
Projector
- C:\myproj\proj.exe |
.INI
file - C:\myproj\proj.ini |
Lingo.ini
- C:\myproj\lingo.ini |
Optional (if Xtra was not embedded into the Projector):
Xtra
file - C:\myproj\Xtras\DirectMediaXtra.x32 |
The Xtra will automatically locate all linked Media files that are located
in the same directory of the Projector. Additional directories can also
be specified using the SEARCHPATHS list attached to each DirectMediaXtra castmember.
This list can be edited directly from the DirectMediaXtra castmember properties
dialog box and is saved with the castmember in the Director movie. Both
absolute and relative directory entries may be used. Relative directories
are evaluated in relation to the projector executable, while absolute
directories must contain a drive letter and complete pathname information.
Examples: |
Relative
directory entry: media |
Absolute
directory entry: E:\media |
When used with Director 5 and 6, the Xtra will also search all the directories
listed in "the searchpaths" Lingo variable for missing Media files. The
searchpaths is also evaluated before any Lingo in the current movie executes
so it should be set preferably in a LINGO.INI file. The release version
of Director 7 had a bug that was corrected in version 7.02, and "the searchpath"
and "the searchpaths" variables were not being scanned by Director. We
included special code on DirectMediaXtra to work around the searchpath
bug, using a global variable named tbsearchpath. You can include the following
code on your LINGO.INI file to define and add directories to the searchpath
and tbsearchpath variables, specifying relative directories to hold your
linked MPEG files:
DIRECTOR
5 and 6 LINGO.INI: |
on
startup |
set
the soundkeepdevice to 0
|
--
Added to look for files in the "media" subdirectory
|
append(the
searchpath, the pathname & "media")
|
end
startup |
DIRECTOR
7 and 8 LINGO.INI: |
on
startup |
set
the soundkeepdevice to 0
|
--
Added to look for files in the "media" subdirectory
|
global
tbsearchpath
|
set
tbsearchpath=[]
|
append(tbsearchpath,
the applicationPath & "media\")
|
append(the
searchpaths, the applicationPath & "media")
|
end
startup |
You can safely put your Media files in the "media" subdirectory (C:\myproj\media
in the example above) and the Xtra will automatically find them when
the Projector starts.