
                                 ARTIST


                           INSTRUCTIONS / HELP

 QUICK START: For those in a hurry to start it will be useful to know that
             extensive help on all the facilities are available on screen:-

          When the pointer is in the Colour Bar (bottom of screen) then

       1) Press and Hold `H' to bring up a general Help window.

       2) Click and Hold Mouse `Menu' button for help on the current tool.

_____________________________________________________________________________

 FULL DETAILS:

 NOTATION:

       Mouse Buttons:  {S} = Select , {M} = Menu , {A} = Adjust.
           Keyboard :  <X> = Press key 'X'  etc.

 
       The screen has three main areas:-

  (A)  The COLOURS SECTION (bottom of the screen) displaying all 256 colours.
 
  (B)  The TOOLS BAR - to select a drawing tool.
 
  (C)  The DRAWING AREA  (with default background colour of white).
   
       We also need to consider the text drawing facility
  (D)  TEXT mode.

       We will deal with each of these in turn :

_____________________________________________________________________________


 (A) The COLOURS SECTION.

       When the pointer is IN the Colours Section :-

      1) Click on {S} to choose a 'pure' colour (the MAIN colour).

      2) Click on {A} to choose a 'dithered' partner to the MAIN
          colour ( the SECONDARY colour).

      3) Click and HOLD on {M} to give a Help window on the currently
          selected tool, Colour Box or when in Text mode.

      4) Press and hold <H> to give a general Help window.


      The 'MAIN' colour is displayed with a white surrounding rectangle.
      The SECONDARY colour is displayed with a small bar on top of the   
       chosen colour.                                     
          The 'MAIN' colour always has precedence.    The Colour Box 
       (on the extreme RHS of the Tools Bar) always displays the current
       pure/dithered colour which is in current use by the various drawing
       tools. If a dithered colour is in use then the Colour Box displays
       a dotted line across the colour box. If a pure colour is chosen
       then no dotted line will be shown.
           With a given MAIN colour , clicking {A} on any of the remaining
       255 different colours gives all the possible dithered colours
       corresponding to that given MAIN colour.  So a total of 32,640
       different dithered colours can be chosen!


           When the pointer is IN the Colours Section (and ONLY then)
      the following keyboard keys become active :-

   (a)  <TAB> - Clears the Drawing area to a default white background.
          
          <~> - Clears the Drawing area to a black background.

   (b) <Escape> - Quits the program and returns to the Desktop.

   (c)   <S>  - Saves the screen to a sub-directory PICS. 
                A screen will be automatically saved to PICS with
                filenames PIC1,PIC2,PIC3 etc. in succesion, during each
                session. After each session they should be renamed with
                more meaningful names ,since restarting the program will
                cause the filenames to revert to PIC1,PIC2 etc again.
 
   <SHIFT>+<S>  This brings up a SAVE Screen dialogue box. You will be
                prompted for the filing system you wish to use (Disc
                or RAM) and the Root Directory Catalogue will be
                displayed. A new Directory may then be chosen.
                Finally you will be asked for the filename of your picture,
                which will then be saved to the current/new Directory.

         Note - all pictures are stored in `Squash' format.

   (d)   <L>  - Loads a screen from the directory PICS. You will be
                prompted to input the required filename.

   <SHIFT>+<L>  This brings up a LOAD Screen dialogue box.
                Follow the prompts as for above. You will be prompted
                for the filename of the picture, which will then be
                loaded onto the screen. Additions / alterations may then
                be made to the picture.

         Note - both the usual Sprite format and `Squash' format pictures
                will be loaded automatically.


   (e)   Pressing the number keys <1>,<2>,....<6> will choose different
                mouse speeds. The default value is <3>.
  
                <1> is the slowest and allows maximum control.
                <6> is very fast ( and should be used with care ).

   (f)   <Insert> = Invert Colours of the whole screen,

         <Home>/<Page Up> will add Low/High `Contrast' to the whole screen.

         <Delete> / <Copy> / <Page Down> add Red / Green / Blue `tinges'.

   (g)   If the POLYGON tool is currently chosen then pressing <I> will
                enable you to type in the number of sides required -
                only numbers between 3 and 99 are allowed.

 
 
    NOTE:   The following keys are always active :-

           <SPACE>  -  aborts the current action  
                        (except for the tools FREE and AIR ).

            <ALT>    -  toggles between a pointer and a full cross-hair
                        cursor.  The latter is useful to align various
                        drawn objects (except for TEXT entry).

