home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac_os2 / playos2.zip / README.OS2 < prev   
Text File  |  1996-04-23  |  3KB  |  86 lines
  1. This is version 0.9 beta of maplay for OS/2.
  2.  
  3. While it works in both of the machines I was able to test it, I don't know
  4. if it works in anything else.
  5.  
  6.  
  7.  
  8. usage: maplay [-v] [-s] [-l] [-r] [-p] [-d] [-c] [-f ushort] filename
  9.   filename   filename of a MPEG audio stream
  10.   -v         verbose mode
  11.   -s         write pcm samples to 'testout.raw'
  12.   -l         decode only the left channel
  13.   -r         decode only the right channel
  14.   -p         do NOT raise priority
  15.   -d         print debug information
  16.   -c         check for filter range violations
  17.   -f ushort  use this scalefactor instead of the default value 32768
  18.  
  19.  
  20.  
  21. Debug output format:
  22.  
  23. Most of debug output is several lines like this one:
  24. in 46080 bytes: rr......rr
  25. The first number is number of bytes entered to ringbuffer. the last 10
  26. letters represents state of playback ringbuffer before it.
  27. '_' is empty
  28. 'r' is ready for playing
  29. '.' has been used
  30. 'P' has been partly used
  31.  
  32. Normally most of them should be 'r'. If you are using switch '-p' and do
  33. something processor intensive, you may see more '.'s. Full buffer will hold
  34. 2.5 seconds of stereo or 5 seconds of mono audio, so little interrupts
  35. shouldn't cause problems. If your machine is fast enough, you should use
  36. '-p' switch, because raising maplay/2 priority to timecritical causes
  37. jerkiness in everything else.
  38.  
  39.  
  40. Credits:
  41.  
  42. Maplay/2 is based on maplay 1.2 sources Copyright (C) 1993, 1994
  43. Tobias Bading (bading@cs.tu-berlin.de).
  44.  
  45. MMPM/2 API functions were made using mm4emx 1.0 by Marc E.E. van Woerkom
  46. (marc_van-woerkom@ac3.maus.de).
  47.  
  48. Maplay/2 was compiled with emx.
  49.  
  50.  
  51. maplay 1.2 can be found in
  52. ftp://bigblue.pvv.unit.no/store/store/ernie/maplay/maplay1_2.tar.Z
  53.  
  54. mm4emx can be found in
  55. ftp://ftp.leo.org/pub/comp/os2/gnu/emx+gcc/contrib/mm4emx10.zip
  56.  
  57. MMPM/2 API information can be found at
  58. http://www.austin.ibm.com/os2games/
  59.  
  60.  
  61. Sources:
  62.  
  63. I didn't include sources in this beta relase because I had to modify some
  64. parts of maplay 1.2 sources rather heavily, and they need tidying up before
  65. I dare to relase them.
  66.  
  67.  
  68. Plea for help:
  69.  
  70. If anyone knows a good way to play huge sample (=like decompressed mpeg-2
  71. audio ;-) using MMPM, please contact me. I had to use rather dubious methods
  72. in starting, maintaining and ending audio stream ;-)
  73.  
  74. Bugs:
  75.  
  76. Report any to me (timo.jantunen@hut.fi or jeti@niksula.cs.hut.fi).
  77.  
  78.  
  79. Legal stuff:
  80.  
  81. This program is free. You are also free to use or not to use it, but I'm
  82. not responsible of any damage it may cause. Do NOT make money with this
  83. program, change copyright information or distribute it without files
  84. README, README.OS2, README.1ST and COPYING.
  85.  
  86.