home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / process / !Process / !Guide < prev    next >
Text File  |  1993-09-03  |  44KB  |  1,113 lines
  1.  
  2.                                    !Process
  3.                           ===========================
  4.                           256 colour image processing
  5.                                       by
  6.                           Henrik Bjerregaard Pedersen
  7.  
  8.  
  9.    About !Process
  10.   ================
  11.    !Process is a 256-colour image processing/manipulation program.
  12.    It enables you to manipulate 256-colour sprites in a variety of ways,
  13.  including noise-removal, sharpening, smoothening, inverting, colour
  14.  separation, conversion to black/white or greytones, edge-detection and more.
  15.    Besides that, !Process also includes some of the features found in !Paint or
  16.  other basic drawing packages.
  17.  
  18.    The following is only a brief summary of the features of !Process. The
  19.  number of ways you can distort/alter/manipulate an image are endless, and
  20.  would therefor require a RATHER large !Help-file to describe in details.
  21.    The best (and most amusing) way to discover the possibilities in (and the
  22.  limits of) !Process, is to load an image and simply try the different
  23.  operations one by one. However, I strongly recommend that you read this file,
  24.  otherwise you may have trouble with some of the features.
  25.  
  26.    Problems
  27.   ==========
  28.    Whenever possible, you should ensure that the images you load into Process
  29.  are created without mask, and that the spritefile contains only one sprite.
  30.  
  31.    Glossary
  32.   ==========
  33.    Source image      ... the image from which pixels/information is READ.
  34.    Destination image ... the image to which pixels/information is WRITTEN.
  35.    Colour component  ... a value in the range 0-255, describing the amount of
  36.                          either RED, GREEN or BLUE. 0 is nothing, 255 is full.
  37.    Kernel            ... a 3x3 matrix which is multiplied with the colour
  38.                          components of a center pixel and its 8 neighbours.
  39.                          The average of the 9 elements of the kernel is
  40.                          calculated, and this becomes the colour of the center
  41.                          pixel.
  42.    Image viewer      ... any of the (from two to nine) image windows.
  43.  
  44.    Starting
  45.   ==========
  46.    Double click on the !Process-icon, and the program installs itself on the
  47.  iconbar.
  48.    !Process will claim approx. 224k as long as no image is loaded. After
  49.  loading an image, the wimpslot will be increased with at least twice the size
  50.  of the spritefile.
  51.  
  52.    Stopping
  53.   ==========
  54.    Select the option Quit from the iconbar menu.
  55.    If you end up in an endless loop of error messages, you can in most cases
  56.   exit the program by pressing DELETE while clicking on the OK icon in the
  57.   error box.
  58.  
  59.    Loading
  60.   =========
  61.    Drag as spritefile containing a 256 colour sprite as the first sprite to the
  62.  iconbar icon, and it will be loaded and will appear in a window.
  63.    Click MENU when the mouse is inside this window, and the main menu appears.
  64.    Process will also load AIM files, Clear files (in 256 greytones), Clear
  65.  files in 24bpp and sprites with a greyscaled 256 entries palette. 24bpp Clear
  66.  files are loaded as 3 8bpp files.
  67.    If the sprite holds a palette (other than greyscaled) this will be used.
  68.  You can force Process to ignore the palette by holding down Ctrl while
  69.  loading the spritefile.
  70.    After applying a filter/effect the processed image will appear in another
  71.  window. If you drag a spritefile to either of these windows, !Process will
  72.  attempt to load the file. If the file has the exact same size as the already
  73.  loaded file, it will simply overwrite the image in the window to which you
  74.  load it, otherwise it will be loaded as given in the submenu
  75.  Miscellaneous.Import sprite.
  76.  
  77.    Palette
  78.   =========
  79.    Usually Process wil ignore the palette of the sprite you load, but if the
  80.  option -pal is set, Process will recognise and use the palette (if present).
  81.    All three types of palettes are valid (16, 64 or 256 (true-colour) entries).
  82.  However, to speed up operations, Process needs to calculate a translation
  83.  table from RGB to 8bit pixel values. This will usually take 10 seconds (on an
  84.  ARM2), and is done when the sprite is loaded. The calculation isn't performed
  85.  if the sprite doesn't have a palette; instead the file
  86.  !Process.Resources.Palette is loaded.
  87.    The calculation of the palette can be suppressed by holding down Ctrl while
  88.  loading the sprite file. Process will then act as if the -pal option wasn't
  89.  set and ignore the palette.
  90.  
  91.    Printing
  92.   ==========
  93.    This isn't what !Process is best at. In fact, it doesn't print at all, so
  94.  what you'll need to do is to save the image (either to disc or directly to
  95.  !Paint) and then use !Paint's printing facilities in conjunction with a
  96.  RISC OS PDriver to get your piece of art on paper.
  97.  
  98.    Greyscaled images
  99.   ===================
  100.    !Process accepts 3 types of greyscaled images:
  101.  
  102.    AIM (256x256 pixels, 8 bpp, always greyscaled)
  103.    Clear (8 bpp, greyscaled palette)
  104.    Sprites (with a palette with 256 greyscaled entries).
  105.  
  106.    Beside these, Process can convert any loaded colour sprite to 8 bpp
  107.  greytones.
  108.    Some of the operations provided by Process are meaningless when applied to
  109.  a greyscaled image (eg RGB separation, Greyscale conversion etc.). In these
  110.  cases the operation will be inaccesible/shaded in the menu.
  111.  
  112.    Options
  113.   =========
  114.    When started, !Process reads the systemvariable Process$Options which may
  115.  contain the following options:
  116.  
  117.          Name        Meaning
  118.         -------------------------------------------------------------
  119.          max2        Sets the number of copies of the image !Process
  120.          max3        creates when a file is loaded.
  121.          max4  etc   Minimum is 2, maximum is 9. If you don't set max
  122.          max9        or set it to an illegal value, max4 is used.
  123.  
  124.          swap        Automatic swapping on.
  125.  
  126.          dma         Disable DMA during lengthy calculations.
  127.  
  128.          tools       Show toolbox.
  129.  
  130.          pal         Use the sprite palette (if present). See above.
  131.  
  132.          mask        Don't ignore the mask (if present)
  133.  
  134.          colour0     Use the extended colour selector RGB (fixed red)
  135.          colour1     Use the extended colour selector RGB (fixed green)
  136.          colour2     Use the extended colour selector RGB (fixed blue)
  137.          colour4     Use the extended colour selector CMY (fixed cyan)
  138.          colour5     Use the extended colour selector CMY (fixed magenta)
  139.          colour6     Use the extended colour selector CMY (fixed yellow)
  140.  
  141.    To perform RGB or HSV separation, max4 is needed, to perform CMYK separation
  142.  max5 is needed.
  143.  
  144.    The system variable Process$WindowTitle holds the template string for the
  145.  text in the titlebar of the image viewers.
  146.    The variable is set in !Process.!Run, and may be altered to include any of
  147.  the given pieces of information:
  148.  
  149.          Arg       Substituted with
  150.          --------------------------
  151.          %%0       "Process"
  152.          %%1       The name (full path) of the sprite file
  153.          %%2       The name (last part) of the sprite file
  154.          %%3       The name of the sprite
  155.          %%4       The mode in which the sprite was created
  156.          %%5       Size X of sprite (pixels)
  157.          %%6       Size Y of sprite (pixels)
  158.          %%7       The image viewer's number (1 - max)
  159.          %%8       Zoom factor X
  160.          %%9       Zoom factor Y
  161.  
  162.    Maps
  163.   ======
  164.    Maps are tables translating one colour to another. 256-colour images use one
  165.  byte per pixel, so mapping is simply done using a 256-bytes table, so that a
  166.  byte with value n is translated into the n'th entry in the table.
  167.    Many of the operations in !Process are performed using maps, to name a few:
  168.  Invert, Add colour, RGB filter, Translate, Greytones, Brighten, Stretch
  169.  histogram, Equalize histogram, Expand/Reduce range etc.
  170.    It is possible to create your own map and apply it to the loaded image. If
  171.  you drag a 256-bytes Data-file (filetype &FFD) to any of the image viewers,
  172.  the file will be loaded and used as a map on that particular image.
  173.    You can edit the BASIC-program GenMap to suit your own purposes.
  174.  
  175.    The colour selector
  176.   =====================
  177.    The colour selector is a window that pops up whenever a selected operation
  178.  ne