Short: Fascinating "wrapped" monoscope for HiP Author: parsec@aljan.com.au (Erik Spåre) Uploader: parsec@aljan.com.au (Erik Spåre) Version: 1.0 Type: mus/misc Requires: OS 3.0+, 68020+, 2MB+ fast, reqtools.library, HippoPlayer ********************************************************************** ** RaveScope 1.0 Copyright © by Erik Spåre 1998 ** ** (Parsec/Phuture 303) ** ********************************************************************** 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. TEMPLATE After the programname you may specify one or more options: SCREEN/S,DISPLAYID/K,INVERT/S,WINLEFT/N/K,WINTOP/N/K,WINWIDTH/N/K, WINHEIGHT/N/K,SCRWIDTH/N/K,SCRHEIGHT/N/K,WRAPACCURACY/N/K, TRADACCURACY/N/K,ALTACCURACY/N/K,WRAPMODE/K,TRADMODE/K,ALTMODE/K SCREEN To have the display on a private screen. DISPLAYID Supply a hexadecimal DisplayID, for instance $21000 (the dollar sign is required) for a low-res screen. If you leave out this you will get a screenmode requester instead. INVERT To have a dark scope on a light background. (Well, depending on your workbench palette it may be the other way round when using a window as the display.) WINLEFT Where you want the window positioned (x-pos), default = 0. WINTOP Where you want the window positioned (y-pos), default = 11. WINWIDTH Width of window (minus borders). Defaults to 280. WINHEIGHT Height of window (minus borders). Defaults to 160. SCRWIDTH Width of screen. Defaults to text-overscan width of selected displaymode. SCRHEIGHT Height of screen. Defaults to text-overscan height of selected displaymode. WRAPACCURACY Accuracy of the wrapped mode. Can be 25, 50, 100, 200 300, 400, 500, 600, 700, 800 or 900 %. Defaults to 100%. Number of dots per display will be the circumference (in pixels) * percent * number of channels. (Do not write the percent sign when you specify this accuracy.) TRADACCURACY Accuracy of the traditional mode. Cannot exceed 9999. Defaults to 500 (but this mode is off by default). Number of dots per display will be this value times number of channels. ALTACCURACY Accuracy of the alternative mode. Cannot exceed 9999. Defaults to 500 (but this mode is off by default). Number of dots per display will be this value times number of channels. WRAPMODE Wrapped mode on or off. Defaults to on. (Write either on or off after this keyword.) TRADMODE Traditional mode on or off. Defaults to off. (Write either on or off after this keyword.) ALTMODE Alternative mode on or off. Defaults to off. (Write either on or off after this keyword.) KEYBOARD CONTROL The only way to control the scope while it's running is through the keyboard. W - Wrapped mode on/off. T - Traditional mode on/off. A - Alternative mode on/off. Q - (or Escape) - Quit F - Switch between screen and window mode. Holding down a shift-key when you press F will call the screenmode requester and open a screen with the screenmode you select. F stands for Full-screen which is what this is intended for, but any size will do. To change the various scope-mode's accuracies, use the numerical keypad. The keys 7, 8 and 9 will increase the wrapped, traditional and alternative accuracy. The corresponding key below, 4, 5 or 6 will decrease it. 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 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) the sample frequency isn't high enough. * PS3M's look much better with a high volume-boost and the main-volume 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! HISTORY 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 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.) ** Version 1.0 released 980209. ============================= Archive contents ============================= Original Packed Ratio Date Time Name -------- ------- ----- --------- -------- ------------- 30004 15705 47.6% 09-Feb-98 22:58:30 +RaveScope 10293 4417 57.0% 09-Feb-98 22:58:54 +RaveScope.doc 5892 2411 59.0% 09-Feb-98 22:58:54 +RaveScope.readme -------- ------- ----- --------- -------- 46189 22533 51.2% 10-Feb-98 06:06:00 3 files