_____________________________________________________________________________


 (B) The TOOLS BAR.

      NOTE:-  some tools have one or two parameters. 
                
      When the pointer is on the Tools Bar :-

     (a) Click {S} to select either a tool or the Colour Box (on the 
          extreme RHS).

     (b) For single parameter tools : 
                   {M} will decrement the parameter
                   {A} will increment the parameter.

         For two parameter tools :   (i.e ARC, POLYGON,  AIR )
                   {M} increments the LHS parameter / icon
                   {A} increments the RHS parameter.
         
      Note:- If the POLYGON tool is currently chosen then pressing <I> on
             the keyboard will enable you to input the number of sides
             required  ( from 3  to  99).

_____________________________________________________________________________


 (C) The DRAWING AREA.
         
 NOTE:    When not actually drawing

         1) we can still use {M} and {A} to change the parameters of the
            various tools.

         2) press <ALT> to toggle between a pointer and a full
            cross-hair cursor.

         3) use {S}+<SHIFT> to pick up a pure colour from the drawing
            OR  use {A}+<SHIFT> to pick up a dithered partner colour.

         4) While using a particular tool pressing <SPACE> will abort/finish 
            the current action ( except for the FREE and AIR tools - just
            release {S} in these cases).


 *************     Click on {S} to start using any tool.      *************

           We shall deal with each of the drawing tools in turn :

 (1) JAGG.

         This gives a jagged "curve" between any two points.This tool
         is useful for drawing maps, trees, mountains etc. Use small steps
         to achieve greater control.
         The degree of jaggedness is governed by the parameter.
         Before starting, use {A} to increment or {M} to decrement the
         parameter.

         Click {S} to start. Moving the mouse will display a dotted line to
         your 'next' point.

         Click {S} again to continue to add points - a continuous jagged
         curve will be displayed, which passes through each of the points
         in succession.

         Click {A} to finish with your last point  ( with an open path ),
         OR click {M} to complete a closed path ( to your initial point ).
         
     Parameter: 1 = minor variation, 6 = violent variation( use with care!)

         Press <SPACE> to abort/finish.


 (2) PARALLELOGRAM.

          Click {S} to fix a start point. Moving the mouse will display a
          dotted line.  Clicking {S} again (or {A}) fixes this first side
          of the parallelogram.

          Moving the mouse now will display the possible parallelograms
          with this fixed side.

          Click {S} again to finish with an outline parallelogram,
          OR click {M} to get a colour filled parallelogram.

          Holding <C> down enables continuous drawing of parallelograms.

          Holding {A} down and moving the mouse will move the parallelogram
          bodily. While still holding {A} down click on {S} for outline,
          or {M} for a colour filled parallelogram. This enables copies
          of a parallelogram to be drawn in various positions.

          Press <SPACE> to abort/finish.


 (3) ELLIPSE.

        Click {S} to start. Moving the mouse will display various sized
        ellipses.
        Click {S} again to finish with an outline ellipse,
        OR  click {M} to finish with a colour filled ellipse.

        Clicking / Holding <Z>,<X> on the keyboard will rotate the
        ellipse anticlockwise / clockwise.
 
        Holding <C> down fixes the centre, enabling 'concentric' ellipses
        to be drawn.
        ( Hold <C>+<X>+{Select} to generate some pretty patterns.)

        Holding {A} down will enable the ellipse to be moved bodily.
        Clicking on {S} / {M} as well will still give outline / filled
        ellipses. 
 
        'Pretty' patterns can be generated by holding down {A} and
         <Z> (or<X>) and then clicking rapidly/holding on {S} (or{M}).

           Press <SPACE> to abort/finish.


 (4) ARC.

        This tool enables smooth curves (open or closed) to be drawn
        through various points.

        The R.H parameter adjusts the width of the curve :-
        1 = thinest line curve, ..., 6 = thickest line curve (default=1)

        The L.H parameter controls the degree of 'curvature' :-
        A = sharpest curves ,  F = most 'bulbous' curves (default=D)

        {M} increments the 'curvature',{A} increments the line width.

        Click {S} to start. Moving the mouse will display a dotted line.
        Click {S} again to continue to add points - a smooth curve will be
        drawn continuously through the succesive points.

        Double clicking {S} will force a sharp vertex/corner.

     Click {A} on the last point to finish with a smooth open curve, OR
     click {M} to finish with a smooth closed path (to your initial point).

          <SPACE> aborts the last/current section.

     Note: the first 'branch' is not finalised until the final {A} or {M}.


 (5) CIRCLE.

       Click {S} to start. Moving the mouse displays various sized circles,
       centered on the initial point.

       Click {S} again to finish with an outline circle,
       OR click {M} to finish with a colour filled circle.

       Holding <C> down enables concentric circles to be drawn.

       Holding {A} down will enable the circle to be moved bodily.
       Clicking on {S}/{M} as well will still give outline/filled circles.

           Press <SPACE> to abort/finish.


 (6) FREE.

       This is a freehand drawing tool.

       Press the number keys <1>,...,<6> to select the
       speed/smoothness of drawing. The default value is 3.

       Click {S} to start, and HOLD it down while moving the mouse.
       This will generate a free-hand curve.
       Hold {A} as well to gradually thicken the line, or {M} to reduce
       the width.

       The parameter determines the width of the line :-
       1 = thinest line , ..., 8 = thickest line.
       (Before drawing, use {A} to increment, {M} to decrement.)

       Holding keys <H>/<V> will force horizontal/vertical lines.

       Hold  <Insert> to Invert colours

       OR  <Home> / <Page Up> for Low / High contrast.

      ERASER: - This tool can also be used as an eraser, if the background
                colour is chosen as the current colour.

        Holding {S}+<SPACE> will display a small outline circle (for
        thickness > 3 ) which makes it easier to see with accuracy 
        the area to be erased.


 (7) LINE.

        This tool enables straight lines to be drawn (continuously)
        in various widths.  The resulting polygonal shapes can be
        open or closed.

     Click {S} to start. Moving the mouse will display a dotted line.

     Click {S} again to continue to add points - a continuous path of
     straight lines through the succesive points will be displayed.

     Hold keys <H>,<V> to force horizontal / vertical lines.

     Click {A} to finish with your last point - giving an open path,
     OR press <C> to complete a closed path to your initial point.
     OR click {M} to finish with a colour filled triangle ( formed by
     the current point and the previous two points that were fixed).

         The parameter determines the width of the line :-
         1 = thinest line, ..., 8 = thickest line.

      Before drawing, use {A} to increment the width, {M} to decrement.

      (Note: using small steps will almost generate a smooth curve)

         Press <SPACE> to abort/finish.


 (8) FILL.

        Click {S} to fill an area with the current colour.

         If the current colour is 'pure' then filling will always work,   
        irrespective of the colour already present in the chosen area.

         If the current colour is a dithered one then filling will only
        work if the colour in the area is 'pure'.  So to overwrite a
        dithered area you must first fill the area with a pure colour and
        THEN refill with your chosen dithered colour.

         Pressing <SPACE> 'unfills' or 'undoes' the last fill (but only if 
        NO colour changes have been made in the meantime).


 (9) RECTANGLE  (and COPY)

        Click {S} to start.
           Moving the mouse displays various rectangles, with one
           vertex at the initial point.
        Click {S} again to finish with an outline rectangle,
     OR click {M} to finish with a colour filled rectangle.

        Holding {A} down will enable the rectangle to be moved bodily,
           and clicking on {S}/{M} will still give outline/filled
           rectangles.
                             
        Pressing <Q> will force the rectangle into a square.

 Rotation:

        Pressing <C> ( or <B>,<Z>,<X> ) will enter rotation mode.

        Pressing <Z>,<X> will rotate the rectangle anticlockwise,clockwise.
        Pressing <A>,<S> will rotate by 15 increments.

        Use the cursor keys to expand/contract its height/width.
        (Pressing Ctrl+<Z>,<X>,cursor keys will give finer control).

        Use Keypad 1,3 to Shear in `X' direction,
        and Keypad 2,5 to Shear in `Y' direction.

        Use <,> for smooth global reduction,magnification of the size.

        Pressing <R> will return the rectangle to its original dimensions.
        Pressing <Q> will force the rectangle into a square. 

        Press <B> to toggle on/off using your rectangle as a brush.

        Click {S} (or press <O>) for outline rectangles.
        Click {M} (or press <F>) for colour filled rectangles.

              Use <SPACE> to abort/finish.

        
  COPY Mode:-  to make a copy of a chosen area at a different place.
        This copy can be flipped, rescaled, rotated or used as a brush.

        Press <Copy> to start COPY mode on the chosen rectangular
        area ( a sprite area ).  A 'beep' sound will occur.

        Move the area to your desired place and click {S}.
        A copy of the chosen area will be drawn,leaving the original
        area intact.This can be repeated as many times as desired.

        Pressing <H> will give a  horizontally flipped copy, while
        pressing <V> will give a vertically flipped copy of the
        original sprite area.
         
        Use the cursor keys to adjust the width/height of the sprite.

        Use Mouse {Adjust}/{Menu} for smooth global magnification/reduction.
        Use the >,< keys to double/halve the dimensions.

        Press <Z>,<X> to rotate anticlockwise/clockwise.
        ( Ctrl+<Z>,<X>,cursor keys will give finer control )

        Pressing <Q> will force the rectangle into a square.

        Pressing <R> will return the sprite to its original dimensions.        
        ( Press <O> to get outline rectangle in current foreground colour.
          Press <F> to get a colour filled rectangle. )

        Press <B> to toggle on/off the Brush facility.
        Holding {S} down will then draw the sprite as a paint brush. 
        

        NOTE: width,height (and horiz,vertical) may lose their contexts
        at larger angles of rotation and adjusting these may seem to
        have the opposite effect to that required. 
        To keep track of this the outline rectangle has little circles
        on the two 'top' corners. You should regard this edge as the 
        'top' edge - <H> will always flip about a line parallel to this
        'top' edge, while <V> will always flip about a line perpendicular
        to this 'top' edge.
        If still in doubt just use the 'opposite' key(s).

              Press <SPACE> to abort/finish COPY mode.

  Note: <Insert> = Invert colours, <Home> / <Page Up> = Low / High contrast.
 
                        
 (10) POLYGON.
 
        Click {S} to start. Moving the mouse will display various polygons
           (or the surrounding ellipse,if the number of sides is large)

         The L.H icon displays the three 'styles' viz. Outline,
         Outline with spokes or just spokes.
         When not drawing {M} toggles through the various styles.

         The R.H parameter is the number of sides.  When not
         drawing {A} increments the number of sides (from 3 to 9).
         Press key <I> to input your own number (from 3 to 99).                                                              

       Click {S} again to finish with a polygon in the chosen style,
    OR click {M} to finish with a filled polygon (irrespective of style).

        Holding <C> down enables concentric polygons to be drawn.

        Hold {A} down to move the polygon bodily. Clicking on {S}/{M} as
                 well will still give the outline / filled polygons.

        Click or Hold <Z> / <X> to rotate anticlockwise / clockwise.
        ( Hold <C>+<X>+{Select} to generate some pretty patterns.)

        Click <H> to force a regular polygon (i.e inside a circle with the
                current height). Similarly click <W> for a regular 
                polygon with the current width.

        ( Hold <C>+<W>+{Select} to generate concentric regular polygons.)

        Note: 'Pretty' patterns can be formed , as with Ellipse.

               Press <SPACE> to abort/finish.


 (11) AIR (SPRAY).

        L.H.parameter is the density of the spray.  Use {M} to increment.
        A = lowest, ..., E = highest.

        R.H.parameter is the radius of the spray.   Use {A} to increment.
        1 = least, ..., 5 = largest.

        Hold {S} down to spray with fine dots, but ONLY if the pointer    
        is moving.

        {S}+<SPACE> ( or {S}+{M} or {S}+{A} ) will spray an area even if 
        the pointer is NOT moving.

        {S}+<D> gives a spray of coarser circular dots  ( D = 'Dots').

        {S}+<F> gives a spray of angular shapes  ( F = 'Foliage').

  ( <SPACE>,{M} or {A} as well sprays even if the pointer is stationary ).

                              
 (12) COLOUR BOX.

        Clicking {S} will pick up the colour from the drawing area which
         is under the pointer.
        Clicking {A} will pick up a dithered partner from the drawing area
         ( it  may be necessary to move the mouse a bit in an area
         containing a dithered colour ).

  At all stages the current colour (pure or dithered) is shown in the box.
                              
        SPECIAL EFFECTS (only when the Colour Box is the chosen tool):-

         Hold {M} down to 'scratch' an area with hues of the colour under
         the pointer.
 
         Hold {M}+<SPACE> to paint with 'blobs' of hues of the colour under
         the pointer.

