home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / music / 3dmod10.zip / 3DMOD.DOC next >
Text File  |  1993-09-02  |  7KB  |  151 lines
  1.                          ┌─────────────────────────┐
  2.                          │    3D Mod version 1.0   │
  3.                          ├─────────────────────────┤
  4.                          │       written by        │
  5.                          │      Renier Crause      │
  6.                          ╘═════════════════════════╛
  7.  
  8. ┌─────────────────────────┐
  9. │ Introduction            │
  10. ╘═════════════════════════╛
  11.   This is a 3D module player for DOS.  It plays all 4 channel Amiga
  12.   ProTrakcer modules through one of several sound output devices.  It
  13.   displays 4 volume bars, and some unexplainable 3D blocks.  If you
  14.   wanna see the 3D effects, that this module player produces, you must
  15.   get (or make) you red/green 3D glasses.  The red lens should be at
  16.   your left eye, and then of course the green lens will be at your
  17.   right eye.  Without such glasses the screen would just look like some
  18.   complicated mess.
  19.  
  20. ┌─────────────────────────┐
  21. │ Requirements            │
  22. ╘═════════════════════════╛
  23.   This Module Player requires the following:
  24.     MS-DOS 3.x of higher
  25.     VGA adapter
  26.     286 or higher CPU (the faster the better)
  27.     red/green 3D glasses
  28.   It is also recommended that you use some other sound device than the
  29.   PC's internal speaker.  The internal speaker REALLY doesn't sound too
  30.   good, but at least that isn't my fault, the internal speaker never
  31.   sounded too good, and it wasn't designed to sound good either.
  32.  
  33. ┌─────────────────────────┐
  34. │ Sound Devices supported │
  35. ╘═════════════════════════╛
  36.   This simply amazing ;-) 3D mod player uses GoldPlay, which of course is
  37.   coded my Sourcer from CodeBlaster (his real name seems to be Stein
  38.   Norheim).  I want to thank the CodeBlasters for giving us mortal
  39.   programmers the ability to program such cool programs as this one.
  40.   The incredible unit supports the following sound devices:
  41.      1.  Soundplayer/Covox in LPT1  (Mono)
  42.      2.  Soundplayer/Covox in LPT2  (Mono)
  43.      3.  SoundBlaster               (Mono)
  44.      4.  Internal Speaker           (Mono of course)
  45.      5.  Two Soundplayers LPT1+2    (Stereo)
  46.      6.  SoundBlaster Pro           (Stereo)
  47.      7.  Stereo SoundPlayer in LPT1 (Stereo)
  48.      8.  Stereo SoundPlayer in LPT2 (Stereo)
  49.  
  50. ┌─────────────────────────┐
  51. │ Command line options    │
  52. ╘═════════════════════════╛
  53.   All settings, for the player, are sent through the command line.  If
  54.   you want to set some settings permanent, I would advise you to create
  55.   a batch file containing the options you want to use.  I may someday
  56.   write a config file, if somebody out there wants it, but I think it's
  57.   just a wast of good time.  Please remember that the file GOLDPLAY.OVL
  58.   must be in the same directory as 3DMOD.EXE.  This is basically the
  59.   format of my command line (actually it's about all programs' command
  60.   line format):
  61.     Usage:  3DMOD [options] modname[.MOD]
  62.   The not so mysterious modname mentioned above, can conatin wildcards,
  63.   but 3DMOD will only play the first module that matches the wildcard.
  64.   If no extension is given .MOD will be assumed.  This is all so simple
  65.   really.
  66.   Now here comes a brief explanation of this options part I mentioned:
  67.     /D#      sound device           (3)
  68.     /F#####  mixing frequency       (16000)
  69.     /I#      SoundBlaster IRQ       (7)
  70.     /M#      SoundBlaster DMA       (1)
  71.     /P###    SoundBlaster port      ($220)
  72.     /B       no volume bars         (on)
  73.     /R       rectangles around bars (off)
  74.     /H       high density bars      (off)
  75.     /S       show SB settings
  76.   The # signs represents numbers.  All numbers are treated as decimal,
  77.   if you want to enter hexadecimal number, you should prefix them with
  78.   a $ sign, for example /P$220 would set the SoundBlaster output port
  79.   to 0220h.  The numbers (and on/off) in parenthesis above are the default
  80.   values that are asumed, if you don't specify that specific option.  The
  81.   /S option is there for you to test everything is exactly setup as you
  82.   want it.
  83.  
  84. ┌─────────────────────────┐
  85. │ The Keys                │
  86. ╘═════════════════════════╛
  87.   Here follows all the incredible keys you can press while the music
  88.   is playing:
  89.     ESC - stop playing and return to DOS
  90.   Well, maybe the keys are not all that incredible as they first seemed.
  91.  
  92. ┌─────────────────────────┐
  93. │ Technical Information   │
  94. ╘═════════════════════════╛
  95.   This crazy program was coded in Turbo Pascal 7.0 (probably the coolest
  96.   language ever written).  The source code of this program isn't available
  97.   to you inquisitive public out there, and if you think you can bribe me
  98.   with money, you are RIGHT!  There is nothing on this earth that can't
  99.   be bought, so if I happen to recieve an envelope that contains some money,
  100.   the sender might just happen to recieve some source.  Be warned though if
  101.   you want well documented source code you would have to send more money,
  102.   because I would have to document it especially for you.  Please contact me
  103.   through eMail (address at end of document) before sending me money.  That
  104.   is if you want source code, if you just want to send me money, hey go
  105.   ahead, I won't try to stop you!
  106.  
  107. ┌─────────────────────────┐
  108. │ Copyright               │
  109. ╘═════════════════════════╛
  110.   3DMOD 1.0  (C) 1993 RC-SOFT, written by Renier Crause.
  111.   This program is copyrighted by me, Renier Crause.  That doesn't mean
  112.   you shouldn't copy this program, in fact I order you to give this
  113.   program te every living person you know (it would of course help, if
  114.   the person you give it, owns a PC).  No, this copyright means you may
  115.   not change my program, or dissemble it without my permission.  This
  116.   program is NOT freeware, it is what I call Mailware (nice name, eh?)
  117.   What this Mailware actually means, is that if you like this program
  118.   (or not) you are obliged to let me know, either through eMail or
  119.   snail mail.
  120.  
  121. ┌─────────────────────────┐
  122. │ How to contact me       │
  123. ╘═════════════════════════╛
  124.   I would prefer you to contact me through eMail.  My internet address
  125.   is:
  126.       9147659@rkw-lan.cs.up.ac.za
  127.       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  128.   Yes you read correctly I'm from South-Africa, and we can actually program
  129.   here (well some of us anyway).  If you don't have access to eMail (shame
  130.   on you) you can also reach me at:
  131.       R.G. Crause
  132.       P.O. Box 38141
  133.       Garsfontein X10
  134.       0042 PRETORIA
  135.       Republic of South-Africa
  136.   PLEASE contact me if you have any comments, suggestions, wish lists,
  137.   bug reports, hate mail etc.  I'll answer all meaningfull eMail, and
  138.   even some meaningless ones.  Sorry I can't answer any snail mail
  139.   comments, but I can sure act on any suggestions you mailed to me.
  140.   Remember, this is not freeware, you are obliged to send me your
  141.   comments :-)  Hey I'm not really that serious, but I would REALLY
  142.   like to hear from you.
  143.  
  144.   Renier.   (written on 01 September 1993)
  145.  
  146.   Oh yeah!  That's the end of this stupid document!!
  147.   PS. If this document looks very similar to TBMOD's doc
  148.       it's becuase there are very similar.                ,,,,,
  149.                                                           (o o)
  150. ------------------------------------------------------ooO--(_)--Ooo--------
  151.