@DATABASE "WavesOfTheFuture.guide"
@WIDTH 71
@VER$ WavesOfTheFuture v3.2
@AUTHOR Stian Strøm (program), Stian Strøm (manual)
@(C) 1999-2002 by Stian Strøm

@NODE MAIN "Waves Of The Future v3.2" manual"
@{B} Waves Of The Future v3.2 (Last modified: 13.07.2000) @{UB}
               
          @{I}"...Amiga a multitasking multispacecraft computer..."@{UI}

      Waves Of The Future Chapters:

      @{" Important           " link IMPORTANT     }    Important information
      @{" Introduction        " link INTRODUCTION  }    Introduction to Waves Of The Future
      @{" Requirements        " link REQUIRE       }    What do you need to run this?
      @{" Installation        " link INSTALL       }    How to install Waves Of The Future
      @{" Usage               " link USAGE         }    How to use Waves Of The Future
      @{" Trouble shooting    " link TROUBLE       }    Solutions to some problems
      @{" About               " link ABOUT         }    Information About Waves Of The Future
      @{" Contact             " link CONTACT       }    How to contact me
      @{" History             " link HISTORY       }    About the programming process
@ENDNODE

@NODE REQUIRE "Tha Menu v1.0 - Enterprise manual - Requirements"
@{B}*** REQUIREMENTS ***@{UB}

  Minimum requirements:

    Minimum Hardware:
      - Amiga with 68040/25MHz +++
      - Ca 0.5 MB free harddisk space
      - 3D graphics card that's supported by Warp3D...

    Prefered Hardware:
      - Amiga with PPC240MHz + 68060/50MHz
      - Ca 0.5 MB free harddisk space
      - 3D graphics card that's supported by Warp3D...

    Software:
      - CyberGraphX v3.0 +++
      - AmigaAmp installed ;)
      - Warp3D v2.0 (Please update to the newest version)
      - WarpUp required for PPC (WOS) version... 

@ENDNODE

@NODE TROUBLE "Waves Of The Future Manual - Trouble shooting"
@{B}*** TROUBLE SHOOTING ***@{UB}

  Screenmode problems:

    Problem:  Hey, the plugin starts, and then it quits at once...
    Solution: -> Delete the screenmode.cfg file in "Wavesofthefuturedatadir",
              -> Start the plugin for CLI (Not from WB of AAMP),
              -> Select a screenmode from the requester.
              -> (The plugin should work normally now no mather where you start it for (AAMP or WB)

  I also want to mention that if you have any problems, you can try deleting the "*.cfg" files...
  (You should also start if from CLI to get debug messages that you can send to me if it doesn't werk.)


@ENDNODE

@NODE CONTACT "Waves Of The Future Manual - Contact"
@{B}*** CONTACT ***@{UB}

  If you need to contact me for any reason:

  Stian Strøm
  Strandveien 68
  8533 BOGEN I OFOTEN
  Norway
  Phone (+47) 90779182

  Email        : stianstr@online.no
  My Homepage  : http://home.sol.no/~atlestro/index.htm
  Software page: http://home.sol.no/~atlestro/agsoft.htm

@ENDNODE

@NODE HISTORY "Waves Of The Future Manual - History"
@{B}*** HISTORY ***@{UB}

  v3.2 - Fixed a new config load/save method. Saving and loading works
         without trouble in the PPC version now...
  v3.1 - Um, troubles with the PPC version has made me discontinue the PPC
         version of the plugin until I sort out the compiling problems.
       - Sinusmove implemented from the PC version of WOTF, looks best with
         wireframe/kewlmode and no texture.
       - It is now possible to adjust the rotation speed of the wave.
  v3.0 - Yes! PPC support finally!!! (Thanks to Steffen Heauser for porting...)
       - Did some optimizations and fixing to make PPC version run faster...
       - Fixed every single warning, and it compiles perfect as PPC or 68k from
         a single sourcefile...
       - Canceled rewritting of Config Save/Load methods (to boring)
  v2.5 - Added a new (and a lot nicer) reflection effect that looks a lot more 
         real than the last one...
       - Added a "idle" mode which makes the plugin use less CPU when no MP3
         is playing (stopped)... (Uses 60-70% on my 040/25MHz in "IDLE" mode.)
         (Makes it easier to change songs and stuff since Dopus isn't snailing in 0.1 mph...)
       - Added a waving sinus curve that is displayed when Amigaamp is stopped...
       - I have added a "Spectrum Selector" which allows you to select what part
       - Now saves the "new reflection on/off" setting...
         of the soundspectrum you want to visualize ;)
       - Did some optimizations to the wireframe mode... (had forgot to cut some un-necessery lines.)
  v2.4 - Did some optimizations to the "kewlmode" runs with 7-8FPS more now...
       - Added an "Also kewl" option, enable with key "m" 
         (only available for the wireframe mode...)
       - The wave is now equally transparent in all corners when Alpha blending
         is used... 
  v2.3 - Added an option to enable/disable autorotation...
       - Added wireframe mode.
       - Added an even kewler "wireframe" mode.. 
  v2.2 - Lorens Johansson has written an arexx script for me which allows
         me to control the PLAY/STOP/PREVIOS/NEXT/PAUSE/FFWD/REW functions
         from within my plugin (same shortcuts as in Amigaamp)
  v2.1 - Thomas Wenzel has done some debugging/fixing, and it now starts 
         and runs without any Cyberguard hits ;)
       - It's also running a bit faster now.
       - It's possible to turn ON/OFF all screeninfo...
         Runs a lot faster without screeninfo...
       - It is now possible to save screeninfo on/off settings...
  v2.0 - Added possibility to move the wave up/down and left/right.
  v1.9 - Re-assigned the keyboard configuration to match some of the
         original Waves Of The Future controls (F1-F10 functions).
  v1.8 - Added possibility to set wave amplitude.
  v1.7 - Added possibility to set detail level of the wave (more polygons).
  v1.6 - Added possibility to set level of reflections.
  v1.5 - Added reflection thingy, I think.
  v1.2 - Plugin now shows the songname and duration.
         FPS counter can be turned on/off.
  v1.1 - Bugfix: The plugin doesn't randomly crash on my computer anymore,
         I take that as a good sign that it's gonna work on all systems now ;)
  v1.0 - Released the first version... (Stable as a russian nuclear reactor...)


@ENDNODE

@NODE IMPORTANT "Waves Of The Future Manual - Important"
@{B}*** IMPORTANT ***@{UB}

  Waves Of The Future is released as freeware, and that means that I can't 
  and will NOT take ANY responsibility if Tha Menu should cause any problems 
  for your computer or yourself in any way... 

  But I don't think it bites ;)

  You can spread it as much as you want as long as you're not gonna
  make any money on it, in such case you should contact me first 
  and ask for permisson...

  It can of course be placed on any Aminet CD without and special permisson
  from me... Aminet rewls ;)

