@DATABASE PerfectPaint.Guide
@$VER: PerfectPaint.guide English 1.0
@(C) Copyright İ 1998-1999 Georges HALVADJIAN" 
@AUTHOR Georges HALVADJIAN" 
@INDEX index 

@REMARK Translation Copyright İ 1999 Joe Mackay


@NODE "main" "PerfectPaint"

         @{bg shadow}@{B}                        @{UB}@{bg back}		@{bg shadow}@{B}                        @{UB}@{bg back}
         @{bg shadow} @{bg fill}@{B}                      @{UB}@{bg shadow} @{bg back}		@{bg shadow} @{bg fill}@{B}                      @{UB}@{bg shadow} @{bg back}
         @{bg shadow} @{bg shine}@{B} PerfectPaintPro V1.3 @{UB}@{bg shadow} @{bg back}		@{bg shadow} @{bg shine}@{B}  PerfectPaint V1.3   @{UB}@{bg shadow} @{bg back}
         @{bg shadow} @{bg fill}@{B}                      @{UB}@{bg shadow} @{bg back}		@{bg shadow} @{bg fill}@{B}                      @{UB}@{bg shadow} @{bg back}
         @{bg shadow}@{B}                        @{UB}@{bg back}		@{bg shadow}@{B}                        @{UB}@{bg back}


                                 AmigaGuide documentation

                      This doc was translated in English by Joe Mackay
____________________________________________________________________________________________
@{FG SHINE}ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{FG TEXT}
    
  @{" Introduction           " link introduction}
  @{" Installation           " link installation}

  @{" Toolbox                " link boite}
  @{" Menus                  " link Menus_PerfectPaint.guide/Main}
  @{" Popup Menus            " link PopUp}
  @{" Keyboard Shortcuts     " link Clavier}

  @{" Arexx Port             " link port}
  @{" Arexx Commands         " link Arexx_PerfectPaint.guide/Main}
  @{" Example Scripts        " link Scripts}    

  @{" History                " link history}
  @{" Author                 " link Auteur}

  @{" Extra Tools            " link Extras}

  @{" To do                  " link Afaire}


  @{" Jpeg.library           " link jpeg.library}
  @{" Render.library         " link render.library}

____________________________________________________________________________________________
@{FG SHINE}ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{FG TEXT}
  Copyright İ 1998-2000 Georges HALVADJIAN All Rights Reserved FreeWare


@ENDNODE
@NODE "Afaire" "To do"

  Certain functions are currently ghosted. 
  Lots of work to be done on brush deformation, animation.

@ENDNODE
@NODE "PopUp" "Popup Menus"
  
  Popup menus are activated by pressing the right mouse button.

@{bg shine}@{B} PerfectPaint @{UB}@{bg back}

  - Over the toolbox:
        New
        Load Picture
        Save Picture
        Load Animation
        Save Animation
        Paths
        Screen Format

  - Over the picture:
        Flip X
        Flip Y
        Rotate 90
        Picture Size

  - Over the ZOOM:
        Small
        Portrait
        Landscape
        Big

  - Over the 'pickup brush' icon:
        Load Brush
        Save Brush

  - Over the 'Stencil' icon:
        Clear Mask
        Invert Mask
        Edit Mask

  - Over the 'Spare' icon:
        Copy Spare to Main picture
        Copy Main Picture to Spare
        Swap Main picture and Spare

  - All tool icons associated with Arexx activate a popup menu which lists the
    contents of the Arexx script's drawer.

@{bg shine}@{B} PerfectPaintPro @{UB}@{bg back}

  - Over the toolbox:
        New
        Load Picture
        Save Picture
        Paths

  - Over the picture:
        Flip X
        Flip Y
        Rotate 90
        Picture Size

  - Over the ZOOM:
        Small
        Portrait
        Landscape
        Big

  - Over the 'pickup brush' icon:
        Load Brush

        Save without mask
        Save with Mask
        Save Deep

        Restore brush

        Smooth Border
        Density mapping
        Opacity

        Free brush

  - Over the 'Spare' icon:
        Copy Spare to Main picture
        Copy Main Picture to Spare
        Swap Main picture and Spare

  - All tool icons associated with Arexx activate a popup menu which lists the
    contents of the Arexx script's drawer.


@ENDNODE
@NODE "Extras" "Extra tools"

  These tools can be found in the directory 'PerfectPaint:Tools/',
  with their original manuals.
  They can also be found on Aminet.


@{FG SHINE}Jpeg2Mov@{FG TEXT}

   Short    : Creates a QuickTime-Movie
   Uploader : ALeX Kazik <alex@kazik.de>
   Author   : ALeX Kazik <alex@kazik.de>
   Type     : gfx/conv
   Version  : 2.3
   Requires : 68020+, AmigaOS 2.04? (Tested: 3.x)

   The latest Version can be found under:  http://www.kazik.de/en/jpeg2mov.html
                             My HomePage:  http://www.kazik.de/alx/


