----------------------
RAG - D - Introduction
----------------------




----------
WARNINGS :
----------

Normally it should not be possible to damage anything by using
RAG-D. But if something happens I don't take the responsibility
for that. It makes no direct changes in hardware- or video-
registers of the Falcon030 and has no own harddiscroutines or
other dangerous jokes.

1.) RAG-D is NOT able to run under MULTITOS ! This program was
    written for 'pixelgraphicmasochists', people who draw pictures
    almost pixel by pixel, and not for people who want to edit
    their digitized photos from their last holiday while typing
    letters to their grandma while optimizing their harddisc and
    calculating some raytraced pictures.

2.) This Version is also able to run under TRUE COLOR but :
    - The block can't be masked till now
    - grabbing a color in the zoom-mode by pressing the right mouse
      button is not possible till now
    - you can't rotate the block till now
 
3.) Not all functions which are displayed are implemented and they
    will cause a message if you try to use them.


+---------------------------------------------------------------------+
|                       Description of RAG-D :                        |
+---------------------------------------------------------------------+

!! IN GENERAL !!

If you want to change some parameters of any funtion in RAG-D you only
have to click on that icon with the RIGHT mousekey !!! Then the parameters
will be displayed and you can gamble around however you want to.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Menutitle "DESK"
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - some infos about the program
  - calling ACCs

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Menutitle "Files"
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - LOAD :
    You may load pictures here. By pressing this button with the right
    mousebutton you may change the kind of files which are loaded.
    RAG-D is able to depack ICE and ATOMIC packed pictures itself.

  - SAVE :
    You may save the actual picture here. To change the kind of picture
    press this with the right mousebutton.
    If you want to you may pack the saved picture with the ICE or 
    ATOMIC packer.

  - QUIT :
    Leave the program and automatical harddisc deleter.
    (just a joke)

  - DOKU :
    Here you are able to write something (max. of 370 characters).
    Your comment will be saved together with the picture.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Menutitel "USER1" & "BLOCK"
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

IMPORTANT !!!!
    If you click on the USER1 menu, there will be displayed another menu !
    The block funtion menu !

  - POINT :
    You can draw single pixels with this function (cool!)

  - DRAW :
    Drawing free. If you are in the draw-mode (and you're not drawing
    at that moment) you can change the draw-speed. Press some hundred
    times the '+' key and draw, then press some hundred times the '-' key
    and draw and you'll see ...

  - CURVE :
    Draws a curve. Set 4 points (if all 4 are set you may move them)
    and draw the curve by pressing the left mousekey. The right one
    aborts the function. If you click on the curve icon with the right
    mousekey the parameters appear.

  - LINE :
    You may draw a line with this (incredible !)
    Press icon with the right mousebutton an the parameters appear.

  - KLINE :
    Draws connected lines.

  - TEXT :
    Not implemented yet. I'm too lazy to fight with the GDOS fonts.

  - AIR :
    A brush.

  - STIPPLE :
    Another brush.

  - FILL :
    Fills parts of the screen

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
UND JETZT IM BLOCK MENU :
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - HORIZ :
    changes left and right of the block (mirror). Also available by
    pressing the cursor left & right keys.

  - VERT :
    changes up & down of the block. Also available by pressing cursor up 
    and down keys

  - ZOOM :
    free zoom of the block

  - ROTATE :
    rotates the block

  - BRIGHT :
    changes the brightness of the block (actually unusful 'coz senseless)
    Adds a count on every pixelcolor in the block (eg. 1->2,2->3)

  - INFO :
    shows how many colors are used in the block aso.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Menutitle USER2
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - QUADR :
    draws a square

  - RECT :
    draws a rectangle

  - CIRCLE :
    draws a circle

  - ELLIPSE :
    draws an elliptical surface

  - CIRCLE PIECE :
    draws a piece of a circle

  - POLY :
    draws a polygon

  - TRI :
    draws a triangle


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
key macros :
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

F1            = zoom /8
F2            = zoom /16
*             = animation menu ( not 100 % finished )
D             = draw
L             = line
F             = fill
Esc           = cut block
Space         = select actual color
Shift + Space = edit colors
HELP          = Realtimezoom in some functions
/             = edit contrast in picture


in the zoom mode 
  - scroll with the cursorkeys
  - 'Space'  = UNDO and UNDO = UNDO
  - 'Return' = select color
  - ','        to increase actual color
  - '.'        to decrease actual color
  - '-'        to have a fullscreenview on the picture
  - 'Control'  switch to draw
  - 'Shift'    switch to fill
  - right mousekey grabbs the color under the mouse cursor
  - click on the little display to exit zoom

in the color - editor ( by pressing SHIFT - 'Space' )

  - 'K' or 'C'  copy color
  - 'F' or 'V'  create color range