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

@REMARK Translation Copyright © 1999 Joe Mackay


@NODE "Main" "Menus"


  @{" Picture           " link Picture}
  @{" Brush             " link Brush}
  @{" Animation         " link Animation}
  @{" Palette           " link Palette}
  @{" Misc              " link Misc}
  @{" User              " link User}

@ENDNODE
@NODE "Picture" "Picture Menu"


@{fg shine}@{B}.New @{UB}@{fg text}
  Creates a new image, letting you specify its width and height.

@{fg shine}@{B}.Load @{UB}@{fg text}
  @{bg fill}@{B}  PerfectPaint @{UB}@{bg back}
  Loads an IFF picture of between 2 and 256 colours. If the picture is not in IFF
  format, the program will try to load it using Datatypes. It will not load 24-bit
  images, unless you have an Ak Datatype which converts 24-bit pictures to 8-bit.
  For the moment Datatype support is not internal, it is handled by an external
  program found in PerfectPaint:Tools (for more information the README is included
  in the drawer).
  @{bg fill}@{B}  PerfectPaintPro @{UB}@{bg back}
  Loads IFF picture (1-24bits,Ham6/8) and JPEG picture ( you need @{" Jpeg.library " link Jpeg.library})
  For other format, PfPaint use datatype.

@{fg shine}@{B}.Save/Save as @{UB}@{fg text}
  @{bg fill}@{B}  PerfectPaint @{UB}@{bg back}
  Saves the current image in ILBM format
  @{bg fill}@{B}  PerfectPaintPro @{UB}@{bg back}
  Save the current picture in ILBM format (24bits or 8bits gray), or JPEG format
  in 24Bits or 8Bits gray ( you need @{" Jpeg.library " link Jpeg.library})

@{fg shine}@{B}.Render @{UB} (PerfectPaintPro only)@{fg text}
  Reduce the number of colors of your current picture
  with or without dithering and save it.
  You need @{" Render.library " link render.library}.

@{fg shine}@{B}.Effects @{UB}@{fg text}
  .Picture size:
     Enlarges or reduces your picture, with antialiasing if it is active.
  .Page Size (PerfectPaintPro only)
     Add a border around your picture
  .Flip X
     Flips the image about the X-axis.    
  .Flip Y
     Flips the image about the Y-axis.    
  .Rot 90° (Landscape)
     Rotates the image by 90°.
    
@{fg shine}@{B}.Prefs/Paths @{UB}@{fg text}
  Here you can define paths for your pictures, brushes and palettes, choose
  a default palette, and decide if you want to save icons with your files.

@{fg shine}@{B}.Info @{UB}@{fg text}
  Gives information about the current pictures and brushes, and tells you if
  you have enough memory for certain operations.

@{fg shine}@{B}.About @{UB}@{fg text}
  Info about the program and available free memory.

@{fg shine}@{B}.Quit @{UB}@{fg text}
  Quits the program.

@ENDNODE
@NODE "Brush" "Brush Menu"

@{fg shine}@{B}.Load @{UB}@{fg text}
  @{bg fill}@{B}  PerfectPaint @{UB}@{bg back}
  Loads a brush.(ilbm or datatype, 2-256 clrs).
  If the new brush has a greater depth than the current
  picture, it will be shown as an empty box. To use it, you will have to
  remap it (see later).
  @{bg fill}@{B}  PerfectPaintPro @{UB}@{bg back}
  Loads a brush, ILBM 1-24bits,HAM6/8, Jpeg (@{" Jpeg.library " link Jpeg.library}) or datatype.

@{fg shine}@{B}.Save @{UB}@{fg text}
  @{bg fill}@{B}  PerfectPaint @{UB}@{bg back}
  Saves the current brush (ILBM format)
  @{bg fill}@{B}  PerfectPaintPro @{UB}@{bg back}
  saves the current brush (ILBM format), with ou without Mask, or in
  DEEP format (with alpha-channel)
  Render:  Reduce the number of colors of your current brush
  with or without dithering and save it.
  You need @{" Render.library " link render.library}.

@{fg shine}@{B}.Free @{UB}@{fg text}
  Destroys the current brush and frees its memory.