@{FG SHINE}BUILDAnim@{FG TEXT}

  BuildAnim can do one of three operations: 1) It can build an
  animation out of individual ILBM pictures, 2) it can split an
  animation into ILBM pictures, or 3) it can convert an animation
  from one compression type to another.

@{B}Auteur@{UB}@{FG TEXT}
  Christer Sundin (d8sunch@dtek.chalmers.se)


@{FG SHINE}MKANIM@{FG TEXT}
  Allows you to construct an animation in ANIM5 format.
    
  @{B}Author@{UB}@{FG TEXT}
    John Bickers
    214 Rata St
    Naenae 6301
    New Zealand

  @{B}E-Mail@{UB}@{FG TEXT}
    jbickers@templar.actrix.gen.nz


@{FG SHINE}NewConvert@{FG TEXT}
  Converts IFF images using datatypes.

  @{B}Author@{UB}@{FG TEXT}
    Alexander Lärz
    Neustädter Str.45
    07768 Kahla
    Germany

  @{B}E-Mail@{UB}@{FG TEXT}
    alexlaerz@t-online.de


@{FG SHINE}tapgif@{FG TEXT}
  Converts an IFF image to GIF format.

  @{B}Author@{UB}@{FG TEXT}
    John Bickers
    Level 6, Grand Arcade
    16 Willis St
    Wellington
    New Zealand

  @{B}E-mail@{UB}@{FG TEXT}
    jbickers@templar.actrix.gen.nz


@{FG SHINE}WhirlGif@{FG TEXT}
  Converts a series of GIF images to a GIF animtion.

  @{B}Author@{UB}@{FG TEXT}
    Kevin Kadow kadokev@msg.net

@ENDNODE
@NODE "Scripts" "Example Scripts"

Directory PerfectPaint:Rexx/

    @{" Box     " link SBox}
    @{" Circle  " link SCircle}
    @{" Ellipse " link SEllipse}
    @{" General " link SGeneral}
    @{" Line    " link SLine}
    @{" Point   " link SPoint}
    @{" Spline  " link SSPline}

@ENDNODE
@NODE "SBox" "Box"

@{B}AnimPainting_Box.rx@{UB}
  Simulates AnimPainting with the Box tool.
  You need to create an animation beforehand.
  The box will be drawn throughout the length of the animation.

@{B}Funny_Border.rx@{UB}
  Several ways to draw a border.
 
@ENDNODE
@NODE "SCircle" "Circle"

@{B}AnimPainting_Circle.rx@{UB}
  Simulates Animpainting with the Circle tool.
  You have to choose the circle's direction of rotation.
  You need to create an animation beforehand.
  The circle will be drawn throughout the length of the animation.

@{B}AnimPainting_Circle_Whirl.rx@{UB}
  Simulates Animpainting with the Circle tool.
  You have to choose the circle's direction of rotation.
  The circle will be drawn starting from its centre.
  You need to create an animation beforehand.
  The circle will be drawn throughout the length of the animation.

@{B}Anim_Pulsar.rx@{UB}
  Creates a pulsar effect (an expanding circle).
  You need to create an animation beforehand.

@{B}Make_AnimStar.rx@{UB}
  This script will create a star. You may choose the number of
  points it has and whether it is empty or filled.
  Then the star will be drawn on each frame of the animation,
  rotating through 90° throughout the animation's length.
  You need to create an animation beforehand.

@{B}Star.rx@{UB}
  This script will create a star. You may choose the number of
  points it has and whether it is empty or filled.

@{B}Total_Circle.rx@{UB}
  This script will create a circle with the specified number of points.

@{B}Sun.rx@{UB}
 This script will create a cartoon's sun.

@ENDNODE
@NODE "SEllipse" "Ellipse"

@{B}AnimPainting_Ellipse.rx@{UB}
  Simulates AnimPainting with the Ellipse tool.
  You have to choose the ellipse's direction of rotation.
  You need to create an animation beforehand.
  The ellipse will be drawn throughout the length of the animation.

@{B}Make_Star.rx@{UB}
  This script will create a star. You may choose the number of
  points it has and whether it is empty or filled.

@{B}Total_Ellipse.rx@{UB}
  This script will create an ellipse with the specified number of points.

@ENDNODE
@NODE "SSpline" "Spline"

@{B}AnimPainting_Spline.rx@{UB}
  Simulates AnimPainting with the Spline tool.
  You need to create an animation beforehand.
  The spline will be drawn throughout the length of the animation.

