@DATABASE PerfectPaint.Guide
@$VER: PerfectPaint.guide Français 1.0
@(C) Copyright © 1998-2000 Georges HALVADJIAN" 
@AUTHOR Georges HALVADJIAN" 
@INDEX index 


@NODE "main" "PerfectPaint"                                                                      
                                                            
                                ###                         
 ########                      #  ##                        
  ##    ##                     #                            
  ##     ##                   ##                       #    
  ##     ##                   ##                      ##    
  ##     ##   ####    ## ### #####   ####     ####   #####  
  ##     ##  #   ##  #######  ##    #   ##   ##   #   ##    
  ##    ###  #    #   ###     ##    #    #   #    ##  ##    
  ######    ########  ##      ##   ######## #         ##    
  ##        #         ##      ##   #        #         ##    
  ##        #         ##      ##   #        #         ##    
  ##        ##        ##      ##   ##       ##        ##    
  ##        ###   #   ##      ##   ###   #  ###   #   ##    
  ##         ######   ##      ##    ######   ######   ## #  
 ####          ###   ####    ####     ###      ###     ##
     
                                                       
                                                        
          ########            ##                            
           ##   ###           ##               #            
           ##    ###                          ##            
           ##    ###                          ##            
           ##    ##  #####   ###   ## ####   #####          
           ##   ### ##   ##   ##   ###   ##   ##            
           #######  ##   ##   ##   ##    ##   ##            
           ##            ##   ##   ##    ##   ##            
           ##         #####   ##   ##    ##   ##            
           ##        #   ##   ##   ##    ##   ##            
           ##       ##   ##   ##   ##    ##   ##            
           ##       ##   ##   ##   ##    ##   ## #           
          ####       ####  ## ##  ####  ####   ##   @{fg shine} V2.0 @{fg back}      
                       

    
  @{" Introduction           " link introduction}
  @{" Installation           " link installation}

  @{" Boite à Outils         " link boite}
  @{" Menus                  " link Menus_PerfectPaint.guide/Main}
  @{" PopUp Menus            " link PopUp}
  @{" Raccourcis clavier     " link Clavier}

  @{" Acceder au Port Arexx  " link port}
  @{" Commandes Arexx        " link Arexx_PerfectPaint.guide/Main}
  @{" Scripts fournis        " link Scripts}    

  @{" Historique             " link history}
  @{" Auteur                 " link Auteur}

  @{" Outils disponibles     " link Extras}

  @{" A faire                " link Afaire}


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

____________________________________________________________________________________________
@{FG SHINE}¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{FG TEXT}
  Copyright © 1998-2000 Georges HALVADJIAN All Rights Reserved, FreeWare

@ENDNODE
@NODE "Afaire" "A faire"

 - Toujours des petits bugs a corriger, ameliorer l'animation, plus d'effets et de scripts.
 - <Vos suggestions

@ENDNODE
@NODE "PopUp" "PopUp Menus"
  
  Les PopUp Menus s'activent a l'aide du bouton droit de la souris.


@{FG SHINE} Au niveau de la barre de déplacement de la boite à outils@{FG TEXT}

        New
        ---------------
        Load Picture
        Save Picture
        ---------------
        Load Animation
        Save Animation
        ---------------
        Paths


@{FG SHINE} Au niveau de l'icone de capture de brosse@{FG TEXT}

        Load Brush
        ---------------
        Save without mask
        Save with mask
        Save Deep
        ---------------
        Restore  Brush
        ---------------
        Smooth border
        Density mapping
        Opacity
        ---------------
        Free brush


@{FG SHINE} Au niveau de l'icone Stencil@{FG TEXT}

        Edit stencil
        ---------------
        Smooth border
        Invert stencil 


@{FG SHINE} Au niveau de l'icone Spare@{FG TEXT}

        Copy Spare to Main Picture
        Copy Main Picture to Spare
        Swap Spare and Main Picture
        ---------------------------
        Copy stencil to spare
        Copy spare to stencil


@{FG SHINE} Au niveau de l'icone Effect@{FG TEXT}

        Compose requester
        Paint effect


@{FG SHINE} Au niveau de l'icone Texte@{FG TEXT}

        Make text
        Convert text to brush


   Toutes les icones d'outils associées à Arexx activent un PopUp Menu qui affiche
   le contenu du tirroir Arexx concerné.

  