@ENDNODE

@NODE USAGE "Waves Of The Future Manual - Usage"
@{B}*** USAGE ***@{UB}

  These are the options: (This is a bit wide, so it would look best if you have a huge screenmode like me ;)

   +-------------------+
   | Keyboard settings |                                               |
  -+-------------------+-----------------------------------------------+--------------------------------------------------------------------------------
   | Key   - Function                                                  | Aditional info
  -+-------------------------------------------------------------------+--------------------------------------------------------------------------------
   | F1    - Change the detail level of the waves                      | The available detail levels so far is 10², 20², 40² (10²=100 polygons)
   | F2    - Change the wave amplitude                                 | The steps isn't linear as it is now, but I'll change it in a later version.
   | F3    - Turn Filtering on/off                                     | This only applys to the texture on the wave...
   | F4    - Turn Dithering on/off                                     | Ain't to much point in this one I think, not much difference...
   | F5    - Turn Alphablending on/off                                 | Makes the objects look transparent. I've set it to 50% transparency I think.
   | F6    - Toggle Amiga Logo on/off                                  | Just a simple Amiga logo popping up here and there on the screen ;)
   | F7    - About Requester...                                        | (Not implemented yet, to lazy) 
   | F8    - Show the available options on the screen...               | 
   | F9    - Turn on/off info: pluginname, my name, songname,          | 
   | F10   - Save Configuration                                        | Saves the major plugin settings... A lot of small stuff isn't saved yet...
   | ESC   - Quit                                                      |
   | R     - Turn reflection effect on/off                             | This was my first attempt for a reflection effect, key 'Q' is better...
   | Y     - Cycle reflection levels (1-6)                             | 'Q' or 'R' must be active for this to have any effect...
   | E     - Cycle blendmodes                                          | 
   | F     - Turn fogging on/off                                       | 
   | NUM8  - Push back the fog end value                               |
   | NUM5  - Push fog end towards viewer                               |
   | NUM9  - Push back fog start                                       |
   | NUM6  - Push fog start towards viewer                             |
   | L     - Turn Alphablending on/off                                 | (Same as 'F5')
   | P     - Turn FPS counter on/off                                   | If you want to check the framerate of the plugin, this is the button for you :)
   | N     - Toggle Autorotation (Enable/Disable)                      | Stops the wave from rotating... You can still use the mouse to rotate it tough.
   | W     - Toggle Wireframe (Enable/Disable)                         | 
   | K     - Toggle Kewlmode                                           | Works only when Wireframe mode is ON...
   | M     - Toggle Alsokewlmode                                       | Works only when Wireframe mode is ON...
   | Q     - Toggle "Real" reflection on/off                           | This is the newest and best reflection effect I have done so far. ;)
   | S     - Toggle SpectrumSelector on/off                            | Use the mouse to select which area of the spectrum you want to visualize.
   | +     - Increase the wave rotation speed by 0.25 degrees pr. step | This also affects the sinusmove which speed is 0.5*waverotationspeed
   | -     - Decrease the wave rotation speed by 0.25 degrees pr. step | This also affects the sinusmove which speed is 0.5*waverotationspeed
   | 1     - Toggle Sinusmove on off...                                | Look best with wireframe/kewlmode and no texture on... or transparent wave.
   | Z     - AmigaAmp control -> Previous Song                         |
   | X     - AmigaAmp control -> Play Song                             |
   | C     - AmigaAmp control -> Pause Song                            |
   | V     - AmigaAmp control -> Stop Song                             |
   | B     - AmigaAmp control -> Next Song                             |
   | LEFT  - AmigaAmp control -> FastForward Song                      |
   | RIGHT - AmigaAmp control -> Rewind Song                           |
  -+-------------------------------------------------------------------+-
   |                                                                   |
   +-------------------+                                               |
   | Mouse Controls    |                                               |
  -+-------------------+-----------------------------------------------+-
   |                                                                   |
   | Hold down left mouse button and move the mouse left/rigth to      |
   | rotate the wave manually.                                         |
   |                                                                   |
   | Hold down right mouse button and move the mouse                   |
   | forwards/backwards to move the wave away/closer to the screen...  |
   |                                                                   |
   | Hold down left+right mouse button to move the wave's X and Y pos  |
   |                                                                   |
  -+-------------------------------------------------------------------+-
   |                                                                   |
   +---------------------+                                             |
   | Screenmode settings |                                             |
  -+---------------------+---------------------------------------------+-
   |                                                                   |
   | The first time you start this plugin, you will see a screenmode   |
   | requster which allows you to select what screenmode you want to   |
   | use.                                                              |
   |                                                                   |
   | This screenmode is saved automatically, so you will never have to | 
   | choose the screenmode again.                                      |
   |                                                                   |
   | Note: If you really want to change the screenmode, just delete    |
   | the file "screenmode.cfg" in the plugin directory...              |
   |                                                                   |
  -+-------------------------------------------------------------------+-
   |                                                                   |

