diff options
Diffstat (limited to 'plugins/gtkui/gtkglext-gtk2/README')
-rw-r--r-- | plugins/gtkui/gtkglext-gtk2/README | 160 |
1 files changed, 160 insertions, 0 deletions
diff --git a/plugins/gtkui/gtkglext-gtk2/README b/plugins/gtkui/gtkglext-gtk2/README new file mode 100644 index 00000000..ae3be691 --- /dev/null +++ b/plugins/gtkui/gtkglext-gtk2/README @@ -0,0 +1,160 @@ + + + G t k G L E x t + + - OpenGL Extension to GTK + + +General Information +=================== + +GtkGLExt is an OpenGL extension to GTK. + +This package is composed of GdkGLExt library and GtkGLExt library. +GdkGLExt library provides the GDK objects which support OpenGL +rendering in GTK. GtkGLExt library provides the GtkWidget API add-ons +to make GTK+ widgets OpenGL-capable. + +The official web site is: + http://gtkglext.sourceforge.net/ + +The official download & development project site is: + http://sourceforge.net/projects/gtkglext/ + + +Licensing +========= + +GtkGLExt libraries are released under the terms of the GNU Lesser +General Public License (GNU LGPL). While components and programs +included with this release are licensed under the terms of the GNU +General Public License (GNU GPL). + + +Supported Platforms +=================== + +Currently GtkGLExt supports + + * UNIX and UNIX-like platforms + Tested under Linux, FreeBSD, IRIX, and Mac OS X. + + * Win32 platforms + Tested under Windows XP & 2000 Professional using MinGW/Cygwin + environment. + + +Requirements +============ + + * GNU C compiler + + * GNU make + + * GTK 2.0 or later (http://www.gtk.org/) + + * OpenGL or Mesa (http://www.mesa3d.org/) + + * GTK-Doc (http://www.gtk.org/rdp/) [optional] + + +Multihead Support +================= + +Multihead support requires GTK+ 2.1 or above. + +If GtkGLExt is already installed, you can check whether installed +GtkGLExt library supports multihead using the following command. + + $ pkg-config --variable=multihead gtkglext-1.0 + + +Installation +============ + +To build and install GtkGLExt, type follows (use GNU make) + + $ ./configure --prefix=/foo/bar (other options...) + $ make (or gmake) + $ make install + +To compile example programs, type + + $ make examples + +Please read INSTALL or type "./configure --help" for more details. + + +Configure Options +================= + +OpenGL options + + --with-gl-prefix=DIR OpenGL (Mesa) is installed in DIR [default=auto] + --with-gl-includedir=DIR OpenGL (Mesa) headers are in DIR [default=auto] + --with-gl-libdir=DIR OpenGL (Mesa) libraries are in DIR [default=auto] + +Debug options + + --enable-debug=[no/minimum/yes] turn on debugging [default=minimum] + +Window system options + + --with-gdktarget=[x11/win32] select GDK target + +Auto-generation files options + + --disable-rebuilds disable all source autogeneration rules + +Documentation options + + --enable-gtk-doc use gtk-doc to build documentation [default=no] + --with-html-dir=PATH path to installed docs + + +Building the CVS Version of GtkGLExt +==================================== + +GtkGLExt's SourceForge CVS repository can be checked out through +anonymous (pserver) CVS with the following instruction set. +When prompted for a password for anonymous, simply press the Enter key. + + $ cvs \ + -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/gtkglext \ + login + $ cvs -z3 \ + -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/gtkglext \ + co -r gtkglext-X-Y gtkglext + + (gtkglext-X-Y is a branch name. e.g. gtkglext-1-0 is 1.0.x branch.) + +When you are at work on the CVS version of GtkGLExt, you can use autogen.sh +for generating configure script and Makefiles. + + $ env ACLOCAL_FLAGS='-I /pkgconfig/share/aclocal -I /gtk/share/aclocal' \ + ./autogen.sh --prefix=${HOME}/gtkglext \ + --enable-debug=yes + $ make + $ make install + $ make examples + +You may have to set ACLOCAL_FLAGS environment variable for some m4 +macros used in configure.in. + +The following versions of the GNU autotools are required. + + autoconf 2.54 and above + automake 1.7.x + libtool 1.5 + + +Contact +======= + +Any patches, bug fixes and improvements are always welcome ;-) + + * Home: http://gtkglext.sourceforge.net/ + * Mailing List: http://mail.gnome.org/mailman/listinfo/gtkglext-list/ + * Bugs: Use the SourceForge bug tracker at http://sourceforge.net/tracker/?group_id=54333&atid=473434 + * Patches: Use the SourceForge patch tracker at http://sourceforge.net/tracker/?group_id=54333&atid=473436 + |