Short:        Fascinating "wrapped" scope for HP/DT/EP
Author:       blodskam@ebox.tninet.se (Erik Spåre)
Uploader:     blodskam ebox tninet se (Erik Spåre)
Type:         mus/misc
Version:      1.2
Requires:     OS 3.0+, 68020+, 2MB+ fast, reqtools.library, HiP or DT or EP
Architecture: m68k-amigaos

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*              RaveScope 1.2 Copyright © by Erik Spåre 980922               *
*                                 (Parsec)                                  *
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

INTRODUCTION

    This program implements a new kind of scope, a "wrapped monoscope".
    Most modules look much better with a wrapped monoscope than they do
    with the traditional one (the double mode in Delitracker's monoscope, or
    the Spacescope in Eagleplayer). The Ravescope also has this "traditonal"
    mode, as well as a new "alternative" mode.


LIMITATIONS

    If you select a non-native screen-mode, this program will (I hope)
    refuse to run it, maybe it will even exit. This will be taken care of
    in the next release, or when I get a gfx-card. If you have a gfx-card,
    then please tell me what happens... (It should work fine in a window
    though.)


HINTS/WARNINGS

    * 100% usually looks the best for protracker modules. PS3M's or mp3's may
      look better with 200% because they only output 2 channels. Do not
      set the wrapped accuracy higher than this, it won't look good because
      (I think) often the sample frequency isn't high enough.

    * PS3M's look much better with a high volume-boost and the main-volume
      set to maximum in Hippoplayer.

    * DeliTracker gives the same data regardless of the sample-boost, but
      the volume must be set to maximum.

    * Resizing is very slow because each time the size change, all the look-up
      tables must be recalculated.

    ! Do not waste your life looking at this scope, as I have done!


BACKGROUND

    4-5 years ago I saw a monoscope for the first time. (It was the
    Quadraplayer's I think.)  When, some months later, I tried to make my
    own (not having any idea of how it was done) I accidently invented this
    "wrapped" scopemode, and to my delight it looked even better.

    I released a first version of it in a music disk-mag I was coding at
    the time, Subculture. (The editor has now turned over to the dark side,
    so there will probably not be a new issue.) There I explained how to do
    it, hoping the scope would spread to my favourite module players. But it
    didn't, either because no one saw it, or because it's a bit complicated
    to implement. (It's not just a question of modifying the inner loop,
    like when converting a plain scope to a monoscope.)


HISTORY

    v1.0 (980209)

        ** The first release.


    v1.1 (980315)

        ** Added support for DeliTracker through the DeliRave genie.

        ** Added the keyword 'DELICONFIG' so that you can use DeliRave's
           config settings with HippoPlayer as well.

        ** The wrapped mode has been prepared for use with 16 bit samples.
           Neither Hippoplayer nor Delitracker gives their userprograms more
           than 8 bits though, so this is quite pointless at the moment.

        ** Added a simple strobo-mode. This looks quite awful, but I seem to
           remember that this can be fun when the room is dark and you're
           drunk.

        ** Remembered to turn on compiler optimizations this time.

        BUGS: It is still very stable, much to my surprise. MPEGA player
        did occasionally give enforcer hits, and I felt a bit guilty for this
        because it has only happened when DeliRave has been active. (But on
        the other hand, I only run enforcer when running DeliRave...)
        Sometimes when a new module is loaded, it won't load until the
        ravewindow is activated. I haven't looked into this yet.


    v1.2 (980922)

        ** Restructured the whole program to make it easier to add support for
           more players. This turned out to be very complicated and took me
           several months.

        ** Rewrote the Delitracker genie to work with this new concept.

        ** Added Eagleplayer support.

        ** I accidently had two WaitTOF:s (wait until next frame) per display.
           Removed one of them.

        ** Got rid of strange flickering, both in window and fullscreen mode.

        ** Added a menu.

	** Changed and added a few keyboard/menu shortcuts.

        ** There's now a special configuration file that will be loaded when
           the RaveScope is using Hippoplayer.

        ** Scrapped all commandline arguments. They were not needed since
           all players are now associated with a configuration file.

        ** The RaveScope can now be iconified. If it is, and a new RaveScope
           is started, this will deiconify the old one.

        ** When a RaveScope player starts to play it will automatically try to
           grab the RaveScope.

        ** Added colours for the fullscreen modes.

        ** Switched from text documentation to amigaguide and added an
           installer script.

        BUGS: Still very stable, though deadlocks can perhaps occur. There's
        a few minor flaws. No double buffering in colour mode for instance.