RoffView Source Code Readme File (ReadMe.txt)
February 19th, 2003
Ryan Holmes

File:     RoffView_2_5_Source.zip
Contents: MFC project and source files for Visual C++ 6.0,
          for the C++/MFC version of my program RoffView.

This original version of RoffView was written for
a class at Arizona State University, CSE470 -
Introduction to Computer Graphics, when I
took it in the Fall of 2000. The program has been
on my RoffView webpage
(Now at http://www.holmes3d.net/graphics/roffview/)
since that time. The source code was not made available
because the project had been and was likely to be
in the future re-used by the instructor.

RoffView is Ryan's Off Viewer. It reads 3D graphics
files in the OFF format, and displays them. A sample
OFF file that I created by hand is included in this
zip file. Many others, and other tools for dealing with
them, can be found on the RoffView page given above.

In the time since I wrote this program I have graduated
from ASU, returned as a Master's student, and been
the Teaching Assistant for CSE470 three semesters in
a row. Over that time we have moved away from using
pure MFC to implement low-level graphics concepts and
have begun using OpenGL and other slightly higher-level
APIs. Because this code is no longer likely to be
directly copied by future students, I am posting the
source. Hopefully it will be of interest/use to others.
It is a small, simple program, but it does use a few
reasonably sophisticated MFC concepts, and displays
pretty pictures.

I am no longer actively working on this program, as I have
ported it to OpenGL and continued adding features to that
version. The source for that version will probably not
be posted, for the same reasons that originally applied
to the source for this version.

You are free to copy/modify/change/fix/break the code as
you see fit. If you find it especially helpful, I would
appreciate a quick e-mail telling me what you've done with
it. If/when you find bugs, if you e-mail me the bug and
the fix, I will update the source and this file and give
you credit for the fix.

-Ryan Holmes
ryan at holmes3d dot net

Version History:
Version 2.5 - Cleaned up source code for release. Fixed
              several GDI object leaks, added comments,
              and tidied things up a bit. (First source
              release. February 2003)
Version 2.1 - Fixed bug that caused exceptions when using
              shaded display mode on Windows 98 (But not
              on Windows 2000). (First executable release.
              December 2000)
Version 2.0 - Addition of illumination model, shaded display,
              pointfield display. Extensive re-write of
              underlying classes for speed. (End of class)
Version 1.5 - Addition of full rotation to first project
Version 1.0 - First project. Perspective viewing, loading
              and saving of files, limited rotation of model.