@ENDNODE

@NODE INSTALL "Waves Of The Future Manual - Install"
@{B}*** INSTALLATION ***@{UB}

  To install Waves Of The Future, just run the install script that is 
  found in this archive, and follow the instructions... 

@ENDNODE

@NODE ABOUT "Waves Of The Future Manual - About"
@{B}*** ABOUT ***@{UB}

  Waves Of The Future is created by: 

  Stian Strøm
  Strandveien 68
  8533 BOGEN I OFOTEN
  Norway

  Email        : stianstr@online.no
  My Homepage  : http://home.sol.no/~atlestro/index.htm
  Software page: http://home.sol.no/~atlestro/agsoft.htm

  This is my second Warp3D plugin, and it's a lot better than my last
  one... even has a few options, kewl hah? ;)

  Thanks to:

	- Thomas Wenzel for debugging and fixing of my source file, and 
	  for answering questions about programming...

	- Steffen Heauser who ported my WOTF source to PPC, which allows
    me to recompile all my Warp3D stuff as WarpUp applications... ;-)

	- Lorens Johansson for the AREXX script which allows me to control 
	  some functions in Amigaamp from within my plugin...

	- Eric Muller which has done some beta testing, and thanks to everyone
	  for bug reports and stuff... ;)

@ENDNODE

@NODE INTRODUCTION "Waves Of The Future Manual - Introduction"
@{B}*** INTRODUCTION ***@{UB}

  Waves Of The Future is a plugin for AmigaAmp which is a program
  used to play MP2/MP3 files...

  This can only be used with AmigaAmp installed and running...

@ENDNODE
