You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
587 lines
15 KiB
587 lines
15 KiB
<!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/include/qgl.h:1 -->
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
|
<title>qgl.h Include File</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 Classes</font></a>
|
|
| <a href="mainclasses.html">
|
|
<font color="#004faf">Main Classes</font></a>
|
|
| <a href="annotated.html">
|
|
<font color="#004faf">Annotated</font></a>
|
|
| <a href="groups.html">
|
|
<font color="#004faf">Grouped 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>qgl.h</h1>
|
|
|
|
<p>This is the verbatim text of the qgl.h include file. It is provided only for illustration; the copyright remains with Trolltech.
|
|
<hr>
|
|
<pre>
|
|
/****************************************************************************
|
|
** $Id: qt/qgl.h 3.3.8 edited Jan 11 14:38 $
|
|
**
|
|
** Definition of OpenGL classes for Qt
|
|
**
|
|
** Created : 970112
|
|
**
|
|
** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved.
|
|
**
|
|
** This file is part of the opengl module of the Qt GUI Toolkit.
|
|
**
|
|
** This file may be used under the terms of the GNU General Public
|
|
** License versions 2.0 or 3.0 as published by the Free Software
|
|
** Foundation and appearing in the file LICENSE.GPL included in the
|
|
** packaging of this file. Alternatively you may (at your option) use any
|
|
** later version of the GNU General Public License if such license has
|
|
** been publicly approved by Trolltech ASA (or its successors, if any)
|
|
** and the KDE Free Qt Foundation.
|
|
**
|
|
** Please review the following information to ensure GNU General
|
|
** Public Licensing requirements will be met:
|
|
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
|
|
** If you are unsure which license is appropriate for your use, please
|
|
** review the following information:
|
|
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
|
|
** or contact the sales department at sales@trolltech.com.
|
|
**
|
|
** This file may be used under the terms of the Q Public License as
|
|
** defined by Trolltech ASA and appearing in the file LICENSE.QPL
|
|
** included in the packaging of this file. Licensees holding valid Qt
|
|
** Commercial licenses may use this file in accordance with the Qt
|
|
** Commercial License Agreement provided with the Software.
|
|
**
|
|
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
|
|
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
|
|
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
|
|
** herein.
|
|
**
|
|
**********************************************************************/
|
|
|
|
#ifndef QGL_H
|
|
#define QGL_H
|
|
|
|
#ifndef QT_H
|
|
#include "qwidget.h"
|
|
#include "qglcolormap.h"
|
|
#endif // QT_H
|
|
|
|
#if !defined( QT_MODULE_OPENGL ) || defined( QT_LICENSE_PROFESSIONAL )
|
|
#define QM_EXPORT_OPENGL
|
|
#else
|
|
#define QM_EXPORT_OPENGL Q_EXPORT
|
|
#endif
|
|
|
|
#ifndef QT_NO_COMPAT
|
|
#define QGL_VERSION 450
|
|
#define QGL_VERSION_STR "4.5"
|
|
QM_EXPORT_OPENGL inline const char *qGLVersion() {
|
|
qObsolete( 0, "qGLVersion", "qVersion" );
|
|
return QGL_VERSION_STR;
|
|
}
|
|
#endif
|
|
|
|
#if defined(Q_WS_WIN)
|
|
# include "qt_windows.h"
|
|
#endif
|
|
|
|
#if defined(Q_WS_MAC)
|
|
#if !defined( QMAC_OPENGL_DOUBLEBUFFER )
|
|
/* This macro is different now. If the macro is not defined QGLWidget will
|
|
* try to determine when you need double buffering. If set to 0 it will
|
|
* never double buffer and *can* be acclerated. If set to 1 (the default)
|
|
* it will always double buffer. Unlike before the value of this macro does
|
|
* not upset binary compatability either. */
|
|
#if QT_MACOSX_VERSION >= 0x1020
|
|
# define QMAC_OPENGL_DOUBLEBUFFER 0
|
|
#endif
|
|
#endif
|
|
# include <OpenGL/gl.h>
|
|
# include <OpenGL/glu.h>
|
|
#else
|
|
# include <GL/gl.h>
|
|
# include <GL/glu.h>
|
|
#endif
|
|
|
|
#if defined(Q_WS_WIN) || defined(Q_WS_MAC)
|
|
class QGLCmap;
|
|
#endif
|
|
|
|
class QPixmap;
|
|
#if defined(Q_WS_X11)
|
|
class QGLOverlayWidget;
|
|
#endif
|
|
|
|
// Namespace class:
|
|
class QM_EXPORT_OPENGL QGL
|
|
{
|
|
public:
|
|
enum FormatOption {
|
|
DoubleBuffer = 0x0001,
|
|
DepthBuffer = 0x0002,
|
|
Rgba = 0x0004,
|
|
AlphaChannel = 0x0008,
|
|
AccumBuffer = 0x0010,
|
|
StencilBuffer = 0x0020,
|
|
StereoBuffers = 0x0040,
|
|
DirectRendering = 0x0080,
|
|
HasOverlay = 0x0100,
|
|
SingleBuffer = DoubleBuffer << 16,
|
|
NoDepthBuffer = DepthBuffer << 16,
|
|
ColorIndex = Rgba << 16,
|
|
NoAlphaChannel = AlphaChannel << 16,
|
|
NoAccumBuffer = AccumBuffer << 16,
|
|
NoStencilBuffer = StencilBuffer << 16,
|
|
NoStereoBuffers = StereoBuffers << 16,
|
|
IndirectRendering = DirectRendering << 16,
|
|
NoOverlay = HasOverlay << 16
|
|
};
|
|
};
|
|
|
|
|
|
|
|
class QM_EXPORT_OPENGL QGLFormat : public QGL
|
|
{
|
|
public:
|
|
QGLFormat();
|
|
QGLFormat( int options, int plane = 0 );
|
|
|
|
bool doubleBuffer() const;
|
|
void setDoubleBuffer( bool enable );
|
|
bool depth() const;
|
|
void setDepth( bool enable );
|
|
bool rgba() const;
|
|
void setRgba( bool enable );
|
|
bool alpha() const;
|
|
void setAlpha( bool enable );
|
|
bool accum() const;
|
|
void setAccum( bool enable );
|
|
bool stencil() const;
|
|
void setStencil( bool enable );
|
|
bool stereo() const;
|
|
void setStereo( bool enable );
|
|
bool directRendering() const;
|
|
void setDirectRendering( bool enable );
|
|
bool hasOverlay() const;
|
|
void setOverlay( bool enable );
|
|
|
|
int plane() const;
|
|
void setPlane( int plane );
|
|
|
|
void setOption( FormatOption opt );
|
|
bool testOption( FormatOption opt ) const;
|
|
|
|
static QGLFormat defaultFormat();
|
|
static void setDefaultFormat( const QGLFormat& f );
|
|
|
|
static QGLFormat defaultOverlayFormat();
|
|
static void setDefaultOverlayFormat( const QGLFormat& f );
|
|
|
|
static bool hasOpenGL();
|
|
static bool hasOpenGLOverlays();
|
|
|
|
friend QM_EXPORT_OPENGL bool operator==( const QGLFormat&,
|
|
const QGLFormat& );
|
|
friend QM_EXPORT_OPENGL bool operator!=( const QGLFormat&,
|
|
const QGLFormat& );
|
|
private:
|
|
uint opts;
|
|
int pln;
|
|
};
|
|
|
|
|
|
QM_EXPORT_OPENGL bool operator==( const QGLFormat&, const QGLFormat& );
|
|
QM_EXPORT_OPENGL bool operator!=( const QGLFormat&, const QGLFormat& );
|
|
|
|
class QM_EXPORT_OPENGL QGLContext : public QGL
|
|
{
|
|
public:
|
|
QGLContext( const QGLFormat& format, QPaintDevice* device );
|
|
QGLContext( const QGLFormat& format );
|
|
virtual ~QGLContext();
|
|
|
|
virtual bool create( const QGLContext* shareContext = 0 );
|
|
bool isValid() const;
|
|
bool isSharing() const;
|
|
virtual void reset();
|
|
|
|
QGLFormat format() const;
|
|
QGLFormat requestedFormat() const;
|
|
virtual void setFormat( const QGLFormat& format );
|
|
|
|
virtual void makeCurrent();
|
|
virtual void swapBuffers() const;
|
|
|
|
QPaintDevice* device() const;
|
|
|
|
QColor overlayTransparentColor() const;
|
|
|
|
static const QGLContext* currentContext();
|
|
|
|
protected:
|
|
virtual bool chooseContext( const QGLContext* shareContext = 0 );
|
|
virtual void doneCurrent(); // ### 4.0: make this public - needed for multithreading stuff
|
|
|
|
#if defined(Q_WS_WIN)
|
|
virtual int choosePixelFormat( void* pfd, HDC pdc );
|
|
#endif
|
|
#if defined(Q_WS_X11)
|
|
virtual void* tryVisual( const QGLFormat& f, int bufDepth = 1 );
|
|
virtual void* chooseVisual();
|
|
#endif
|
|
#if defined(Q_WS_MAC)
|
|
virtual void* chooseMacVisual(GDHandle);
|
|
#endif
|
|
|
|
bool deviceIsPixmap() const;
|
|
bool windowCreated() const;
|
|
void setWindowCreated( bool on );
|
|
bool initialized() const;
|
|
void setInitialized( bool on );
|
|
void generateFontDisplayLists( const QFont & fnt, int listBase );
|
|
|
|
uint colorIndex( const QColor& c ) const;
|
|
void setValid( bool valid );
|
|
void setDevice( QPaintDevice *pDev );
|
|
|
|
protected:
|
|
#if defined(Q_WS_WIN)
|
|
HGLRC rc;
|
|
HDC dc;
|
|
WId win;
|
|
int pixelFormatId;
|
|
QGLCmap* cmap;
|
|
#elif defined(Q_WS_X11) || defined(Q_WS_MAC)
|
|
void* vi;
|
|
void* cx;
|
|
#if defined(Q_WS_X11)
|
|
Q_UINT32 gpm;
|
|
#endif
|
|
#endif
|
|
QGLFormat glFormat;
|
|
QGLFormat reqFormat;
|
|
static QGLContext* currentCtx;
|
|
|
|
private:
|
|
void init( QPaintDevice *dev = 0 );
|
|
class Private {
|
|
public:
|
|
bool valid;
|
|
bool sharing;
|
|
bool initDone;
|
|
bool crWin;
|
|
QPaintDevice* paintDevice;
|
|
QColor transpColor;
|
|
#ifdef Q_WS_MAC
|
|
QRect oldR;
|
|
#endif
|
|
};
|
|
Private* d;
|
|
|
|
friend class QGLWidget;
|
|
#ifdef Q_WS_MAC
|
|
void fixBufferRect();
|
|
#endif
|
|
|
|
private: // Disabled copy constructor and operator=
|
|
QGLContext() {}
|
|
QGLContext( const QGLContext& ) {}
|
|
QGLContext& operator=( const QGLContext& ) { return *this; }
|
|
};
|
|
|
|
|
|
|
|
|
|
class QM_EXPORT_OPENGL QGLWidget : public QWidget, public QGL
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
QGLWidget( QWidget* parent=0, const char* name=0,
|
|
const QGLWidget* shareWidget = 0, WFlags f=0 );
|
|
QGLWidget( QGLContext *context, QWidget* parent, const char* name=0,
|
|
const QGLWidget* shareWidget = 0, WFlags f=0 );
|
|
QGLWidget( const QGLFormat& format, QWidget* parent=0, const char* name=0,
|
|
const QGLWidget* shareWidget = 0, WFlags f=0 );
|
|
~QGLWidget();
|
|
|
|
void qglColor( const QColor& c ) const;
|
|
void qglClearColor( const QColor& c ) const;
|
|
|
|
bool isValid() const;
|
|
bool isSharing() const;
|
|
virtual void makeCurrent();
|
|
void doneCurrent();
|
|
|
|
bool doubleBuffer() const;
|
|
virtual void swapBuffers();
|
|
|
|
QGLFormat format() const;
|
|
#ifndef Q_QDOC
|
|
virtual void setFormat( const QGLFormat& format );
|
|
#endif
|
|
|
|
const QGLContext* context() const;
|
|
#ifndef Q_QDOC
|
|
virtual void setContext( QGLContext* context,
|
|
const QGLContext* shareContext = 0,
|
|
bool deleteOldContext = TRUE );
|
|
#endif
|
|
|
|
virtual QPixmap renderPixmap( int w = 0, int h = 0,
|
|
bool useContext = FALSE );
|
|
virtual QImage grabFrameBuffer( bool withAlpha = FALSE );
|
|
|
|
virtual void makeOverlayCurrent();
|
|
const QGLContext* overlayContext() const;
|
|
|
|
static QImage convertToGLFormat( const QImage& img );
|
|
|
|
void setMouseTracking( bool enable );
|
|
virtual void reparent( QWidget* parent, WFlags f, const QPoint& p,
|
|
bool showIt = FALSE );
|
|
|
|
const QGLColormap & colormap() const;
|
|
void setColormap( const QGLColormap & map );
|
|
|
|
void renderText( int x, int y, const QString & str,
|
|
const QFont & fnt = QFont(), int listBase = 2000 );
|
|
void renderText( double x, double y, double z, const QString & str,
|
|
const QFont & fnt = QFont(), int listBase = 2000 );
|
|
public slots:
|
|
virtual void updateGL();
|
|
virtual void updateOverlayGL();
|
|
|
|
protected:
|
|
virtual void initializeGL();
|
|
virtual void resizeGL( int w, int h );
|
|
virtual void paintGL();
|
|
|
|
virtual void initializeOverlayGL();
|
|
virtual void resizeOverlayGL( int w, int h );
|
|
virtual void paintOverlayGL();
|
|
|
|
void setAutoBufferSwap( bool on );
|
|
bool autoBufferSwap() const;
|
|
|
|
void paintEvent( QPaintEvent* );
|
|
void resizeEvent( QResizeEvent* );
|
|
|
|
virtual void glInit();
|
|
virtual void glDraw();
|
|
|
|
private:
|
|
int displayListBase( const QFont & fnt, int listBase );
|
|
void cleanupColormaps();
|
|
void init( QGLContext *context, const QGLWidget* shareWidget );
|
|
bool renderCxPm( QPixmap* pm );
|
|
QGLContext* glcx;
|
|
bool autoSwap;
|
|
|
|
QGLColormap cmap;
|
|
|
|
#if defined(Q_WS_WIN) || defined(Q_WS_MAC)
|
|
QGLContext* olcx;
|
|
#elif defined(Q_WS_X11)
|
|
QGLOverlayWidget* olw;
|
|
friend class QGLOverlayWidget;
|
|
#endif
|
|
|
|
private: // Disabled copy constructor and operator=
|
|
#if defined(Q_DISABLE_COPY)
|
|
QGLWidget( const QGLWidget& );
|
|
QGLWidget& operator=( const QGLWidget& );
|
|
#endif
|
|
|
|
#if defined(Q_WS_MAC)
|
|
private:
|
|
const QGLContext *slcx;
|
|
uint pending_fix : 1,
|
|
glcx_dblbuf : 2,
|
|
dblbuf : 1,
|
|
clp_serial : 15;
|
|
QPixmap *gl_pix;
|
|
QGLFormat req_format;
|
|
|
|
void macInternalRecreateContext( QGLContext *ctx,
|
|
const QGLContext* = NULL,
|
|
bool update = TRUE );
|
|
bool macInternalDoubleBuffer( bool fix = TRUE );
|
|
virtual void setRegionDirty( bool );
|
|
virtual void macWidgetChangedWindow();
|
|
#endif
|
|
private slots:
|
|
void macInternalFixBufferRect();
|
|
};
|
|
|
|
|
|
//
|
|
// QGLFormat inline functions
|
|
//
|
|
|
|
inline bool QGLFormat::doubleBuffer() const
|
|
{
|
|
return testOption( DoubleBuffer );
|
|
}
|
|
|
|
inline bool QGLFormat::depth() const
|
|
{
|
|
return testOption( DepthBuffer );
|
|
}
|
|
|
|
inline bool QGLFormat::rgba() const
|
|
{
|
|
return testOption( Rgba );
|
|
}
|
|
|
|
inline bool QGLFormat::alpha() const
|
|
{
|
|
return testOption( AlphaChannel );
|
|
}
|
|
|
|
inline bool QGLFormat::accum() const
|
|
{
|
|
return testOption( AccumBuffer );
|
|
}
|
|
|
|
inline bool QGLFormat::stencil() const
|
|
{
|
|
return testOption( StencilBuffer );
|
|
}
|
|
|
|
inline bool QGLFormat::stereo() const
|
|
{
|
|
return testOption( StereoBuffers );
|
|
}
|
|
|
|
inline bool QGLFormat::directRendering() const
|
|
{
|
|
return testOption( DirectRendering );
|
|
}
|
|
|
|
inline bool QGLFormat::hasOverlay() const
|
|
{
|
|
return testOption( HasOverlay );
|
|
}
|
|
|
|
//
|
|
// QGLContext inline functions
|
|
//
|
|
|
|
inline bool QGLContext::isValid() const
|
|
{
|
|
return d->valid;
|
|
}
|
|
|
|
inline void QGLContext::setValid( bool valid )
|
|
{
|
|
d->valid = valid;
|
|
}
|
|
|
|
inline bool QGLContext::isSharing() const
|
|
{
|
|
return d->sharing;
|
|
}
|
|
|
|
inline QGLFormat QGLContext::format() const
|
|
{
|
|
return glFormat;
|
|
}
|
|
|
|
inline QGLFormat QGLContext::requestedFormat() const
|
|
{
|
|
return reqFormat;
|
|
}
|
|
|
|
inline QPaintDevice* QGLContext::device() const
|
|
{
|
|
return d->paintDevice;
|
|
}
|
|
|
|
inline bool QGLContext::deviceIsPixmap() const
|
|
{
|
|
return d->paintDevice->devType() == QInternal::Pixmap;
|
|
}
|
|
|
|
|
|
inline bool QGLContext::windowCreated() const
|
|
{
|
|
return d->crWin;
|
|
}
|
|
|
|
|
|
inline void QGLContext::setWindowCreated( bool on )
|
|
{
|
|
d->crWin = on;
|
|
}
|
|
|
|
inline bool QGLContext::initialized() const
|
|
{
|
|
return d->initDone;
|
|
}
|
|
|
|
inline void QGLContext::setInitialized( bool on )
|
|
{
|
|
d->initDone = on;
|
|
}
|
|
|
|
inline const QGLContext* QGLContext::currentContext()
|
|
{
|
|
return currentCtx;
|
|
}
|
|
|
|
//
|
|
// QGLWidget inline functions
|
|
//
|
|
|
|
inline QGLFormat QGLWidget::format() const
|
|
{
|
|
return glcx->format();
|
|
}
|
|
|
|
inline const QGLContext *QGLWidget::context() const
|
|
{
|
|
return glcx;
|
|
}
|
|
|
|
inline bool QGLWidget::doubleBuffer() const
|
|
{
|
|
return glcx->format().doubleBuffer();
|
|
}
|
|
|
|
inline void QGLWidget::setAutoBufferSwap( bool on )
|
|
{
|
|
autoSwap = on;
|
|
}
|
|
|
|
inline bool QGLWidget::autoBufferSwap() const
|
|
{
|
|
return autoSwap;
|
|
}
|
|
|
|
#endif
|
|
</pre>
|
|
<!-- eof -->
|
|
<p><address><hr><div align=center>
|
|
<table width=100% cellspacing=0 border=0><tr>
|
|
<td>Copyright © 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>
|