RSX 3D  Contents  Interfaces  Data Structures  Previous  Next

Redistributing RSX 3D

If you are planning to ship RSX 3D with your application, please consult the release notes on licensing issues.

The following topics describe the files and process you need to follow to redistribute RSX 3D with your application.


Run-time Installation Files

The RSX 3D SDK installation puts the files you need for redistributing run-time RSX 3D in your RSX3D\SAMSETUP\DISK1 directory. Copy files from this directory to your delivery medium and add instructions to your application's InstallShield 3.0 script.

The RSX 3D InstallShield run-time installation consists of the following files:

rsx.ins
InstallShield script to install RSX.
 
rsx.z
Core files for RSX 3D.
 
rsxredis.z
Required redistributable files for RSX 3D. (These files are optional only if you are already shipping msvcrt40.dll with your application.)

The RSX 3D run-time install expands rsx.z and installs these files on your end user's system:

rsx.dll
RSX 3D audio library.
 
rsxdata.dll
RSX 3D audio data library.
 
aaudio.dll
Support for the RSX 1.0 API.
 
RSXConfg.exe
RSX Configuration and Diagnostic Utility
 
RSXConfg.hlp
Configuration Utility help file.
 
button.mid
MIDI test file for Configuration Utility.
 
RSXTool.exe
Tray applet for easy switching of audio peripherals.
 
RSXTool.hlp
Help file for tray applet.

The install may also install file(s) from rsxredis.z into the WINDOWS\SYSTEM directory:

msvcrt40.dll
C run-time library.

NOTE. If you are shipping the same version (or a newer version) of msvcrt40.dll with your application, you can decrease the size of the RSX 3D installation by not including the file: rsxredis.z.

The RSX 3D run-time install creates a folder called Intel RSX 3D with icons and shortcuts to the following:

RSXConfg.exe
RSX configuration/diagnostic utility.
 
Uninst.exe
Uninstall executable. This executable resides in the WINDOWS\SYSTEM directory. The run-time install only adds the RSX icon on systems running Windows NT, version 3.51.

Installing the Run-time Files with InstallShield

To install the RSX 3D run-time files, you must use InstallShield 3.0. The RSX 3D run-time components always install to DRIVE:\RSX2 where DRIVE is the drive letter where Windows is installed.

Add the following lines to your application's InstallShield script to install RSX 3D:

if(DoInstall(rsx.ins, "SILENT", WAIT) != 0) then
MessageBox("An error occurred trying to begin the RSX installation",
WARNING);endif;

The first parameter in the DoInstall function, rsx.ins, is the filename of the RSX 3D install script.

The second parameter in the DoInstall function, "SILENT" represents the command-line options to use for launching the RSX run-time install. The SILENT option suppresses display of dialog boxes or splash screens. The third parameter, WAIT, halts your installation program until the RSX 3D installation finishes.

NOTE. Calling the install script, as described above, is different from using the InstallShield Silent mode specified with -s. Our silent mode offers the advantage of displaying error messages in the event of a failure.

If you do not invoke the RSX 3D run-time install with the SILENT option, the installation uses its own user interface.

IMPORTANT: If you use an InstallShield packing list file (setup.pkg) in your installation, ensure that the source file (setup.lst) includes the files rsx.z and rsxredis.z (if you are using this file).


Installing the Run-time Files without using InstallShield

If you do not wish to use the RSX 3D Installshield runtime installation you may use our standalone RSX 3D runtime installation program. The two (2) files required for this installation can be found in the \rtsetup directory under the directory you installed the RSX SDK into. The install program is rsxsetup.exe and the RSX uninstall program is rsxunins.exe.

To install RSX 3D:

From the installation program for your application simply copy the following files to the user's local hard disk - preferably into their TEMP directory.

  1. rsxsetup.exe
  2. rsxunins.exe
  3. rsx.dll
  4. aaudio.dll
  5. rsxdata.dll
  6. rsxtool.exe
  7. rsxtool.hlp
  8. msvcrt40.dll (Optional if you are already installing this file as part of the installation of your application)
  9. rsxconfg.exe
  10. rsxconfg.hlp
  11. button.mid
  12. license.txt

You may wish to compress these files in your installation and then decompress them onto the user's local hard drive. After the files have been copied to the user's local hard drive run the program rsxsetup.exe (the copy residing in the user's TEMP directory. This program will install RSX 3D and it will also clean up all of the above files (1-12) from the users's TEMP directory.

 

RSX 3D  Contents  Interfaces  Data Structures  Previous  Next

Copyright ©1996, 1997 Intel Corporation. All rights reserved