home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / CDMP16.ZIP / CDMP.DOC < prev    next >
Encoding:
Text File  |  1995-04-14  |  7.4 KB  |  198 lines
  1.  
  2.                 DOCUMENTATION
  3.  
  4.                      to
  5.  
  6.                     CDMP
  7.  
  8.               (CyberDyne Module Player)
  9.  
  10.  
  11. 1.Introduction:
  12.     This module player is designed to play MOD and 669-files on your
  13.     computer through various sound devices. Due to highly optimized
  14.     assembler code it will not run any more on a 286; you will need
  15.     at least a 386 processor.
  16.     The player also uses a so called 'FLAT-Mode', which is another
  17.     operation mode of the processor enabling one to access up to
  18.     4GB !!! But the disadvantage of this technique is that the
  19.     player does not run together with any virtual memory manager like
  20.     EMM386,QEMM,386MAX etc...
  21.  
  22. 2.How to start the program:
  23.     Simply type CDMP at your DOS-prompt. If everything works fine, then
  24.     you will see a menu to select your sound-device. Choose one that
  25.     you like (SB timer sounds a bit better than SB DMA) and press
  26.     return. Then you will be asked for some parameters for your sound-
  27.     device and then you may select the sampling-rate. Note that SB-timer
  28.     does not support any rates above 22000 Hz !!!
  29.     And higher sampling rates slows down the mixing and your computer
  30.     may crash if it is too slow !!! The same is with qualitiy mode. This
  31.     technique sounds better but needs a LOT of processor power compared
  32.     to normal playing.
  33.     If you use stereo, then fast panning is again something faster. (Fast
  34.     panning means, that a voice is either left or right and not between)
  35.     But note that the quality mode does not work in stereo without fast
  36.     panning turned on.
  37.     The last option available is 'Fading out'. When you switch on this
  38.     item, the songs won't be stopped immeditely, but they will be faded
  39.     out slowly.
  40.     The setup will be saved to disk for the next time.
  41.  
  42. 3.In the file menu:
  43.     When you have finished the setup then a file list appears, where
  44.     you can start any song by pressing Enter. F1 displays a small help
  45.     and with F2 you may reconfigure your device. Esc exits the program
  46.     and saves your current setup.
  47.  
  48. 4.While playing a song:
  49.     When you have selected your sound-device etc, then a file-list
  50.     will appear where you can select the module to play. Simply
  51.     press enter and the sound-output will start with a neat oscillo-
  52.     scope. While playing the module you may always press F1 for a quick
  53.     help, but here are listed the keys again:
  54.  
  55.     <-,->           Use the cursor keys to jump from one pattern to the
  56.             next or to the previous.
  57.     + ,-            Use + and - for changing the volume
  58.     1 - 9           Use the numbers 1 to 9 to activate/deactivate a
  59.             music channel. The activ channels are displayed
  60.             just a bit below the scope.
  61.     F1              Displays a quick help
  62.     F2              Turn on/off low pass filter. This filter smoothens
  63.             the output data producing much less noise. But note
  64.             that there are some loud pieces where this filter
  65.             does not work
  66.     F3              Turn on/off mid-pass filter. This filter isn't really
  67.             a 'mid-pass', it is a soft low-pass filter and does
  68.             again not work with all music.
  69.     F4              Turn on/off high-pass filter. This is a VERY effectiv
  70.             high-pass filter killing the bass - sounds a lot like
  71.             PC-Speaker output ;-)
  72.     F5              Display/Play instruments - Here the screen changes
  73.             and you are in the instrument list. Use the cursor
  74.             keys to scroll through the list and return to play
  75.             one sample. Use F1-F8 to change the pitch and Esc
  76.             to return to normal playing screen.
  77.             If you want to play the samples WITHOUT music, simply
  78.             deactivate all channels and then go into the instru-
  79.             ment ripper.
  80.     F6              This calls the so called "psycholysis", where three
  81.             boxes are displayed on the screen according to the
  82.             frequency analysis. There are some pieces where this
  83.             really looks neat, and other where it look like
  84.             trash. Just give it a try !
  85.     F10             DOS-Shell. This calls the COMMAND.COM while still
  86.             playing music. Not that not all programs do work
  87.             properly, because the timer interrupt is hooked to
  88.             another routine. Simply type EXIT to return to the
  89.             player
  90.     Esc             Select a new file
  91.  
  92.     Note that the spectrum analysis is a REAL one which uses a FHT
  93.     (this should be faster than a FFT ;-), but its vertical scale is
  94.     nor linear nor logarithmic. It is a SINE (!!!) function ;-) (But it
  95.     look nice, doesn't it ?)
  96.  
  97.  
  98. 5. Format extensions:
  99.     Currently, there are only 3 format extensions:
  100.     MOD effect 8 is used for panning (40h is center,max 80h)
  101.     S3M effect X is used for panning (like MOD)
  102.     S3M effect Y is used for a "Träller", which plays similar to
  103.         Arpeggio 2 notes: Yab   a is speed of changes
  104.                     b is number of halftones to add
  105.         This effect is useful for octave-tremolos or tr.
  106.     S3M effect Z is used for a new reverse effect (try it with speech !)
  107.  
  108. 6. FCMOVER utility: 
  109.     With the version 1.1 of CDMP, a small utility is added in order to
  110.     extract music from Future Crew demos. It is very easy to use:
  111.     FCMOVER l unreal.exe  
  112.         - or -
  113.     FCMOVER unreal.exe
  114.         will show all files in the archieve.
  115.     FCMOVER e unreal.exe tmp.s3m
  116.         will extract tmp.s3m from the archieve unreal.exe
  117.  
  118.     Note that this program does not work with all future crew demos.
  119.     Tested are:
  120.         PANIC.EXE       -       Works !
  121.         UNREAL.EXE      -       Works !
  122.         FISHTRO.EXE     -       There is a bug in the S3M file
  123.                     causing trash output.
  124.         SECOND.EXE      -       Does not work, because it uses a
  125.                     new archieve.
  126.  
  127.     ATTENTION: I DO NOT KNOW, IF THE FUTURE CREW LIKES THIS PROGRAM;
  128.     IF ANYBODY (OR THE FUTURE CREW ITSELF) IS AGAINST THIS UTILITY,
  129.     BECAUSE YOU COULD EXTRACT EVERYTHING, I WILL STOP TO SPREAD THIS
  130.     PROGRAM ! PLEASE INFORM ME !!!!
  131.  
  132. 7.Cardware:
  133.     This program is cardware, this means if you like the program,
  134.     send in a postcard to me of your hometown.
  135.     If you are interested in the CDMI (CyberDyne Music interface), then
  136.     you should contact me. The player is only a demonstration
  137.     application for the CDMI and its source-code is available from me.
  138.     (See ORDER.DOC for further information)
  139.  
  140.     Kaya Memisoglu
  141.     Reichenberger Ring 50
  142.     63512 Hainburg
  143.     Germany
  144.  
  145.     You can also contact me via the Nirvana BBS:
  146.     (Leave a message to "Marc van Shaney", my handle)
  147.  
  148.     Nirvana BBS  ++49-(0)6245-3056
  149.     Sysop:RAYTRAYZA
  150.  
  151.  
  152. 8. Thanx go to:
  153.     RAYTRAYZA for spreading CDMP, for making his BBS to a support site,...
  154.     VANGELiSTEAM for releasing their source-code ;-)
  155.  
  156.  
  157. 9. Revision history:
  158.  
  159.     1.0     1/17/1995
  160.         First release together with the CDMI-demo plus the source-
  161.         code of the demo
  162.     1.1     2/05/1995
  163.         + Interpolation added
  164.         + Configuration will be saved to disk
  165.         # Fixed bug with extended commands (Exy)
  166.         # Speeded up mixing-routines
  167.         + S3M support
  168.         + STM support
  169.         + Added FCMOVER.EXE
  170.         + Added *STEREO*
  171.         # Fixed some problems with DOS-shell
  172.     1.2     3/03/1995
  173.         # Fixed MOD-Frequency adjustments
  174.         # Fixed low- and mid-pass filters
  175.         + Added outfading feature
  176.         # Changed palette (red,gren,blue sucks !)
  177.         # Fixed slides
  178.         # Moved DMA buffer to XMS -> More free low ram
  179.         + Added support for no HIMEM.SYS (RAW-Mode)
  180.     1.5     03/11/1995
  181.         + Added frequency analysis
  182.         + Added MTM format
  183.         + Added psycholysis (TM)
  184.     1.51    03/17/1995
  185.         # Fixed bug in MTM loader
  186.         + Added volume-optimizing
  187.         + Added directory-sorting
  188.     1.52    04/09/1995
  189.         # Fixed little volume-slide bug in S3M
  190.     1.53    04/11/1995
  191.         + Added ANSI
  192.         + NIRVANA BBS IS NOW CDMP/CDMI WHQ !!!
  193.     1.6
  194.         # Changed layout
  195.  
  196. 10. Coming soon:
  197.     XM - compatibility   (Lets say a 50% comp.)
  198.