| 1 |
GEDIT - A 3-D object editor |
| 2 |
|
| 3 |
Copyright(c) 1993-1998, Riley Rainey, [email protected] |
| 4 |
|
| 5 |
Permission to use, copy, modify and distribute (without charge) this |
| 6 |
software, documentation, images, etc. is granted, provided that this |
| 7 |
comment and the author's name is retained. |
| 8 |
|
| 9 |
This software is provided by the author as is, and without any expressed |
| 10 |
or implied warranties, including, but not limited to, the implied |
| 11 |
warranties of merchantability and fitness for a particular purpose. In no |
| 12 |
event shall the author be liable for any direct, indirect, incidental, or |
| 13 |
consequential damages arising in any way out of the use of this software. |
| 14 |
|
| 15 |
|
| 16 |
|
| 17 |
|
| 18 |
WHAT IS GEDIT? |
| 19 |
|
| 20 |
Well, this can be considered "work in progress", but it works. GEDIT can be |
| 21 |
used to build displayable objects for ACM. It requires Motif 1.1 or later. |
| 22 |
|
| 23 |
Generating three dimensional objects on a two dimensional screen is a bit of |
| 24 |
a challenge. GEDIT solves the problem by displaying two views of the same |
| 25 |
object simultaneously. |
| 26 |
|
| 27 |
The main GEDIT window displays a top and side view of an area used to build |
| 28 |
an object out of planar polygons. As an experiment, press the Polygon |
| 29 |
button on the left-hand side of the display. You must then define the |
| 30 |
three points that will determine the polygon's plane. |
| 31 |
|
| 32 |
You do that by clicking the mouse in one of the two view windows -- |
| 33 |
hold mouse button one down and move the mouse. See how the |
| 34 |
point in the opposite window moves up and down when you move the mouse |
| 35 |
up and down? |
| 36 |
|
| 37 |
What you're doing is defining a point in 3-space -- the first |
| 38 |
two coordinates are determined from where you clicked the mouse in the |
| 39 |
first window. The remaining coordinate is determined by the location of the |
| 40 |
point in the other window when you're finished dragging and you release the |
| 41 |
mouse button. Do that three times and you've defined three points that |
| 42 |
define a plane -- more mouse clicks immediately define a point on the |
| 43 |
polygon since the polygon's plane has already been determined by the |
| 44 |
location of the first three points. |
| 45 |
|
| 46 |
How is that useful? Picture this: take your favorite airplane book that |
| 47 |
contains three-views (top, left, front view) of a given aircraft. Now take the |
| 48 |
book over to a copier and copy those diagrams onto an overhead slide (the |
| 49 |
clear paper ;-)). Now cut out each view. You can then fire up GEDIT on your |
| 50 |
workstation, and tape the side view in the top window and the top view over |
| 51 |
the bottom one (I usually have enough static electricity around to hold it |
| 52 |
up without any tape) (make sure the two diagrams line up correctly). Now |
| 53 |
start defining wings, tails, etc ... cute, no? You can then change views |
| 54 |
(see the Layout menu) and do a similar thing with the front view. |
| 55 |
|
| 56 |
In the SaveAs dialog, you can output a file in V format. If you want the |
| 57 |
object to be revisable, save a copy under another filename in GEDIT |
| 58 |
(GDF) format. |
| 59 |
|
| 60 |
|
| 61 |
-- RBR |
| 62 |
|
| 63 |
|
| 64 |
BUILDING GEDIT |
| 65 |
-------------- |
| 66 |
|
| 67 |
GEDIT uses the ACM V graphics library. You must have the ACM sources |
| 68 |
available in order to build GEDIT. You will need to edit GEDIT's Makefile to |
| 69 |
set the "ACM" variable to point to the top-level ACM source directory |
| 70 |
(i.e. the directory that contains ACM's README file). |
| 71 |
|
| 72 |
|
| 73 |
The GEDIT File Format |
| 74 |
--------------------- |
| 75 |
|
| 76 |
Unfortunately, I was in a rush when I defined this graphics file format. |
| 77 |
It stores information in your platform's binary form (with its definition of |
| 78 |
structure alignment and floating point values) -- this is likely to |
| 79 |
be incompatible with the binary format of someone else's machine. So, |
| 80 |
until someone defines a "PGDF" (portable GDF) file format and a |
| 81 |
converter between "PGDF" and GDF, you are limited in the sharing that |
| 82 |
you'll be able to do with raw GDF files. |
| 83 |
|
| 84 |
A gdf directory that includes several files that I created (on a Sun-4) have |
| 85 |
been provided for you to examine. |
| 86 |
|
| 87 |
OTHER NOTES |
| 88 |
----------- |
| 89 |
|
| 90 |
This software is designed to run on paletted visuals. It will run, but |
| 91 |
produce undesireable results in DirectColor visual. |
| 92 |
|