File: README

package info (click to toggle)
gtkgl2 1.99.0-2
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 1,104 kB
  • ctags: 330
  • sloc: sh: 6,744; ansic: 3,173; makefile: 125
file content (126 lines) | stat: -rw-r--r-- 4,030 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
GtkGLArea
---------


AUTHOR
------
 Janne L�f <jlof@mail.student.oulu.fi>

CONTRIBUTORS
------------
 Karl Nelson     <kenelson@ece.ucdavis.edu>          (original autoconf, gtkglarea--)
 Daniel Skarda   <0rfelyus@atrey.karlin.mff.cuni.cz> (original automake & libtool)
 Jussi L�f       <jussi.lof@pirko.fi>                (LightWave objects)
 Andrew Marriott <raytrace@lillee.cs.curtin.edu.au>  (original win32 port)
 Chris Abernethy <chris65536@home.com>               (gtkglarea_demo.c)

LICENSE
-------

    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., 675 Mass Ave, Cambridge, MA 02139, USA.


INTRODUCTION
------------

 GtkGLArea is an OpenGL widget for GTK+ GUI toolkit.

 Just as GTK+ is build on top of GDK, GtkGLArea is built on top of gdkgl which
 is basically wrapper around GLX functions. The widget itself is derived
 from GtkDrawinigArea widget and adds only few extra functions.

 Lower level gdkgl functions make it easy to render on any widget that has
 OpenGL capable visual, rendering to off-screen pixmaps is also supported. 

 Related project which may iterest those who use GTK-- is GtkGLArea--. It is a
 C++ wrapper for gtkglarea written by Karl Nelson <kenelson@ece.ucdavis.edu>. 


INSTALLATION
------------

 You need GTK+ and either OpenGL or Mesa, if you have both you can choose which
 one to use by giving --with-lib-GL or --with-lib-MesaGL option to configure.

 Run './configure --help' to see all options you may give at configuration stage.
 Run './configure' and 'make' to build. You may now test programs in examples
 directory. Run 'make install' to install.

 Include files go to PREFIX/include/gtkgl/
 Library files go to PREFIX/lib/


WIN32
-----

 There is now a working windows port. There are old hand-written
 makefiles (makefile.mingw) but those are out-of-date. Autoconfigurated
 build should work OK. If you cannot get it to work, the makefile.mingw files
 should be pretty straightforward to modify.

 Prebuilt Win32 packages of GLib 2.0 and GTK+ 2.0 can be downloaded
 from www.gimp.org/win32. Also a prebuilt GtkGLArea package might
 eventually be available from there.

 OpenlGL headers are also needed, either use those from the
 PlatformSDK (freely downloadable from Microsoft, even if you have to
 use a complex installer program, and it's hard to decide which of the
 zillion optional parts you actually want to get these headers), or
 grab

   Mingw32_OpenGL.zip

 from ftp://ftp.teleport.com/pub/users/pgarceau/

 or alternatively you may use

  glut-cygwin.zip

 from http://www.cim.pe.u-tokyo.ac.jp/~kawachi/software/cygwin_glut-e.html

 Unzip these packages to some directory.

 The Inner workings of win32 gtkglarea is quite different form glx
 version, therefore you should only use GtkGLArea widget (gtk_gl_*)
 functions, no gdk_gl_* functions.


DOCUMENTATION
-------------

 Documentation is slightly out of date, sorry.

 docs/gtkglarea.txt	documents GtkGLArea widget (needs updating)
 docs/gtkgl.txt		documents gtk_gl_* functions (needs updating)
 docs/HOWTO.txt		good advice


LINKS
-----

 GtkGLArea home page http://www.student.oulu.fi/~jlof/gtkglarea/
 Gtk-- wrapper http://www.ece.ucdavis.edu/~kenelson/gtk-glarea/


TODO
----

 - rewrite documentation in texinfo format
 - weed out bugs from autoconfigure scripts
 - overlays
 - add more functionality to windows port

---
Trademarks are owned by trademark owners.