Click here to Skip to main content
15,867,568 members
Articles / Operating Systems / Windows

Playing a Sound from a J# Application using DirectX9

Rate me:
Please Sign up or sign in to vote.
4.08/5 (5 votes)
21 Nov 20044 min read 80.1K   20   10
This introductory article will show you how to play a sound using DirectX9 from a J# application

Introduction

All cool applications have sound effects. Your J# applications should be no exception, whether they are migrated from Sun Java to .NET or they are completely new J# applications. It is very easy to play sounds from a .NET application using the DirectX 9 libraries. This article will show you how to do this.

Step 1: Install the DirectX 9 SDK

The first step is to install the DirectX9 SDK on the development computer. Go to the DirectX 9 download web site, and grab the latest SDK and install it.

The Direct X 9 download page:

When this article was written, the latest SDK was the October 2004 update.
http://www.microsoft.com/downloads/details.aspx?FamilyId=B7BC31FA-2DF1-44FD-95A4-C2555446AED4&displaylang=en

Step 2: Download the DirectX 9 Redistributable for Client Computers

All client computers that want to run your J# DirectX9 application must have the DirectX9 runtime libraries installed (just like they must have the J# runtime libraries to run J# applications). These libraries are usually installed through the Windows Update, but if your client does not have an internet access, you can provide the redistributable DirectX9 install package with your application. You will find the latest redistributable package on the DirectX 9 download page.

The DirectX 9 download page:

When this article was written, the latest redistributable was the October 2004 edition:
http://www.microsoft.com/downloads/details.aspx?FamilyId=143EF8C6-CFF7-4AF0-209-1CDF49C58BC0&displaylang=en

Step 3: Make the J# Application

After installing the DirectX9 SDK, open Visual Studio and open a new J# application.

Add a Reference to Microsoft.DirectX.DirectSound

In Visual Studio, choose the “Project” and “Add Reference…” in the menu. Add a reference to Microsoft.DirectX.DirectSound in the .NET tab.

Image 1

Give Me Sound!

To gain performance, DirectX uses buffers to play sounds on hardware sound devices. This means you have to load the sounds into buffers before any hardware devices can play them. Hardware devices are accessed through a Microsoft.DirectX.DirectSound.Device class instance. A buffer instance is made of the Microsoft.DirectX.DirectSound.SecondaryBuffer class. The sound device on your computer is normally shared between different applications. You control how the sound in your application will behave with other running applications through setting a CooperativeLevel on the device instance.

The complete code will look like this:

J#
// Setup the sound device
Microsoft.DirectX.DirectSound.Device dev = 
    new Microsoft.DirectX.DirectSound.Device();

dev.SetCooperativeLevel( this, 
  Microsoft.DirectX.DirectSound.CooperativeLevel.Normal );

// Setup a buffer to hold the sound
Microsoft.DirectX.DirectSound.SecondaryBuffer snd = 
    new Microsoft.DirectX.DirectSound.SecondaryBuffer( 
      "your_sound_file.wav", dev );

// Play the sound
snd.Play( 0, Microsoft.DirectX.DirectSound.BufferPlayFlags.Default );

This code will play a sound file called “your_sound_file.wav”.

Do We Have More Config Options?

Yes, they are accessed through an instance of the Microsoft.DirectX.DirectSound.BufferDescription class you pass as an argument to the buffer.

Mute When Switching Applications

Did you notice the sound did not play if you switched to another application? To enable the sound all the time, set the GlobalFocus property to true.

J#
Microsoft.DirectX.DirectSound.Device dev = 
    new Microsoft.DirectX.DirectSound.Device();

dev.SetCooperativeLevel( this, 
  Microsoft.DirectX.DirectSound.CooperativeLevel.Normal );
        
Microsoft.DirectX.DirectSound.BufferDescription dsc = 
    new Microsoft.DirectX.DirectSound.BufferDescription();

dsc.set_GlobalFocus( false );

Microsoft.DirectX.DirectSound.SecondaryBuffer snd = 
    new Microsoft.DirectX.DirectSound.SecondaryBuffer( 
      "your_sound_file.wav", dev );

snd.Play( 0, Microsoft.DirectX.DirectSound.BufferPlayFlags.Default );

Hardware / Software Buffers

You can force the sound to be loaded into the hardware device buffer by setting the LocateInHardware property to true. However, if the hardware does not support this option, the call will fail. Equally, you can force the sound to be loaded into a software buffer with setting the LocateInSoftware property to true;

J#
Microsoft.DirectX.DirectSound.Device dev = 
    new Microsoft.DirectX.DirectSound.Device();

dev.SetCooperativeLevel( this, 
  Microsoft.DirectX.DirectSound.CooperativeLevel.Normal );
        
Microsoft.DirectX.DirectSound.BufferDescription dsc = 
    new Microsoft.DirectX.DirectSound.BufferDescription();

dsc.set_GlobalFocus( false );

// dsc.set_LocateInHardware( true );
dsc.set_LocateInSoftware( true );

Microsoft.DirectX.DirectSound.SecondaryBuffer snd = 
    new Microsoft.DirectX.DirectSound.SecondaryBuffer( 
    "your_sound_file.wav", dev );

