wxPLplot library documentation
5.5.3
Welcome to the wxPLplot library homepage. wxPLplot is not a branch of PLplot (http://plplot.sourceforge.net) it's more or less a distribution of the PLplot library. All new code will sooner or later be merged in the PLplot library. Makefiles for Linux/MacOSX are provided which copy new code back into the PLplot directory, where you can configure/compile the (enhanced) PLplot library then. For Windows a Sconscript (www.scons.org) is provided which will eventually allow to compile a static/shared library for most Windows compilers. In the moment only the MinGW compiler using the Windows Command Line Interface is supported and only a static library will be build.
In Addition two new classes are provided (wxPLplotstream and wxPLplotwindow) which give the programmer access to the complete PLplot API and also a very basic Widget for use in your own program. Eventually there are plans to provide a more enhanced Widget with it's own API.
The PLplot wxWidgets driver doesn't only give you access to the PLplot library for your wxWidgets programs - it also enables one to use the PLplot library from within your C/C++/Java/.... console program. The wxWidgets driver opens a GUI for you then.
- 20051212: Release of wxPLplot 0.1, upload of the homepage
wxPLplot Version 0.1 (2005 12 12): wxPLplot-0_1.zip
- Modify the configure script - use the wxWidgets macros wxwin.m4
- Export into several file formats (Postscript, PNG, Gif, Jpeg, ... )
- Improve display quality by using Antigrain (http://www.antigrain.com)
- Improve the wxWidgets driver, so that it surpasses the Tcl/Tk driver in functionality (this will have not too much impact on the use of PLplot inside a wxWidgets program).
- Provide a widget with it's own modern API (hide PLplot API)
Though there are efforts to make PLplot compile in Cygwin and MSys we provide here a solution to compile (wx)Plplot in natural Windows CLI with MinGW with the help of Scons. The Sconscript provided awaits, that the WXWIN variable is set and that wxWidgets was compiled with certain features (monolithic, shared, debug/release) it's too much effort to provide a SConscript file which can handle all possible cases wxWidgets can be compiled. But it's not that hard, to adapt the Sconscipt file for your needs.
In the moment only the MinGW compiler is supported, but it is not much work to support other compilers, since scons is used (and this will eventually happen if time permits it). PLplot uses the freetype library for antialiased font and the gd library for png/gif/jpeg support. Both libraries are also supported in Windows.
In order to run the provided SConscript you have to have the latest scons package installed. You also need to install Python for that.
- Download and install the Python for Windows 2.4.2 package (e.g. in C:\Python) @ http://www.python.org/download/
- Download and install the Scons 0.96.91 package (in the same directory) @ www.scons.org. If you downloaded the installer there is no more to do, otherwise read the scons readme file for setup instructions.
- If you have
cvs in the PATH then run: cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/plplot login
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/plplot co -P plplot
Run this in the same directory wxPLplot is installed - otherwise you have to set the PLDIR environment variable.
- Download the latest version of the freetype sourcecode at http://www.freetype.org . A local copy can be downloaded here: freetype-2.1.10.zip.
- Unzip the package into the same directory as the wxPLplot directory resides, or any other directory - in that case you have to set the
FREETYPEDIR environment variable. - MinGW: Go into the freetype directory and run
mingw32-make twice.
- Download the latest version of the gd library for Windows at http://www.boutell.com/gd . A local copy can be downloaded here: gdwin32.zip.
- Unzip the package into the same directory as the wxPLplot directory resides, or any other directory - in that case you have to set the
GDDIR environment variable. - MinGW: Everything is ready.
- Download wxWidgets 2.6.2 from http://www.wxwidgets.org .
- Unzip somewhere and set the WXWIN environment variable so that it points to the wxwidgets base dir (wxWidgets-2.6.2)
- MinGW: Go into the %WXWIN%\build\msw and run
mingw32-make MONOLITHIC=1 SHARED=1 BUILD=debug
mingw32-make MONOLITHIC=1 SHARED=1 BUILD=release
This will build a monolithic shared debug and release build in %WXWIN%\lib\gcc_dll.
- Unzip wxPLplot.zip into a directory and cd into it
- Run:
setup.bat - Run:
scons for a debug build or scons debug=0 for a release build The compiled library will be copied to the lib directory. Your compiler should be automatically detected. - Copy the
*.dll files from %WXWIN%\lib\gcc_dll into the example and the demo directory or somewhere in the PATH so that they can be found - MinGW: To test the examples, cd into the examples directory and run
mingw32-make -f makefile.mingw. To test the wxWidgets demo, cd into the demo direcory and run mingw32-make -f makefile.mingw.
- Get latest cvs version of plPlot (see above)
- Install wxWidgets (e.g. into /usr/local/wxWidgets)
- You need at least automake 1.82 and libtool 1.4
- Unzip wxPLplot.zip into a directory and cd into it
cd into the unix directory and run make (set PLDIR before if wxPLplot and plplot are not in the same directory)cd into plplot directory- Run:
cf/bootstrap.sh - Run:
./configure --prefix=/usr/local/plplot --disable-static --with-wxwidgets-bindir=/usr/local/wxWidgets/bin --enable-wxwidgets=yes
- Run:
export LD_LIBRARY_PATH=/usr/local/wxWidgets/lib (if you didn't install wxWidgets into /usr/local) - Run: make
- Run:
sudo make install (or su -c "make install" ) - Run: cd examples/c
- Run: make x01c
- Run: ./x01c and choose the wxWidgets driver
cd into wxPLplot/demo - Run:
Run: export PATH=/usr/local/wxWidgets/bin:/usr/local/plplot/bin:$PATH (if PLplot/wxWidgets aren't in /usr/local ) - Run:
make -f makefile.lnx - Run: .\demo_str
- Chartdirector: http://www.advsofteng.com/ (cross platform, commercial)
- DPlot: http://www.dplot.com/ (only Windows, but DPlot jr. is free)
- DISLIN: http://www.dislin.de/ (cross platform, free for non-commercial use)
- pgplot: http://www.astro.caltech.edu/~tjp/pgplot/ (old?)
- GNUPlot: http://www.gnuplot.info
- Plot package from Pelikhan: http://projectdistributor.net/Projects/Project.aspx?projectId=104 and http://www.codeproject.com/miscctrl/pgllib.asp#xx1095102xx (actually dead, unsupported, only Windows, though was looking very good, was commercial before, tried to make it cross platform once, but this would have been quite an enormous task, zlib license)
This homepage was made and the source code was documented with the help of doxygen (http://www.doxygen.org).
Generated on Mon Dec 19 17:02:38 2005 for wxPLplot library by
1.4.5