@ENDNODE
@NODE "Extras" "Outils disponibles"

  Ces outils se trouvent dans le repertoire 'PerfectPaint:Tools/', avec leur
  manuel original.
  Ils se trouvent egalement sur 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}
  Permet de construire une animation au format ANIM5.
    
  @{B}Auteur@{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}
  Convertit les images au format IFF avec l'aide des datatypes.

  @{B}Auteur@{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}
  Convertit une image IFF au format GIF.

  @{B}Auteur@{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}
  Convertit une serie d'image GIF en une animation GIF.

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

@ENDNODE
@NODE "Scripts" "Scripts fournis"

Répertoire 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}
  Simule l'AnimPainting avec l'outil Boite.
  Vous devez avoir préalablement construit une animation
  La boite va se dessiner tout en faisant defiler l'animation.

@{B}Funny_Border.rx@{UB}
  Plusieurs facon de tracer un cadre.
 
@ENDNODE
@NODE "SCircle" "Circle"

@{B}AnimPainting_Circle.rx@{UB}
  Simule l'AnimPainting avec l'outil Cercle.
  Vous devez déterminer le sens de rotation du cercle.
  Vous devez avoir préalablement construit une animation
  Le cercle va se dessiner tout en faisant defiler l'animation.

@{B}AnimPainting_Circle_Whirl.rx@{UB}
  Simule l'AnimPainting avec l'outil Cercle.
  Vous devez déterminer le sens de rotation du cercle.
  Le cercle se dessinera en partant de son centre.
  Vous devez avoir préalablement construit une animation
  Le cercle va se dessiner tout en faisant defiler l'animation.

@{B}Anim_Pulsar.rx@{UB}
  Crée un effet pulsar (le cercle qui se dilate)
  Vous devez avoir préalablement construit une animation

@{B}Make_AnimStar.rx@{UB}
  Ce script va construire une étoile dont vous devez
  déterminer le nombre de branche et si la forme est pleine ou vide.
  Ensuite il va dessiner cette etoile sur chaque image en
  lui faisant subir progressivement une rotation de 90°
  tout au long de l'animation.
  Vous devez avoir préalablement construit une animation

@{B}Star.rx@{UB}
  Ce script va construire une étoile dont vous devez
  déterminer le nombre de branche et si la forme est pleine ou vide.

@{B}Total_Circle.rx@{UB}
  Ce script va construire un cercle avec un nombre de point determiné.
  Vous devez déterminer le nombre de points.

@{B}Sun.rx@{UB}
  Ce script va construire un soleil stylisé.
@ENDNODE
@NODE "SEllipse" "Ellipse"

@{B}AnimPainting_Ellipse.rx@{UB}
  Simule l'AnimPainting avec l'outil Ellipse.
  Vous devez déterminer le sens de rotation de l'Ellipse.
  Vous devez avoir préalablement construit une animation
  L'Ellipse va se dessiner tout en faisant defiler l'animation.

@{B}Make_Star.rx@{UB}
  Ce script va construire une étoile dont vous devez
  déterminer le nombre de branche et si la forme est pleine ou vide.

@{B}Total_Ellipse.rx@{UB}
  Ce script va construire une ellipse avec un nombre de point determiné.
  Vous devez déterminer le nombre de points.

@ENDNODE
@NODE "SSpline" "Spline"

@{B}AnimPainting_Spline.rx@{UB}
  Simule l'AnimPainting avec l'outil Spline.
  Vous devez avoir préalablement construit une animation
  La spline va se dessiner tout en faisant defiler l'animation.

@{B}Total_Spline.rx@{UB}
  Ce script va construire une spline avec un nombre de point determiné.
  Vous devez déterminer le nombre de points.

@ENDNODE
@NODE "SGeneral" "Général"

@{B}FadeInBlack.rx@{UB}
  Ce script va créer un fondu au noir sur une animation.
Vous devez spécifier l'image de depart et l'image d'arrivée et
si le fondu doit s'ouvrir ou se fermer.

@{B}SaveAnimGif.rx@{UB}
  Sauve l'animation courante au format GIF.

@{B}SaveGif_Brush.rx@{UB}
  Sauve la brosse courante au formay GIF.

@{B}SaveGif_Picture.rx@{UB}
  Sauve l'image courante au format GIF.

@{B}SaveNewIcon.rx@{UB}
  Assemble les deux brosses disponibles et construit une icone NewIcon.
Ce script necessite l'executable 'Injectbrush' dans votre repertoire C:

@{B}Warp.rx@{UB}
  Crée a l'aide de l'image courante une animation comportant 10
images, va faire un warp aléatoire sur chaque image et va jouer
l'animation

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

@ENDNODE
@NODE "SLine" "Line"

@{B}AnimPainting_Line.rx@{UB}
  Simule l'AnimPainting avec l'outil ligne.
  Vous devez avoir préalablement construit une animation
  La ligne va se dessiner tout en faisant defiler l'animation.

