EdgePoints 4.4 Contents
***********************

@Remark $VER: EdgePoints_guide 4.4 (23.2.97)

EdgePoints is a command which can either edge detect an image and produce a one bitplane output file or edge detect two images and produce an ARexx script for MPMorph to add the points.

From the GUI the O key can be used to action the requester. The C or Esc key can be used to cancel the requester.

The shell parameters are:

There is also a GUI with an extra gadget:

FROM1/K/A - First input file
****************************

This gives the name of the first input file.

From the GUI if the Mode gadget is set to Add Points then this defaults to first image and can not be changed, if it is set to Edge Detect then it defaults to the first image but can be changed.

The I key can be used to activate this gadget. With the right shift key a file requester is displayed.

FROM2/K/A - Second input file
*****************************

This gives the name of the second input file.

If this is supplied then all of TO, PERC2, MINP, MAXP and MINDIFF must be supplied

From the GUI this defaults to the second image and can not be changed.

TO/K - Output file
******************

If FROM2 is not supplied then this parameter is optional. If not supplied then the edge detected image is displayed on a screen. Any key can be pressed to stop the image being displayed. Click in the top left corner and try again if the key is ignored. If it is supplied then it gives the name of the file to save the edge detected ILBM Black and White image.

If FROM2 is supplied then this parameter must be supplied and gives the name of the file to save the MPMorph ARexx script.

This can not be changed from the GUI.

PERCENT1=PERC1/N/K/A - Percentage of first file
***********************************************

This gives the percentage of the first image which is considered to be an edge.

From the GUI this defaults to 10 which is a reasonable value.

The P key can be used to increase this value. With the shift key the value is decreased.

PERCENT2=PERC2/N/K - Percentage of second file
**********************************************

When FROM2 is supplied or the Mode is set to Add Points this gives the percentage of the second image which is considered to be an edge.

From the GUI this defaults to 10 which is a reasonable value.

The E key can be used to increase this value. With the shift key the value is decreased.

MINPOINTS=MINP/N/K - Number of points to add
********************************************

When FROM2 is supplied or the Mode is set to Add Points this gives the number of points which should be added to the morph. This should be smaller than the MAXP/Test Points value.

Depending on the MINDIFF/Min Seperation value the actual number of points may be smaller than the number requested.

From the GUI this defaults to 50 which may be a reasonable value.

The A key can be used to increase this value. With the shift key the value is decreased.

MAXPOINTS=MAXP/N/K - Number of points to test
*********************************************

When FROM2 is supplied or the Mode is set to Add Points this gives the number of points which are tested. This should be larger than the MINP/Add Points value.

If the GRID/Grid parameter is provided/gadget is selected then this number of points is initially added in a square grid, otherwise they are added randomly.

From the GUI this defaults to 150 which may be a reasonable value.

The T key can be used to increase this value. With the shift key the value is decreased.

MINDIFF/N/K - Minimum points seperation
***************************************

When FROM2 is supplied or the Mode is set to Add Points this gives the minimum seperation of points to add to the morph.

From the GUI this defaults to 5 which may be a reasonable value.

The S key can be used to increase this value. With the shift key the value is decreased.

X/N/K/A - Width of output
*************************

This gives the width of the output. The input images are scaled to this size.

From the GUI this defaults to the width of the morph and can not be changed.

Y/N/K/A - Height of output
**************************

This gives the height of the output. The input images are scaled to this size.

From the GUI this defaults to the height of the morph and can not be changed.

GRID/S - Random or grid
***********************

If this parameter is supplied/gadget selected then points are initially added in a grid. Otherwise they are added at random.

From the GUI this defaults to selected. The G key toggles the selection.

PUBSCREEN/K - Public screen name
********************************

This parameter can be used to select a screen on which to display progress requesters.

From the GUI this defaults to the screen that MPMorph is running on and can not be changed.

Add Points or Edge Detect
*************************

This gadget defaults to Add Points which add points to the morph. It can also be set to Edge Detect which displays the result of edge detecting an image.

The M key can be used to cycle this gadget.

Copyright and distribution requirements
***************************************

      EdgePoints - Edge detection for MPMorph
      Copyright (C) © 1995 Mark John Paddock

      This program is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published by
      the Free Software Foundation; either version 2 of the License, or
      any later version.

      This program is distributed in the hope that it will be useful,
      but WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      GNU General Public License for more details.

      You should have received a copy of the GNU General Public License
      along with this program; if not, write to the Free Software
      Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

      mark@topic.demon.co.uk
      mpaddock@cix.compulink.co.uk

EdgePoints IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY OR RESPONSIBILITY IS ASSUMED.

EdgePoints is ©1995 Mark John Paddock

Please send any criticisms, bugs, etc. by EMail to mark@topic.demon.co.uk or mpaddock@cix.compulink.co.uk.