Title:			WIDGET5
Author:			Andrew Sellors (asellors@orac2.demon.co.uk)
Version:		1.00
Title From:		Documentation
Author From:		Documentation
Version From:		Documentation
Supplier:		Andrew Sellors (asellors@orac2.demon.co.uk)
Date:			08/11/95
Keywords:		Image processing systems
Shareware:		No
Machine:		Archimedes
Operating system:	RISCOS
Memory requirements:	
Peripherals needed:	
Other s/ware needed:	RISC OS 3.10 or later
Directory:		micros/arch/riscos/d097
Date mounted/updated:	09/11/95
File names:		widget5.arc
Unarchived files:	25
Unarchived size:	274 kbytes
Omissions:		
See also:		GREYEDIT (a114), AIM (a271), PROCESS (b009),
			IMAGE (b173), SPRTOOLS (d073)

-------------------------------------------------------------------------------

Acquiring the package:

Download the archive file(s) and extract using SparkPlug 2
(see the "tools_help" file in micros/arch/riscos/tools for further info).


Description:

Widget 5 is a 256 grey level image processing package for square pixel
Sprites.  It will work with any size of image, memory permitting.  Widget 5
loads any file as a 256 grey level image, disregarding any palette, useful
for owners of the Brainsoft video digitizer.  Images are stored in 12 separate
"Image Banks" in memory.  Widget 5 can be run in any screen mode, but those
which have 256 grey levels in the palette will result in the best images.

Also supplied is Pal256, a utility for RISC OS 3.50 or later, which can
program the palette when in a 256 colour mode to a selection of predefined
palettes such as standard, greyscale and greyscale plus wimp colours.

* Widget 5 supports the following image manipulation functions:

     * Add two images
     * Average two images
     * Mix two images
     * Convolve an image to another using a NxM matrix (N,M in the range 1-9)
     * Focal Analysis with the following localised processes on a
       3x3, 5x5, 7x7 or 9x9 patch:
       * Mean greylevel
       * Median
       * Maximum
       * Minimum
     * Changing image greylevels by:
       * Drawing the mapping function using the mouse
       * Applying a threshold value
       * Applying a gamma correction value
       * Applying histogram equalization
       * Applying S.L.C.E. (Saturating Linear Contrast Enhancement)
     * Scaling an image by resampling using bi-linear interpolation
     * False colouring selected greylevel ranges and calculating the percentage
       of each range.
     * Levels slice by false colouring equally spaced sections of the total
       grey level range to a defined number of sections and calculating the
       percentages of pixels contained in each of the ranges.
     * Widget 5 allows an irregularly shaped area mask to be defined to allow
       localised processing.
     * Area masks can be loaded and saved as text files of point coordinates.
     * Widget 5 allows the image to be zoomed using the usual magnifier window
     * Widget 5 can draw the following graphs from an image:
       * Greylevel histogram
       * Cumulative histogram
     * Individual bar heights can be inspected on the graphs.
     * Graph data can be saved as a CSV file to allow importation into another
       package for analysis.
     * Widget 5 allows Convolution Filters to be loaded and saved.