@{B}Funny_Line.rx@{UB}
  Plusieurs façons de tracer une ligne.

@{B}Line_Measure.rx@{UB}
  Donne la longueur exacte d'une ligne.

@{B}Angle repare.rx@{UB}
 Tracez une ligne correspondant a une pente
 L'angle va etre calculé afin de corriger cette pente.
 L'effet 'Rotate' est automatiquement selectionné et l'angle selectionné.
 
@{B}Arrow.rx@{UB}
 Dessine des flèches


@ENDNODE
@NODE "port" "Acceder au Port Arexx"

On peut acceder au Port de différentes façons.

Si le script est démarré par PerfectPaint, ce dernier enverra comme premier
paramètre le nom du port à utiliser:

Ex:
    /* Titre du script*/
     Options results
     parse ARG Port ..... b
     ADDRESS value Port
     .....
         
Il y a plusieurs façons de faire demarrer un script par PerfectPaint:


@{FG SHINE}De manière 'générale'; Ce script n'est associé à aucun outil:@{FG TEXT}

Ex:
    /* Titre du script*/
     Options results
     parse ARG Port b
        ADDRESS value Port    
     ......


@{FG SHINE}Si le script est associé à un outil:@{FG TEXT}

        @{B}Ligne:@{UB}@{FG TEXT}
            parse ARG Port x1 y1 x2 y2 b
          /* x1 et y1 sont les coordonnées du début de ligne
             x2 et y2 sont les coordonnées de fin de ligne.*/

        @{B}Cercle:@{UB}@{FG TEXT}
          parse ARG Port x1 y1 r b
          /* x1 et y1 sont les coordonnées du centre du cercle
             r est le rayon du cercle.*/

        @{B}Boite:@{UB}@{FG TEXT}
          parse ARG Port x1 y1 x2 y2 b
          /* x1 et y1 :coin Haut et gauche de la boite
             x2 et y2: coin Bas et droit de la boite*/
  
        @{B}Ellipse:@{UB}
          parse ARG Port x1 y1 r1 r2 b
          /* x1 et y1 :centre de l'ellipse
             r1 et r2: les différents radius de l'ellipse*/             

        @{B}Point:@{UB}
          parse ARG Port x1 y1 b
          /* x1 et y1 :Coordonnées du point*/

        @{B}Spline:@{UB}
          parse ARG Port x1 y1 x2 y2 x3 y3 b
          /* x1 et y1 :Coordonnées du debut de spline
             x2 et y2  :Coordonnées du fin de spline 
             x3 et y3: Point de courbure*/ 


@{FG SHINE}Si le script est associé à la fonction Bridge:@{FG TEXT}
          parse ARG Port1 Port2 b
          /* Port1: Port d'origine
             Port 2: Port de destination*/ 

__________________________________________________________________________
@{FG SHINE}¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{FG TEXT}
    

@{FG SHINE}Si le script n'est pas démarré par PerfectPaint, Il faut verifier si une
cession de PerfectPaint est ouverte et capturer son port.@{FG TEXT}

Ex:
    /* 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
     /* Aucune cession de PerfectPaint n'est ouverte, on quitte le script*/

     ADDRESS value Port 
    ...

__________________________________________________________________________
@{FG SHINE}¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{FG TEXT}
    
Si le script crée se nomme 'StartUp.rx' et est localisé dans le tirroir Perfectpaint, au coté 
du programme principal, ce script sera éxécuté au demarrage de PerfectPaint.


@ENDNODE
@NODE "history" "Historique"

  @{"   V2.0  " link H4} Aout2000
  @{"   V1.3  " link H3} 18 Avril 2000
  @{"   V1.2  " link H2} 30 Nov 1999
  @{"   V1.1  " link H1}

@ENDNODE

