====== HyperFun Polygon Convertor ======

This is a Windows tool for 2D polygon drawing and conversion to HyperFun.

There are two programs:

1) polygon.exe is a simple Windows editor for a 2D polygon: 
  * press left mouse button - add vertex
  * double click - close the polygon
  * any vertex can be selected and moved by pressing left mouse button
  * right mouse button - remove the polygon
  * open, save and "save as" to a text file are supported 
  * everything is drawn and saved in screen coordinates, so the polygon needs to be drawn clockwise!

One can avoid using polygon.exe and input the text file for 2D polygon manually.
For example, for a triangle:
<code>
3
0. 0.
0.5 1.
0. 1.
</code>

2) Polygon_Frep console program translates ASCII file with polygon data into HF file.

DOS command:
<code>
>Polygon_Frep p.txt p.hf
</code>

**p.txt** is an **input** file with vertex coordinates (counter-clockwise) (see the sample p1.txt)\\
**p.hf** is an **output** file (see the sample p1.hf).\\
Note that x[3] is used in the HF model, so formally it is an infinite cylinder in 3D defined as
<code>f(x,y,z) >= 0, where f(x,y,0) >= 0 is a 2D polygon.</code>
The maximal bounding box is x:[0,760], y:[0,470]

===== Viewing the generated HF object in the HyperFun for Windows program. =====

To render this object make the following steps:
1) Assign in HFW:
<code>x[1] -> x
x[2] -> y
x[3] -> 0
f -> 0</code> 
2) In Redering-Polygonization-Axes/Box visibility, make 
<code>Long step 100
short step 0 </code>
3) Render frame

Note it is up side down, because of the drawing the letter in screen coordinates.

To flip the polygon up side down and to fit it to any given rectangle:
1) add the following lines at the top:
<code>
-- box to fit the letter in
xmin = 2; xmax = 4; ymin = 2; ymax = 4;
xt = 760*(x[1]-xmin)/(xmax-xmin);
yt = 470*(1-(x[2]-ymin)/(ymax-ymin));
</code>

2) change in the text below these symbols:
<code>
x[1] to xt
x[2] to yt
</code>

Send questions and inquiries to

ekart at nm.ru
pasko at acm.org