Go to file
Manolo Gouy 1c904d452b Now compiles with GCC3 and 4.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7270 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-03-15 15:57:48 +00:00
cairo makedepend updates for all source directories (except src/xutf8). 2010-01-27 20:16:38 +00:00
CMake CMake support: added platform test for HAVE_SCANDIR_POSIX, 2010-01-16 14:18:18 +00:00
documentation Added a \ref for proper doc linking. 2010-02-26 17:50:51 +00:00
FL Merge of branch-1.3-Fl_Printer, with the following main changes: 2010-03-14 18:07:24 +00:00
fluid Updated Fl_Device and Fl_Printer for Xcode 2010-03-14 21:29:12 +00:00
GL STR#2035 fix : Changed all 1998-200[0-8] dates to 1998-2009 for supported fltk files (this excludes i.e the png subdir). 2009-01-12 14:52:45 +00:00
ide Updated Fl_Device and Fl_Printer for Xcode 2010-03-14 21:29:12 +00:00
jpeg Added Fl_Tree source code, demo files, and documentation. Thanks, Greg! 2009-11-14 15:49:12 +00:00
lib Use true instead of : for POSTBUILD on non-MacOS systems. 2002-06-24 19:49:45 +00:00
makefiles STR#2035 fix : Changed all 1998-200[0-8] dates to 1998-2009 for supported fltk files (this excludes i.e the png subdir). 2009-01-12 14:52:45 +00:00
png Updated the bundled libpng to v1.2.40 (released Sep. 10, 2009). 2009-09-18 11:11:32 +00:00
src Now compiles with GCC3 and 4. 2010-03-15 15:57:48 +00:00
test Make the GL printer menu in the cube demo look a little but tidier in 2010-03-15 09:31:10 +00:00
watcom Attempt to make 'localeconv()' part of the configuration process. VC6 works, but I'll need feedback for all other platforms... . Trying OS X in a few minutes. 2005-07-24 18:41:30 +00:00
zlib Changed the copyright to 2009 for header files. Still todo: src and test directory. 2009-01-01 16:11:32 +00:00
ANNOUNCEMENT First checkin simply updating a few version numbers and copyright dates 2008-03-27 21:38:44 +00:00
CHANGES Updated CHANGES file with Fl_Device and Fl_Printer support. 2010-03-14 19:41:24 +00:00
CMakeLists.txt Applied vs8.patch to solve STR#2244. 2010-03-03 07:26:19 +00:00
configh.cmake.in CMake support: added platform test for HAVE_SCANDIR_POSIX, 2010-01-16 14:18:18 +00:00
configh.in Moved OS X code base to the more moder Cocoa toolkit thanks to the awesome work of Manolo Gouy (STR #2221). This is a big one! I tested all test applications under 32-bit autoconf and Xcode, and a few apps under 64bit intel. No PPC testing was done. Please verify this patch if you have the machine! 2009-12-06 22:21:55 +00:00
configure.in fix mingw32 crosscompilation under linux - select correct WIN32 GUI 2010-03-13 21:51:52 +00:00
COPYING Update paragraph 4 of the FLTK license exemptions; basically, justify/ 2001-12-12 02:20:15 +00:00
CREDITS Added Manolo Gouy to CREDITS for his great work on porting FLTK 1.3 2009-12-13 13:57:36 +00:00
DartConfig.cmake Cmake updates (STR #645) 2005-02-06 00:17:50 +00:00
fltk-config.in Changed the copyright to 2009 for header files. Still todo: src and test directory. 2009-01-01 16:11:32 +00:00
fltk.db Updated Fl_Device and Fl_Printer for Xcode 2010-03-14 21:29:12 +00:00
fltk.list.in Changed the copyright to 2009 for header files. Still todo: src and test directory. 2009-01-01 16:11:32 +00:00
fltk.spec.in Changed the copyright to 2009 for header files. Still todo: src and test directory. 2009-01-01 16:11:32 +00:00
fltk.xpm Add FLTK logo file for distributions. 2003-06-13 17:35:17 +00:00
forms.h Initial revision 1998-10-06 18:21:25 +00:00
install-sh Make sure INSTALL command uses absolute path for install-sh... 2007-02-08 19:14:29 +00:00
Makefile Updated make etags target src files filter. 2009-06-27 16:39:36 +00:00
makeinclude.in Merge of branch-1.3-Fl_Printer, with the following main changes: 2010-03-14 18:07:24 +00:00
makesrcdist Changed Makefile in src to use 1.3 instead of 1.1 (STR #1922). Fixed minor issue with handling of shortcuts in text input fields. 2008-04-23 20:08:39 +00:00
README Restoring README. 2010-03-06 14:33:40 +00:00
README.123 Updated Fl_Device and Fl_Printer for Xcode 2010-03-14 21:29:12 +00:00
README.cairo + Cairo branch merged after successful testing on Mac OS X 10.5.4, Linux Ubuntu 8.04,Windows XPSP2. 2008-09-25 18:26:33 +00:00
README.fltk118-utf Merging the UTF8 patch, consisting of O'ksi'd s original 1.1.6 patch and additions by Ian. PLEASE BE AWARE that the patch in its current incarnation is a regression in many aspects and further work is required before we can announce Unicode support. 2008-09-10 23:56:49 +00:00
README.mac Modfied README.mac to explain how to build Universal Binaries for earlier OS X versions like Tiger. 2008-05-21 21:18:53 +00:00
README.win32 Updated version of README.win32 by Ian (STR #1683) 2007-05-17 16:02:09 +00:00
TODO.osx Updated TODO.osx list. 2008-10-13 23:57:49 +00:00
TODO.utf8 add fl_draw(int angle, const char* ... functions for rotated text drawing 2009-04-24 09:28:30 +00:00
watcom.mif wsock32 static lib dependency removal from win build files. 2008-08-28 17:33:56 +00:00

README - Fast Light Tool Kit (FLTK) Version 1.3.0
-------------------------------------------------

WHAT IS FLTK?

    The Fast Light Tool Kit ("FLTK", pronounced "fulltick") is a
    a cross-platform C++ GUI toolkit for UNIX(r)/Linux(r) (X11),
    Microsoft(r) Windows(r), and MacOS(r) X. FLTK provides
    modern GUI functionality without the bloat and supports 3D
    graphics via OpenGL(r) and its built-in GLUT emulation. 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://www.fltk.org/documentation.php


BUILDING AND INSTALLING FLTK UNDER UNIX AND MacOS X

    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-cygwin         - Enable the Cygwin libraries (WIN32)
	--enable-debug          - Enable debugging code & symbols
	--disable-gl            - Disable OpenGL support
	--enable-shared         - Enable generation of shared libraries
	--enable-threads        - Enable multithreading support
	--enable-xdbe           - Enable the X double-buffer extension
	--enable-xft            - Enable the Xft library (anti-aliased fonts)

	--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 Visual C++ project files under the
    "ide/" directory.  See the file ide/README.IDE for more info.

    The second method is to use a GNU-based development tool
    with the files in the "makefiles" directory.  To build
    with the CygWin tools, use the supplied configure script
    as specified in the UNIX section above:

        sh configure ...options...

    To build using other 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://www.fltk.org/
	         http://www.fltk.org/str.php [for reporting bugs]
	         http://www.fltk.org/software.php [source code]

	- FTP:   http://ftp.easysw.com/pub/fltk
	         ftp://ftp.easysw.com/pub/fltk
	         ftp://ftp2.easysw.com/pub/fltk
	         ftp://ftp.funet.fi/pub/mirrors/ftp.easysw.com/pub/fltk
	         ftp://linux.mathematik.tu-darmstadt.de/pub/linux/mirrors/misc/fltk
	         ftp://gd.tuwien.ac.at/hci/fltk

	- EMail: fltk@fltk.org [see instructions below]

    To send a message to the FLTK mailing list ("fltk@fltk.org")
    you must first join the list.  Non-member submissions are
    blocked to avoid problems with SPAM.

    To join the FLTK mailing list, go the following web page:

        http://lists.easysw.com/listinfo/fltk


REPORTING BUGS

    To report a bug in FLTK, use the form at:

        http://www.fltk.org/str.php

    For general support and questions, please use the FLTK
    mailing list at "fltk@fltk.org".


TRADEMARKS

    Microsoft and Windows are registered trademarks of Microsoft
    Corporation. UNIX is a registered trademark of the X/Open
    Group, Inc.  OpenGL is a registered trademark of Silicon
    Graphics, Inc.  MacOS is a registered trademark of Apple
    Computers, Inc.


COPYRIGHT

    FLTK is copyright 1998-2009 by Bill Spitzak
    (spitzak@users.sourceforge.net) and others, 
    see the CREDITS file for more info.

    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.