                    How To Use Polygraf

This is a rather long text file, so scroll down to see everything.

Create the polygon by selecting the menu item PolyGraf/Drawing the Polygon.

Test the Window by selecting Polygraf/The PolyWindow

The Polygon Drawing tool is not much of a drawing tool. Mostly it's just a
crude method to set points for the polygon array.

Currently Polygraf will save the contents of the "Drawing Window to an INI 
file that can be loaded into another application.

A couple of points about PolyWindows. The PolyRgn API calls appear to require
point 0,0 of the polygon to coincide with point 0,0 of the window. So when you
draw the polygon you must do two things.

1. The first and last points of the array must be at 0,0

2. The Second and next to the last points of the array 
   must be exactly the same. 

When you do this, the PolyRgn will appear inside of the parent window, but all 
of the region outside of the polygon will be clipped away. If you use any X,Y 
addressing in your code, it will be relative to point 0,0 of the original Window.

A lot of this code was gleaned from other sources, some from Icetips and some from
newsgroups and other sources of example code. Therefore I've decided to release this
application under the GNU-GPL License agreement. That license is included as
a part of this distribution.


What Still Needs To Be Done:

The Editor is rather rudimentary. The input for the x,y positions is done via spin
boxes and it really should be done by mouse clicks. This would allow much 
larger arrays to be created.

The point array is currently saved as an INI file and I think that is probably sound as
it makes storage of the definitions for window shapes independent of any particular
file drivers. However it would be nice to add a load/save dialog.

A Template needs to be written to add the Window clipping code and Window movement
routines automagically.

If anyone has any further ideas or suggestions, drop me an email:

   sylkie@powertech.no