snd.Play( 0, Microsoft.DirectX.DirectSound.BufferPlayFlags.Default );

How to Control the Sound Volume

If you want to change the sound volume, first enable the volume control on the buffer description instance. Second, you can control the volume with the volume property on the sound buffer instance. 0 is full volume, -10000 is mute.

J#
Microsoft.DirectX.DirectSound.Device dev = 
    new Microsoft.DirectX.DirectSound.Device();

dev.SetCooperativeLevel( this, 
  Microsoft.DirectX.DirectSound.CooperativeLevel.Normal );
        
Microsoft.DirectX.DirectSound.BufferDescription dsc = 
    new Microsoft.DirectX.DirectSound.BufferDescription();

dsc.set_ControlVolume( true );

Microsoft.DirectX.DirectSound.SecondaryBuffer snd = 
    new Microsoft.DirectX.DirectSound.SecondaryBuffer( 
    "your_sound_file.wav", dev );

snd.set_Volume( -2000 );

snd.Play( 0, Microsoft.DirectX.DirectSound.BufferPlayFlags.Default );

How to Control the Left – Right Balance

To change the sound balance, enable the pan property on the buffer description instance, and set the balance level with the pan property on the buffer instance. 0 gives equal amount of sound from both left and right speaker. Positive number gives more sound out of the right speaker. Negative number will give more sound from the left speaker.

J#
Microsoft.DirectX.DirectSound.Device dev = 
    new Microsoft.DirectX.DirectSound.Device();

dev.SetCooperativeLevel( this, 
  Microsoft.DirectX.DirectSound.CooperativeLevel.Normal );
        
Microsoft.DirectX.DirectSound.BufferDescription dsc = 
    new Microsoft.DirectX.DirectSound.BufferDescription();

dsc.set_LocateInSoftware( true );
dsc.set_ControlVolume( true );
dsc.set_ControlPan( true );

Microsoft.DirectX.DirectSound.SecondaryBuffer snd = 
    new Microsoft.DirectX.DirectSound.SecondaryBuffer( 
    "your_sound_file.wav", dev );

snd.set_Volume( 0 );
snd.set_Pan( 5000 );

snd.Play( 0, Microsoft.DirectX.DirectSound.BufferPlayFlags.Default );

How to Change the Frequency

You can set the frequency of the sound by enabling the control frequency property and setting the frequency on the sound buffer.

J#
Microsoft.DirectX.DirectSound.Device dev = 
    new Microsoft.DirectX.DirectSound.Device();

dev.SetCooperativeLevel( this, 
  Microsoft.DirectX.DirectSound.CooperativeLevel.Normal );
        
Microsoft.DirectX.DirectSound.BufferDescription dsc = 
    new Microsoft.DirectX.DirectSound.BufferDescription();

dsc.set_ControlFrequency( true );

Microsoft.DirectX.DirectSound.SecondaryBuffer snd = 
    new Microsoft.DirectX.DirectSound.SecondaryBuffer( 
    "your_sound_file.wav", dev );

snd.set_Frequency( 10000 );
    
snd.Play( 0, Microsoft.DirectX.DirectSound.BufferPlayFlags.Default );

References

License

This article has no explicit license attached to it, but may contain usage terms in the article text or the download files themselves. If in doubt, please contact the author via the discussion board below. A list of licenses authors might use can be found here.


Written By
Web Developer
Norway Norway
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralBufferDescription to Buffer connection Pin
Thorbjørn Jørgensen26-Mar-07 13:28
Thorbjørn Jørgensen26-Mar-07 13:28 
GeneralRe: BufferDescription to Buffer connection Pin
Thorbjørn Jørgensen26-Mar-07 13:38
Thorbjørn Jørgensen26-Mar-07 13:38 
QuestionHow to Change the output both speaker Left or Right Only Pin
aka^_^chan23-Jul-06 21:21
aka^_^chan23-Jul-06 21:21 
GeneralInstalling DirectX Pin
DipeshKhakhkhar23-Nov-04 17:24
DipeshKhakhkhar23-Nov-04 17:24 
GeneralRe: Installing DirectX Pin
Lars-Inge Tønnessen23-Nov-04 19:28
Lars-Inge Tønnessen23-Nov-04 19:28 
GeneralRe: Installing DirectX Pin
DipeshKhakhkhar23-Nov-04 20:00
DipeshKhakhkhar23-Nov-04 20:00 
GeneralRe: Installing DirectX Pin
Lars-Inge Tønnessen24-Nov-04 10:22
Lars-Inge Tønnessen24-Nov-04 10:22 
GeneralRe: Installing DirectX Pin
DipeshKhakhkhar24-Nov-04 13:29
DipeshKhakhkhar24-Nov-04 13:29 
GeneralRe: Installing DirectX Pin
DipeshKhakhkhar24-Nov-04 13:32
DipeshKhakhkhar24-Nov-04 13:32 
GeneralRe: Installing DirectX Pin
Lars-Inge Tønnessen27-Nov-04 1:57
Lars-Inge Tønnessen27-Nov-04 1:57 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.