RSX 3D  Contents  Interfaces  Data Structures  Previous  Next

Installing and Configuring RSX 3D

The topics presented here describe the contents of the RSX 3D Software Developer's Kit, the system requirements, the supported operating systems, and the licensing requirements. They also provide notes about the installation and describe how to set up, configure, and test the RSX 3D system.

The topics discussed here are:


Deliverables

The RSX 3D Software Developer's Kit Release package contains:


System Requirements

RSX 3D requires an Intel486™ processor, 8 Megabytes RAM, a sound card, and Windows 95 or Windows NT operating system. For optimal performance, we recommend using a 90Mhz Pentium® processor with 16 Megabytes RAM.

Required

Processor - 80486 processor

Memory - 8 Megabytes

Disk Space - 5 Megabytes

Sound Card - Any

Recommended

Processor - 90Mhz Pentium® processor

Memory - 16 Megabytes

Disk Space - 25 Megabytes

Sound Card - Stereo Sound Card

Supported Operating Systems

RSX 3D supports the following operating systems:


License Definitions

The RSX 3D Software Developer's Kit license (located on the CD-ROM) applies to all of the developer tools, sample source, documentation, and licensed binaries delivered with your RSX 3D Software Developer's Kit Release package. Please read the license agreement carefully before you use this product.

If you would like to ship RSX 3D with your application, contact Intel for a commercial, redistribution license. See Redistributing RSX for details and a description of how to include RSX 3D with your application.


Software

This SDK contains the Intel RSX 3D. The RSX 3D installation copies these files onto your hard disk:

Directory/File and Description

RSX3D\readme.wri
A file that you should read before using RSX 3D. It contains useful information about RSX 3D.
 
RSX3D\license.txt
A copy of the RSX 3D license agreement.
 
RSX3D\BIN\aaudio.dll
A DLL that maps RSX 1.0 calls to RSX 3D calls.
 
RSX3D\BIN\rsx.dll
The RSX 3D audio library.
 
RSX3D\BIN\rsxdata.dll
The RSX 3D audio data library.
 
RSX3D\BIN\rsxconfg.exe
A configuration/diagnostic utility to test if RSX 3D is working.
 
RSX3D\BIN\rsxconfg.hlp
The help file for rsxconfg.exe.
 
RSX3D\BIN\rsxtool.exe
A tray applet Tray applet that allows for easy switching between audio peripherals like headphones and speakers. This applet is executed when the RSX 3D libraries are active.
 
RSX3D\BIN\rsxtool.hlp
The help file for rsxtool.exe.
 
RSX3D\BIN\DEBUG\aaudio.dll
A debug version of aaudio.dll.
 
RSX3D\BIN\DEBUG\rsx.dll
A debug version of rsx.dll.
 
RSX3D\CEXAMPLE\
The source files for the minimal C example using RSX 3D.
 
RSX3D\CEXAMPLE\RELEASE\cexample.exe
A release version of the C example.
 
RSX3D\CEXAMPLE\RELEASE\cexample.wav
The wave file used by the C example.
 
RSX3D\CPPMIN\
The source files for the minimal C++/MFC example using RSX 3D.
 
RSX3D\CPPMIN\RELEASE\cppmin.exe
A release version of the C++/MFC example.
 
RSX3D\CPPMIN\RELEASE\cppmin.wav
The wave file used by the C++/MFC example.
 
RSX3D\DOCS\
The RSX 3D Documents in HTML format.
 
RSX3D\INCLUDE\rsx.h
The required header file for all RSX 3D-based applications.
 
RSX3D\INCLUDE\version.rc
A version resource template required to build the sample applications.
  
RSX3D\STREAMEM
Streaming Emitter Sample
 
RSX3D\SLSAMPLE
Streaming Listener Sample
 
RSX3D\RTSETUP
Install/Uninstall programs
 
RSX3D\SAMSAMPLE
Sample Setup for use with InstallShield
 
RSX3D\RSXPLAY\
The source files for the RSX 3D Audio Player.
 
RSX3D\RSXPLAY\RES
The resource source files for the RSX 3D Audio Player.
 
RSX3D\RSXPLAY\RELEASE\rsxplay.exe
A release version of the RSX 3D Audio Player.
 
RSX3D\RSXPLAY\RELEASE\rsxplay.wav
The wave file used by the RSX 3D Audio Player.

IMPORTANT: Windows NT does not currently support Direct3D, which is required for the following applications.

RSX3D\CHOPPER\
The source files and the executable for the RSX 3D Chopper Sample/Demo.
 
RSX3D\CHOPPER\RES
The resource source files for the RSX 3D Chopper Sample/Demo.
 
RSX3D\CLOWN\
The executable files for the RSX 3D Clown Demo.
 
RSX3D\RSXROIDS\
The source files and the executable for the RSX 3D Asteroids Sample/Demo.
 
RSX3D\RSXROIDS\RES
The resource source files for the RSX 3D Asteroids Sample/Demo.

NOTE. The samples and demos were built and tested using Microsoft Visual C++ 4.1.


RSX 3D Web Page

Check Intel's Web page: http://www.intel.com/ial/rsx for updated information and releases.


Installation Notes

To install RSX 3D, simply insert the disc in your CD-ROM drive and follow the on-screen prompts to complete the installation. Although you may choose any name for your installation directory, the documentation refers to your top-level installation directory as RSX3D.