@{B}Total_Spline.rx@{UB}
  This script will create a spline with the specified number of points.

@ENDNODE
@NODE "SGeneral" "General"

@{B}FadeInBlack.rx@{UB}
  This script will fade an animation to black.
  You must specify the start and end frames, and whether it
  should fade in or out.

@{B}SaveAnimGif.rx@{UB}
  Saves the current animation in AnimGIF format.

@{B}SaveGif_Brush.rx@{UB}
  Saves the current brush in GIF format.

@{B}SaveGif_Picture.rx@{UB}
  Saves the current picture in GIF format.

@{B}SaveNewIcon.rx@{UB}
  Takes the two supplied brushed and creates a NewIcon.
  This script needs the executable 'Injectbrush' in your C: directory.

@{B}Warp.rx@{UB}
  Uses the current picture to create a 10-frame animation, performing
  a random warp on each frame. The animation is then played.

@{B}Communication with ADPro@{UB}
  LoadADPro_Brush.rx
  LoadADPro_Picture.rx
  SaveADPro_Brush.rx
  SaveADPro_Picture.rx

@ENDNODE
@NODE "SLine" "Line"

@{B}AnimPainting_Line.rx@{UB}
  Simulates AnimPainting with the Line tool.
  You need to create an animation beforehand.
  The line will be drawn throughout the length of the animation.

@{B}Funny_Line.rx@{UB}
  Several ways to plot a line.

@{B}Line_Measure.rx@{UB}
  Gives the exact length of a line.

@{B}Angle repare.rx@{UB}  

@{B}Arrow.rx@{UB}
 Make Arrows.
@ENDNODE
@NODE "port" "Arexx Port"

The Arexx port may be accessed in different ways.

If the script is started from within PerfectPaint, the first parameter
passed to the script is the name of the port to use.

Example:
    /* Title of script*/
     Options results
     parse ARG Port ..... b
     ADDRESS value Port
     .....
         

There are many ways to execute a script from PerfectPaint:

@{FG SHINE}In the simplest way, the script is not associated with any tool.@{FG TEXT}

Example:
    /* Title of script*/
     Options results
     parse ARG Port b
        ADDRESS value Port    
     ......


@{FG SHINE}If the script is associated with a tool:@{FG TEXT}

        @{B}Line:@{UB}@{FG TEXT}
            parse ARG Port x1 y1 x2 y2 b
          /* x1, y1: co-ordinates of the start of the line
             x2, y2: co-ordinates of the end of the line */

        @{B}Circle:@{UB}@{FG TEXT}
          parse ARG Port x1 y1 r b
          /* x1, y1: co-ordinates of the centre of the circle
             r: the circle's radius */

        @{B}Box:@{UB}@{FG TEXT}
          parse ARG Port x1 y1 x2 y2 b
          /* x1, y1: top-left corner of the box
             x2, y2: bottom-right corner of the box */
  
        @{B}Ellipse:@{UB}
          parse ARG Port x1 y1 r1 r2 b
          /* x1, y1: centre of the ellipse
             r1, r2: the ellipse's radii */

        @{B}Point:@{UB}
          parse ARG Port x1 y1 b
          /* x1, y1: co-ordinates of the point */

        @{B}Spline:@{UB}
          parse ARG Port x1 y1 x2 y2 x3 y3 b
          /* x1, y1: Co-ordinates of the start of the spline
             x2, y2: Co-ordinates of the end of the spline 
             x3, y3: Point of curvature */ 


@{FG SHINE}If the script is associated with the Bridge function:@{FG TEXT}

          parse ARG Port1 Port2 b
          /* Port1: Source port
             Port2: Destination port */ 

__________________________________________________________________________
@{FG SHINE}ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{FG TEXT}
    
@{FG SHINE}If the script is not started by Perfectpaint, an instance of PerfectPaint
must be searched for and its port found.@{FG TEXT}

Example:
    /* Script name */

     found=0
     Port="Perfect_Paint."
     DO i=1 to 7
        IF SHOW('P',Port||i) THEN DO
           Port=Port||i
           found=1
           LEAVE
        END
     END

    if found=0 then EXIT
     /* No instances of PerfectPaint are running, so quit */

     ADDRESS value Port 
    ...

__________________________________________________________________________
@{FG SHINE}ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{FG TEXT}

If a script is called 'StartUp.rx' and is found in the PerfectPaint drawer
along with the main program, this script will be executed at startup.

@ENDNODE
@NODE "history" "History"

  @{"   V1.3  " link H3} 18 April 2000
  @{"   V1.2  " link H2} 30 Nov 1999
  @{"   V1.1  " link H1}

@ENDNODE

