home *** CD-ROM | disk | FTP | other *** search
/ Dream 49 / Amiga_Dream_49.iso / amiga / applications / musique / ravescope.readme < prev    next >
Text File  |  1998-02-11  |  6KB  |  144 lines
  1. Short:    Fascinating "wrapped" monoscope for HiP
  2. Author:   parsec@aljan.com.au (Erik Spσre)
  3. Uploader: parsec@aljan.com.au (Erik Spσre)
  4. Version:  1.0
  5. Type:     mus/misc
  6. Requires: OS 3.0+, 68020+, 2MB+ fast, reqtools.library, HippoPlayer
  7.  
  8. **********************************************************************
  9. **         RaveScope 1.0 Copyright ⌐ by Erik Spσre 1998             **
  10. **                       (Parsec/Phuture 303)                       **
  11. **********************************************************************
  12.  
  13. INTRODUCTION
  14.  
  15.     This program implements a new kind of scope, a "wrapped monoscope".
  16.     Most modules look much better with a wrapped monoscope than they do
  17.     with the traditional one (the double mode in Delitracker's monoscope, or
  18.     the Spacescope in Eagleplayer). The Ravescope also has this "traditonal"
  19.     mode, as well as a new "alternative" mode.
  20.  
  21.  
  22. TEMPLATE
  23.  
  24.     After the programname you may specify one or more options:
  25.  
  26.     SCREEN/S,DISPLAYID/K,INVERT/S,WINLEFT/N/K,WINTOP/N/K,WINWIDTH/N/K,
  27.     WINHEIGHT/N/K,SCRWIDTH/N/K,SCRHEIGHT/N/K,WRAPACCURACY/N/K,
  28.     TRADACCURACY/N/K,ALTACCURACY/N/K,WRAPMODE/K,TRADMODE/K,ALTMODE/K
  29.  
  30.     SCREEN        To have the display on a private screen.
  31.  
  32.     DISPLAYID     Supply a hexadecimal DisplayID, for instance $21000
  33.                   (the dollar sign is required) for a low-res screen. If
  34.                   you leave out this you will get a screenmode requester
  35.                   instead.
  36.  
  37.     INVERT        To have a dark scope on a light background. (Well, depending
  38.                   on your workbench palette it may be the other way round when
  39.                   using a window as the display.)
  40.  
  41.     WINLEFT      Where you want the window positioned (x-pos), default = 0.
  42.  
  43.     WINTOP        Where you want the window positioned (y-pos), default = 11.
  44.  
  45.     WINWIDTH      Width of window (minus borders). Defaults to 280.
  46.  
  47.     WINHEIGHT     Height of window (minus borders). Defaults to 160.
  48.  
  49.     SCRWIDTH      Width of screen. Defaults to text-overscan width of selected
  50.                   displaymode.
  51.  
  52.     SCRHEIGHT     Height of screen. Defaults to text-overscan height of selected
  53.                   displaymode.
  54.  
  55.     WRAPACCURACY  Accuracy of the wrapped mode. Can be 25, 50, 100, 200
  56.                   300, 400, 500, 600, 700, 800 or 900 %. Defaults to 100%.
  57.                   Number of dots per display will be the circumference (in
  58.                   pixels) * percent * number of channels. (Do not write
  59.                   the percent sign when you specify this accuracy.)
  60.  
  61.     TRADACCURACY  Accuracy of the traditional mode. Cannot exceed 9999.
  62.                   Defaults to 500 (but this mode is off by default).
  63.                   Number of dots per display will be this value times
  64.                   number of channels. 
  65.  
  66.     ALTACCURACY   Accuracy of the alternative mode. Cannot exceed 9999.
  67.                   Defaults to 500 (but this mode is off by default).
  68.                   Number of dots per display will be this value times
  69.                   number of channels.
  70.  
  71.     WRAPMODE      Wrapped mode on or off. Defaults to on. (Write either
  72.                   on or off after this keyword.)
  73.  
  74.     TRADMODE      Traditional mode on or off. Defaults to off. (Write
  75.                   either on or off after this keyword.)
  76.  
  77.     ALTMODE       Alternative mode on or off. Defaults to off. (Write
  78.                   either on or off after this keyword.)
  79.  
  80.  
  81. KEYBOARD CONTROL
  82.  
  83.     The only way to control the scope while it's running is through the
  84.     keyboard.
  85.  
  86.     W - Wrapped mode on/off.
  87.  
  88.     T - Traditional mode on/off.
  89.  
  90.     A - Alternative mode on/off.
  91.  
  92.     Q - (or Escape) - Quit
  93.  
  94.     F - Switch between screen and window mode. Holding down a shift-key
  95.         when you press F will call the screenmode requester and open
  96.         a screen with the screenmode you select. F stands for Full-screen
  97.         which is what this is intended for, but any size will do.
  98.  
  99.     To change the various scope-mode's accuracies, use the numerical keypad.
  100.     The keys 7, 8 and 9 will increase the wrapped, traditional and alternative
  101.     accuracy. The corresponding key below, 4, 5 or 6 will decrease it.
  102.  
  103.  
  104. LIMITATIONS
  105.  
  106.     If you select a non-native screen-mode, this program will (I hope)
  107.     refuse to run it, maybe it will even exit. This will be taken care of
  108.     in the next release, or when I get a gfx-card. If you have a gfx-card,
  109.     then please tell me what happens... (It should work fine in a window though.)
  110.  
  111.  
  112. HINTS/WARNINGS
  113.  
  114.     * 100% usually looks the best for protracker modules. PS3M's may
  115.     look better with 200% because they only output 2 channels. Do not
  116.     set the wrapped accuracy higher than this, it won't look good because
  117.     (I think) the sample frequency isn't high enough.
  118.  
  119.     * PS3M's look much better with a high volume-boost and the main-volume
  120.     set to maximum.
  121.  
  122.     * Resizing is very slow because each time the size change, all the look-up
  123.     tables must be recalculated.
  124.  
  125.     ! Do not waste your life looking at this scope, as I have done!
  126.  
  127.  
  128. HISTORY
  129.  
  130.     4-5 years ago I saw a monoscope for the first time. (It was the
  131.     Quadraplayer's I think.)  When, some months later, I tried to make my
  132.     own (not having any idea how it was done) I accidently invented this
  133.     "wrapped" scopemode, and to my delight it looked even better.
  134.  
  135.     I released a first version of it in a music disk-mag I was coding at
  136.     the time, Subculture. (The editor has now turned over to the dark side,
  137.     so there will probably not be a new issue.) There I explained how to do
  138.     it, hoping the scope would spread to my favourite module players. But it
  139.     didn't, either because no one saw it, or because it's a bit complicated
  140.     to implement. (It's not just a question of modifying the inner loop,
  141.     like when converting a plain scope to a monoscope.)
  142.  
  143.     ** Version 1.0 released 980209.
  144.