RSX 3D  Contents  Interfaces  Data Structures  Previous  Next

Registry Settings

Registry settings control how your computer runs. Your computer system and each application that you run has a set of registry keys.

Table 1 lists the RSX 3D registry values and provides a data type, range of valid values, and a description for each.

You can use one of these means to change registry keys:

You may want to dynamically change registry settings if you plan to run your application/game in full-screen mode, or if you are debugging your program.

NOTE. When your application is in full-screen mode, the only way to dynamically change registry settings is through your application, because the other options are not visible and accessible.


Table 1. RSX 3D Registry Values

Registry Value Type Values Description
NumWaveBuffers1
(not valid for DirectSound)
DWORD 2 - 7 Number of buffers to use when writing to a WAVE API. If the device type is Wave and audio breaks up, increase this value.
Device Type1 STRING "directsound" or "wave" Default audio output device: DirectSound or WAVE. If RSX 3D cannot play to the default device, it tries the other device.
Buffersize1 DWORD 20 - 400
Default=120
Number of milliseconds of buffering used by the direct listener. If audio breaks up, increase this value.
RSXToolPath2 STRING pathname Full path name of RSX 3D Tray applet (for example, C:\windows\system\rsxtool.exe).
Debug Level2 DWORD 0 - 5 Level of debug output to generate.
0 = Level 0, turn all debug messages off
1 = Level 1, output error messages only to debug window
4 = Level 4, output detailed report to file (the file is rsxdebug.log in your TEMP dir)
5 = Level 5, output highly detailed report to debug window
Peripheral3 DWORD 0, 1 Current audio peripheral.
0 = Stereo Speakers
1 = Headphones
MidiID4 DWORD 0 to n Contains the ID of the MIDI device to use when rendering MIDI files through RSX 3D.
Cache Time5 DWORD > or = 1
Default=3
Specifies the default cache time (in seconds) to use when playing cached emitters. If the emitter resides on a slow CD-ROM or network drive and audio breaks up, increase this value.
Device Format1 DWORD 0 - 15 Specifies the default output to use to open a direct listener.
1 = 8 KHz, 8-bit stereo
2 = 8 KHz, 16-bit monaural
3 = 8 KHz, 16-bit stereo
4 = 11 KHz, 8-bit monaural
5 = 11 KHz, 8-bit stereo
6 = 11 KHz, 16-bit monaural
7 = 11 KHz, 16-bit stereo
8 = 22 KHz, 8-bit monaural
9 = 22 KHz, 8-bit stereo
10 = 22 KHz, 16-bit monaural
11 = 22 KHz, 16-bit stereo
12 = 44 KHz, 8-bit monaural
13 = 44 KHz, 8-bit stereo
14 = 44 KHz, 16-bit monaural
15 = 44 KHz, 16-bit stereo
NOMMX DWORD 0, 1 On computers with MMX(TM) technology this key enables you to disable the MMX(TM) optimized instructions.
0 = Use MMX(TM) optimized instructions.
1 = Do not use MMX(TM) optimized instructions.
Data STRING valid filename The name of the RSX 3D Data library. This is the name of the DLL containing the 3D Audio data. It must be in the same directory as rsx.dll. Default name is "rsxdata.dll".
Clip DWORD 0, 1 0 = no clipping
1 = clipping turned on
This key only applies to computers without MMX(TM) technology. For computers featuring MMX(TM) technology - clipping is always turned on.
True3D DWORD 0, 1 0 = True 3D sound off
1 = True 3D sound on
The RSX 3D tray applet uses this key.

Notes:

1 To dynamically change the value of this registry key while RSX 3D is running, change the registry value, release (destroy) the current direct listener, and then create a new one.

2 To change the value of this registry key, release RSX 3D and then recreate it.

3 You can change peripherals while RSX 3D is running. See Section B.1.4 for instructions.

4 If this value changes while RSX 3D is running, each MIDI-based cached emitter created after the registry value changes will use the newly specified MIDI device.

5 If this value changes while RSX 3D is running, each emitter created after the registry value changes will have the new cache time.


Using the Registry Editor to Change Registry Settings

To access the Registry Editor from Windows 95, click Start and then select Run from the Windows menu. The Run applet window opens. Use the options in this window to locate and run regedit. On other systems, run WINDOWS\regedit.exe.

When you invoke regedit, the Registry Edit window opens. One side of this window contains a registry list, the other contains the corresponding registry key values. Work your way down the registry list until you reach the 2.0 registry key. The registry key is as follows:

HKEY_LOCAL_MACHINE\SOFTWARE\Intel\Realistic Sound Experience\2.0.  

When you click the 2.0 registry folder, the current registry key values appear on the right pane of the Registry Edit window.

Typical system registry settings for RSX are:

(Default)		(value not set)
Buffersize		0x00000078 (120)
Debug Level		0x00000000 (0)
Device Type		"directsound"
NumWaveBuffers		0x00000003 (3)
Peripheral		0x00000001 (1)
RSXToolPath		"C\RSX2\rsxtool.exe"

NOTE. There is no restore option on this dialog.

Enter new values for the values you want to change.


Using the Configuration Utility to Change Registry Settings

To use the Configuration Utility to change some of the registry settings, either open the Intel RSX 3D folder on your Start menu and select Configuration, or locate and run Rsxconfg.exe (which the installation copies into your RSX3D\BIN directory). You can change Buffersize, cache times, MidiID, and peripherals from the Configuration Utility. See Installing and Configuring RSX 3D for specific instructions. You can also change peripherals from the Tray applet.


Using the Tray Headphone Icon to Change Registry Settings

To change peripherals when your application is running with RSX 3D, click the headphone icon that appears in the task tray in the lower-right corner of your application window. A dialog opens that allows you to switch between speakers and headphones.

Figure 1. Headphone Icon on Tray


Changing RSX 3D Settings from Your Application

While RSX 3D is running with your application, you can change registry settings for peripherals:

  1. Create and open an event named RSXRegChange. This returns a handle to an auto-reset event.
  2. Update the registry with the new values.
  3. Signal the event. When RSX 3D receives the signal, it updates the settings. RSX 3D automatically resets the event.
  4. Close the handle to the event when you finish using it.

The following code demonstrates how to change peripherals from your application:

// registry keys
#define RSX20_REG_KEY "SOFTWARE\\Intel\\Realistic Sound Experience\\2.0"
#define RSX20_PERIPHERAL_VALUE	"Peripheral"	

// Function prototypes
HRESULT ChangeRSXRegistry(DWORD);
HRESULT OnPeripheralChange(DWORD);

// global handle to an event
HANDLE g_hRSXEvent = NULL;

// The following code should be exectued on initialization
// i.e in WinMain or the constructor for a class...
//
// The name of the event: RSXRegChange must not be changed
//

// begin initialization code
g_hRSXEvent  = CreateEvent (NULL, FALSE, FALSE, "RSXRegChange");

if(g_hRSXEvent  == NULL) {
    OutputDebugString("Error creating RSX Registry event");
    // do error processing
} // endif

// end initialization code

 


RSX 3D  Contents  Interfaces  Data Structures  Previous  Next

Copyright ©1996, 1997 Intel Corporation. All rights reserved