@NODE "H3" "V1.3"

  PerfectPaint (1-8bits) & PerfectPaintPro (24bits)
  -------------------------------------------------

  - Right mouse button on Undo icone: Redo Object
  - Improve Shine Effect
  - Improve popup menus
  - Improve polygone filling
  - Fix a bug with very big antialiasing circle
  - Improve Spray Effect
  - New text effect:
       - Azzaro
       - Emboss
  - New Arexx command
 	     - pp_UpdateUndoBox (Undo only a part of the picture)
		   - pp_GetWidthT (Width of curent text)
		   - pp_GetHeightT (Height of current text)
       - pp_freebrush
       - pp_PickBrush
       - pp_ScaleBrush
  - Improve Pick-Brush
    if you pick a brush with shift key, Background color will not be transparent.
  - Improve memory allocation, Now PerfectPaint & PerfectPaintPro are compatible with
    virtual memory (Gigamem, VMM)



  PerfectPaintPro (24bits) only:
  ------------------------------

  - Big work on Brush:
       - Load & Save With or without alpha chanel.
       - Effect: Smooth border, Mapping density, Opacity
  - Animation is available
  - Palette menu is available
  - More effects available
  - New text effect: 
       - Stone
       - Motion_Toolkit
  - SpeedUp undo,brush preview (zoom)
  - little bug fixed with Load&Save Jpeg
  - Improve Compose requester and add a popupmenu for it.
  - Load HAM6 and HAM8 Picture
  - New commands: 'save Render Image' 'Save Render brush' 'Save Render Anim'
    With the help of "render.library" you can reduce nb of colors of
    your picture, brush or animation with various dithering.
    (you need render.library)
  - New arexx command

    COMPOSE REQUESTER
    * pp_ComposeReqOn
    * pp_ComposeReqOff
    * pp_Compose
    
    CONVOLUTIONS
    * pp_ConvInit
    * pp_Conv y C1 C2 C3 C4 C5

    RENDER REQUESTER
    * pp_RenderReq
    * pp_Render

    * pp_BrushOpacity
    * pp_SavePrefs
    * pp_PickBrush x y width height
    * Improve pp_Bsave
    * pp_AskMultiFile
		

  - Improve Gif script (Save GIFPicture,GIFBrush,GIFAnimation)
    Now these scripts can work on 24Bits version of Perfectpaint
  - New script: - Save QuickTime movie (you need Jpeg2mov)
                - Load Postscript (you need Ghostscript)
 
@ENDNODE

@NODE "H2" "V1.2"

1-8 Bits

  - Some bugs fixed with PopUp Menus and animation
  - Better look with VisualPrefs
  - Improve cloud effect
  - Little bug corrected with arexx
  - Little bug corrected with the spreadcolor
  - Little bug corrected with Antialiased line.
  - Some shortcuts are changed (see doc)
  - Improve displace effect
  - Xdpi and Ydpi can be used with the font requester
  - New tool on the toolbox: Symmetry (see doc)
  - Fastest antialiased circle
  - Improve 'Pick brush', you can now directly select in the tool box,
    the way to pick it.
  - Brush deformation: 
         - Size (with or without antialiasing)
         - Rotation (with or without antialiasing)
         - Shear

24 Bits

  - Beta version
  - Load ilbm (1-24 bits)
  - Load & Save Jpeg (with @{"Jpeg.library" link Jpeg.library} )
  - Not all menus, effects, commands are available, it's really a beta version.
  - Fastest then 8bits version
  - Improve effect with compose requester (add,sub,alpha...)
  - Improve convolutions, fastest, preview, popupmenu...
  - New palette requester

@ENDNODE

@NODE "H1" "V1.1"

- New function: "Adjust Palette", you can modify your palette
   with R,V,B,Contrast,Color and Brightness.
- Improve GUI:
         * All Window can be moved.
         * Buttons are more system friendly
- Stencil icon have now a PopUp menu with
         * Clear Mask
         * Invert Mask
         * Edit Mask
- Add a tooltype: 'DPAINLIKE', with this toltype, toolbox will always 
   be opened on the right of the screen, and zoom window on the left.
- Improve Popup Menus
- No more assign is needed.
- Improve zoom window:
         * Add a popup Menu
         * Add a closed button
         * Window can be moved
         * less bugs
- 22 new Arexx commands
- Animation keep in memory Jiffies.
- Improve 'GifAnim' script
- New script:
         * Arrow for line tool
         * Sun for circle tool
         * Angle repare
- Improve texture requester with popup menu (">"), Preview guide ("?")
- Improve Text:
         * Special effects (Bicolor,Deco,Granit,Relief,Shadow...).
         * Full animation.
         * rotation, Shear, scaleX and ScaleY.
- Improve text requester with popup menu (">") and preview guide ("?")
- 'Make/Redo Object' are now Ok with polygons,freedraw, Text and arexx.
- Picture and brush can be saved with thumbnail (with NewIcons)
- and many more improvements

