CD Prep
Creating an auto-starting CD for Vox Proxy slide shows

Introduction......................................................................................................................................................... 1
Presentation Guidelines..................................................................................................................................... 1
Support for PowerPoint 97 and Viewer............................................................................................................ 2
Minimum System Requirements for Playback
............................................................................................... 3
How the CD will run........................................................................................................................................... 3
Users with NT, Windows 2000, and Windows XP........................................................................................ 5
Running the CD Prep program.......................................................................................................................... 5

1. CD Layout..................................................................................................................................... 5
2. CD Image folder.......................................................................................................................... 6
3. Single presentation or menu...................................................................................................... 6
4. Menu builder................................................................................................................................ 6
5. Files................................................................................................................................................ 7
6. Characters..................................................................................................................................... 8
7. Languages.................................................................................................................................... 9
8. Info file.......................................................................................................................................... 9
9. Author file................................................................................................................................... 10
10. Startup Message and Copyright notice............................................................................... 10
11. Finish.......................................................................................................................................... 11

Creating the CD............................................................................................................................................... 12
CD Diagnostics............................................................................................................................................... 12

INTRODUCTION

The purpose of the CD Prep program is to create a CD-R which will auto-start on an end-user's computer and run slide shows which include Vox Proxy scripts without requiring the user to have first installed the Vox Proxy Player. The CD Prep program creates a "CD image" folder on your hard drive which contains all of the files and folders to be placed on the CD. You will use your CD-burner software to copy those files and folders to the CD.

The Vox Proxy CD Prep program supports running PowerPoint presentations and/or Vox Proxy Script Macros. If the user does not have PowerPoint, it will install the PowerPoint 97 Viewer.

This program requires that you have version 1.12 of Vox Proxy (or newer). Check your version from Script Writer/Help/About Vox Proxy.

Please be aware that there are many issues involving the end-user's computer and configuration which could cause the presentations on the CD not to work properly. Some of those are discussed below.

You should also be aware that the CD you will distribute is not a zero-footprint application. Although your presentation files and the Vox Proxy application software are not installed on the user's computer, there are certain speech components and Microsoft Agent files that are. See the installation details below for more information about what is installed on the end-user's computer.

Presentation Guidelines

When preparing a presentation and Vox Proxy scripts for delivery on a CD, it is very important that any files used in the presentation (such as media files) will be locatable on the CD. This generally means that you cannot "hard-code" the location (the directory path) of any files, because you do not know what the end-user's CD drive letter will be.

Vox Proxy provides several "variables" for this purpose:

&DiskDrive – The drive where the CD is playing. Example: “D:”
&folder – The folder where your Vox Proxy program files are located.
This corresponds to "\program files\vox proxy" on your system.
&media – Vox Proxy's media folder. This corresponds to:
"\program files\vox proxy\media" on your system.
&tempdir The windows temp folder on the end-user’s computer (where the CD is playing). Any files listed in the “temp” folder on the CD will be copied into this folder when the CD starts and deleted when the CD ends.
&presentations – Vox Proxy's presentations folder. This corresponds to:
"\program files\vox proxy\presentations" on your system.
&winfolder – The windows folder on the computer where the CD is playing.
&pptpath – The folder where the PowerPoint presentation resides on the computer where the CD is playing. This would normally be: &DiskDrive\presentations