@NODE "H4" "V2.0"

   - Désolé pour les utilisateurs AGA, mais cette version et celles qui suivront
     ne seront compatibles qu'avec une carte graphique et (cybergraphx ou Picasso96)
   - Les problemes avec Picasso96 ont été resolu, enfin j'espere
     (en tout cas la comatiblite de Picasso96 avec cybergraphx n'est pas totale)
   - Amélioration du GUI.
   - Un seul programme pour manipuler et dessiner de 2 a 16Mo couleurs
   - Plus de commandes Arexx
   - Disponibilité des deformations de brosses avec preview en temps reel
   - Amélioration du zoom, qui est maintenant une vraie fenetre.
   - Convertion de votre anim, image ou brosse en RGB ou CMAP.
   - Possibilité de creer un masque avec la baguette magique, pipette, cercle...
   - Impression via TurboPrint
   - Grab alpha-channel, Grab RGB
   - Correction des couleurs et du Gamma.
   - Nouveaux script arexx: Button_On, Button_Off, LensFlare
   - Nouveau tiroir Arexx: Anim
   .......


@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
  - Plus d'effets sont disponibles
  - 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

  - QQ bugs corriges sur les PopUp Menus et l'animation
  - Compatible avec VisualPrefs
  - Optimization de l'effet Cloud, une erreur de couleur corrigée,ajout de la densité.
  - Petit bug avec arexx corrigé.
  - Petit bug corrigé avec le spreadcolor de l'editeur de palette
  - Changement de certain racourcis clavier:
	  Maintenant, les touches flechees permettent de se deplacer dans le zoom et
	  Alt droit + fleche haut pour augmenter la taille du crayon; 
    alt droit + fleche bas pour la diminuer.
  - Amélioration de l'effet 'Displace': plus régulier
  - Petit bug corrige avec les lignes antialiasées.
  - Le requester de fontes tient compte des variables Xdpi et Ydpi
  - Nouvelle Icone dans la boite a outils: Symétrie, paramétrable et disponible pour
    tous les outils de dessin.
  - Acceleration des cercles antialiasées.
  - Amélioration de la capture de brosse, vous pouvez directement selectionner
    dans la boite a outil, l'outil pour découper la brosse.
  - Déformations de brosses:
      - Taille (avec ou sans antialiasing)
      - Penchement
      - Rotation (avec ou sans antialiasing)

24 Bits

	- Beta version
  - Charge les images ILBM 1-24bits
  - Charge et sauve au format JPEG a l'aide de la @{"Jpeg.library" link Jpeg.library} 
  - Tous les effets, menus, ne sont pas disponible
  - Beaucoup plus rapide que la version 8 Bits
  - Amélioration des effets avec effet de composition ( add, sub ,alpha ...)
  - Amélioration des convolutions, Plus rapide, editable, popupmenu, Preview...

@ENDNODE

@NODE "H1" "V1.1"


  - Ajout d'un tooltype 'DPAINTLIKE', avec ce tooltype, la boite à outils sera toujours
    ouverte a la droite de votre écran, et le zoom a la gauche de l'écran.
  - Les popup menus sont dorenavant toujours ouvert et ceci malgres la position de la
    boite a outils.
  - Amélioration de la fenetre ZOOM: 
            - Bouton de fermeture
            - Deplacement de la fenetre
            - Un PopUp menu.
            - QQ bugs corrigés.
  - De nouvelles commandes Arexx
  - l'animation garde en memoire sa vitesse.
  - le Script 'Save GifAnim' a été amélioré incluant les Jiffies.
  - Nouveau script:
        * Arrow pour l'outil ligne
        * Sun pour l'outil cercle
  - Ajout d'un popup menu au niveau de l'icone stencil
  - Nouvelle fonction "Adjust Palette", vous permet de modifier votre palette
    a l'aide du R,G,B,contrast,Couleur et luminance.
  - toutes les Fenetre peuvent etre deplacées.
  - L'assign PerfectPaint: n'est plus nécéssaire
  - Amélioration du requester "Texture" avec popup menu (">") et guide de previsualisation("?").
  - De nouvelles commandes Arexx afin de gerer le texte.
  - Amélioration du texte avec l'ajout d'effets spéciaux, l'utilisation de la
    bullet.library pour gerer les fontes vectorielles( les +: plus rapide, rotation
    de la fonte, penchement, DPI en X et Y)
  - Animation du texte.
  - Amélioration du requester texte avec popup menu (">") et guide de previsualisation
    des effets spéciaux ("?").
  - Petit bug corrigé entre le texte et le zoom.
  - Amélioration du GUI: les boutons sont plus 'system friendly'
  - La fonction 'Make/Redo object' a été étendu aux polygones et dessin libre.
  - Images et brosses peuvent etre sauvegardées avec une icone 'Thumbnail'.( NewIcons indispensable)

@ENDNODE

@NODE "XPKmaster.library" "XPKmaster.library"

Short:    V5.2 Compression package, user edition
Author:   Dirk Stoecker, Christian von Roques, Urban Dominik Mueller, ...
Uploader: stoecker@amigaworld.com (Dirk Stoecker)
Version:  5.2
Type:     util/pack

on Aminet: util/pack/xpk_User.lha

Description
XPK is an interfacing standard between application programs and packer 
libraries. Every XPK application program can pack data with any XPK packer.

Distributability
XPK is copyrighted, but freely distributable for non-commercial use. Some
parts of XPK have a different legal status, ie. PD, GPL or shareware.

This is the main part of the xpk distribution. In this archive are all the
files you really need.

How to install the files: Decrunching XPK archives you want to install into
ONE directory and double click Install icon in xpk_User directory.
You need at least Installer program version 42.9 to do that. Installer can
be found in Aminet (util/misc/Installer*.lha). Current version is 43.3.

Changes to last release:
bug work around in Query function

Try WWW addresses
    http://www.amigaworld.com/support/xpkmaster/
or  http://home.pages.de/~Gremlin/xpkmaster.html

Here all files are accessable (also the xpk_Crypt.lha archive).

Please contact me or any of the other authors stated in the docs:

************************************************************************
* snail-mail:                  * e-mail:                               *
*   Dirk Stoecker              *   stoecker@amigaworld.com             *
*   Geschwister-Scholl-Str. 10 *   dstoecker@gmx.de                    *
*   01877 Bischofswerda        * world wide web:                       *
*   GERMANY                    *   http://home.pages.de/~Gremlin/      *
* phone:                       * pgp key:                              *
*   GERMANY +49 (0)3594/706666 *   get with finger or from WWW pages   *
************************************************************************
      
                                                                                             
@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

on Aminet: dev/misc/RenderLib.lha

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" "Raccourcis Clavier"

@{B} Espace @{UB}Fais apparaitre une mire de precision sur la fenetre.
@{B} j @{UB} Active ou Désactive la page spare
@{B} p @{UB} Active l'editeur de palette
@{B} u @{UB} Undo
@{B} HELP @{UB} Affiche la documentation
@{B} DEL @{UB} Efface le curseur

@{B}Les touches fléchées Haut et Bas + Alt droit : @{UB} pour changer la taille du crayon.

@{B} n @{UB} Nouveau
@{B} l @{UB} Charge une image
@{B} s @{UB} Sauve l'image en cours
@{B} q @{UB} Quit

@{B} b @{UB} Charge une brosse
@{B} c @{UB} Sauve la brosse en cours

@{B} | @{UB} Coordonnées
@{B} / @{UB} Fonction Bridge

@{B} x @{UB} Flip X de la brosse
@{B} y @{UB} Flip Y de la brosse
@{B} z @{UB} Rotation de 90° de la brosse

@{B} X @{UB} Flip X de l'image
@{B} Y @{UB} Flip Y de l'image
@{B} Z @{UB} Rotation de 90° de l'image

 @{B}F5@{UB} Possibilité d'entrer manuellement les caractéristiques d'un objet (cercle, ligne, courbe
      Ellipse, boite) 
__________________________________________________________________________
@{FG SHINE}¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{FG TEXT}
 @{FG SHINE}ZOOM :@{FG TEXT}
  @{B} + @{UB}@{FG TEXT} Augmente le Zoom
  @{B} - @{UB}@{FG TEXT} Diminue le Zoom
  @{B} Enter @{UB}@{FG TEXT} Recentre le Zoom
  @{B} Touches fléchées @{UB} Déplacement dans le Zoom ou l'image en cours
__________________________________________________________________________
@{FG SHINE}¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{FG TEXT}
 @{FG SHINE}BROSSE :@{FG TEXT}
  @{B} F1 @{UB}@{FG TEXT} Transparence
  @{B} F2 @{UB}@{FG TEXT} Couleur
  @{B} F3 @{UB}@{FG TEXT} Solide
  @{B} F4 @{UB} Prévisualisation de la brosse sous forme de boite
__________________________________________________________________________
@{FG SHINE}¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯@{FG TEXT}
 @{FG SHINE}ANIMATION :@{FG TEXT}
  @{B} 1 @{UB}@{FG TEXT} Image précédente
  @{B} 2 @{UB}@{FG TEXT} Image suivante
  @{B} 3 @{UB}@{FG TEXT} Aller à l'image ...
  @{B} 4 @{UB} Joue l'animation
  @{B} 5 @{UB} Joue l'animation une fois
  @{B} 6 @{UB} Joue l'animation en Ping-Pong

  @{B} Espace @{UB} Stoppe l'animation      

@ENDNODE
@NODE "Auteur" "Auteur"

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

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

@ENDNODE
@NODE "introduction" "Introduction"

    @{I}Dans toute la documentation:@{UI}
@{I}    LMB = Left Mouse Button (Bouton gauche de la souris)@{UI}
@{I}    RMB = Right Mouse Button (Bouton droit de la souris)@{UI}
@{I}    Bg = Foreground (Couleur de fond)@{UI}
@{I}    Fg = Backgroud(Couleur de premier plan)@{UI}

  PerfectPaint est un puissant logiciel de dessin et d'animation
  De 2 à 16Mo couleurs


@{bg shine}@{B} Matériel: @{UB}@{bg back}

    68030 minimum + Coprocesseur
    OS 3.0 minimum
    Carte graphique (Cybergraphx min cgxv41_r71 ou Picasso96)
    Jpeg.library
    Render.library
    XPKmaster.library (Utilisé pour sauver les animations en 24bits)


@{bg shine}@{B} Quelques fonctions de PerfectPaint: @{UB}@{bg back}

     Programme de dessin et d'animation 1-24bits
     Antialiasing
     Page spare
     Stencil
     Undo multiple
     Fonction texte avec Antialiasing, Bevel et Outline, effets
     Symmétrie
     Différente sorte de Crayon
     Animation
     Zoom temps reel (<=8bits)
     Arexx
     Nombreux effets
     24bits: Mapping densité, opacité et Adoucissement de bordure pour les brosses.
     *Color:
           - Shade
           - Light
           - Transluency
           - Inverse color
           - False color
           - grey
           - Treshold
           - Airbrush
           - Spray
     *Wrap: 
           - Texture
           - Brush
           - spare
           - Cloud
           - Gradient
     *Distort:
           - Displace
           - Fish eye lens
           - FlipX
           - FlipY
           - Fractal
           - Ripple
           - Rotate
           - Sin
           - Straw
           - Twirl
           - Wave
     *Convolution
     *Other:
           - Shadow
           - Grain
           .......

Lire la documentation pour plus d'information

@ENDNODE
@NODE "installation" "Installation"

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

Désarchiver le fichier PerfectPaint.lha et copier
le tiroir "PerfectPaint" dans son integralité
où bon vous semble.

Ce tiroir contient une fonte "Xen.font"
Copier :
Xen.font
Xen.font.info
Xen.info
et le repertoire XEN
dans le tiroir FONTS de votre workbench.

Installation de RexxMast
Si ce n'est deja fait, copier l'executable RexxMast 
dans votre WBstartup.

Installer la @{" Render.library " link render.library}
Installer @{" Jpeg.library " link jpeg.library}
Installer @{" XPKmaster.library " link XPKmaster.library}

@{bg shine}@{B} La derniere version de Cybergraphx V3 peut se trouver ici: @{bg back}@{UB} 
http://www.vgr.com/v3/cgxv41_r71.lha
ftp://ftp.vgr.com/cgxv41_r71.lha
http://www.vgr.com/meanmachine/cgxv41_r71.lha


@ENDNODE
@NODE "boite" "Boite à Outils"

  Toutes les icones avec un onglet acceptent une action avec le bouton droit
de la souris.(*)

 _______________
| _____________ | 
||             || 
||   Crayons   ||
||_____________|| 
|               |     A : Outil Cercle vide, plein, Arexx (*)
| ___  ___  ___ |     B : Outil Boite vide, pleine, Arexx (*)
||   ||   ||   ||     C : Outil Ligne vide, pleine, Arexx (*)
|| A || B || C ||     D : Outil Spline vide (*), pleine (*), Arexx (*)
||___||___||___||     E : Outil de remplissage
| ___  ___  ___ |     F : Outil tracé main libre, lié, plein, Arexx (*)
||   ||   ||   ||     G : Outil Ellipse vide, pleine, Arexx (*)
|| D || E || F ||    @{" H " link Hh}: Outil Texte (*)
||___||___||___||     I : Outil Polygone vide, plein, bezier vide, bezier plein.
| ___  ___  ___ |
||   ||   ||   ||    @{" a " link a}: Capture de brosse (*)
|| G || H || I ||    @{" b " link b}: Grille (*)
||___||___||___||     c  : Loupe
|               |    @{" d " link d}: Page de reserve (*)
| ___  ___  ___ |    @{" e " link e}: Effets (*)
||   ||   ||   ||    @{" f " link f}: Stencil (*)
|| a || b || c ||    @{" g " link g}: Symétrie (*)
||___||___||___||    @{" h " link h}: Outil Spéciaux: Warp (*),Grab alpha-channel,Grab RGB
| ___  ___  ___ |    @{" i " link i}: AntiAliasing
||   ||   ||   ||
|| d || e || f ||    @{" j " link "picture/palette.iff/Main" 0}: Selecteur de couleurs
||___||___||___||    @{" k " link "picture/palette.iff/Main" 0}: Visualisateur des couleurs en cours
| ___  ___  ___ |    @{" l " link "picture/palette.iff/Main" 0}: Inversion de couleurs
||   ||   ||   ||    @{" m " link "picture/palette.iff/Main" 0}: Palette
|| g || h || i ||    @{" L'éditeur de palette " link editpal}
||___||___||___||    
|               |    @{" n " link n}: Poubelle (*)
|      ___      |    @{" o " link o}: Undo/Redo (*)
|     |   |     |    @{" p " link p}: Arexx (*)
|  j  | k |  l  | 
|     |___|     | 
.               .
.               . Tout tracé avec le bouton gauche de la souris se fera avec la couleur
.      m        . de premier plan.
.               .
| ___  ___  ___ | Tout tracé avec le bouton droit de la souris se fera avec la couleur
||   ||   ||   || de fond.
|| n || o || p ||
||___||___||___||
|_______________|

les outils tel que Cercle, Boite, Ligne, Spline, Ellipse, Point peuvent avoir un
script Arexx associé.
Vous pouvez selectionner ce script en cliquant avec le bouton droit de la souris
sur l'icone de l'outils, lorsque celui apparait avec une couronne.

Des scripts sont fournis (pour exemple):

     @{" Script Cercle  " link SCircle}
     @{" Script Boite   " link SBox}
     @{" Script Ligne   " link SLine}
     @{" Script Spline  " link SSpline}
     @{" Script Ellipse " link SEllipse}
     @{" Script Point   " link SPoint}

@ENDNODE
@NODE "editpal" "Editeur de palette"

@{" Image " link "picture/Ed_Palette.gif/Main" 0}

 Vous pouvez editer une palette a l'aide des couleurs RGB ou HSV.
 Pour selectionner une couleur, cliquer avec le LMB sur la couleur voulue.

 @{B} COPY @{UB}copie une couleur sur une autre couleur
 selectionnez une couleur, cliquez sur 'COPY' et selectionnez la
 couleur de destination

 @{B} EX @{UB}Echange deux couleurs sur la palette
 Selectionnez une couleur, cliquez sur "EX" et selectionnez
 la couleur de destination. la couleur de depart
 deviendra la couleur de destination et vis-versa.

 @{B} SWAP @{UB}Echange deux couleurs sur la palette (<= 8Bits)
  mais sans modifier l'aspect de l'image en cours.
  (l'image en cours sera remappée, pas d'undo)

 @{B} SPREAD @{UB}Construit un degradé de couleur
Selectionnez la couleur de depart, cliquez sur 'SPREAD'
et selectionnez la couleur de destination, un degrade de couleur se
fera entre ces deux couleurs.

 @{B} Cancel @{UB}Ferme le requester et perd les modifications
faites sur la palette.

 @{B} OK @{UB}Ferme l'Editeur de palette et conserve ses modifications.

@ENDNODE
@NODE "g" "Symétrie"

 La symétrie est disponible pour tous les outils (meme le texte).
 
LMB: Active la Symétrie
RMB: Affiche un requester vous permettant de modifier:
     - Le type de Symétrie
     - Le radius
     - Le centre de Symétrie

@ENDNODE

@NODE "o" "Undo/Redo"

LMB: Active le Undo
RMB: Active le Redo Objet (accessible aussi avec F5)

  L'undo est multiple et est sur 10 niveaux.

@ENDNODE
@NODE "p" "Arexx"

LMB: Active le script Arexx
RMB: Affiche un requester permettant de selectionner un script
     pour cet icone ainsi que pour les icones Cercle, Boite, Ligne ,
     Spline, Ellipse et Point.

  @{" Acceder au Port Arexx  " link port}
  @{" Commandes Arexx        " link Arexx_PerfectPaint.guide/Main}
  @{" Scripts fournis        " link Scripts}

@ENDNODE
@NODE "n" "Poubelle"

LMB: Efface l'image en cours avec la couleur de fond.
RMB: Affiche un requester d'effacement pour l'animation
     vous permettant d'effacer une image ou une serie d'images.

  Le stencil sera respecté, si il est actif.

@ENDNODE
@NODE "h" "Outils spéciaux"

@{B}Warp@{UB}
LMB: Active l'outil Warp
RMB: Definit la taille du Warping.

    Déforme l'image selon la technique du warping.
    Si l'icone 'Antialiasing' est actionnée, l'effet sera antialiasé.

@{B}Grab alpha-channel@{UB}
Vous permet de copier sur la brosse courante la luminosité de l'image en cours
(utile pour les effets de textures, ou la possibilité d'inserer dans la brosse
un masque pre-defini)

@{B}Grab RGB@{UB}
Meme function que precedemment a part que cette fois ci, ce sont les composantes RGB qui seront
copiées sur la brosse.

@ENDNODE
@NODE "f" "Stencil ou Masque"

LMB: Active le stencil
RMB: Affiche le popup menu

  La création d'un masque, vous permet de peindre autour d'une image
  sans peindre sur elle, comme si elle été protégée par un cache.

@ENDNODE
@NODE "i" "Antialiasing"


  Si l'icone est actionnée
   - Le tracé de tous les outils seront antialiasés
   - La plupart des effets seront antialiasés


@ENDNODE
@NODE "e" "Effets"

LMB: Active l'effet en cours, si vous n'avez pas encore choisi d'effet
     un requester apparait avec tous les effets disponibles.

RMB: Fait apparaitre le requester d'effets ou le requester de composition
     Ce requester de composition permet de definir en temps reel la facon dont
     l'effet obtenu sera mis sur l'image: Opacité,Add,Sub,Darken,Alpha et Inv_Alpha

Vous pouvez donner un effet à tous les outils.
Il y a 4 familles:
- Couleur (color)
- Habiller (wrap)
- Déformer
- Pixelate
- Autre

@ENDNODE
@NODE "d" "Page de reserve (spare)"

LMB: Active la page spare (si vous avez assez de mémoire) ou la désactive.
     la page spare est de la meme taille et de la meme profondeur que l'image courante.     
RMB: Paramètres

Vous pouvez:
copier l'image spare sur l'image courante.
Copier l'image courante sur l'image spare.
echanger l'image spare et l'image courante.

  Toutes modifications de l'image courante (Chargement, changement de taille, profondeur)
initialise la page de reserve.

@ENDNODE

@NODE "b" "Grille"

RMB: active la grille
LMB: paramètres de la grille

'X spacing' et 'Y spacing' representent la taille de votre grille en X et Y.
'View grid' la grille peut etre visible dans la fenetre, vous pouvez choisir aussi
sa couleur.
le 'Grab' n'est pas encore disponible.

@ENDNODE
@NODE "Hh" "Outil Texte"

 Si vous selectionnez l'outil texte avec le bouton droit de la souris
 L'éditeur de texte apparait.

 Si vous selectionnez l'outil texte avec le bouton gauche de la souris
 La brosse texte s'active, si elle n'existe pas, l'éditeur de texte
 apparait.

 Les fontes acceptées:

    - Vectorielles:
           Options: Outline et Bevel avec une épaisseur spécifique.
                    Antialiasing sur deux niveaux
                    Rotation, Penchement, étirement et Animation.

    - Bitmap:
           Options: Outline et Bevel avec une épaisseur spécifique.
                    Antialiasing sur deux niveaux

    - Couleurs:(PerfectPaint seulement)
           Options: Utiliser la palette de la fonte
                    Remapper la brosse sans modifier la palette courante
                    Colorize: Pour les fontes en niveaux de gris ou les fontes
                              antialiasées.

 Une fois la brosse construite, vous pouvez a tous moments choisir une couleur
 de premier plan, la brosse s'adaptera automatiquement a la
 nouvelle couleur choisie.

 Un scripts Arexx peut etre associé au texte, celui-ci s'executera des que le texte sera posé
 sur l'image, actionnez l'icone '?' pour plus d'information.

 La brosse obtenue peut être apliquée sur l'image courante avec tous
 les effets disponibles.


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


@ENDNODE
@NODE "a" "Capture de brosse"

 Pour capturer une brosse, 
 - Cliquez sur l'icone 'Pick-up brush'
 - Selectionnez l'outil de découpage
 - dessinez sur l'image l'objet a découper

 Si vous actionnez la touche Shift gauche, la brosse capturée n'aura pas de transparence,
 au sinon la couleur de fond en cours sera transparente.

 Vous pouvez utiliser simultanément 2 brosses. Pour passer d'une brosse a une autre,
 Actionner le bouton droit de la souris sur l'icone 'Brosse ' dans la partie crayon
 de la boite a outils.

 Si vous capturez la brosse avec le bouton droit de la souris, la partie capturée sera
 effacée de l'image.

 Il existe 3 mode de gestion de la brosse:
  F1 Transparence
  F2 Couleur
  F3 Solide

  F4 La brosse apparait en previsualisation ( sous forme de boite).
     Un autre appui sur la touche F4, ne fait apparaitre que le masque de la brosse.(PerfectPaint seulement)

 La brosse capturée peut être apliquée sur l'image courante avec tous
 les effets disponibles.

@ENDNODE