@ENDNODE

@NODE "Render.library" "Render.library"

Short:    image processing kernel
Author:   Timm S. Müller
Uploader: Timm S. Müller (timm.mueller@darmstadt.netsurf.de)
Type:     dev/misc
Version:  30.0
Requires: Kickstart 2.04 (v37), MC68020


render.library
-----------------------------

  render.library  is  an amiga shared library that serves an image
  processing  kernel.  it  is  an  interface between truecolor and
  chunky  graphics,  and  it supports all amiga-specific pixel and
  color   schemes.   render.library   provides palette-management,
  histograms,  alpha-channel processing, color reduction, scaling,
  rendering,  dithering,  texture-mapping, and many conversion and
  support functions.


author
----------------------------

  bifat / TEK neoscientists

  timm.mueller@darmstadt.netsurf.de

  http://come.to/neoscientists

  Timm S. Müller
  Bartningstraße 15
  64289 Darmstadt
  ++49 (0)6151 715917
  

requirements
-----------------------------

  - mc68020 or better
  - kickstart 2.04 (v37) or better


features
-----------------------------

  - histograms up to 24 bit
  - rendering
  - dithering
  - color quantization
  - heavy alphachannel support
  - HAM mode support
  - custom memory management
  - scaling
  - low-level texture-mapping
  - conversion functions
  - fully documented with autodocs, charts, tutorials
  - supplied with C, Assembler, and E includes
  - freeware

@ENDNODE

@NODE "Jpeg.library" "Jpeg.library"

Short:    V5.1 shared library to load/save jpegs
Uploader: paulh@mafeking.scouts.org.au (Paul Huxham)
Author:   paulh@mafeking.scouts.org.au (Paul Huxham)
Type:     util/libs

On Aminet: jpeglibrary50.lha

For anyone who wants to use/manipulate jpeg files in their own applications,
this library makes it very easy.

jpeg.library is a shared library that can be used to examine, load and
save jpeg images. You can have multiple jpegs objects (load/save), supports
all the standard jpeg quality and smoothing parameters and can scale loaded
images (smaller). Jpeg image data can reside on disk or in memory.

Example programs included.

* Version 5.1 fixes a problem with previous 020ffp and 040ffp versions of
the library.

** This software is based in part on the work of the Independent JPEG Group.

For the latest version of jpeg.library and to check out other software I
have written, check my home page at:

http://mafeking.scouts.org.au/~paulh/

İ 1998, 1999 Paul Huxham


@ENDNODE

@NODE "Clavier" "Keyboard Shortcuts"

@{B} Space @{UB} Puts a pattern on the window to aid precision
@{B} j @{UB} Activates or disactivates the spare page
@{B} p @{UB} Activates the palette editor
@{B} u @{UB} Undo
@{B} HELP @{UB} Brings up the documentation
@{B} DEL @{UB} Gets rid of the cursor

@{B} Up/down arrow keys + right Alt @{UB} Change the pen size

@{B} n @{UB} New
@{B} l @{UB} Loads a picture
@{B} s @{UB} Saves the current picture
@{B} q @{UB} Quit

@{B} b @{UB} Loads a brush
@{B} c @{UB} Saves the current brush

@{B} | @{UB} Displays co-ordinates
@{B} / @{UB} Bridge function

@{B} x @{UB} Flips the brush about the X-axis
@{B} y @{UB} Flips the brush about the Y-axis
@{B} z @{UB} Rotates the brush by 90°

@{B} X @{UB} Flips the picture about the X-axis
@{B} Y @{UB} Flips the picture about the Y-axis
@{B} Z @{UB} Rotates the picture by 90°

@{B} F5 @{UB} Lets you specify an object's dimensions manually
     (circle, line, curve, ellipse, box)
__________________________________________________________________________
@{FG SHINE}ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{FG TEXT}
 @{FG SHINE}ZOOM :@{FG TEXT}
  @{B} + @{UB}@{FG TEXT} Increase the zoom factor
  @{B} - @{UB}@{FG TEXT} Reduce the zoom factor
  @{B} Enter @{UB}@{FG TEXT} Refocus the zoom
  @{B} arrow keys @{UB} Move the zoom
__________________________________________________________________________
@{FG SHINE}ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{FG TEXT}
 @{FG SHINE}BROSSE :@{FG TEXT}
  @{B} F1 @{UB}@{FG TEXT} Transparency
  @{B} F2 @{UB}@{FG TEXT} Colour
  @{B} F3 @{UB}@{FG TEXT} Solid
  @{B} F4 @{UB} Previews the brush in box form
       Pressing F4 again shows only the brush's mask.
