RSX 3D Contents Interfaces Data Structures Previous Next
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.
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.
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.
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
While RSX 3D is running with your application, you can change registry settings for peripherals:
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