@{fg shine}@{B}.Restore @{UB}@{fg text}
  Returns the current brush to the way it was when it was captured.

@{fg shine}@{B}.Mode @{UB}@{fg text}
   .Matte: the brush has transparency (the transparent colour being the
      Bg colour when the brush was captured)
   .Colour: the brush has transparency but its contents are solely in the
      selected colour.
   .Replace: the brush has no transparency.

@{fg shine}@{B}.Misc @{UB}@{fg text}
  @{bg fill}@{B}  PerfectPaint @{UB}@{bg back}
  @{B}Change Transparency:@{UB} changes the transparency of the current brush
  @{B}Add Transparency:@{UB} adds transparency to the current brush
  @{B}Fix Transparency:@{UB} sets the brush's transparency to match the brush
     itself, not just its mask.
  @{B}Invert Mask:@{UB} Inverts the mask of the current brush
  @{B}Outline Mask:@{UB} Adds an outline to the mask of the current brush
  @{bg fill}@{B}  PerfectPaintPro @{UB}@{bg back}
  @{B}Smooth border:@{UB}
  @{B}Invert Mask:@{UB}
  @{B}Density Mapping:@{UB} it will allow you to Edit,with spline, then density
     of your current brush
  @{B}Opacity:@{UB}

@{fg shine}@{B}.Flip @{UB}@{fg text}
  @{B}Flip X@{UB}
  @{B}Flip Y@{UB}

@{fg shine}@{B}.Size @{UB}@{fg text}
   This effect can be antialiased.
  @{B}Halve:@{UB}
     Quickly halves the pixel dimensions of the brush
  @{B}Halve X:@{UB}
     Quickly halves the pixel dimensions of the brush (Only on X)
  @{B}Halve Y:@{UB}
     Quickly halves the pixel dimensions of the brush (Only on Y)
  @{B}Double:@{UB}
     Quickly doubles the pixel dimensions of the brush
  @{B}Double X:@{UB}
     Quickly doubles the pixel dimensions of the brush (Only on X)
  @{B}Double Y:@{UB}
     Quickly doubles the pixel dimensions of the brush (Only on Y)
  @{B}Numeric:@{UB}
     Allows you to scale your brush to any arbitrary size.
  
@{fg shine}@{B}Rotation:@{UB}@{fg text}
  @{B}Free:@{UB}(PerfectPaint only)
     Use  numeric keyboard: '6' to increase the rotation, '4' to decrease and '0' to
     initialise the rotation.
     Rotation can be antialiased.
  @{B}Rot 90°@{UB}

@{fg shine}@{B}Shear:@{UB}@{fg text}(PerfectPaint only)
   Use  numeric keyboard: '6' to increase, '4' to decrease and '0' to
   initialise.
  @{B}Horizontal:@{UB}
  @{B}Vertical:@{UB}

@ENDNODE
@NODE "Animation" "Animation Menu"

@{fg shine}@{B}.Load@{UB}@{fg text}
@{bg fill}@{B} PerfectPaint @{UB}@{bg back}
   Pictures: loads a series of images to construct an animation.
      (ILBM and the same size)  
   Anim: loads an animation in Anim5 or Anim7 format.
      (The animation is stored uncompressed in Fast memory).
@{bg fill}@{B} PerfectPaintPro @{UB}@{bg back}
   Pictures: loads a series of images to construct an animation.
      (Size and format can be differents)  
   Anim: loads an animation in Anim5 or Anim7 format.
      (The animation is stored on disk).
   24Bits anim: Not for the moment

@{fg shine}@{B}.Save@{UB}@{fg text}
@{bg fill}@{B} PerfectPaint @{UB}@{bg back}
   Pictures: saves the animation as a series of individual frames.
   Anim: saves the animation in Anim5 format.
@{bg fill}@{B} PerfectPaintPro @{UB}@{bg back}
   Pictures: saves the animation as a series of individual frames.
      (ILBM or Jpeg)
   Render Pictures:  Reduce the number of colors of each pictures
      with or without dithering, save them and built an animation
      You need @{" Render.library " link render.library}. 
   24bits anim: not for the moment

   You can use Arexx scripts to save your animation in :
      GIFanim (Rexx/General/SaveAnimGif.rx)
   or QuickTime movie (Rexx/General/MkQT.rx)

