3b5208b4b5
Added Craig P. Earls to author list on FLTK Programming Manual. git-svn-id: file:///fltk/svn/fltk/trunk@291 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
183 lines
6.6 KiB
Plaintext
183 lines
6.6 KiB
Plaintext
README - Fast Light Tool Kit (FLTK) Version 1.0
|
|
-----------------------------------------------
|
|
|
|
WHAT IS FLTK?
|
|
|
|
The Fast Light Tool Kit ("FLTK", pronounced "fulltick") is a LGPL'd
|
|
C++ graphical user interface toolkit for X (UNIX(r)), OpenGL(r),
|
|
and Microsoft(r) Windows(r) NT 4.0, 95, or 98. It was originally
|
|
developed by Mr. Bill Spitzak and is currently maintained by a
|
|
small group of developers across the world with a central
|
|
repository in the US.
|
|
|
|
|
|
LICENSING
|
|
|
|
FLTK comes with complete free source code. FLTK is available under
|
|
the terms of the GNU Library General Public License. Contrary to
|
|
popular belief, it can be used in commercial software! (Even Bill
|
|
Gates could use it.)
|
|
|
|
|
|
ON-LINE DOCUMENTATION
|
|
|
|
All of the documentation is in HTML in the subdirectory
|
|
"documentation". The "index.html" file should be your starting
|
|
point. PostScript(tm) and PDF versions of this documentation is
|
|
also available from the FLTK web site at:
|
|
|
|
http://fltk.easysw.com/documentation.html
|
|
|
|
|
|
BUILDING AND INSTALLING FLTK UNDER UNIX
|
|
|
|
In most cases you can just type "make". This will run configure
|
|
with the default (no) options and then compile everything.
|
|
|
|
FLTK uses GNU autoconf to configure itself for your UNIX platform.
|
|
The main things that the configure script will look for are the
|
|
X11, OpenGL (or Mesa), and JPEG header and library files. Make
|
|
sure that they are in the standard include/library locations. If
|
|
they aren't you need to define the CFLAGS, CXXFLAGS, and LDFLAGS
|
|
environment variables.
|
|
|
|
If you aren't using "gcc", "g++", "c++", or "CC" for your C++
|
|
compiler, you'll also need to set the CXX environment variable.
|
|
Similarly, if you aren't using "gcc" or "cc" for your C compiler
|
|
you'll need to set the CC environment variable.
|
|
|
|
You can run configure yourself to get the exact setup you need.
|
|
Type "./configure <options>". Options include:
|
|
|
|
--enable-debug - Enable debugging code & symbols
|
|
--enable-shared - Enable generation of shared libraries
|
|
|
|
--bindir=/path - Set the location for executables
|
|
[default = /usr/local/bin]
|
|
--libdir=/path - Set the location for libraries
|
|
[default = /usr/local/lib]
|
|
--includedir=/path - Set the location for include files.
|
|
[default = /usr/local/include]
|
|
--prefix=/dir - Set the directory prefix for files
|
|
[default = /usr/local]
|
|
|
|
When the configure script is done you can just run the "make"
|
|
command. This will build the library, FLUID tool, and all of the
|
|
test programs.
|
|
|
|
To install the library, become root and type "make install". This
|
|
will copy the "fluid" executable to "bindir", the header files to
|
|
"includedir", and the library files to "libdir".
|
|
|
|
|
|
BUILDING FLTK UNDER MICROSOFT WINDOWS
|
|
|
|
There are two ways to build FLTK under Microsoft Windows. The
|
|
first is to use the 5.0 project files under the "visualc"
|
|
directory. Just open (or double-click on) the "fltk.dsw" file to
|
|
get the whole shebang.
|
|
|
|
The second method is to use a GNU-based development tool with the
|
|
files in the "makefiles" directory. To build using one of these
|
|
tools simply copy the appropriate makeinclude and config files to
|
|
the main directory and do a make:
|
|
|
|
copy makefiles\Makefile.<env> Makefile
|
|
make
|
|
|
|
|
|
BUILDING FLTK UNDER OS/2
|
|
|
|
The current OS/2 build requires XFree86 for OS/2 to work. A native
|
|
Presentation Manager version has not been implemented yet
|
|
(volunteers are welcome!).
|
|
|
|
To build the XFree86 version of FLTK for OS/2, copy the appropriate
|
|
makeinclude and config files to the main directory and do a make:
|
|
|
|
copy makefiles\Makefile.os2x Makefile
|
|
make
|
|
|
|
|
|
INTERNET RESOURCES
|
|
|
|
FLTK is available on the 'net in a bunch of locations:
|
|
|
|
- WWW: http://fltk.easysw.com
|
|
|
|
- FTP: ftp://ftp.easysw.com/pub/fltk
|
|
ftp://ftp.northamerica.net/pub/ESP/fltk
|
|
ftp://ftp.funet.fi/mirrors/ftp.easysw.com/pub/fltk
|
|
|
|
- EMail: fltk@easysw.com [see instructions below]
|
|
fltk-bugs@easysw.com [for reporting bugs]
|
|
|
|
To send a message to the FLTK mailing list ("fltk@easysw.com") you
|
|
must first join the list. Non-member submissions are blocked to
|
|
avoid problems with SPAM.
|
|
|
|
To join the FLTK mailing list, send a message to
|
|
"majordomo@easysw.com" with "subscribe fltk" in the message body.
|
|
A digest of this list is available by subscribing to the
|
|
"fltk-digest" mailing list.
|
|
|
|
|
|
REPORTING BUGS
|
|
|
|
To report a bug in FLTK, send an email to "fltk-bugs@easysw.com".
|
|
Please include the FLTK version, operating system & version, and
|
|
compiler that you are using when describing the bug or problem.
|
|
|
|
For general support and questions, please use the FLTK mailing
|
|
list at "fltk@easysw.com".
|
|
|
|
|
|
MESA
|
|
|
|
Currently the best way to get OpenGL on your Linux system is to use
|
|
Mesa. FLTK has been tested with Mesa on several machines (and also
|
|
with "real" OpenGL on SGI machines).
|
|
|
|
Mesa is available at "http://www.ssec.wisc.edu/~brianp/Mesa.html".
|
|
|
|
The configure script will not see Mesa unless it is installed as
|
|
either libGL or libMesaGL. If you don't want to do this you will
|
|
have to edit config.h (set HAVE_GL to 1) and makeinclude (add the
|
|
libraries).
|
|
|
|
|
|
TRADEMARKS
|
|
|
|
Microsoft and Windows are registered trademarks of Microsoft
|
|
Corportation. UNIX is a registered trademark of the X/Open Group,
|
|
Inc. OpenGL is a registered trademark of Silicon Graphics, Inc.
|
|
|
|
|
|
COPYRIGHT
|
|
|
|
FLTK is copyright 1998-1999 by Bill Spitzak (spitzak@d2.com) and others,
|
|
including:
|
|
|
|
Craig P. Earls (cpearls@mit.edu)
|
|
Curtis Edwards (curtise@fa.disney.com)
|
|
Gustavo Hime (hime@centroin.com.br)
|
|
Matthias Melcher (matthias@mediaone.net)
|
|
Vincent Penne (vincent.penne@wanadoo.fr)
|
|
Michael Sweet (mike@easysw.com)
|
|
Carl Thompson (clip@home.net)
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Library General Public License
|
|
as published by the Free Software Foundation; either version 2 of
|
|
the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Library General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Library General Public
|
|
License along with this library; if not, write to the Free Software
|
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
|
|
USA.
|