home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / graphics / directx / dsshow / readme.txt < prev    next >
Encoding:
Text File  |  1997-07-15  |  2.0 KB  |  37 lines
  1. DirectSound Mixing Test (dsshow)
  2. --------------------------------
  3.  
  4. This app allows the user to play with most of the controls exposed by
  5. DirectSoundBuffers, including the mixing of multiple sounds, and changing
  6. frequency, pan, and volume of those sounds.
  7.  
  8. Open one or more .wav files using the File.Open dialog.  A control bar will
  9. be displayed for each file opened.  Dsshow uses static buffers for its sounds
  10. and is therefore designed for short sounds only.  If you try to open a file
  11. that is very large, you will run out of system memory - beware!
  12.  
  13. The control bar for each sound contains a bunch of things.  First, the file
  14. name is displayed at the top.  The next line states whether the buffer is
  15. mixed in software (SW) or hardware (HW), and whether the buffer is playing
  16. or stopped.  Dsshow will put buffers in hardware whenever possible.  On the
  17. next two lines, the current play and write cursors are displayed.  They are
  18. updated every half second or so.  Then there are sliders to control the
  19. buffers frequency, pan, and volume settings.  At the bottom, there is a
  20. Play/Stop button (it morphs back and forth, try it!) and a Close button (to
  21. delete the file from the view), and a checkbox for Looping.
  22.  
  23. The dsshow title bar tells you information about the hardware mixing
  24. capabilities of your sound card.  It displays the number of free hw mixing
  25. channels and hw memory (if you have an ISA card like most people).  If both
  26. of those numbers are 0, your card does not have hardware mixing.
  27.  
  28. There are also two interesting things you can do from the Options menu.
  29. First, you can set the format of the primary buffer by selecting
  30. Options.Output Type.  This will list the formats supported by the primary
  31. buffer, and let you choose one.  Also, you can toggle Options.Enumerate Drivers
  32. which will show you what objects DirectSoundEnumerate will list for you,
  33. and allow you to select one.  This only happens when you start up Dsshow,
  34. so to see the effect, select this menu item, exit Dsshow, and then run Dsshow
  35. again.
  36.  
  37.