source: rtems-graphics-toolkit/fltk-1.3.0/README @ b0e772a

Last change on this file since b0e772a was f5c9e9c, checked in by Alexandru-Sever Horin <alex.sever.h@…>, on 07/05/12 at 09:33:03

Aded FLTK 1.3.0

  • Property mode set to 100644
File size: 6.1 KB
Line 
1README - Fast Light Tool Kit (FLTK) Version 1.3.0
2-------------------------------------------------
3
4WHAT IS FLTK?
5
6    The Fast Light Tool Kit ("FLTK", pronounced "fulltick") is a
7    a cross-platform C++ GUI toolkit for UNIX(r)/Linux(r) (X11),
8    Microsoft(r) Windows(r), and MacOS(r) X. FLTK provides
9    modern GUI functionality without the bloat and supports 3D
10    graphics via OpenGL(r) and its built-in GLUT emulation. It
11    was originally developed by Mr. Bill Spitzak and is
12    currently maintained by a small group of developers across
13    the world with a central repository in the US.
14
15
16LICENSING
17
18    FLTK comes with complete free source code. FLTK is available
19    under the terms of the GNU Library General Public License.
20    Contrary to popular belief, it can be used in commercial
21    software! (Even Bill Gates could use it.)
22
23
24ON-LINE DOCUMENTATION
25
26    All of the documentation is in HTML in the subdirectory
27    "documentation". The "index.html" file should be your
28    starting point.  PostScript(tm) and PDF versions of this
29    documentation is also available from the FLTK web site at:
30
31        http://www.fltk.org/documentation.php
32
33
34BUILDING AND INSTALLING FLTK UNDER UNIX AND Mac OS X
35
36    In most cases you can just type "make".  This will run
37    configure with the default (no) options and then compile
38    everything.
39
40    FLTK uses GNU autoconf to configure itself for your UNIX
41    platform. The main things that the configure script will
42    look for are the X11, OpenGL (or Mesa), and JPEG header and
43    library files.  Make sure that they are in the standard
44    include/library locations.  If they aren't you need to
45    define the CFLAGS, CXXFLAGS, and LDFLAGS environment
46    variables.
47
48    If you aren't using "gcc", "g++", "c++", or "CC" for your
49    C++ compiler, you'll also need to set the CXX environment
50    variable. Similarly, if you aren't using "gcc" or "cc" for
51    your C compiler you'll need to set the CC environment
52    variable.
53
54    You can run configure yourself to get the exact setup you
55    need. Type "./configure <options>".  Options include:
56
57        --enable-cygwin         - Enable the Cygwin libraries (WIN32)
58        --enable-debug          - Enable debugging code & symbols
59        --disable-gl            - Disable OpenGL support
60        --enable-shared         - Enable generation of shared libraries
61        --enable-threads        - Enable multithreading support
62        --enable-xdbe           - Enable the X double-buffer extension
63        --enable-xft            - Enable the Xft library (anti-aliased fonts)
64
65        --bindir=/path          - Set the location for executables
66                                  [default = /usr/local/bin]
67        --libdir=/path          - Set the location for libraries
68                                  [default = /usr/local/lib]
69        --includedir=/path      - Set the location for include files.
70                                  [default = /usr/local/include]
71        --prefix=/dir           - Set the directory prefix for files
72                                  [default = /usr/local]
73
74    When the configure script is done you can just run the
75    "make" command. This will build the library, FLUID tool, and
76    all of the test programs.
77
78    To install the library, become root and type "make
79    install".  This will copy the "fluid" executable to
80    "bindir", the header files to "includedir", and the library
81    files to "libdir".
82   
83    To install additional files and icons to be used by the main
84    desktop environments such as KDE, GNOME and XFCE, you will also
85    need to run "make install-desktop" as root.
86
87
88BUILDING FLTK UNDER MICROSOFT WINDOWS
89
90    There are two ways to build FLTK under Microsoft Windows.
91    The first is to use the Visual C++ project files under the
92    "ide/" directory.  See the file ide/README.IDE for more info.
93
94    The second method is to use a GNU-based development tool.
95    To build with the Cygwin or MinGW tools, use the supplied
96    configure script as specified in the UNIX section above:
97
98        sh configure ...options...
99
100
101INTERNET RESOURCES
102
103    FLTK is available on the 'net in a bunch of locations:
104
105        - WWW:   http://www.fltk.org/
106                 http://www.fltk.org/str.php [for reporting bugs]
107                 http://www.fltk.org/software.php [source code]
108
109        - FTP:   http://ftp.easysw.com/pub/fltk
110                 ftp://ftp.easysw.com/pub/fltk
111                 ftp://ftp2.easysw.com/pub/fltk
112                 ftp://ftp.funet.fi/pub/mirrors/ftp.easysw.com/pub/fltk
113                 ftp://linux.mathematik.tu-darmstadt.de/pub/linux/mirrors/misc/fltk
114                 ftp://gd.tuwien.ac.at/hci/fltk
115
116        - EMail: fltk@fltk.org [see instructions below]
117
118    To send a message to the FLTK mailing list ("fltk@fltk.org")
119    you must first join the list.  Non-member submissions are
120    blocked to avoid problems with SPAM.
121
122    To join the FLTK mailing list, go the following web page:
123
124        http://lists.easysw.com/listinfo/fltk
125
126
127REPORTING BUGS
128
129    To report a bug in FLTK, use the form at:
130
131        http://www.fltk.org/str.php
132
133    For general support and questions, please use the FLTK
134    mailing list at "fltk@fltk.org".
135
136
137TRADEMARKS
138
139    Microsoft and Windows are registered trademarks of Microsoft
140    Corporation. UNIX is a registered trademark of the X/Open
141    Group, Inc.  OpenGL is a registered trademark of Silicon
142    Graphics, Inc.  Mac OS is a registered trademark of Apple
143    Computers, Inc.
144
145
146COPYRIGHT
147
148    FLTK is copyright 1998-2011 by Bill Spitzak
149    (spitzak@users.sourceforge.net) and others,
150    see the CREDITS file for more info.
151
152    This library is free software; you can redistribute it
153    and/or modify it under the terms of the GNU Library General
154    Public License as published by the Free Software Foundation;
155    either version 2 of the License, or (at your option) any
156    later version.
157
158    This library is distributed in the hope that it will be
159    useful, but WITHOUT ANY WARRANTY; without even the implied
160    warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
161    PURPOSE.  See the GNU Library General Public License for
162    more details.
163
164    You should have received a copy of the GNU Library General
165    Public License along with this library; if not, write to the
166    Free Software Foundation, Inc., 59 Temple Place, Suite 330,
167    Boston, MA 02111-1307 USA.
Note: See TracBrowser for help on using the repository browser.