Skip to content

Commit

Permalink
Markdown cleanup pass for wire4/README
Browse files Browse the repository at this point in the history
  • Loading branch information
hollasch committed Sep 30, 2017
1 parent 68c1204 commit 61b2ba5
Showing 1 changed file with 48 additions and 54 deletions.
102 changes: 48 additions & 54 deletions wire4/README.md
Original file line number Diff line number Diff line change
@@ -1,60 +1,54 @@

This is the initial release of my 4D wireframe viewer that I wrote for my
master's thesis, "Four-Space Visualization of 4D Objects", in May 1991. The
thesis is also available in this same GitHub project.

This release should include the following files:

README.txt // This File
copyright // Copyright Notice
wire4.doc // User's Manual for wire4
psplot.doc // User's Manual for psplot
makefile // Unix Make File
wire4.h // wire4 Main Header File
vector.h // Header File for Vector Operations
psplot.c // Source for psplot
strcmpic.c // Case-Insensitive String Comparison
v3cross.c // 3D Vector Cross Product
v4cross.c // 4D Vector Cross Product
w4_display.c // Graphics Display Functions
w4_geometry.c // 4D Geometry Functions
w4_main.c // Main wire4 File
w4_parse.c // wire4 Input File Parsing Functions
axes.w4 // wire4 Input Files...
cube.w4
cube3d.w4
curve1.w4
curve2.w4
curve3.w4
dual.w4
frustum.w4

You will probably need to tweak the makefile to get it to run on your platform.
I've tried to make this as straightforward as possible, but let me know if you
have problems.

Wire4 supports wireframe display of arbitrary 4D objects (from ASCII input
files) and displays objects with user-specified edge colors, depth-cueing, and
interactive 3D and 4D rotation. Both 4D to 3D and 3D to 2D projections can be
interactively set to parallel or perspective projection. Also included in the
package is a program to generate simple PostScript files of arbitrary wireframe
wire4
====================================================================================================

This is the initial release of the 4D wireframe viewer that I wrote for my master’s thesis,
“Four-Space Visualization of 4D Objects”, in May 1991. The thesis is also available in this same
GitHub project or from http://hollasch.github.io/ray4.

This release includes the following files:

| File | Description
|:----------------|:----------------------------------------
| `README.md` | _This File_
| `copyright` | _Copyright Notice_
| `wire4.doc` | _User’s Manual for wire4_
| `psplot.doc` | _User’s Manual for psplot_
| `makefile` | _Unix Make File_
| `wire4.h` | _wire4 Main Header File_
| `vector.h` | _Header File for Vector Operations_
| `psplot.c` | _Source for psplot_
| `strcmpic.c` | _Case-Insensitive String Comparison_
| `v3cross.c` | _3D Vector Cross Product_
| `v4cross.c` | _4D Vector Cross Product_
| `w4_display.c` | _Graphics Display Functions_
| `w4_geometry.c` | _4D Geometry Functions_
| `w4_main.c` | _Main wire4 File_
| `w4_parse.c` | _wire4 Input File Parsing Functions_
| `axes.w4`<br>`cube.w4`<br>`cube3d.w4`<br>`curve1.w4`<br>`curve2.w4`<br>`curve3.w4`<br>`dual.w4`<br>`frustum.w4` | _wire4 Input Files_

You will probably need to tweak the makefile to get it to run on your platform. I’ve tried to make
this as straightforward as possible, but let me know if you have problems.

Wire4 supports wireframe display of arbitrary 4D objects (from ASCII input files) and displays
objects with user-specified edge colors, depth-cueing, and interactive 3D and 4D rotation. Both 4D
to 3D and 3D to 2D projections can be interactively set to parallel or perspective projection. Also
included in the package is a program to generate simple PostScript files of arbitrary wireframe
views.

Wire4 uses the GL library, so it is mostly useful for SGI boxes, although other
platforms that have a GL compatibility library may also run the program.
Wire4 uses the GL library, so it is mostly useful for SGI boxes, although other platforms that have
a GL compatibility library may also run the program.

Also available for release is my 4D raytracing program. Let me know if you are
interested and I'll send you a copy. Ray4 runs on any platform that supports C
and floating point, but currently the only display programs available are for
the Amiga, SGI platforms, and Sun rasterfiles.
Also available for release is my 4D raytracing program. Let me know if you are interested and I’ll
send you a copy. Ray4 runs on any platform that supports C and floating point, but currently the
only display programs available are for the Amiga, SGI platforms, and Sun rasterfiles.

Finally, I'd like to acknowledge and thank the folks who volunteered to
beta-test this software for me:
Finally, Id like to acknowledge and thank the folks who volunteered to beta-test this software for
me:

Greg Aharonian
Brian Carney
Mark Ferneau
Marty Ryan
- Greg Aharonian
- Brian Carney
- Mark Ferneau
- Marty Ryan

Steve Hollasch
[email protected]
----
Steve Hollasch / [email protected]

0 comments on commit 61b2ba5

Please sign in to comment.