12a43edc2d
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/trunk/SWIG@4141 626c5289-ae23-0410-ae9c-e8d60b6d4f22
65 lines
2 KiB
Text
65 lines
2 KiB
Text
GIFPlot
|
|
=======
|
|
|
|
To illustrate various SWIG features, the following examples involve
|
|
building an interface to a small, but somewhat useful graphics library
|
|
for creating 2D and 3D images in the form of GIF files. The Perl,
|
|
Python, Tcl, Java and Ruby directories contain various examples specific to
|
|
those languages.
|
|
|
|
This library was originally developed as part of the SPaSM molecular
|
|
dynamics project at Los Alamos National Laboratory. However, due to
|
|
patent enforcement issues related to LZW encoding and a general lack
|
|
of time on the part of the author, the library was never officially
|
|
released. On the plus side, a number of people have found it to be a
|
|
useful easter egg within the SWIG distribution :-).
|
|
|
|
<LEGAL>
|
|
DUE TO PATENT RESTRICTIONS ON THE LZW COMPRESSION ALGORITHM, THIS
|
|
LIBRARY ONLY PRODUCES UNCOMPRESSED GIF FILES. SO THERE.
|
|
</LEGAL>
|
|
|
|
Building the Library
|
|
====================
|
|
|
|
In order to run the examples, it is first necessary to build the GIFPlot
|
|
C library. To do this, simply follow these instructions:
|
|
|
|
./configure
|
|
make
|
|
|
|
On Windows, you can probably just do this:
|
|
|
|
cd Lib
|
|
nmake /f Makefile.msc
|
|
|
|
Running the Examples
|
|
====================
|
|
|
|
Once the library has been built, go the Perl, Python, Tcl, Java or Ruby directory
|
|
to see various SWIG examples. Each example should have a README file with a
|
|
description.
|
|
|
|
The examples are compiled using the makefile located in the top level "Examples"
|
|
directory of the distribution. If they don't compile, you will need to
|
|
adjust the settings in this file.
|
|
|
|
Documentation
|
|
=============
|
|
|
|
Read the source Luke. The examples should be pretty much self-explanatory.
|
|
The header file Include/gifplot.h contains the full API.
|
|
|
|
The original documentation for the library can be found online at:
|
|
|
|
http://islab.cs.uchicago.edu/gifplot
|
|
|
|
|
|
Let me know what you think!
|
|
===========================
|
|
If you found this example to be useful, confusing, or otherwise, I would like to know
|
|
about it. Suggestions for improvement are welcome.
|
|
|
|
-- Dave (beazley@cs.uchicago.edu)
|
|
|
|
|