home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac_os2 / maplay92.zip / README.OS2 < prev    next >
Text File  |  1996-06-08  |  5KB  |  137 lines
  1. This is version 0.92 of maplay for OS/2 (maplay/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. usage: maplay [-v] [-s] [-l] [-r] [-p] [-d] [-c] [-f ushort] -@ list filename[s]
  7.   filename   filename of a MPEG audio stream
  8.   -v         verbose mode
  9.   -q         quiet mode (don't print filenames, when playing multiple files)
  10.   -s         write pcm samples to 'testout.raw'
  11.   -l         decode only the left channel
  12.   -r         decode only the right channel
  13.   -p         do NOT raise priority
  14.   -d         print debug information
  15.   -c         check for filter range violations
  16.   -f ushort  use this scalefactor instead of the default value 32768
  17.   -@ list    get files (and comments) from file 'list'
  18.  
  19.  
  20. You may specify more than one input filename (and use wildcards), use
  21. file(s) containing list of files to play or combination of both.
  22.  
  23.  
  24. List file format:
  25.  
  26. Any blank lines or lines with '#' or ';' as first character are ignored.
  27. In any other line, first word is taken as filename and rest of the line
  28. is regarded as comment (and if '-q' switch is not used, printed to screen
  29. when starting to play that file). Filenames may include paths. Below is
  30. an example of a playlist.
  31.  
  32. ------start------
  33. # Maison Ikkoku Best Selection
  34.  
  35. mibest01.mp2 Kanashimi yo Konnichiwa "Hello, it's Sadness" OP
  36. mibest02.mp2 Natsu no Sora so no 2 "The Summer Sky, No. 2"
  37. mibest03.mp2 Ashita Hareru Ka "Will Tomorrow be Bright"
  38. mibest04.mp2 Godai ga Kyoko wo Omou Toki "When Godai thinks of Kyoko"
  39. mibest05.mp2 Cinema ED
  40. mibest06.mp2 Aki "Fall"
  41. mibest07.mp2 Yokan "Presentiment"
  42. mibest08.mp2 Kaeri Michi "The Road Home"
  43. mibest09.mp2 Fantasy ED
  44. ------cut-----
  45.  
  46.  
  47. Debug output format:
  48.  
  49. Most of debug output is several lines like this one:
  50. in 46080 bytes: rr......rr
  51. The first number is number of bytes entered to ringbuffer. the last 10
  52. letters represents state of playback ringbuffer before it.
  53. '_' is empty
  54. 'r' is ready for playing
  55. '.' has been used
  56. 'P' has been partly used
  57.  
  58. Normally most of them should be 'r'. If you are using switch '-p' and do
  59. something processor intensive, you may see more '.'s. Full buffer will hold
  60. 2.5 seconds of stereo or 5 seconds of mono audio, so little interrupts
  61. shouldn't cause problems. If your machine is fast enough, you should use
  62. '-p' switch, because raising maplay/2 priority to timecritical causes
  63. jerkiness in everything else.
  64.  
  65.  
  66. Credits:
  67.  
  68. Maplay/2 is based on maplay 1.2 sources Copyright (C) 1993, 1994
  69. Tobias Bading (bading@cs.tu-berlin.de).
  70.  
  71. MMPM/2 API functions were made using mm4emx 1.0 by Marc E.E. van Woerkom
  72. (marc_van-woerkom@ac3.maus.de).
  73.  
  74. Maplay/2 was compiled with emx, and needs it's runtime libraries
  75. (ftp://ftp.leo.org/pub/comp/os/os2/02-emx-runtime.zip).
  76.  
  77. And the conversion was made by Timo Jantunen (jeti@niksula.cs.hut.fi,
  78. http://www.hut.fi/~jeti/).
  79.  
  80.  
  81. maplay 1.2 can be found in
  82. ftp://bigblue.pvv.unit.no/store/store/ernie/maplay/maplay1_2.tar.Z
  83.  
  84. mm4emx can be found in
  85. ftp://ftp.leo.org/pub/comp/os2/gnu/emx+gcc/contrib/mm4emx10.zip
  86.  
  87. MMPM/2 API information can be found at
  88. http://www.austin.ibm.com/os2games/
  89.  
  90.  
  91. Sources:
  92.  
  93. I didn't include sources in this relase because I had to modify some parts
  94. of maplay 1.2 sources rather heavily, and they need tidying up before I
  95. dare to relase them.
  96.  
  97.  
  98. Plea for help:
  99.  
  100. If anyone knows a good way to play huge sample (=like decompressed mpeg-2
  101. audio ;-) using MMPM, please contact me. I had to use rather dubious methods
  102. in starting, maintaining and ending audio stream ;-). I know of DART, but
  103. am not sure yet whether to use it or not (as it needs DLLs not widely
  104. available).
  105.  
  106.  
  107. Problems?
  108.  
  109. * If you hear snaps during playback, try adding '-c' parameter. If it suggests
  110.   -f switch with a value, use it. (I usually use parameters -c -f 25000)
  111.  
  112. * If you have Soundblaster-16 compatible soundcard, you may need to update
  113.   your drivers from ftp://ftp.creaf.com/pub/creative/files/os2/sb_os2.exe.
  114.   You have to do the installation first with the install.exe program which
  115.   puts a new device line in the config.sys. But it doesn't copy the files to
  116.   the mmos2 directory! You have to do it yourself. If you forget this the
  117.   computer will stop during the next boot!
  118.   (Thanks for Joern Westermann (jnwester@immd4.informatik.uni-erlangen.de)
  119.   for this info.)
  120.  
  121.  
  122. Bugs:
  123.  
  124. Report any to me (timo.jantunen@hut.fi or jeti@niksula.cs.hut.fi). Please
  125. include maplay output with switches '-v -d' (from start to few lines after
  126. 'ply: ??????????' lines).
  127.  
  128.  
  129. Legal stuff:
  130.  
  131. This program is free. You are also free to use or not to use it, but I'm
  132. not responsible of any damage it may cause. Do NOT make money with this
  133. program, change copyright information or distribute it without unmodified
  134. files README, README.OS2, README.1ST and COPYING.
  135.  
  136.  
  137.