__________________________________________________________________________
@{FG SHINE}ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{FG TEXT}
 @{FG SHINE}ANIMATION :@{FG TEXT}
  @{B} 1 @{UB}@{FG TEXT} Previous frame
  @{B} 2 @{UB}@{FG TEXT} Next frame
  @{B} 3 @{UB}@{FG TEXT} Go to frame...
  @{B} 4 @{UB} Play animation
  @{B} 5 @{UB} Play animation once
  @{B} 6 @{UB} Ping-pong animation

  During animation playback:
  @{B} <- @{UB} Slow down animation
  @{B} -> @{UB} Speed up animation
  @{B} Space @{UB} Stop the animation

@ENDNODE
@NODE "Auteur" "Author"

Georges HALVADJIAN
21 allée des jardins de Francheville
69340 Francheville FRANCE

gothic.fr@free.fr
HTTP://gothic.fr.free.fr/amiga/index.html

@ENDNODE
@NODE "introduction" "Introduction"

    @{I}Throughout the documentation:@{UI}
@{I}    LMB = Left Mouse Button@{UI}
@{I}    RMB = Right Mouse Button@{UI}
@{I}    Bg = Background@{UI}
@{I}    Fg = Foreground@{UI}

  Paint, Anim and manipulate pictures from 1bit to 24bits

@{B}Requirements:@{UB}

 PerfectPaint:(1-8bits)
 ----------------------
    Minimum 68030 + FPU
    Minimum OS 3.0
    Graphics card recommended

 PerfectPaintPro:(24bits)
 ------------------------
    Minimum 68030 + FPU
    Minimum OS 3.0
    Graphics card with Cybergraphique or Picasso96
    Render.library recommanded
    Jpeg.library recommended

@{B}Some features of PerfectPaint:@{UB}
     Drawing in 1-24 bits
     Antialiasing
     Spare page
     Stencil
     Symmetry
     Multiple-level undo
     Text with antialiasing, bevel, outline and effects
     Different types of pen
     Animation
     Real-time zooming (1-8bits)
     Arexx
     Brush: Mapping density, Opacity, Smooth border (24bits)
     Several effects
     *Colour:
           - Shade
           - Light
           - Transluency
           - Inverse color
           - False color
           - grey
           - Treshold
           - Airbrush
           - Spray
     *Wrap: 
           - Texture
           - Brush
           - spare
           - Cloud
           - Gradient
     *Distortion:
           - Displace
           - Fish eye lens
           - FlipX
           - FlipY
           - Fractal
           - Ripple
           - Rotate
           - Sin
           - Straw
           - Twirl
           - Wave
     *Convolution
     *Other:
           - Shadow
           - Grain
           .......

Read the documentation for more information.

@ENDNODE
@NODE "installation" "Installation"

@{bg shine}@{B} PerfectPaint & PerfectPaintPro @{bg back}@{UB}

Unarchive the file PerfectPaint.lha and copy the
entire "PerfectPaint" drawer wherever you like.

This drawer contains a font called "Xen.font".
Copy:
  Xen.font
  Xen.font.info
  Xen.info
  The XEN directory
to your FONTS: directory.

Create a new assignment in your user-startup:
Assign "PerfectPaint: ..."
Example:
  Assign PerfectPaint:   DH0:PerfectPaint

Installation of RexxMast:
If it is not already there, copy the RexxMast
executable to your WBStartup drawer.

@{B}@{bg shine} PerfectPaintPro only @{bg back}@{UB}

Installation of @{" Jpeg.library " link Jpeg.library} (via Aminet)
 (if you want to load and save Jpeg picture)

Installation of @{" Render.library " link Render.library} (via Aminet)
 If you want to recude the number of color of your picture.
 (usefull if you want to create gif, gifanim, anim5...)

@ENDNODE
@NODE "boite" "Toolbox"

  All icons with a dog-ear have an action accessible with the right mouse
button.(*)

 _______________