_____________________________________________________________________________



 (D) TEXT Mode:
        
          Text mode can be entered at any time, by pressing <T>,
          irrespective of the current position of the pointer.
          Pressing <T> will display text dialogue boxes and enables
          entry of Text onto the drawing area.


          Press <Y> to make font changes, or any other key to choose
          the default/current value of font type.
 
               
          Enter your text at the text-prompt, followed by <RETURN>.
          ( Just pressing <RETURN> retains the current text string )
          The dialogue box disappears and a rectangle will appear on
          the screen. This can be moved around with the mouse and
          clicking {A} increases the size of the box, while {M} will
          decrease its size.

           Clicking {S} on the drawing area will now enter the text 
          within the box at the position of the pointer. The colour
          of the text will be the current main colour, but this can
          altered by choosing a new colour from the Colour Bar.
          ({S}+<Shift>=thick text, {S}+<Ctrl>=thicker text)
               
           If the pointer is on the Colour Bar then {S} will select a
          text colour (as usual) while {M} gives a Help-Text window.
          Note: Text can only be painted in one of the main colours -
          any dithered partner is ignored.
 
           Pressing <T> again brings back the font/text dialogue box,
          so that alterations or new text can be entered.

          The actions of various other keys are summarized below:-

                      Press <SPACE> to abort/finish.


          SUMMARY of the active keys during TEXT placement:

      <Select> = Plot the text,    or <B> = Paint the text as a Brush.
              
            ( +<Shift> =thick text, +<Alt> = thicker text )

      <T> = Re-enter the Font/Text dialogue box to make changes. 
 
      <L> = Toggle antialiasing        |    <SPACE> = Abort/Finish
                                       |
      Global magnification:  use {A}/{M} for smooth magnification/reduction,
      OR  use   > = Double size,  < = Half size 

      Rotation about the Origin: = <Z>,<X>  OR  <A>,<S> for 15 increment.

      Clear screen : <Tab> = White, <~> = Black.

      X-Stretch = Left,right cursors   |   Y-Stretch = Up,down cursors
                                       |
      X-Shear = Keypad <1>,<3>         |   Y-Shear = Keypad <2>,<5>
                                       |
      Flip about Width = <W>           |   Flip about Height/Depth = <D>
                                       |
      Reflection in Vertical = <V>     |   Reflection in Horizontal = <H>
                                       |
      Reflection in the Origin = <O>   |   Plot in n point circle = Keyboard
                                       |                            2,3,...,9
                                       |
      Restore default size/shape = <R> |   Plot in 12 point circle = <?>


           Note:-  'Origin' means the bottom-left of the text string.
           The 'background' colour used for antialiasing is taken as
           the screen background colour at the 'Origin',which may not
           always be suitable if there are numerous colours on screen
           (hence the facility to turn anti-aliasing OFF).


_____________________________________END_____________________________________