1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (qt-info@nokia.com)

     6 **

     7 ** This file is part of the documentation of the Qt Toolkit.

     8 **

     9 ** $QT_BEGIN_LICENSE:LGPL$

    10 ** No Commercial Usage

    11 ** This file contains pre-release code and may not be distributed.

    12 ** You may use this file in accordance with the terms and conditions

    13 ** contained in the Technology Preview License Agreement accompanying

    14 ** this package.

    15 **

    16 ** GNU Lesser General Public License Usage

    17 ** Alternatively, this file may be used under the terms of the GNU Lesser

    18 ** General Public License version 2.1 as published by the Free Software

    19 ** Foundation and appearing in the file LICENSE.LGPL included in the

    20 ** packaging of this file.  Please review the following information to

    21 ** ensure the GNU Lesser General Public License version 2.1 requirements

    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

    23 **

    24 ** In addition, as a special exception, Nokia gives you certain additional

    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception

    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

    27 **

    28 ** If you have questions regarding the use of this file, please contact

    29 ** Nokia at qt-info@nokia.com.

    30 **

    31 **

    32 **

    33 **

    34 **

    35 **

    36 **

    37 **

    38 ** $QT_END_LICENSE$

    39 **

    40 ****************************************************************************/

    41 

    42 /*!

    43     \page windowsce-opengl.html

    44     \title Windows CE OpenGL ES

    45     \ingroup qtce

    46     \brief Information about support for OpenGL ES with Qt for Windows CE.

    47 

    48     \section1 Introduction

    49 

    50     \l {http://www.opengl.org}{OpenGL} is an industry standard API for 2D/3D

    51     graphics. It provides a powerful, low-level interface between software

    52     and acceleration hardware, and it is operating system and window system

    53     independent.

    54 

    55     \l {http://www.khronos.org/opengles}{OpenGL ES} is a subset of the

    56     \l {http://www.opengl.org}{OpenGL} standard. It is meant for use in

    57     embedded systems. Hence, it has a smaller, more constrained API.

    58 

    59     Qt for Windows CE uses EGL 1.1 to embed OpenGL ES windows within the

    60     Windows CE window manager.

    61 

    62     To use OpenGL ES enabled widgets in a Qt for Windows CE application, you

    63     only need to subclass QGLWidget and draw on instances of the subclass with

    64     OpenGL ES functions.

    65 

    66     OpenGL ES includes profiles for floating-point and fixed-point arithmetic.

    67     The floating point profile is called OpenGL ES CM (Common) and the

    68     fixed-point profile is called OpenGL ES CL (Common Lite).

    69 

    70     You can run \c{configure} with the \c{-opengl-es-cm} option for the Common

    71     profile or \c{-opengl-es-cl} for the Common Lite profile. In both cases,

    72     ensure that the \c{lib} and \c{includes} paths include the OpenGL ES

    73     headers and libararies from your SDK. The OpenGL ES lib should be called

    74     either \c{libGLES_CM.lib} for the Common profile or \c{libGLES_CL.lib}

    75     for the Common Lite profile.

    76 

    77     To configure Qt for Windows Mobile 5.0 and OpenGL ES Common Lite support

    78     you can run \c{configure} like this:

    79 

    80     \snippet doc/src/snippets/code/doc_src_wince-opengl.qdoc 0

    81 

    82     The distinction between the Common and Common Lite profiles is important,

    83     because the Common Lite profile has less functionality and only supports a

    84     fixed-point vertex format.

    85 

    86     To start programming with Qt and OpenGL ES on Windows CE, you can start

    87     with the \l{Hello GL ES Example}. This example shows how to use QGLWidget

    88     and QGLPainter with OpenGL ES. It also provides some hints on how to port

    89     OpenGL code to OpenGL ES.

    90 

    91     \section2 Using OpenGL to Accelerate Normal 2D Painting

    92 

    93     Qt provides QOpenGLPaintEngine, a subclass of QPaintEngine that translates

    94     QPainter operations into OpenGL calls. This is especially convenient for

    95     drawing text or QImage objects in an OpenGL ES context. For further

    96     details, refer to the \l{Hello GL ES Example}.

    97 

    98 */