Debian Codegraph @

src/gedit/README

raw
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