General Setup and Configuration

RSX 3D provides a Diagnostic utility to determine whether RSX 3D is functioning properly. When you complete an RSX 3D installation, this utility runs and verifies the installation. To access this utility at other times, either open the Intel RSX 3D folder on your Start menu and click Configuration, or locate and run Rsxconfg.exe, which the installation copies into your RSX 3D\BIN directory.

The Configuration utility provides these property pages:

 

Testing Audio Peripherals

When you invoke the Configuration Utility, the Audio Peripherals property page opens. To access this property page at other times, click the Audio Peripherals tab. This property page lets you select an audio peripheral to use with RSX 3D, test your RSX 3D Audio, adjust sound balance and volume, and access the Intel Realistic 3D Sound Experience Web page.

To select an audio peripheral, click the radio button next to the appropriate statement or press a shortcut key sequence (<Alt> plus <S>, <H> or <D>). You can listen to RSX 3D output from speakers, or headphones.

To start the RSX 3D audio test, click Test RSX 3D Audio or press <Alt><T>. RSX 3D runs several diagnostic tests (some tests require that you respond to questions) and reports the results in a pop-up message box. Figure 1 shows the options on the Audio Peripherals property page. If the RSX 3D audio tests are not successful, run the Diagnostics to find out why the RSX 3D audio tests failed.

Figure 1. Testing Audio Peripherals

To adjust the sound level, click Adjust Volume or press <Alt><A>. This opens the Microsoft Volume Control applet. (You can also access this applet by double-clicking the speaker icon on the task tray.) This applet lets you adjust slide bars to set sound balance and volume for Volume Control, MIDI, Audio CD, Line-In, and Wave-Out audio devices.

To access the Intel RSX Web page, click Go. If you have a Web browser installed, you will jump directly to our Web page. There, you will find useful information, demonstrations, utilities, installation notes, and more.

Getting Diagnostics About Your RSX Installation

Click the Diagnostics tab to bring the Diagnostics property page to the foreground. This property page lets you run tests that check the status and setup of your computer and RSX 3D Audio. Click Run Diagnostics or press <Alt><R> to start the test. The utility initializes RSX 3D, creates a direct listener and a cached emitter, asks you some questions, and reports the results of its tests in the diagnostic scroll box. Figure 2 shows the output from a diagnostic test.

Figure 2. Testing the RSX Installation

Use the arrows on the scroll bar to scroll through the entire list of diagnostic messages. To save the output messages, click Copy Output to Clipboard. You can then paste the output into a mail message or another application. You might want to do this if you encounter a problem and want to send the messages to Technical Support (e-mail: rsx@intel.com) or post a question to the RSX newsgroup (news://cs.intel.com/Intel.rsx) or (http://cs.intel.com/Intel/rsx/).

Changing Advanced Settings

There are two Advanced Settings property pages: one to use to change buffer times and another to change device settings. See Figure 3 and Figure 4. You can also change these settings from the Registry.

Buffer Times

Click the Advanced Settings - Buffer Times tab to access the property page that lets you change the size and cache time used for the audio buffers your sound device uses when communicating with RSX 3D.

Buffering for output audio device represents the length of the output buffer in units of time. Valid buffer sizes are 20 to 400 seconds. If you experience audio glitches while playing audio files, increase the buffer size. If you notice that the movement of sound is slow, try decreasing the buffer size. To reset to the default buffer size (120 seconds), click Restore Default or press <Alt><R>.

The default cached emitter cache time is represents the amount of data from file-based emitters that is pre-loaded into memory. If the cached emitter resides on a slow CD-ROM or network drive and audio breaks up, increasing the cache time value may help. Valid cache times are greater or equal to one second. To reset to the default cache time (3 seconds), click Restore Default or press <Alt><D>.

Figure 3. Advanced Settings - Buffer Times Property Page

Device Settings

Click the Advanced Settings - Device Settings tab to access the property page that lets you change the default audio device format used by a direct listener and select a MIDI device. You can also change these settings from the Registry.

The Default Format of Audio Device list contains a range of settings from the lowest quality, 8 kilohertz, 8 bit monaural, to the highest quality, 44 kilohertz, 16 bit stereo. Select a format from the list. The default is a mid-range setting of 22 kilohertz, 16 bit stereo. To reset the audio device format to the default, click Restore Default or press <Alt><R>.

The MIDI Device Selection list contains a selection of available devices. Select the device you want to use for your application from this list. Click Test or press <Alt><T> to verify that RSX 3D can play MIDI through the selected device. If the MIDI doesn't play try a different MIDI device. The default and selections available are system dependent. To reset the MIDI device to the default, click Restore Default or press <Alt><D>.

The Enable RSX 3D Tray Icon Applet for quick selection of peripherals check box allows you to turn on or off the RSX 3D Tray Icon which appears in the Windows 95 tray while RSX 3D audio is playing. Click the check box or press <Alt><E> to toggle the icon.

Figure 4. Advanced Settings - Device Settings Property Page

Finding Out About RSX 3D

Click the About RSX 3D tab to display copyright information, instructions on how to get in touch with Intel, and a scrolling screen with information about RSX 3D. See Figure 5.

Figure 5. About RSX Property Page


RSX 3D  Contents  Interfaces  Data Structures  Previous  Next

Copyright ©1996, 1997 Intel Corporation. All rights reserved