| 1 |
This is ../../doc/geomview, produced by makeinfo version 4.13 from |
| 2 |
../../doc/geomview.texi. |
| 3 |
|
| 4 |
INFO-DIR-SECTION Graphics Applications |
| 5 |
START-INFO-DIR-ENTRY |
| 6 |
* Geomview: (geomview). The interactive 3D viewing program. |
| 7 |
END-INFO-DIR-ENTRY |
| 8 |
|
| 9 |
|
| 10 |
File: geomview, Node: Top, Next: Intro, Prev: (dir), Up: (dir) |
| 11 |
|
| 12 |
Geomview, the interactive 3D viewing program. |
| 13 |
|
| 14 |
* Menu: |
| 15 |
|
| 16 |
* Intro:: Introduction to Geomview. |
| 17 |
* Distrib:: How to get the latest Geomview distribution. |
| 18 |
* Copying:: The GNU Lesser Public License. |
| 19 |
* History:: History of Geomview's Development. |
| 20 |
* Platforms:: Supported Platforms. |
| 21 |
* Pronunciation:: How to Pronounce ``Geomview''. |
| 22 |
* Overview:: Overview of Geomview. |
| 23 |
* Tutorial:: Introductory Tutorial. |
| 24 |
* Interaction:: Interacting with Geomview. |
| 25 |
* OOGL File Formats:: Formats for Geometry Input. |
| 26 |
* Customization:: Modifying the behavior of Geomview. |
| 27 |
* Modules:: Programs that use Geomview for graphics display. |
| 28 |
* GCL:: GCL: the Geomview Command Language. |
| 29 |
* Non-Euclidean Geometry:: Non-Euclidean Geometry. |
| 30 |
* Mathematica:: Mathematica Graphics in Geomview or RenderMan. |
| 31 |
* Installation:: Installing Geomview on your computer. |
| 32 |
* Support:: Getting Technical Support for Geomview. |
| 33 |
|
| 34 |
* Contributing:: How to contribute to Geomview. |
| 35 |
* Function Index:: A node for each GCL function. |
| 36 |
* List of Figures:: List of Figures. |
| 37 |
|
| 38 |
|
| 39 |
File: geomview, Node: Intro, Next: Distrib, Prev: Top, Up: Top |
| 40 |
|
| 41 |
Introduction to Geomview |
| 42 |
************************ |
| 43 |
|
| 44 |
Geomview is an interactive program for viewing and manipulating |
| 45 |
geometric objects, originally written by staff members of the Geometry |
| 46 |
Center at the University of Minnesota, starting in 1991. It can be used |
| 47 |
as a stand-alone viewer for static objects or as a display engine for |
| 48 |
other programs which produce dynamically changing geometry. It runs on |
| 49 |
many kinds of Unix computers, including Linux, SGI, Sun, and HP. It also |
| 50 |
runs with Cygwin. This manual describes Geomview version 1.9. |
| 51 |
|
| 52 |
Geomview is free software, available under the terms of the GNU |
| 53 |
Lesser Public License; *note Copying:: for details. |
| 54 |
|
| 55 |
Geomview and this manual are available for download from |
| 56 |
`http://www.geomview.org'. |
| 57 |
|
| 58 |
Permission is granted to make copies of this manual. |
| 59 |
|
| 60 |
If you have questions or comments about Geomview or this manual, |
| 61 |
consider joining in the `geomview-users' mailing list, which is a forum |
| 62 |
in which users of Geomview communicate to answer each others' questions |
| 63 |
and to share news about what they are doing with Geomview. The |
| 64 |
Geomview authors participate in this list and sometimes post answers to |
| 65 |
questions there. To join the list, visit the list web page at |
| 66 |
`http://lists.sourceforge.net/mailman/listinfo/geomview-users'. |
| 67 |
|
| 68 |
|
| 69 |
File: geomview, Node: Distrib, Next: Copying, Prev: Intro, Up: Top |
| 70 |
|
| 71 |
Distribution |
| 72 |
************ |
| 73 |
|
| 74 |
Geomview is "free software"; this means that everyone is free to use it |
| 75 |
and free to redistribute it on certain conditions. Geomview is not in |
| 76 |
the public domain; it is copyrighted and there are restrictions on its |
| 77 |
distribution, but these restrictions are designed to permit everything |
| 78 |
that a good cooperating citizen would want to do. What is not allowed |
| 79 |
is to try to prevent others from further sharing any version of |
| 80 |
Geomview that they might get from you. The precise conditions are |
| 81 |
found in the GNU Lesser Public License that comes with Geomview and also |
| 82 |
appears following this section. |
| 83 |
|
| 84 |
One way to get a copy of Geomview is from someone else who has it. |
| 85 |
You need not ask for our permission to do so, or tell any one else; just |
| 86 |
copy it. If you have access to the Internet, you can get the latest |
| 87 |
distribution version of Geomview at `http://www.geomview.org'. |
| 88 |
|
| 89 |
You may also receive Geomview when you buy a computer. Computer |
| 90 |
manufacturers are free to distribute copies on the same terms that |
| 91 |
apply to everyone else. These terms require them to give you the full |
| 92 |
sources, including whatever changes they may have made, and to permit |
| 93 |
you to redistribute the Geomview received from them under the usual |
| 94 |
terms of the General Public License. In other words, the program must |
| 95 |
be free for you when you get it, not just free for the manufacturer. |
| 96 |
|
| 97 |
|
| 98 |
File: geomview, Node: Copying, Next: History, Prev: Distrib, Up: Top |
| 99 |
|
| 100 |
Copying |
| 101 |
******* |
| 102 |
|
| 103 |
NOTE: Geomview is distributed under the GNU LESSER GENERAL PUBLIC |
| 104 |
LICENSE. For the purposes of this license we think of Geomview as if it |
| 105 |
were a "library", and of Geomview external modules as "programs that |
| 106 |
link with the library". We do this because we specifically want to |
| 107 |
allow proprietary programs and modules to use Geomview. |
| 108 |
|
| 109 |
GNU LESSER PUBLIC LICENSE |
| 110 |
************************* |
| 111 |
|
| 112 |
Version 2.1, February 1999 |
| 113 |
|
| 114 |
Copyright (C) 1991, 1999 Free Software Foundation, Inc. |
| 115 |
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 116 |
|
| 117 |
Everyone is permitted to copy and distribute verbatim copies |
| 118 |
of this license document, but changing it is not allowed. |
| 119 |
|
| 120 |
[This is the first released version of the Lesser GPL. It also counts |
| 121 |
as the successor of the GNU Library Public License, version 2, hence |
| 122 |
the version number 2.1.] |
| 123 |
|
| 124 |
Preamble |
| 125 |
======== |
| 126 |
|
| 127 |
The licenses for most software are designed to take away your freedom |
| 128 |
to share and change it. By contrast, the GNU General Public Licenses |
| 129 |
are intended to guarantee your freedom to share and change free |
| 130 |
software-to make sure the software is free for all its users. |
| 131 |
|
| 132 |
This license, the Lesser General Public License, applies to some |
| 133 |
specially designated software packages-typically libraries-of the Free |
| 134 |
Software Foundation and other authors who decide to use it. You can |
| 135 |
use it too, but we suggest you first think carefully about whether this |
| 136 |
license or the ordinary General Public License is the better strategy |
| 137 |
to use in any particular case, based on the explanations below. |
| 138 |
|
| 139 |
When we speak of free software, we are referring to freedom of use, |
| 140 |
not price. Our General Public Licenses are designed to make sure that |
| 141 |
you have the freedom to distribute copies of free software (and charge |
| 142 |
for this service if you wish); that you receive source code or can get |
| 143 |
it if you want it; that you can change the software and use pieces of |
| 144 |
it in new free programs; and that you are informed that you can do |
| 145 |
these things. |
| 146 |
|
| 147 |
To protect your rights, we need to make restrictions that forbid |
| 148 |
distributors to deny you these rights or to ask you to surrender these |
| 149 |
rights. These restrictions translate to certain responsibilities for |
| 150 |
you if you distribute copies of the library or if you modify it. |
| 151 |
|
| 152 |
For example, if you distribute copies of the library, whether gratis |
| 153 |
or for a fee, you must give the recipients all the rights that we gave |
| 154 |
you. You must make sure that they, too, receive or can get the source |
| 155 |
code. If you link other code with the library, you must provide |
| 156 |
complete object files to the recipients, so that they can relink them |
| 157 |
with the library after making changes to the library and recompiling |
| 158 |
it. And you must show them these terms so they know their rights. |
| 159 |
|
| 160 |
We protect your rights with a two-step method: (1) we copyright the |
| 161 |
library, and (2) we offer you this license, which gives you legal |
| 162 |
permission to copy, distribute and/or modify the library. |
| 163 |
|
| 164 |
To protect each distributor, we want to make it very clear that |
| 165 |
there is no warranty for the free library. Also, if the library is |
| 166 |
modified by someone else and passed on, the recipients should know that |
| 167 |
what they have is not the original version, so that the original |
| 168 |
author's reputation will not be affected by problems that might be |
| 169 |
introduced by others. |
| 170 |
|
| 171 |
Finally, software patents pose a constant threat to the existence of |
| 172 |
any free program. We wish to make sure that a company cannot |
| 173 |
effectively restrict the users of a free program by obtaining a |
| 174 |
restrictive license from a patent holder. Therefore, we insist that |
| 175 |
any patent license obtained for a version of the library must be |
| 176 |
consistent with the full freedom of use specified in this license. |
| 177 |
|
| 178 |
Most GNU software, including some libraries, is covered by the |
| 179 |
ordinary GNU General Public License. This license, the GNU Lesser |
| 180 |
General Public License, applies to certain designated libraries, and is |
| 181 |
quite different from the ordinary General Public License. We use this |
| 182 |
license for certain libraries in order to permit linking those |
| 183 |
libraries into non-free programs. |
| 184 |
|
| 185 |
When a program is linked with a library, whether statically or using |
| 186 |
a shared library, the combination of the two is legally speaking a |
| 187 |
combined work, a derivative of the original library. The ordinary |
| 188 |
General Public License therefore permits such linking only if the |
| 189 |
entire combination fits its criteria of freedom. The Lesser General |
| 190 |
Public License permits more lax criteria for linking other code with |
| 191 |
the library. |
| 192 |
|
| 193 |
We call this license the "Lesser" General Public License because it |
| 194 |
does Less to protect the user's freedom than the ordinary General |
| 195 |
Public License. It also provides other free software developers Less |
| 196 |
of an advantage over competing non-free programs. These disadvantages |
| 197 |
are the reason we use the ordinary General Public License for many |
| 198 |
libraries. However, the Lesser license provides advantages in certain |
| 199 |
special circumstances. |
| 200 |
|
| 201 |
For example, on rare occasions, there may be a special need to |
| 202 |
encourage the widest possible use of a certain library, so that it |
| 203 |
becomes a de-facto standard. To achieve this, non-free programs must |
| 204 |
be allowed to use the library. A more frequent case is that a free |
| 205 |
library does the same job as widely used non-free libraries. In this |
| 206 |
case, there is little to gain by limiting the free library to free |
| 207 |
software only, so we use the Lesser General Public License. |
| 208 |
|
| 209 |
In other cases, permission to use a particular library in non-free |
| 210 |
programs enables a greater number of people to use a large body of free |
| 211 |
software. For example, permission to use the GNU C Library in non-free |
| 212 |
programs enables many more people to use the whole GNU operating |
| 213 |
system, as well as its variant, the GNU/Linux operating system. |
| 214 |
|
| 215 |
Although the Lesser General Public License is Less protective of the |
| 216 |
users' freedom, it does ensure that the user of a program that is |
| 217 |
linked with the Library has the freedom and the wherewithal to run that |
| 218 |
program using a modified version of the Library. |
| 219 |
|
| 220 |
The precise terms and conditions for copying, distribution and |
| 221 |
modification follow. Pay close attention to the difference between a |
| 222 |
"work based on the library" and a "work that uses the library". The |
| 223 |
former contains code derived from the library, whereas the latter must |
| 224 |
be combined with the library in order to run. |
| 225 |
|
| 226 |
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION |
| 227 |
=============================================================== |
| 228 |
|
| 229 |
0. This License Agreement applies to any software library or other |
| 230 |
program which contains a notice placed by the copyright holder or |
| 231 |
other authorized party saying it may be distributed under the |
| 232 |
terms of this Lesser General Public License (also called "this |
| 233 |
License"). Each licensee is addressed as "you". |
| 234 |
|
| 235 |
A "library" means a collection of software functions and/or data |
| 236 |
prepared so as to be conveniently linked with application programs |
| 237 |
(which use some of those functions and data) to form executables. |
| 238 |
|
| 239 |
The "Library", below, refers to any such software library or work |
| 240 |
which has been distributed under these terms. A "work based on the |
| 241 |
Library" means either the Library or any derivative work under |
| 242 |
copyright law: that is to say, a work containing the Library or a |
| 243 |
portion of it, either verbatim or with modifications and/or |
| 244 |
translated straightforwardly into another language. (Hereinafter, |
| 245 |
translation is included without limitation in the term |
| 246 |
"modification".) |
| 247 |
|
| 248 |
"Source code" for a work means the preferred form of the work for |
| 249 |
making modifications to it. For a library, complete source code |
| 250 |
means all the source code for all modules it contains, plus any |
| 251 |
associated interface definition files, plus the scripts used to |
| 252 |
control compilation and installation of the library. |
| 253 |
|
| 254 |
Activities other than copying, distribution and modification are |
| 255 |
not covered by this License; they are outside its scope. The act |
| 256 |
of running a program using the Library is not restricted, and |
| 257 |
output from such a program is covered only if its contents |
| 258 |
constitute a work based on the Library (independent of the use of |
| 259 |
the Library in a tool for writing it). Whether that is true |
| 260 |
depends on what the Library does and what the program that uses |
| 261 |
the Library does. |
| 262 |
|
| 263 |
1. You may copy and distribute verbatim copies of the Library's |
| 264 |
complete source code as you receive it, in any medium, provided |
| 265 |
that you conspicuously and appropriately publish on each copy an |
| 266 |
appropriate copyright notice and disclaimer of warranty; keep |
| 267 |
intact all the notices that refer to this License and to the |
| 268 |
absence of any warranty; and distribute a copy of this License |
| 269 |
along with the Library. |
| 270 |
|
| 271 |
You may charge a fee for the physical act of transferring a copy, |
| 272 |
and you may at your option offer warranty protection in exchange |
| 273 |
for a fee. |
| 274 |
|
| 275 |
2. You may modify your copy or copies of the Library or any portion |
| 276 |
of it, thus forming a work based on the Library, and copy and |
| 277 |
distribute such modifications or work under the terms of Section 1 |
| 278 |
above, provided that you also meet all of these conditions: |
| 279 |
|
| 280 |
a. The modified work must itself be a software library. |
| 281 |
|
| 282 |
b. You must cause the files modified to carry prominent notices |
| 283 |
stating that you changed the files and the date of any change. |
| 284 |
|
| 285 |
c. You must cause the whole of the work to be licensed at no |
| 286 |
charge to all third parties under the terms of this License. |
| 287 |
|
| 288 |
d. If a facility in the modified Library refers to a function or |
| 289 |
a table of data to be supplied by an application program that |
| 290 |
uses the facility, other than as an argument passed when the |
| 291 |
facility is invoked, then you must make a good faith effort |
| 292 |
to ensure that, in the event an application does not supply |
| 293 |
such function or table, the facility still operates, and |
| 294 |
performs whatever part of its purpose remains meaningful. |
| 295 |
|
| 296 |
(For example, a function in a library to compute square roots |
| 297 |
has a purpose that is entirely well-defined independent of the |
| 298 |
application. Therefore, Subsection 2d requires that any |
| 299 |
application-supplied function or table used by this function |
| 300 |
must be optional: if the application does not supply it, the |
| 301 |
square root function must still compute square roots.) |
| 302 |
|
| 303 |
These requirements apply to the modified work as a whole. If |
| 304 |
identifiable sections of that work are not derived from the |
| 305 |
Library, and can be reasonably considered independent and separate |
| 306 |
works in themselves, then this License, and its terms, do not |
| 307 |
apply to those sections when you distribute them as separate |
| 308 |
works. But when you distribute the same sections as part of a |
| 309 |
whole which is a work based on the Library, the distribution of |
| 310 |
the whole must be on the terms of this License, whose permissions |
| 311 |
for other licensees extend to the entire whole, and thus to each |
| 312 |
and every part regardless of who wrote it. |
| 313 |
|
| 314 |
Thus, it is not the intent of this section to claim rights or |
| 315 |
contest your rights to work written entirely by you; rather, the |
| 316 |
intent is to exercise the right to control the distribution of |
| 317 |
derivative or collective works based on the Library. |
| 318 |
|
| 319 |
In addition, mere aggregation of another work not based on the |
| 320 |
Library with the Library (or with a work based on the Library) on |
| 321 |
a volume of a storage or distribution medium does not bring the |
| 322 |
other work under the scope of this License. |
| 323 |
|
| 324 |
3. You may opt to apply the terms of the ordinary GNU General Public |
| 325 |
License instead of this License to a given copy of the Library. |
| 326 |
To do this, you must alter all the notices that refer to this |
| 327 |
License, so that they refer to the ordinary GNU General Public |
| 328 |
License, version 2, instead of to this License. (If a newer |
| 329 |
version than version 2 of the ordinary GNU General Public License |
| 330 |
has appeared, then you can specify that version instead if you |
| 331 |
wish.) Do not make any other change in these notices. ^L Once |
| 332 |
this change is made in a given copy, it is irreversible for that |
| 333 |
copy, so the ordinary GNU General Public License applies to all |
| 334 |
subsequent copies and derivative works made from that copy. |
| 335 |
|
| 336 |
This option is useful when you wish to copy part of the code of |
| 337 |
the Library into a program that is not a library. |
| 338 |
|
| 339 |
4. You may copy and distribute the Library (or a portion or |
| 340 |
derivative of it, under Section 2) in object code or executable |
| 341 |
form under the terms of Sections 1 and 2 above provided that you |
| 342 |
accompany it with the complete corresponding machine-readable |
| 343 |
source code, which must be distributed under the terms of Sections |
| 344 |
1 and 2 above on a medium customarily used for software |
| 345 |
interchange. |
| 346 |
|
| 347 |
If distribution of object code is made by offering access to copy |
| 348 |
from a designated place, then offering equivalent access to copy |
| 349 |
the source code from the same place satisfies the requirement to |
| 350 |
distribute the source code, even though third parties are not |
| 351 |
compelled to copy the source along with the object code. |
| 352 |
|
| 353 |
5. A program that contains no derivative of any portion of the |
| 354 |
Library, but is designed to work with the Library by being |
| 355 |
compiled or linked with it, is called a "work that uses the |
| 356 |
Library". Such a work, in isolation, is not a derivative work of |
| 357 |
the Library, and therefore falls outside the scope of this License. |
| 358 |
|
| 359 |
However, linking a "work that uses the Library" with the Library |
| 360 |
creates an executable that is a derivative of the Library (because |
| 361 |
it contains portions of the Library), rather than a "work that |
| 362 |
uses the library". The executable is therefore covered by this |
| 363 |
License. Section 6 states terms for distribution of such |
| 364 |
executables. |
| 365 |
|
| 366 |
When a "work that uses the Library" uses material from a header |
| 367 |
file that is part of the Library, the object code for the work may |
| 368 |
be a derivative work of the Library even though the source code is |
| 369 |
not. Whether this is true is especially significant if the work |
| 370 |
can be linked without the Library, or if the work is itself a |
| 371 |
library. The threshold for this to be true is not precisely |
| 372 |
defined by law. |
| 373 |
|
| 374 |
If such an object file uses only numerical parameters, data |
| 375 |
structure layouts and accessors, and small macros and small inline |
| 376 |
functions (ten lines or less in length), then the use of the object |
| 377 |
file is unrestricted, regardless of whether it is legally a |
| 378 |
derivative work. (Executables containing this object code plus |
| 379 |
portions of the Library will still fall under Section 6.) |
| 380 |
|
| 381 |
Otherwise, if the work is a derivative of the Library, you may |
| 382 |
distribute the object code for the work under the terms of Section |
| 383 |
6. Any executables containing that work also fall under Section 6, |
| 384 |
whether or not they are linked directly with the Library itself. |
| 385 |
|
| 386 |
6. As an exception to the Sections above, you may also combine or |
| 387 |
link a "work that uses the Library" with the Library to produce a |
| 388 |
work containing portions of the Library, and distribute that work |
| 389 |
under terms of your choice, provided that the terms permit |
| 390 |
modification of the work for the customer's own use and reverse |
| 391 |
engineering for debugging such modifications. |
| 392 |
|
| 393 |
You must give prominent notice with each copy of the work that the |
| 394 |
Library is used in it and that the Library and its use are covered |
| 395 |
by this License. You must supply a copy of this License. If the |
| 396 |
work during execution displays copyright notices, you must include |
| 397 |
the copyright notice for the Library among them, as well as a |
| 398 |
reference directing the user to the copy of this License. Also, |
| 399 |
you must do one of these things: |
| 400 |
|
| 401 |
a. Accompany the work with the complete corresponding |
| 402 |
machine-readable source code for the Library including |
| 403 |
whatever changes were used in the work (which must be |
| 404 |
distributed under Sections 1 and 2 above); and, if the work |
| 405 |
is an executable linked with the Library, with the complete |
| 406 |
machine-readable "work that uses the Library", as object code |
| 407 |
and/or source code, so that the user can modify the Library |
| 408 |
and then relink to produce a modified executable containing |
| 409 |
the modified Library. (It is understood that the user who |
| 410 |
changes the contents of definitions files in the Library will |
| 411 |
not necessarily be able to recompile the application to use |
| 412 |
the modified definitions.) |
| 413 |
|
| 414 |
b. Use a suitable shared library mechanism for linking with the |
| 415 |
Library. A suitable mechanism is one that (1) uses at run |
| 416 |
time a copy of the library already present on the user's |
| 417 |
computer system, rather than copying library functions into |
| 418 |
the executable, and (2) will operate properly with a modified |
| 419 |
version of the library, if the user installs one, as long as |
| 420 |
the modified version is interface-compatible with the version |
| 421 |
that the work was made with. |
| 422 |
|
| 423 |
c. Accompany the work with a written offer, valid for at least |
| 424 |
three years, to give the same user the materials specified in |
| 425 |
Subsection 6a, above, for a charge no more than the cost of |
| 426 |
performing this distribution. |
| 427 |
|
| 428 |
d. If distribution of the work is made by offering access to copy |
| 429 |
from a designated place, offer equivalent access to copy the |
| 430 |
above specified materials from the same place. |
| 431 |
|
| 432 |
e. Verify that the user has already received a copy of these |
| 433 |
materials or that you have already sent this user a copy. |
| 434 |
|
| 435 |
For an executable, the required form of the "work that uses the |
| 436 |
Library" must include any data and utility programs needed for |
| 437 |
reproducing the executable from it. However, as a special |
| 438 |
exception, the materials to be distributed need not include |
| 439 |
anything that is normally distributed (in either source or binary |
| 440 |
form) with the major components (compiler, kernel, and so on) of |
| 441 |
the operating system on which the executable runs, unless that |
| 442 |
component itself accompanies the executable. |
| 443 |
|
| 444 |
It may happen that this requirement contradicts the license |
| 445 |
restrictions of other proprietary libraries that do not normally |
| 446 |
accompany the operating system. Such a contradiction means you |
| 447 |
cannot use both them and the Library together in an executable |
| 448 |
that you distribute. |
| 449 |
|
| 450 |
7. You may place library facilities that are a work based on the |
| 451 |
Library side-by-side in a single library together with other |
| 452 |
library facilities not covered by this License, and distribute |
| 453 |
such a combined library, provided that the separate distribution |
| 454 |
of the work based on the Library and of the other library |
| 455 |
facilities is otherwise permitted, and provided that you do these |
| 456 |
two things: |
| 457 |
|
| 458 |
a. Accompany the combined library with a copy of the same work |
| 459 |
based on the Library, uncombined with any other library |
| 460 |
facilities. This must be distributed under the terms of the |
| 461 |
Sections above. |
| 462 |
|
| 463 |
b. Give prominent notice with the combined library of the fact |
| 464 |
that part of it is a work based on the Library, and explaining |
| 465 |
where to find the accompanying uncombined form of the same |
| 466 |
work. |
| 467 |
|
| 468 |
8. You may not copy, modify, sublicense, link with, or distribute the |
| 469 |
Library except as expressly provided under this License. Any |
| 470 |
attempt otherwise to copy, modify, sublicense, link with, or |
| 471 |
distribute the Library is void, and will automatically terminate |
| 472 |
your rights under this License. However, parties who have |
| 473 |
received copies, or rights, from you under this License will not |
| 474 |
have their licenses terminated so long as such parties remain in |
| 475 |
full compliance. |
| 476 |
|
| 477 |
9. You are not required to accept this License, since you have not |
| 478 |
signed it. However, nothing else grants you permission to modify |
| 479 |
or distribute the Library or its derivative works. These actions |
| 480 |
are prohibited by law if you do not accept this License. |
| 481 |
Therefore, by modifying or distributing the Library (or any work |
| 482 |
based on the Library), you indicate your acceptance of this |
| 483 |
License to do so, and all its terms and conditions for copying, |
| 484 |
distributing or modifying the Library or works based on it. |
| 485 |
|
| 486 |
10. Each time you redistribute the Library (or any work based on the |
| 487 |
Library), the recipient automatically receives a license from the |
| 488 |
original licensor to copy, distribute, link with or modify the |
| 489 |
Library subject to these terms and conditions. You may not impose |
| 490 |
any further restrictions on the recipients' exercise of the rights |
| 491 |
granted herein. You are not responsible for enforcing compliance |
| 492 |
by third parties with this License. |
| 493 |
|
| 494 |
11. If, as a consequence of a court judgment or allegation of patent |
| 495 |
infringement or for any other reason (not limited to patent |
| 496 |
issues), conditions are imposed on you (whether by court order, |
| 497 |
agreement or otherwise) that contradict the conditions of this |
| 498 |
License, they do not excuse you from the conditions of this |
| 499 |
License. If you cannot distribute so as to satisfy simultaneously |
| 500 |
your obligations under this License and any other pertinent |
| 501 |
obligations, then as a consequence you may not distribute the |
| 502 |
Library at all. For example, if a patent license would not permit |
| 503 |
royalty-free redistribution of the Library by all those who |
| 504 |
receive copies directly or indirectly through you, then the only |
| 505 |
way you could satisfy both it and this License would be to refrain |
| 506 |
entirely from distribution of the Library. |
| 507 |
|
| 508 |
If any portion of this section is held invalid or unenforceable |
| 509 |
under any particular circumstance, the balance of the section is |
| 510 |
intended to apply, and the section as a whole is intended to apply |
| 511 |
in other circumstances. |
| 512 |
|
| 513 |
It is not the purpose of this section to induce you to infringe any |
| 514 |
patents or other property right claims or to contest validity of |
| 515 |
any such claims; this section has the sole purpose of protecting |
| 516 |
the integrity of the free software distribution system which is |
| 517 |
implemented by public license practices. Many people have made |
| 518 |
generous contributions to the wide range of software distributed |
| 519 |
through that system in reliance on consistent application of that |
| 520 |
system; it is up to the author/donor to decide if he or she is |
| 521 |
willing to distribute software through any other system and a |
| 522 |
licensee cannot impose that choice. |
| 523 |
|
| 524 |
This section is intended to make thoroughly clear what is believed |
| 525 |
to be a consequence of the rest of this License. |
| 526 |
|
| 527 |
12. If the distribution and/or use of the Library is restricted in |
| 528 |
certain countries either by patents or by copyrighted interfaces, |
| 529 |
the original copyright holder who places the Library under this |
| 530 |
License may add an explicit geographical distribution limitation |
| 531 |
excluding those countries, so that distribution is permitted only |
| 532 |
in or among countries not thus excluded. In such case, this |
| 533 |
License incorporates the limitation as if written in the body of |
| 534 |
this License. |
| 535 |
|
| 536 |
13. The Free Software Foundation may publish revised and/or new |
| 537 |
versions of the Lesser General Public License from time to time. |
| 538 |
Such new versions will be similar in spirit to the present version, |
| 539 |
but may differ in detail to address new problems or concerns. |
| 540 |
|
| 541 |
Each version is given a distinguishing version number. If the |
| 542 |
Library specifies a version number of this License which applies |
| 543 |
to it and "any later version", you have the option of following |
| 544 |
the terms and conditions either of that version or of any later |
| 545 |
version published by the Free Software Foundation. If the Library |
| 546 |
does not specify a license version number, you may choose any |
| 547 |
version ever published by the Free Software Foundation. |
| 548 |
|
| 549 |
14. If you wish to incorporate parts of the Library into other free |
| 550 |
programs whose distribution conditions are incompatible with these, |
| 551 |
write to the author to ask for permission. For software which is |
| 552 |
copyrighted by the Free Software Foundation, write to the Free |
| 553 |
Software Foundation; we sometimes make exceptions for this. Our |
| 554 |
decision will be guided by the two goals of preserving the free |
| 555 |
status of all derivatives of our free software and of promoting |
| 556 |
the sharing and reuse of software generally. |
| 557 |
|
| 558 |
NO WARRANTY |
| 559 |
|
| 560 |
15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO |
| 561 |
WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE |
| 562 |
LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT |
| 563 |
HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT |
| 564 |
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT |
| 565 |
NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND |
| 566 |
FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE |
| 567 |
QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE |
| 568 |
LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY |
| 569 |
SERVICING, REPAIR OR CORRECTION. |
| 570 |
|
| 571 |
16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN |
| 572 |
WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY |
| 573 |
MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE |
| 574 |
LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, |
| 575 |
INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR |
| 576 |
INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF |
| 577 |
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU |
| 578 |
OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY |
| 579 |
OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN |
| 580 |
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. |
| 581 |
|
| 582 |
END OF TERMS AND CONDITIONS |
| 583 |
|
| 584 |
How to Apply These Terms to Your New Programs |
| 585 |
============================================= |
| 586 |
|
| 587 |
If you develop a new library, and you want it to be of the greatest |
| 588 |
possible use to the public, we recommend making it free software that |
| 589 |
everyone can redistribute and change. You can do so by permitting |
| 590 |
redistribution under these terms (or, alternatively, under the terms of |
| 591 |
the ordinary General Public License). |
| 592 |
|
| 593 |
To apply these terms, attach the following notices to the library. |
| 594 |
It is safest to attach them to the start of each source file to most |
| 595 |
effectively convey the exclusion of warranty; and each file should have |
| 596 |
at least the "copyright" line and a pointer to where the full notice is |
| 597 |
found. |
| 598 |
|
| 599 |
ONE LINE TO GIVE THE LIBRARY'S NAME AND A BRIEF IDEA OF WHAT IT DOES. |
| 600 |
Copyright (C) <year> NAME OF AUTHOR |
| 601 |
|
| 602 |
This library is free software; you can redistribute it and/or |
| 603 |
modify it under the terms of the GNU Lesser General Public |
| 604 |
License as published by the Free Software Foundation; either |
| 605 |
version 2 of the License, or (at your option) any later version. |
| 606 |
|
| 607 |
This library is distributed in the hope that it will be useful, |
| 608 |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 609 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| 610 |
Lesser General Public License for more details. |
| 611 |
|
| 612 |
You should have received a copy of the GNU Lesser General Public |
| 613 |
License along with this library; if not, write to the Free Software |
| 614 |
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 615 |
|
| 616 |
Also add information on how to contact you by electronic and paper |
| 617 |
mail. |
| 618 |
|
| 619 |
You should also get your employer (if you work as a programmer) or |
| 620 |
your school, if any, to sign a "copyright disclaimer" for the library, |
| 621 |
if necessary. Here is a sample; alter the names: |
| 622 |
|
| 623 |
Yoyodyne, Inc., hereby disclaims all copyright interest in the |
| 624 |
library `Frob' (a library for tweaking knobs) written by James |
| 625 |
Random Hacker. |
| 626 |
|
| 627 |
<signature of Ty Coon>, 1 April 1990 |
| 628 |
Ty Coon, President of Vice |
| 629 |
|
| 630 |
That's all there is to it! |
| 631 |
|
| 632 |
|
| 633 |
File: geomview, Node: History, Next: Platforms, Prev: Copying, Up: Top |
| 634 |
|
| 635 |
History of Geomview's Development |
| 636 |
********************************* |
| 637 |
|
| 638 |
Geomview was originally written at the Geometry Center at the University |
| 639 |
of Minnesota in Minneapolis. The Geometry Center was a research and |
| 640 |
education center funded by the National Science Foundation, with a |
| 641 |
mission to promote research and communication of mathematics. Much of |
| 642 |
the work there involved the use of computers to help visualize |
| 643 |
mathematical concepts. |
| 644 |
|
| 645 |
The project that eventually led to Geomview began in the summer of |
| 646 |
1988 with the work of Pat Hanrahan on a viewing program called |
| 647 |
MinneView. Shortly thereafter Charlie Gunn begin developing OOGL |
| 648 |
(Object Oriented Graphics Language) in conjunction with MinneView. |
| 649 |
Many people contributed to OOGL and MinneView, including Stuart Levy, |
| 650 |
Mark Meuer, Tamara Munzner, Steve Anderson, Mario Lopez, Todd Kaplan. |
| 651 |
|
| 652 |
In 1991 the staff of the Geometry Center began work on a new improved |
| 653 |
version of OOGL, and a new and improved viewing program, which they |
| 654 |
called Geomview. At that time essentially the only game in town for |
| 655 |
interactive 3D graphics was Silicon Graphics (SGI), so Geomview was |
| 656 |
developed initially on SGI workstations, using IRIS GL. The first |
| 657 |
version was finished in January of 1992. It immediately became very |
| 658 |
popular among visitors to the Geometry Center, and through the Center's |
| 659 |
ftp archive (this was before the web) people at other institutions began |
| 660 |
using it too. |
| 661 |
|
| 662 |
In addition to SGI workstations the Geometry Center had quite a few |
| 663 |
NeXT stations, so soon after Geomview was running on SGIs the staff |
| 664 |
developed a version for NeXTStep as well. By this time there were |
| 665 |
several thousand people using it around the world. |
| 666 |
|
| 667 |
A few years later the staff ported Geomview to X windows and OpenGL, |
| 668 |
and eventually, with the demise of NeXT, the NeXT version fell by the |
| 669 |
wayside. |
| 670 |
|
| 671 |
In its mission to foster communication among researchers and |
| 672 |
educators, the Geometry Center developed a web site, www.geom.umn.edu, |
| 673 |
in late 1993. It was one of the first 300 web sites in existence. A |
| 674 |
part of the web site was of course devoted to Geomview, and helped to |
| 675 |
spread the word about its existence. |
| 676 |
|
| 677 |
The Geometry Center closed its "brick and mortar" facilities in |
| 678 |
August of 1998 (NSF cut its funding), but the web site continued to |
| 679 |
exist, and Geomview continued to be very popular around the world. In |
| 680 |
December of 1999 some of the former Geometry Center staff set up |
| 681 |
`http://www.geomview.org' as a permanent home on the web for Geomview. |
| 682 |
|
| 683 |
Geomview's original authors, as well as a number of other volunteers |
| 684 |
around the world, are still actively involved in using and developing |
| 685 |
Geomview. |
| 686 |
|
| 687 |
* Menu: |
| 688 |
|
| 689 |
* Authors:: Authors. |
| 690 |
|
| 691 |
|
| 692 |
File: geomview, Node: Authors, Prev: History, Up: History |
| 693 |
|
| 694 |
Authors |
| 695 |
======= |
| 696 |
|
| 697 |
Tamara Munzner, Stuart Levy, and Mark Phillips are the original authors |
| 698 |
of Geomview. Celeste Fowler, Charlie Gunn, and Nathaniel Thurston also |
| 699 |
made significant contributions. Daniel Krech and Scott Wisdom did the |
| 700 |
NeXTStep and RenderMan port, and Daeron Meyer and Tim Rowley did the |
| 701 |
port to X windows. Many other Geometry Center staff members, as well |
| 702 |
as several people elsewhere, also contributed. |
| 703 |
|
| 704 |
Mark Phillips wrote this manual, with substantial help from Stuart |
| 705 |
Levy and Tamara Munzner. Countless Geomview users have also been of |
| 706 |
great help by reading it and pointing out mistakes. |
| 707 |
|
| 708 |
|
| 709 |
File: geomview, Node: Platforms, Next: Pronunciation, Prev: History, Up: Top |
| 710 |
|
| 711 |
Supported Platforms |
| 712 |
******************* |
| 713 |
|
| 714 |
Geomview 1.9 should - in principle - compile and run on any fairly |
| 715 |
recent Unix-like operating system. Specifically, it runs on Linux and on |
| 716 |
Cygwin (Cygwin emulates a SystemV Unix-like environment under Microsoft |
| 717 |
Windows). Unluckily Geomview compiles with MacOS X (Darwin), but |
| 718 |
seemingly communicating with Geomview by means of pipes and sockets |
| 719 |
cause segmentation faults. Feel free to fix that! *Note Contributing::, |
| 720 |
for details. |
| 721 |
|
| 722 |
|
| 723 |
File: geomview, Node: Pronunciation, Next: Overview, Prev: Platforms, Up: Top |
| 724 |
|
| 725 |
How to Pronounce "Geomview" |
| 726 |
*************************** |
| 727 |
|
| 728 |
The word 'Geomview' is a combination of the first syllable of the word |
| 729 |
'geometry', and the word 'view'. The authors pronounce it with the |
| 730 |
accent on the first syllable |
| 731 |
|
| 732 |
GE-om-view |
| 733 |
|
| 734 |
Some people put the accent on the second syllable, where it falls in |
| 735 |
the word 'geometry', but the original authors, who invented the name, |
| 736 |
prefer the accent-on-first-syllable pronunciation. |
| 737 |
|
| 738 |
|
| 739 |
File: geomview, Node: Overview, Next: Tutorial, Prev: Pronunciation, Up: Top |
| 740 |
|
| 741 |
1 Overview |
| 742 |
********** |
| 743 |
|
| 744 |
Geomview's main purpose is to display objects whose geometry is given, |
| 745 |
allowing interactive control over details such as point of view, speed |
| 746 |
of movement, appearance of surfaces and lines, and so on. Geomview can |
| 747 |
handle any number of objects and allows both separate and collective |
| 748 |
control over them. |
| 749 |
|
| 750 |
The simplest way to use Geomview is as a stand-alone viewer to see |
| 751 |
and manipulate objects. It can display objects described in a variety |
| 752 |
of file formats. It comes with a wide variety of example objects, and |
| 753 |
you can create your own objects. |
| 754 |
|
| 755 |
You can also use Geomview to handle the display of data coming from |
| 756 |
another program that is running simultaneously. As the other program |
| 757 |
changes the data, the Geomview image reflects the changes. Programs |
| 758 |
that generate objects and use Geomview to display them are called |
| 759 |
_external modules_. External modules can control almost all aspects of |
| 760 |
Geomview. The idea here is that many aspects of the display and |
| 761 |
interaction parts of geometry software are independent of the geometric |
| 762 |
content and can be collected together in a single piece of software |
| 763 |
that can be used in a wide variety of situations. The author of the |
| 764 |
external module can then concentrate on implementing the desired |
| 765 |
algorithms and leave the display aspects to Geomview. Geomview comes |
| 766 |
with a collection of sample external modules, and this manual describes |
| 767 |
how to write your own. |
| 768 |
|
| 769 |
Geomview is the product of an effort at the Geometry Center to |
| 770 |
provide interactive geometry software that is particularly appropriate |
| 771 |
for mathematics research and education. In particular, Geomview can |
| 772 |
display things in hyperbolic and spherical space as well as Euclidean |
| 773 |
space. |
| 774 |
|
| 775 |
Geomview allows multiple independently controllable objects and |
| 776 |
cameras. It provides interactive control for motion, appearances |
| 777 |
(including lighting, shading, and materials), picking on an object, |
| 778 |
edge or vertex level, snapshots in SGI image file or Renderman RIB |
| 779 |
format, and adding or deleting objects is provided through direct mouse |
| 780 |
manipulation, control panels, and keyboard shortcuts. |
| 781 |
|
| 782 |
Geomview supports the following simple data types: polyhedra with |
| 783 |
shared vertices (.off), quadrilaterals, rectangular meshes, vectors, |
| 784 |
and Bezier surface patches of arbitrary degree including rational |
| 785 |
patches. Object hierarchies can be constructed with lists of objects |
| 786 |
and instances of object(s) transformed by one or many 4x4 matrices. |
| 787 |
Arbitrary portions of changing hierarchies may be transmitted by |
| 788 |
creating named references. |
| 789 |
|
| 790 |
Geomview can display 3-D graphics output from Mathematica and Maple. |
| 791 |
|
| 792 |
|
| 793 |
File: geomview, Node: Tutorial, Next: Interaction, Prev: Overview, Up: Top |
| 794 |
|
| 795 |
2 Tutorial |
| 796 |
********** |
| 797 |
|
| 798 |
This chapter leads you through some of the basics of using Geomview. |
| 799 |
Work through this chapter in front of a computer where you can try out |
| 800 |
the examples given here to get a feel for what you can do with Geomview. |
| 801 |
|
| 802 |
To start Geomview, login to the computer and get a shell window. A |
| 803 |
shell window is a window in which you can type Unix commands; the prompt |
| 804 |
in the window usually ends with a '%'. In the shell window (the mouse |
| 805 |
cursor must be in the window) type the following (`<Enter>' here means |
| 806 |
hit the "Enter" key): |
| 807 |
|
| 808 |
geomview tetra dodec <Enter> |
| 809 |
|
| 810 |
This command starts up Geomview and loads two example objects, a |
| 811 |
tetrahedron and a dodecahedron. After a few seconds three windows |
| 812 |
should appear; *note Figure: figinitial. |
| 813 |
|
| 814 |
Figure 2.1: Initial Geomview display. |
| 815 |
|
| 816 |
The panel on the left is Geomview's main control panel; it's called |
| 817 |
the _Main_ panel. The skinny panel in the middle is the _Tools_ panel |
| 818 |
and is for selecting different kinds of motions. The window on the |
| 819 |
right is the camera window and in it you see a large tetrahedron and a |
| 820 |
dodecahedron which is partially obscured by the tetrahedron. |
| 821 |
|
| 822 |
Geomview has lots of panels but by default it displays only these |
| 823 |
three. We'll describe some aspects of these and a couple of the others |
| 824 |
in this tutorial. You can read more about these and other panels in |
| 825 |
the later chapters of this manual. |
| 826 |
|
| 827 |
Put the mouse cursor in the camera window and press down and hold the |
| 828 |
left mouse button. Now, while holding down the button, slowly move the |
| 829 |
mouse around. You should see the picture rotate in the direction you |
| 830 |
move the mouse. If you lift up on the mouse button while moving the |
| 831 |
mouse, the picture continues rotating. To stop it, hold the mouse very |
| 832 |
still and click down and up on the left mouse button. |
| 833 |
|
| 834 |
Geomview uses the _glass sphere_ model for mouse-based motion. This |
| 835 |
means you are supposed to think of the object as being inside an |
| 836 |
invisible sphere and the mouse cursor is a gripper outside the sphere. |
| 837 |
When you hold down the left mouse button, the gripper grabs the sphere; |
| 838 |
when you let go of the button, the gripper releases the sphere. Moving |
| 839 |
the mouse while holding the button down causes the sphere (and hence |
| 840 |
the object) to move in the same direction as the mouse. |
| 841 |
|
| 842 |
In addition to the two solids you should also see two wire-frame |
| 843 |
boxes in the camera window. These are the "bounding boxes" of the two |
| 844 |
objects. By default Geomview puts a bounding box around each object |
| 845 |
that it displays so that you have an idea of how large it is. |
| 846 |
|
| 847 |
Notice that as you move the mouse around the tetrahedron and |
| 848 |
dodecahedron move as a unit. That is because by default what you are |
| 849 |
actually moving is the "World". To move an individual object instead of |
| 850 |
the whole world, move the mouse cursor to the _Targets_ browser in the |
| 851 |
_Main_ panel. Click (any button) on the word _tetra_. This makes the |
| 852 |
tetrahedron be the "target object". Now move the cursor back to the |
| 853 |
camera window and you can rotate just the tetrahedron. |
| 854 |
|
| 855 |
The motion that you have been applying up to now has been rotation, |
| 856 |
because that is the motion mode that is selected in the _Tools_ panel. |
| 857 |
To translate instead, click on the _Translate_ button. Now when you |
| 858 |
move the mouse in the camera window while holding down the left button, |
| 859 |
the tetrahedron (which should still be the target object from before) |
| 860 |
will translate in the direction you move the mouse. Notice that you |
| 861 |
can translate it beyond the edge of the window as long as you keep |
| 862 |
holding the left mouse button down. If you lift up on the mouse button |
| 863 |
while moving the mouse, the tetrahedron will keep going. It moves |
| 864 |
rather rapidly so it is very easy to lose track of where it is. |
| 865 |
|
| 866 |
If you accidentally lose the tetrahedron by translating it too far |
| 867 |
out of the view of the window, you can get it back by clicking on the |
| 868 |
_Center_ button in the _Tools_ panel. This causes it to come back to |
| 869 |
its initial position. |
| 870 |
|
| 871 |
Click on the _Center_ button to bring the tetrahedron home, and then |
| 872 |
translate it off to one side so that you can completely see the |
| 873 |
dodecahedron. |
| 874 |
|
| 875 |
Your world now has two objects in it that are beside each other. You |
| 876 |
should see the dodecahedron in the middle of the window and maybe part |
| 877 |
of the tetrahedron off to one side. Go back to the _Targets_ browser |
| 878 |
in the _Main_ panel and click on "World" to select the whole world |
| 879 |
again. Now click on the _Look At_ button in the _Tools_ panel. You |
| 880 |
should see the dodecahedron and the tetrahedron in the middle of the |
| 881 |
window next to each other (*note Figure: figlookatworld.). The _Look |
| 882 |
At_ button positions the camera in such a way that the target object is |
| 883 |
centered in the window. |
| 884 |
Figure 2.2: Looking at the world. |
| 885 |
|
| 886 |
Now put the cursor over the middle of the dodecahedron and |
| 887 |
double-click the right mouse button. This means click it down-and-up |
| 888 |
two times in rapid succession. Notice that the dodecahedron becomes |
| 889 |
the target object; you can see this in the _Targets_ browser in the |
| 890 |
_Main_ panel. Double-clicking the right mouse button on an object is |
| 891 |
another way to make it the target object. |
| 892 |
|
| 893 |
|