src/opengl/qglscreen_qws.cpp
changeset 0 1918ee327afb
child 4 3b1da2848fc7
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/opengl/qglscreen_qws.cpp	Mon Jan 11 14:00:40 2010 +0000
@@ -0,0 +1,242 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the QtOpenGL module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include <QGLScreen>
+#include <QGLContext>
+#include <QGLWidget>
+#include "private/qglwindowsurface_qws_p.h"
+
+QT_BEGIN_NAMESPACE
+
+class QGLScreenPrivate
+{
+public:
+    QGLScreen::Options options;
+    QGLScreenSurfaceFunctions *functions;
+};
+
+/*!
+  \internal
+  \preliminary
+  \class QGLScreen
+
+  \brief This class encapsulates an OpenGL screen driver.
+*/
+
+QGLScreen::QGLScreen(int displayId)
+    : QScreen(displayId, GLClass), d_ptr(new QGLScreenPrivate)
+{
+    d_ptr->options = NoOptions;
+    d_ptr->functions = new QGLScreenSurfaceFunctions();
+}
+
+QGLScreen::~QGLScreen()
+{
+    delete d_ptr->functions;
+    delete d_ptr;
+}
+
+/*!
+    \since 4.3
+    \obsolete
+
+    Initializes the \a context and sets up the QGLWindowSurface of the
+    QWidget of \a context based on the parameters of \a context and
+    based on its own requirements.  The format() of \a context needs
+    to be updated with the actual parameters of the OpenGLES drawable
+    that was set up.
+
+    \a shareContext is used in the same way as for QGLContext. It is
+    the context with which \a context shares display lists and texture
+    ids etc. The window surface must be set up so that this sharing
+    works.
+
+    Returns true in case of success and false if it is not possible to
+    create the necessary OpenGLES drawable/context.
+
+    Since 4.4.2, this function will be not be called if options()
+    indicates that a native window or pixmap drawable can be created
+    via the functions in the surfaceFunctions() object.
+
+    This function is obsolete in Qt 4.5 and higher.  Use surfaceFunctions()
+    instead.
+
+    \sa options(), surfaceFunctions()
+*/
+bool
+QGLScreen::chooseContext(QGLContext *context, const QGLContext *shareContext)
+{
+    Q_UNUSED(context);
+    Q_UNUSED(shareContext);
+    return false;
+}
+
+/*!
+    \enum QGLScreen::Option
+    This enum defines options that can be set on QGLScreen instances.
+
+    \value NoOptions There are no special options on the screen.  This is the default.
+    \value NativeWindows Native windows can be created with QGLScreenSurfaceFunctions::createNativeWindow().
+    \value NativePixmaps Native pixmaps can be created with QGLScreenSurfaceFunctions::createNativePixmap().
+    \value NativeImages Native images can be created with QGLScreenSurfaceFunctions::createNativeImage().
+    \value Overlays The screen supports GL overlays.
+*/
+
+/*!
+    \since 4.4.2
+
+    Returns the options associated with this QGLScreen.
+
+    \sa setOptions()
+*/
+QGLScreen::Options QGLScreen::options() const
+{
+    return d_ptr->options;
+}
+
+/*!
+    \since 4.4.2
+
+    Sets the options associated with this QGLScreen to \a value.
+
+    \sa options()
+*/
+void QGLScreen::setOptions(QGLScreen::Options value)
+{
+    d_ptr->options = value;
+}
+
+/*!
+    \since 4.4.2
+
+    Returns the surface functions object for this QGLScreen.
+
+    \sa setSurfaceFunctions()
+*/
+QGLScreenSurfaceFunctions *QGLScreen::surfaceFunctions() const
+{
+    return d_ptr->functions;
+}
+
+/*!
+    \since 4.4.2
+
+    Sets the surface functions object for this QGLScreen to \a functions.
+    The QGLScreen will take over ownership of \a functions and delete
+    it when the QGLScreen is deleted.
+
+    \sa setSurfaceFunctions()
+*/
+void QGLScreen::setSurfaceFunctions(QGLScreenSurfaceFunctions *functions)
+{
+    if (functions && functions != d_ptr->functions) {
+        delete d_ptr->functions;
+        d_ptr->functions = functions;
+    }
+}
+
+/*!
+    \internal
+    \preliminary
+    \class QGLScreenSurfaceFunctions
+    \brief The QGLScreenSurfaceFunctions class encapsulates the functions for creating native windows and pixmaps for OpenGL ES.
+*/
+
+/*!
+    \since 4.4.2
+
+    Creates a native OpenGLES drawable for the surface of \a widget and
+    returns it in \a native.  Returns true if the OpenGLES drawable could
+    be created, or false if windows are not supported.
+
+    This function will be called if the NativeWindows option is set on
+    the screen.
+
+    \sa createNativePixmap(), createNativeImage(), QGLScreen::options()
+*/
+bool QGLScreenSurfaceFunctions::createNativeWindow(QWidget *widget, EGLNativeWindowType *native)
+{
+    Q_UNUSED(widget);
+    Q_UNUSED(native);
+    return false;
+}
+
+/*!
+    \since 4.4.2
+
+    Creates a native OpenGLES drawable for directly rendering into
+    \a pixmap and returns it in \a native.  Returns true if the OpenGLES
+    drawable could be created, or false if direct rendering into pixmaps
+    is not supported.
+
+    This function will be called if the NativePixmaps option is set on
+    the screen.
+
+    \sa createNativeWindow(), createNativeImage(), QGLScreen::options()
+*/
+bool QGLScreenSurfaceFunctions::createNativePixmap(QPixmap *pixmap, EGLNativePixmapType *native)
+{
+    Q_UNUSED(pixmap);
+    Q_UNUSED(native);
+    return false;
+}
+
+/*!
+    \since 4.4.2
+
+    Creates a native OpenGLES drawable for directly rendering into
+    \a image and returns it in \a native.  Returns true if the OpenGLES
+    drawable could be created, or false if direct rendering into images
+    is not supported.
+
+    This function will be called if the NativeImages option is set on
+    the screen.
+
+    \sa createNativeWindow(), createNativePixmap(), QGLScreen::options()
+*/
+bool QGLScreenSurfaceFunctions::createNativeImage(QImage *image, EGLNativePixmapType *native)
+{
+    Q_UNUSED(image);
+    Q_UNUSED(native);
+    return false;
+}
+
+QT_END_NAMESPACE