EXAMPLE:
If you play an audio file (let's say "applause.wav"), rather than entering the "PlayWav" command in your script as follows:
PlayWav c:\program files\Vox Proxy\media\applause.wav

You should instead enter it as:
PlayWav &media\applause.wav

This syntax ensures that it will work not only on YOUR computer, but also from the CD (or from anyone else's computer who has installed the Vox Proxy Player). It is good practice to always use these variables in your scripts rather than "hard-coding" file locations.

Support for PowerPoint 97 and Viewer

Presentations run on the CD can support PowerPoint 97 or even the PowerPoint Viewer. Vox Proxy scripts, however, cannot be accessed from within the presentation file by these programs. Therefore, it is necessary for you to create a separate file containing the scripts. For each presentation file, run "Export to file" on the Tools menu of the Script Writer. That will create a script file in the same location as the presentation file. The name of the file will also be the same except that the file extension will be "VPS".

When you create the CD Image, the CDPrep program will automatically look for VPS files accompanying any PPT or PPS files and copy them into the "presentations" folder.

When the end user starts the CD, the software will detect whether the user's computer has access to PowerPoint. If not, it will offer to install the PowerPoint Viewer, which is included on the CD in the setup file "ppview97.exe".

The author should be aware that each version of PowerPoint has many features which are not supported in prior versions. You must design your presentations accordingly if you want them to work properly with all versions. The PowerPoint Viewer supports only features available in PowerPoint 97.

One important feature of Vox Proxy will not work in PowerPoint 97 (or the Viewer): the WaitforClick command. As an alternative to WaitforClick, split your slide into duplicate slides at the points where you want to wait for a click.

In addition, the PowerPoint Viewer does not support slide ID numbers. In order to work in the Viewer, be sure to use slide numbers rather than slide ID numbers in your “GotoSlide” commands.

Minimum System Requirements for Playback

The computer on which the CD will be played must have Windows 95, 98, ME, NT 4.0, 2000 Professional, or XP. It will NOT play correctly under Windows 3.1. Other minimum requirements:
Disk space: 4MB plus the size of any characters you include
Recommended:
RAM: 64MB for Windows 95, 98, ME; 128MB for NT, 2000, XP
CPU: 300MHz or faster

How the CD will run

When the end-user inserts the CD in a drive, and assuming that the user has not turned off the auto-start feature of their drive in Windows, the CD will autostart and perform the following operations.

First, a window will be displayed giving the user an opportunity to continue or abort and quit the CD.

At this point, no installation information has been checked. The user may display your "Author" and "Info" files, where you can explain what's on the CD and provide contact information, instructions, or other materials.

If the user clicks No, the program will terminate.

If the user clicks Yes, Vox Proxy will start and run from the CD. It will first check the user's computer for the following items, install if necessary, and copy certain files. Neither the Vox Proxy software nor your presentation files will be installed to the end-user's computer, but will actually run from the CD. Certain Microsoft Agent and speech features, however, must be installed on the user's computer. These include the Agent control (which is pre-installed on almost all versions of Windows), any Text-To-Speech engines needed, and the character files. The space needed on the user's computer is minimal, a little more than the size of the character files you are using.

During the installation process, the user will see the following:

This indicates that the software is checking for necessary speech and Agent components and will install whatever it needs, as follows:

  1. Microsoft Speech API version 4. If not found, it will install from the file "spchapi.exe". The speech API is normally installed on any Windows system containing a sound card. See the notes below for Windows XP.
  2. Microsoft Agent control. If not found, it will install from the file "msagent.exe". This should almost never happen, because the agent control has been a standard feature in Windows since at least Win-98.
  3. Languages (TTS engines). Checks for the TTS engines which you have specified in the CD Prep program. Installs if necessary from the files included in your setup. This will usually be necessary, because the "TruVoice" TTS used by all of Vox Proxy's standard characters does not come pre-installed in Windows. The setup file for TruVoice is "tv_enua.exe". For other languages, the setup files begin with "lstts" and "agtx".
  4. Speech Recognition Engine. Installs only if you need it, according to your setup. If installed, the setup file is "actcnc.exe".
  5. Character files: copies onto the user's hard drive any character files which you have selected in your setup. These files are identified by the file extension "ACS" and are copied into the folder:
    \windows\msagent\chars (for Windows 95, 98, and ME)
    or
    \WINNT\msagent\chars (for Windows NT, 2000, and XP)

Vox Proxy will start PowerPoint and display your menu of presentations or, if you have configured it for only a single presentation, open your presentation file from the CD, and start the slide show. A sample menu showing four presentations is illustrated here:

When the presentation is complete, Vox Proxy will return to your presentation menu. PowerPoint will remain open on the end-user's computer. If you have specified only a single presentation, there will be no menu and the program will terminate.

If the same user either reruns the CD or runs other CDs from you in the future, they will start much faster because the Agent and TTS files will have already been installed.

Users with NT, Windows 2000, and Windows XP

On systems where it is necessary to install any speech components (as described above in "How the CD will run"), the user must have administrator rights to permit those installations. On Windows 95, 98, and ME, those rights are always available, but on NT, 2000, and XP, they may or may not be. In labeling your CD, and in any user documentation included with your CD, you should make it clear that the user should have administrator rights in order to run the CD.

Note that these installations are required only the first time the CD is played. Any subsequent playing can be done without administrator rights. Subsequent CDs which you send out will also not require administrative rights unless you include a TTS engine not included on a previous CD.

Windows XP contains a new version of the Microsoft speech API (version 5) which is not backward compatible, and is not compatible with the speech supported by Microsoft Agent (version 4). Vox Proxy's CD Prep program will automatically install version 4. Windows will support both versions concurrently without conflict. However, some XP users report that the speech will not work until the computer is rebooted. If users report that your presentations run and the characters appear but do not speak, you should advise them to reboot and reinsert the CD.

Running the CD Prep Program

The CD Prep Wizard will guide you through each step of the process needed to create a "CD Image Folder" containing all of the files necessary for an auto-starting CD. You may click "Back" or "Next" at any time to review previous information entered. You can also jump to a specific page by clicking on the View menu item.

On any page of the CD Prep Wizard, you may have Paul give you a brief description of the information required on that page by pressing the "Talk to me" button.

1. CD Layout

When you run the CD Prep program, you are determining the "layout" of the CD, including files, menu information, and documentation. At the finish of this process, you will be asked for a "layout name". All of the information about the CD layout will be saved under this name. In the future, if you want to modify the layout and re-create it, you can open the layout by clicking File/Open.

2. CD "image" folder
When you finish setting up a CD layout, the actual files and data are saved in a folder called the "CD Image folder" on your hard drive. You will then use your CD-R burner software to copy the contents of this image folder onto the CD. If you specify an existing folder name, the program will not delete the contents of this folder when it copies the CD layout files into it, so you should be sure that it does not contain extraneous files or sub-folders which you don't want on the CD.

3. Single Presentation or Menu
Specify here whether the CD will contain only a single presentation or multiple presentations. For a single presentation, select the presentation file here. When the CD starts, the slide show will automatically start and run. When it is finished, the program will terminate.

For multiple presentations, you will create a menu which will be displayed to the user. After each presentation is played, the menu will reappear.

4. Menu Builder
If the CD will contain multiple presentations, this is where you build the menu which the user will see and which will control the files to be played.

For each presentation on the menu, you must specify three items:

1.        The Menu text.

2.        The presentation file. This can be either a PowerPoint file (.ppt or .pps) or a Vox Proxy script macro file (VPs).

3.        Description. This description will be shown to the user when the presentation is selected on the user menu.

5. Files
There may be a number of files needed on the CD other than the presentation files themselves. Here, you may list four kinds of files to be included on the CD:

PowerPoint presentations. This may include ".pps" or ".ppt" files. Do NOT include files already specified on the Menu Builder. You may, however, include PowerPoint slide shows which are run from a script macro. All of these files will be placed in the "presentations" folder on the CD.

Script Macros. Include any Vox Proxy script macros here. These files must have the extension ".vpm". They will be placed in the "macros" folder on the CD.

Media files. Include any media files which are called in your script macros and are not embedded in a PowerPoint presentation. Any files compatible with Microsoft Media Player can be included. These files will be placed in the "media" folder on the CD.

Temp files. Any files listed here will be copied to the “temp” folder on the end-user’s hard drive. When the presentation is complete, these files will be deleted from the user’s hard drive. This feature allows media or files to be rapidly accessed during the presentation. Files accessed from the CD drive can be slow to load after the drive stops spinning. If you use media files copied here, be sure to use the variable &tempdir rather than &media in your script.

Other files. Any ancillary files may be included here. They will be placed in the "other" folder on the CD.

When selecting files, you can drag-and-drop files displayed by the "Browse" button or from Windows Explorer.

6. Characters
On this page, select the characters which you will need on the CD. Paul is always preselected even if you don't need him. Character files will be copied onto the user's hard drive.


7. Languages
The language page appears similar the the characters page shown above, but lists all of the languages included with Vox Proxy. Select the languages which are used in your scripts. Languages determines the Text-To-Speech engines which must be installed on the user's computer. Most characters require the U.S. English language by default. Do not select any languages which you do not actually need, because their installation slows down the CD startup.

8. Info File
The "Info file" is an optional HTML, RTF, or text file which will be displayed when the user presses the "CD Info" button on the CD menu. You must create this file in a text or html editor. HTML or RTF offers nicer display formatting than plain text files. For RTF or text, you can create the file using Wordpad. For HTML, you may use any html editor. If you use an HTML file, you can include picture files or other hyperlinked HTML files. Any such "support files" must either be in the same directory as the html file or in a sub-directory.

After specifying the files, you can see exactly what the user will see by clicking on the "Info" button.

9. Author

You may designate a file similar to the "Info" file described above for the purpose of identifying the author(s) of your presentations. Like the Info file, this can be an HTML, RTF, or text file.

10. CD Startup Message & Copyright

When the CD auto-starts, it displays a dialog box to the user allowing him/her to continue with the autostart or not. Copyright messages are displayed on this screen, which appears similar to the following:

You may edit or replace the startup message an the copyright notice, up to “Uses Vox Proxy.”

11. Finish
When you click "Finish" on the final page of the CD Prep Wizard, you will be ready to create the actual "CD Image" files. First, if you have not yet named the CD layout, you will be asked to provide a name. The program will then proceed to create the CD Image and copy all of your relevant files to the appropriate folders.

Creating the CD

After finishing the CD Prep process, you will have a directory, called the "CD Image Folder" containing all of the files and folders needed to create the auto-starting CD.

Use your CD-writer software to copy the entire contents of this folder, including its sub-folders, to the CD-R. When done, check the contents of the CD using Windows Explorer. In the root directory of the CD, you should see at least the following folders and files:

CD Diagnostics

After creating the CD, you can run a diagnostics check on it from the tools menu of CD Prep. The results of the diagnostic check will look something like the following: