summaryrefslogtreecommitdiffstats
path: root/doc/html/opengl.html
blob: 78eff9c0dcfac648a6ce82a4ea6c5ffb5095df60 (plain)
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/opengl/qgl.cpp:2250 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Qt OpenGL 3D Graphics</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>

<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
 <a href="index.html">
<font color="#004faf">Home</font></a>
 | <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
 | <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
 | <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
 | <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
 | <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Qt OpenGL 3D Graphics</h1>


<p> 
<p> 
<p> <h2> Introduction
</h2>
<a name="1"></a><p> OpenGL is a standard API for rendering 3D graphics.
<p> OpenGL only deals with 3D rendering and provides little or no support
for GUI programming issues. The user interface for an
OpenGL<sup>*</sup> application must be created with another toolkit,
such as <a href="motif-extension.html#Motif">Motif</a> on the X platform, Microsoft Foundation Classes (MFC)
under Windows, or Qt on <em>both</em> platforms.
<p> The Qt OpenGL module makes it easy to use OpenGL in Qt applications.
It provides an OpenGL widget class that can be used just like any
other Qt widget, except that it opens an OpenGL display buffer where
you can use the OpenGL API to render the contents.
<p> The Qt OpenGL module is implemented as a platform-independent Qt/C++
wrapper around the platform-dependent GLX, WGL, or AGL C APIs. The
functionality provided is very similar to Mark Kilgard's GLUT library,
but with much more non-OpenGL-specific GUI functionality, i.e. the
whole Qt API.
<p> <h2> Installation
</h2>
<a name="2"></a><p> When you install Qt for X11, the configure script will autodetect if
OpenGL headers and libraries are installed on your system, and if so,
it will include the Qt OpenGL module in the Qt library. (If your
OpenGL headers or libraries are placed in a non-standard directory,
you may need to change the QMAKE_INCDIR_OPENGL and/or
QMAKE_LIBDIR_OPENGL in the config file for your system). Some
configurations require threading to be enabled for OpenGL, so if
OpenGL is not detected, try <tt>configure -thread</tt>.
<p> When you install Qt for Windows, the Qt OpenGL module is always
included.
<p> The Qt OpenGL module is not licensed for use with the Qt Professional
Edition. Consider upgrading to the Qt Enterprise Edition if you
require OpenGL support.
<p> Note about using Mesa on X11: Mesa versions earlier than 3.1 would use
the name "MesaGL" and "MesaGLU" for the libraries, instead of "GL" and
"GLU". If you want to use a pre-3.1 version of Mesa, you must change
the Makefiles to use these library names instead. The easiest way to
do this is to edit the QMAKE_LIBS_OPENGL line in the config file you
are using, changing "-lGL -lGLU" to "-lMesaGL -lMesaGLU"; then run
"configure" again.
<p> <h2> The <a href="qgl.html">QGL</a> Classes
</h2>
<a name="3"></a><p> The OpenGL support classes in Qt are:
<ul>
<li> <a href="qglwidget.html">QGLWidget</a>: An easy-to-use Qt
widget for rendering OpenGL scenes.
<li> <a href="qglcontext.html">QGLContext</a>: Encapsulates an OpenGL rendering context.
<li> <a href="qglformat.html">QGLFormat</a>: Specifies the
display format of a rendering context.
<li> <a href="qglcolormap.html">QGLColormap</a>: Handles indexed
colormaps in GL-index mode.
</ul>
<p> Many applications only need the high-level <a href="qglwidget.html">QGLWidget</a> class. The other
QGL classes provide advanced features. X11 users might like to read
the notes on <a href="opengl-x11-overlays.html">overlays</a>.
<p> See also the <a href="opengl-examples.html">OpenGL examples</a>.
<p> The QGL documentation assumes that you are familiar with OpenGL
programming. If you're new to the subject a good starting point is
<a href="http://www.opengl.org/">http://www.opengl.org/</a>.
<p> <sup>*</sup> OpenGL is a trademark of Silicon Graphics, Inc. in the
United States and other countries.
<p> 
<!-- eof -->
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>