| _____________ | 
||             || 
||    Pens     ||
||_____________|| 
|               |     A : Circle tool - empty, filled, Arexx (*)
| ___  ___  ___ |     B : Box tool - empty, filled, Arexx (*)
||   ||   ||   ||     C : Line tool - empty, filled, Arexx (*)
|| A || B || C ||     D : Spline tool - empty (*), filled (*), Arexx (*)
||___||___||___||     E : Fill tool
| ___  ___  ___ |     F : Point tool - freehand, joined, filled, Arexx (*)
||   ||   ||   ||     G : Ellipse tool - empty, filled, Arexx (*)
|| D || E || F ||    @{" H " link Hh}: Text tool (*)
||___||___||___||     I : Polygon tool - empty, filled, empty bézier, filled bézier
| ___  ___  ___ |
||   ||   ||   ||    @{" a " link a}: Capture brush (*)
|| G || H || I ||    @{" b " link b}: Grid (*)
||___||___||___||    @{" c " link c}: Zoom (*)
|               |    @{" d " link d}: Spare page (*)
| ___  ___  ___ |    @{" e " link e}: Effects (*)
||   ||   ||   ||    @{" f " link f}: Stencil (*)
|| a || b || c ||    @{" g " link g}: Symmetry (*)
||___||___||___||    @{" h " link h}: Specil tools: Warp (*)
| ___  ___  ___ |    @{" i " link i}: Antialiasing
||   ||   ||   ||
|| d || e || f ||    @{" j " link "picture/palette.iff/Main" 0}: Colour selector
||___||___||___||    @{" k " link "picture/palette.iff/Main" 0}: Current colours
| ___  ___  ___ |    @{" l " link "picture/palette.iff/Main" 0}: Colour inversion
||   ||   ||   ||    @{" m " link "picture/palette.iff/Main" 0}: Palette
|| g || h || i ||    @{" Palette Editor " link editpal}
||___||___||___||    
|               |    @{" n " link n}: Trashcan (*)
|      ___      |    @{" o " link o}: Undo/Redo (*)
|     |   |     |    @{" p " link p}: Arexx (*)
|  j  | k |  l  | 
|     |___|     | 
.               .
.               . All drawing actions with the left mouse button will be made in the
.      m        . primary colour.
.               .
| ___  ___  ___ | All drawing actions with the left mouse button will be made in the
||   ||   ||   || background colour.
|| n || o || p ||
||___||___||___||
|_______________|

The circle, box, line, spline, ellipse and point tools may have an Arexx script
associated with them.
You can select this script by right-clicking on the tool icon, when it appears
with the Arexx crown symbol.

Some example scripts are supplied:

     @{" Circle script  " link SCircle}
     @{" Box script     " link SBox}
     @{" Line script    " link SLine}
     @{" Spline script  " link SSpline}
     @{" Ellipse script " link SEllipse}
     @{" Point script   " link SPoint}

@ENDNODE
@NODE "editpal" "Palette Editor"

You can edit a palette using either the RGB or HSV systems.
To select a colour, click with the LMB on the required colour.

 @{B} COPY @{UB}Copies one colour to another
Select a colour, click on 'COPY' then select the destination colour.

 @{B} EX @{UB}Exchanges two colours in the palette
Select a colour, click on 'EX' then select a second colour.
The first colour will become the second colour and vice-versa.

 @{B} SWAP @{UB}Exchanges two colours in the palette
...but without modifying the current picture.
(The current image will be remapped.)

 @{B} SPREAD @{UB}Creates a colour gradient
Select the start colour, click on 'SPREAD' then select the destination
colour. A colour gradient will be made between the two colours.

 @{B} R1 R2 R3 @{UB}These are the colour ranges, used by the 'Gradient' effect
To define a range select the start colour, click on 'R1', 'R2' or 'R3'
then select the end colour.

 @{B} UNDO @{UB}Restores the palette to the way it was before the requester
       was opened

 @{B} QUIT @{UB}Closes the requester and discards any changes made

 @{B} OK @{UB}Closes the requester and keeps any changes made

@ENDNODE
@NODE "o" "Undo/Redo"

LMB: Activates Undo
RMB: Activates Redo Object

  10 levels of undo are allowed.

@ENDNODE

@NODE "g" "Symmetry"

  Symmetry can be used with all tools.
  
LMB: Activate Symmetry
RMB: Lets you choose the type of Symmetry, center and radius


@ENDNODE

@NODE "p" "Arexx"

LMB: Activates an Arexx script
RMB: Brings up a requester which lets you select a script for that icon
     as well as for the circle, box, line, spline, ellipse and point
     icons.

  @{" Arexx Port        " link port}
  @{" Arexx Commands    " link Arexx_PerfectPaint.guide/Main}
  @{" Example Scripts   " link Scripts}

@ENDNODE
@NODE "n" "Trashcan"

LMB: Erases the current picture, replacing it with the background colour
RMB: Brings up an erase requester for animation, allowing you to erase
     one frame or a series of frames

  The stencil will be used, if it is active.

@ENDNODE
@NODE "h" "Warp"

LMB: Activates the warp tool
RMB: Lets you choose the warping strength

  Deforms the picture using a warping technique.
  If the 'Antialiasing' icon is selected, the effect will be antialiased.

@ENDNODE
@NODE "f" "Stencil or Mask"

