IMAGE PROCESSING
================

  The image processing context is opened via PROCESS from the popup menu. 
  The following functions will be available:

   * Info
     Displays short information about the currently selected
     saver or image processing module.

   * View
     Displays the graphic on the screen.

   * Load
     Loads a new graphic.

   * Save
     Saves the currently loaded graphic in the selected file format
     which is also possible via double-clicking on the specific
     file format's name.

   * Execute
     Applies the selected image processing operation to the graphic.
     For more information see description of the single image processing
     modules.

   * Viewmode
     Changes the screen mode of the current graphic.

   * Quit
     Leaves the image processing context.

   Restrictions:
   The settings for 8Bit-display and 24Bit-display from the configuration
   menu of the display drivers will not influence the image processing
   context.
   When AGA/ECS drivers are active 24 BIT graphics will always be
   displayed in grey scales. Colour displays of 24 BIT graphics from the
   image processing function are only possible with a graphic card driver.


  Image processing operators
  --------------------------

   PMPro's image processing module contains a bunch of functions
   which allow nearly any possibility imaginable for manipulating
   your graphic.

   A small overview of image processing functions of PMPro are as follows.

   The column colour depth specifies which colour depths can be handled
   by the corresponding operator. For example some operators do need
   24BIT data as input. In such a case graphics with less colours have
   to be converted to 24 BIT with the function "AnyTo24Bit" beforehand.

   NOTE: HAM-graphics will only be correctly processed by the
   AnyTo24Bit operator. When processing HAM graphics these
   have to be converted to 24 Bit beforehand!


   Operator           Function                               Colour depth

   XOR                playing around with effects            1..8 BIT
   24BitToHAM         dithers 24 Bit to HAM6/HAM8            24 BIT
   Dither24Bit        dithers 24 Bit to 2..256 colours       24BIT
   AnyTo24Bit         converts to 24 Bit                     1..8BIT,HAM
   Crop               crops shapes of graphics               1..8,24BIT
   HilbertDither256   dithers to black & white               1..8BIT
   ExtractGrayScales  converts to grey scales                1..8,24BIT
   ExtractRed         extracts red values                    1..8,24BIT
   ExtractGreen       extracts green values                  1..8,24BIT
   ExtractBlue        extracts blue values                   1..8,24BIT
   TopToBottom        vertical mirroring                     1..8,24BIT
   LeftToRight        horizontal mirroring                   1..8,24BIT
   Rotate             rotate by 90/180/270 degrees           1..8,24BIT
   Scale50            change size by 50% or 200%             1..8,24BIT
   CallPNM            call external PBM/PGM/PPM tools        1..8BIT,24BIT
   OptimizePalette    optimise palette (reduce redundancy)   1..8BIT
   EdgeDetect         detect edges...                        24BIT
   Sharpen            sharpness adjustment                   24BIT
   Blur               Blur-filter                            24BIT
   DitherFix24        colour reduction to 16/256 colours     24BIT
                      with fixed palette
   Convolve           Convolution matrix (various            24BIT
                      effects like Emboss, etc.)
   ScaleFree          freely scaling of a graphic            1..8,24BIT
   RGBAdjust          changing RGB values                    1..8,24BIT
   Gamma              Gamma correction                       1..8,24BIT
   Brightness         brightness adjustment                  1..8,24BIT
   Contrast           adjusting contrast                     24BIT
   Mosaic             Mosaic-effect                          1..8,24BIT
   Tiling             Mosaic-effect derivative               1..8,24BIT
   Slicing            Mosaic-effect derivative               1..8,24BIT
   Emboss             Emboss-filter                          1..8,24BIT
   Complement         Negative-effect                        1..8,24BIT
   Antique            Antique-effect                         1..8,24BIT
   Diffuse            random pixel spreading                 24BIT
   HighPass           highpass filter                        24BIT
   Motion_Blur        motion sharpness effect                24BIT
   OilPaint           oilpainting effect                     24BIT
   Threshold          conversion to black & white            24BIT
   Bentley            random pixel spreading derivative      24BIT
   DeepPress          deep press effect                      24BIT
   Autoborder         Removes single-coloured areas          1..8, 24BIT
   RotateFree         freely rotate graphics                 24BIT
   PaletteDither      Dithers to a given palette             24BIT



   REFERENCE:
   ----------

   XOR
   ---
   Colour depth: 1..8 BIT
   Options   : Value between 0 and 255
   Function  : Playing around with effects 

   24BitToHAM
   ----------
   Colour depth: 24 BIT
   Options   : HAM6 or HAM8
   Function  : dithers 24BIT to HAM6/HAM8

   Dither24Bit
   -----------
   Colour depth: 24 BIT
   Options   : Corresponding Colour depth in Bitplanes, dither-method
   Function  : dithers 24 BIT to 2..256 Colours with a given dither-method
               like Floyd, Burkes, Ordered or Bestpen.

   AnyTo24Bit
   ----------
   Colour depth: 1..8 BIT, HAM
   Options   : none
   Function  : Converts any graphics to 24 BIT (necessary for some
               operators)

   Crop
   ----
   Colour depth: 1..8, 24 BIT
   Options   : x- and y-offset, width and height (in pixel)
   Function  : crops shapes of graphics

   HilbertDither256
   ----------------
   Colour depth: 1..8 BIT
   Options   : Background colour: black or white
   Function  : dithers to black & white

   ExtractGrayScales
   -----------------
   Colour depth: 1..8, 24 BIT
   Options   : corresponding colour depth: 1..8 Bitplanes
   Function  : converts to greyscales

   ExtractRed
   ----------
   Colour depth: 1..8,24 BIT
   Options   : none
   Function  : extracts red values from graphics

   ExtractGreen
   ------------
   Colour depth: 1..8,24 BIT
   Options   : none
   Function  : extracts green values from graphics

   ExtractBlue
   -----------
   Colour depth: 1..8,24 BIT
   Options   : none
   Function  : extracts blue values from graphics

   TopToBottom
   -----------
   Colour depth: 1..8,24 BIT
   Options   : none
   Function  : vertical mirroring

   LeftToRight
   -----------
   Colour depth: 1..8, 24 BIT
   Options   : none
   Function  : horizontal mirroring

   Rotate
   ------
   Colour depth: 1..8, 24 BIT
   Options   : 90, 180 or 270 Degrees
   Function  : rotate graphics

   Scale50
   -------
   Colour depth: 1..8, 24 BIT
   Options   : Mode: Double or Half
   Function  : change size of graphics (double or half size)

   CallPNM
   -------
   Colour depth: 1..8, 24 BIT
   Options   : PNM command (with full path) and options
   Function  : call external PBM/PGM/PBM tools. For example enter
               work:pnmscale for command and -xscale 2.0 for options.

   OptimizePalette
   ---------------
   Colour depth: 1..8 BIT
   Options   : none
   Function  : reduce redundancy colours in your colour palette

   EdgeDetect
   ----------
   Colour depth: 24 BIT
   Options   : none
   Function  : matrix operation, which detect edges in your picture.
               If you apply the exractgreyscales-Operator after this,
               you get a LINEART-effect

   Sharpen
   -------
   Colour depth: 24 BIT
   Options   : strength 1 to 100
   Function  : This operator sharpens an image.

   Blur
   ----
   Colour depth: 24 BIT
   Options   : strength 1 to 100
   Function  : Applies a blurring filter.

   DitherFix24
   -----------
   Colour depth: 24 BIT
   Options   : 4BIT grey or 8BIT colour
   Function  : Colour reduction to 16 greyscales / 256 colours with a
               fixed palette.

   Convolve
   --------
   Colour depth: 24 BIT
   Options   : Matrix, add and division-factor
   Function  : Applies convolution matrix with various effects.
               Convolutions can perform many different image processing
               functions by varying the values comprising the
               convolution matrix. Determining the values to use in the
               convolution matrix requires much experimentation or a
               knowledge of image processing theory. To save you from
               this, we provide a lot of example matrices you can use or
               change it. Try it out!

   ScaleFree
   ---------
   Colour depth: 1..8, 24 BIT
   Options   : X- and Y-scale factor in percent or new size (in pixel)
   Function  : This operator scales a graphics freely between 20% and 200%
               of its original size or to a given new size (in pixel).

   RGBAdjust
   ---------
   Colour depth: 1..8, 24 BIT
   Options   : RGB-Values to increase or decrease
   Function  : Changing the RGB-components of a graphics for various
               colour effects.

   Gamma
   -----
   Colour depth: 1..8, 24 BIT
   Options   : Red, green and blue gamma correction value
   Function  : Allows Gamma correction of a graphics for each colour
               component (RED, GREEN or BLUE)

   Brightness
   ----------
   Colour depth: 1..8, 24 BIT
   Options   : Value to increase or decrease brightness
   Function  : Brightness adjustment

   Contrast
   --------
   Colour depth: 24 BIT
   Options   : Value to increase or decrease contrast
   Function  : Contrast adjustment

   Mosaic
   ------
   Colour depth: 1..8, 24 BIT
   Options   : size of the blocks in pixel
   Function  : Divide graphics into square blocks, known as mosaic-effect.

   Tiling
   ------
   Colour depth: 1..8, 24 BIT
   Options   : blocksize 1..10
   Function  : Tiles an image into many blocks. A block size of 10 gives
               a great effect.

   Slicing
   -------
   Colour depth: 1..8, 24 BIT
   Options   : none
   Function  : Slices up an image into horizontal an vertical strips.

   Emboss
   ------
   Colour depth: 1..8, 24 BIT
   Options   : none
   Function  : Applies an Emboss-Filter. Applying the EtractGreyScales
               Operator after Emboss will enhance the effect.

   Complement
   ----------
   Colour depth: 1..8, 24 BIT
   Options   : none
   Function  : Negative effect.

   Antique
   -------
   Colour depth: 1..8, 24 BIT
   Options   : Output colour depth in Bitplanes
   Function  : Change the colours of a graphics to an antique colour map.

   Diffuse
   -------
   Colour depth: 24 BIT
   Options   : Strength 1 to 100
   Function  : This operator creates an effect as if the image was
               exploded pixel by pixel

   HighPass
   --------
   Colour depth: 24 BIT
   Options   : Strength 1 to 100
   Function  : Applies a HighPass-Filter for interesting "painted colours"
               effects.
               A strength of 10 gives a negative effect, a strength
               of 99 gives a real colourful effect.

   Motion_Blur
   -----------
   Colour depth: 24 BIT
   Options   : Strength 1 to 100
   Function  : Motion unsharpen effect.

   OilPaint
   --------
   Colour depth: 24 BIT
   Options   : Strength 1 to 16
   Function  : A great painting effect. This take a lot of time, because
               this effect is very complex.

   Threshold     
   ---------
   Colour depth: 24 BIT
   Options   : Threshold colour 1 to 255
   Function  : Conversion to black & white without dithering

   Bentley
   -------
   Colour depth: 24 BIT
   Options   : none
   Function  : An effect that makes the image look ghostly.

   DeepPress
   ---------
   Colour depth: 24 BIT
   Options   : Strength 1 to 100
   Function  : Creates an chiselled effect on an image.

   AutoBorder
   ----------
   Colour depth: 1..8,24 BIT
   Options   : none
   Function  : Removes single-coloured areas around the actual graphics.

   RotateFree
   ----------
   Colour depth: 24 BIT
   Options   : angle between 1 and 359 degrees, coordinate point
   Function  : This operator allows to freely rotate graphics by specifying
               an angle and a co-ordinate point. By selection of size
               adjustment, the graphics will also be enlarged according
               to the rotation, so that it will still be fully visible.
               When not selecting this some parts of the graphics may
               be cut off.

  
   PaletteDither
   -------------
   Colour depth: 24 BIT
   Options   : colordepth, colour palette
   Function  :  This operator allows you to dither 24 Bit graphics to a
                given, fixed palette. Just select an IFF file with the
                required palette. Now your graphics will be dithered
                to 2..256 colours and has exactly the desired colour
                palette. This function is quite nice for combining
                different graphics with an image program, which does
                not work in 24 Bit (e.g. DPaint).