@{fg shine}@{B}.Frames@{UB}@{fg text}
   Create: create an animation
   Add frames: add frames to the animation, after the current frame
   Copy frames: copy the current frame or a series of frames
   Delete frames: delete the current frame or a series of frames from
      the animation

@{fg shine}@{B}.Control@{UB}@{fg text}
   Previous: makes the previous frame the current one
   Next: makes the following frame the current one
   Go to: allows you to move to a specific frame
   Play: plays the animation. It will play until you press the space bar
   Play Once: plays the animation a single time
   Ping Pong: repeats the animation forwards and backwards until you press
      the space bar
   Display screenmode:(perfectpaint only)
      You may choose a screen to play the animation on.
      By default, the screen is a duplicate of your work
      screen. Choose a CybergraphX or Picasso96 screen

@{fg shine}@{B}.Free Anim@{UB}@{fg text}
      Destroys the current animation.


Notes1
  If you click the @{B}right mouse button@{UB} on the 'trashcan' icon, you may
  delete the current frame or a series of frames.

Notes2 (PerfectPaint)
  Animation has been optimised to play on a graphics card and will not work on a
  "classic" Amiga screen

Notes3 (PerfectPaintPro)
  The animation is stored in disk, only a preview of each frame is stored in RAM.
  
                   
@ENDNODE
@NODE "Palette" "Palette Menu"

@{fg shine}@{B}.Load@{UB}@{fg text}
  Loads a palette.

@{fg shine}@{B}.Save@{UB}@{fg text}
  Saves the current palette.

@{fg shine}@{B}.Edit@{UB}@{fg text}
  @{" Edits " link PerfectPaint.guide/editpal} the current palette.

@{fg shine}@{B}.Adjust palette@{UB}@{fg text}(PerfectPaint only)
  you can modify your palette
  with R,V,B,Contrast,Color and Brightness.

@{fg shine}@{B}.Fix Palette@{UB}@{fg text}
  Stores the current palette so that it can be restored later.

@{fg shine}@{B}.Use Brush palette@{UB}@{fg text}(PerfectPaint only)
  Use the palette of the current brush.

@{fg shine}@{B}.Restore palette@{UB}@{fg text}
  Restore the original palette, or one stored by "Fix Palette".

@{fg shine}@{B}.Convert to grey@{UB}@{fg text}
  Converts the current palette to greyscale.

@{fg shine}@{B}.Antique@{UB}@{fg text}
  Converts the current palette to sepia tones.

@{fg shine}@{B}.Remap Brush@{UB}@{fg text}(PerfectPaint only)
  Remaps the current brush using the current palette.

@{fg shine}@{B}.Make usable palette@{UB}@{fg text}(PerfectPaint only)
  PerfectPaint will modify the palette without altering the picture
  so that the OS GUI becomes visible (use this if the current palette
  makes the GUI unusable).


@ENDNODE

@NODE "Misc" "Misc Menu"

@{fg shine}@{B}.Coord@{UB}@{fg text}
  Toggles the co-ordinate display.

@{fg shine}@{B}.Bridge@{UB}@{fg text}
  Allows fast communication with another instance of PerfectPaint so
  that you can send pictures, brushes and palettes.

@{fg shine}@{B}.Invert Stencil@{UB}@{fg text}(PerfectPaint only)
  Inverts the current stencil.

@{fg shine}@{B}.Flush Memory@{UB}@{fg text}
  Frees any memory not needed by the program.

@{fg shine}@{B}.Make Object@{UB}@{fg text}
  Allows you to manually enter an object's dimensions (works with circle, line,
  ellipse, curve and box). The requester will store the details of the last
  constructed object.

@ENDNODE
@NODE "User" "User Menu"

This menu belongs to you, you may modify it as you wish.

@{fg shine}@{B}Edit@{UB}@{fg text}
  Lets you edit the 'User' menu.
  You may have up to 5 entries, and up to 15 subentries for each entry.
  You may assign an Arexx script to each subentry. If you enter a 0 in a
  subentry's name, a separator bar will appear in the menu.

  By default, one menu will be created.

@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 "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