LMB: Activates the stencil
RMB: Brings up the stencil construction requester

  Creating a stencil allows you to paint around an image without painting
  over it, as if it were protected by a mask.

  @{B}The requester:@{UB}
  You may reposition it anywhere on the screen by dragging the requester's
  title bar.

  Click on the colours that you wish to use in your stencil. You can select
  the colours by clicking on the requester's palette or on the image itself.

  After choosing all the colours you wish to protect, click OK to create
  your stencil.

  The selected colours will now be protected against all attempts at
  drawing.

@ENDNODE
@NODE "i" "Antialiasing"

  If the icon is selected:
   - Any reduction in size of the picture will be antialiased.
   - Certain distortion effects will be antialiased.
   - Drawings are antialiased

@ENDNODE
@NODE "e" "Effects"

@{bg shine} PerfectPaint: @{bg back}

LMB: Activates the current effect. If you haven't chosen an effect a
     requester will appear listing all the available effects.
RMB: Brings up the effect requester

  You can apply an effect to all the tools.
  There are 5 types of effect:
  - Colour
  - Wrap
  - Deform
  - Pixelate
  - Convolution
  - Other

@{bg shine} PerfectPaintPro: @{bg back}

LMB: Activates the current effect. If you haven't chosen an effect a
     requester will appear listing all the available effects.
RMB: Brings up the effect requester or the compose requester
     (the compose requester will allow you to compose
     between the current effect and the current picture)
     compose: Opacity, Add,Sub,Darken,Alpha,Inv-Alpha

  You can apply an effect to all the tools.
  There are 4 types of effect:
  - Colour
  - Wrap
  - Deform
  - Pixelate
  - Other

  Convolutions was rewritten with RT preview and is now in 'Other'


@{" Effects " link Effect_PerfectPaint.guide/Main}

@ENDNODE
@NODE "d" "Spare page"

LMB: Activates the spare page (if you have enough memory) or disactivates it.
     The spare page has the same size and depth as the current picture.
RMB: Parameters

You can:
  copy the spare image to the current image
  copy the current image to the spare image
  exchange the spare and current images

  All modifications to the current image (loading, size and depth changes)
  initialise the spare page.

@ENDNODE
@NODE "c" "Zoom"

RMB: Activates zooming
LMB: Zoom parameters

'x2, x4, x8' Magnification strength

'Low,  M1, M2, Big' Size of zoom window:
   Low 320x256
   M1 320x512
   M2 576x256
   Big 576x512

There are two zoom modes:
- Manual mode
  This is a static mode. At any time, you can adjust the zoom positon with
  the 'Enter' key on the numeric keypad and zoom with the '+' and '-' keys.

- Dynamic mode (PerfectPaint only)
  The magnification is in real-time, you can also zoom with the '+' and '-'
  keys on the numeric keypad.

The zoom is just a representation of the picture. For the time being you
cannot draw on it.

@ENDNODE
@NODE "b" "Grid"

RMB: Activates the grid
LMB: Grid parameters

'X spacing' and 'Y spacing' represent the grid's size.
'View grid' makes the grid visible in the window, you can also choose
            its colour.
'Grab' is not currently available.

@ENDNODE
@NODE "Hh" "Text tool"

 If you select the text tool with the right mouse button, the text editor
 will appear.

 If you select the text tool with the left mouse button, the text brush
 will become active. If one does not exist, the text editor will appear.

 Accepted fonts:

    - Vector:
           Options: Outline and Bevel with a specified thickness
                    Two levels of antialiasing
                    Rotation, Shear, ScaleX, ScaleY and Animation.
    - Bitmap:
           Options: Outline and Bevel with a specified thickness
                    Two levels of antialiasing
    - Colour: (PerfectPaint only)
           Options: Use the font's palette
                    Remap the brush without modifying the current palette
                    Colourize: For greyscale or antialiased fonts

 Once the brush has been created, you may at any time choose a primary
 colour. The brush will automatically adapt itself to the new colour.

 If the brush is antialiased, it will appear with incorrect colours.
 However, it will be drawn correctly once it is placed on the page.

 The text brush may have all the available effects applied to it.


@{" Text Requester (picture) " link "picture/Text.iff/Main" 0}


@ENDNODE
@NODE "a" "Capture brush"

 To capture a brush, 
    - select 'pick brush' icon
    - select a tool (box, circle...)
    - draw the object on your picture

  If you press Left Shift, the background colour will
  not be transparent.

 You may use 2 brushes simultaneously. To go between the two brushes, click
 the right mouse button on the 'Brush' icon in the pen part of the toolbox.

 If you capture the brush with the right mouse button, the captured image will
 be erased from the picture.

 There are 3 brush modes:
  F1 Transparent
  F2 Colour
  F3 Solid

  F4 The brush appears as a preview (in box form)
     Pressing F4 again shows only the brush's mask (Perfectpaint only)

 The captured brush may be placed on the page with all the available effects.

@ENDNODE
