summaryrefslogtreecommitdiff
path: root/doc/src/platforms/wince-opengl.qdoc
diff options
context:
space:
mode:
authorJason Barron <jbarron@trolltech.com>2009-08-18 08:34:18 +0200
committerJason Barron <jbarron@trolltech.com>2009-08-18 08:34:18 +0200
commitfd6740b6ade6e7f8e51a9cc558b723e7fae15ccf (patch)
treeaa2ba4ce64d047d73c29ab0616e8a89d352c3abd /doc/src/platforms/wince-opengl.qdoc
parentd24029e3d4639f1300e7a68858936911df969f69 (diff)
parent572e165dcb8cc8fcdfaa4ab9bdab050f6a6cc173 (diff)
downloadqt4-tools-fd6740b6ade6e7f8e51a9cc558b723e7fae15ccf.tar.gz
Merge commit 'qt/master'
Conflicts: doc/src/examples.qdoc doc/src/plugins-howto.qdoc doc/src/topics.qdoc examples/phonon/musicplayer/mainwindow.cpp src/3rdparty/freetype/src/base/ftobjs.c src/corelib/global/qglobal.h src/corelib/tools/qalgorithms.h src/corelib/tools/qshareddata.cpp src/corelib/tools/qsharedpointer.cpp src/corelib/tools/tools.pri src/corelib/xml/qxmlstream.h src/gui/painting/painting.pri src/gui/widgets/qdatetimeedit.cpp tests/auto/qdesktopservices/qdesktopservices.pro tests/auto/qgraphicsitem/tst_qgraphicsitem.cpp tests/auto/qtextcodec/test/test.pro
Diffstat (limited to 'doc/src/platforms/wince-opengl.qdoc')
-rw-r--r--doc/src/platforms/wince-opengl.qdoc98
1 files changed, 98 insertions, 0 deletions
diff --git a/doc/src/platforms/wince-opengl.qdoc b/doc/src/platforms/wince-opengl.qdoc
new file mode 100644
index 0000000000..3c7e22f83f
--- /dev/null
+++ b/doc/src/platforms/wince-opengl.qdoc
@@ -0,0 +1,98 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the documentation 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 either Technology Preview License Agreement or the
+** Beta Release License Agreement.
+**
+** 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.0, included in the file LGPL_EXCEPTION.txt in this
+** package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+** If you are unsure which license is appropriate for your use, please
+** contact the sales department at http://qt.nokia.com/contact.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+ \page windowsce-opengl.html
+ \title Windows CE OpenGL ES
+ \ingroup qtce
+ \brief Information about support for OpenGL ES with Qt for Windows CE.
+
+ \section1 Introduction
+
+ \l {http://www.opengl.org}{OpenGL} is an industry standard API for 2D/3D
+ graphics. It provides a powerful, low-level interface between software
+ and acceleration hardware, and it is operating system and window system
+ independent.
+
+ \l {http://www.khronos.org/opengles}{OpenGL ES} is a subset of the
+ \l {http://www.opengl.org}{OpenGL} standard. It is meant for use in
+ embedded systems. Hence, it has a smaller, more constrained API.
+
+ Qt for Windows CE uses EGL 1.1 to embed OpenGL ES windows within the
+ Windows CE window manager.
+
+ To use OpenGL ES enabled widgets in a Qt for Windows CE application, you
+ only need to subclass QGLWidget and draw on instances of the subclass with
+ OpenGL ES functions.
+
+ OpenGL ES includes profiles for floating-point and fixed-point arithmetic.
+ The floating point profile is called OpenGL ES CM (Common) and the
+ fixed-point profile is called OpenGL ES CL (Common Lite).
+
+ You can run \c{configure} with the \c{-opengl-es-cm} option for the Common
+ profile or \c{-opengl-es-cl} for the Common Lite profile. In both cases,
+ ensure that the \c{lib} and \c{includes} paths include the OpenGL ES
+ headers and libararies from your SDK. The OpenGL ES lib should be called
+ either \c{libGLES_CM.lib} for the Common profile or \c{libGLES_CL.lib}
+ for the Common Lite profile.
+
+ To configure Qt for Windows Mobile 5.0 and OpenGL ES Common Lite support
+ you can run \c{configure} like this:
+
+ \snippet doc/src/snippets/code/doc_src_wince-opengl.qdoc 0
+
+ The distinction between the Common and Common Lite profiles is important,
+ because the Common Lite profile has less functionality and only supports a
+ fixed-point vertex format.
+
+ To start programming with Qt and OpenGL ES on Windows CE, you can start
+ with the \l{Hello GL ES Example}. This example shows how to use QGLWidget
+ and QGLPainter with OpenGL ES. It also provides some hints on how to port
+ OpenGL code to OpenGL ES.
+
+ \section2 Using OpenGL to Accelerate Normal 2D Painting
+
+ Qt provides QOpenGLPaintEngine, a subclass of QPaintEngine that translates
+ QPainter operations into OpenGL calls. This is especially convenient for
+ drawing text or QImage objects in an OpenGL ES context. For further
+ details, refer to the \l{Hello GL ES Example}.
+
+*/