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

     2 **

     3 ** Copyright (C) 2010 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 

    44     \page qt-embeddedLinux-accel.html

    45 

    46     \target Hardware Acceleration with Qt for Embedded Linux

    47 

    48     \title Qt for Embedded Linux Hardware Accelerated Graphics

    49     \ingroup qt-embedded-linux

    50 

    51 

    52 	\input platforms/emb-hardwareacceleration.qdocinc

    53 

    54     \section1 Windowing on Embedded Linux with Hardware Accelerated Graphics

    55 

    56     Qt for Embedded Linux includes its own windowing system, QWS. QWS was

    57     designed in 1999, well before graphics acceleration was available for

    58     embedded devices. It does a great job providing a lightweight window

    59     manager including all the expected functionality such as arbitrary

    60     windows that can be moved, resized, minimized, etc. Getting QWS to work

    61     with GPUs is very challenging, particularly with OpenGL and OpenVG

    62     because there is no standard way in Linux to share textures across

    63     processes. Some silicon vendors provide private APIs to allow texture

    64     sharing, others do not. These limitations are documented under the

    65     sections describing each type of accelerated hardware APIs. The simplest

    66     most generic support for accelerated graphics is a full screen single

    67     process single window.

    68 

    69     \section2 General options

    70     \list

    71         \o QWS, not accelerated, allows arbitrary windowing with multiple

    72         processes drawing on the screen.

    73         \o X11 with an accelerated X11 driver provided by the silicon

    74         vendor. Like QWS, this allows arbitrary windows with multiple

    75         processes drawing on the screen. Our experience is that there is

    76         some overhead from X11 which will adversely affect framerates.

    77         Additionally, our experience is that the drivers from silicon

    78         vendors are still maturing.

    79         \o Full screen single process single window. This will always work.

    80         Some additional capabilities are available and are documented in

    81         the acceleration specific API sections.

    82     \endlist

    83 

    84     \section1 Supported Hardware Accelerated Graphics APIs

    85 

    86     This table shows which Hardware Accelerated Graphics APIs currently

    87     supported by Qt.

    88 

    89      \table 

    90      \header

    91         \o Supported APIs

    92 		\o API Version

    93      \row

    94         \o \l {Qt for Embedded Linux and OpenGL}{OpenGL ES}

    95 		\o 1.x and 2.x

    96      \row

    97         \o \l {Qt for Embedded Linux and OpenVG}{OpenVG } 

    98 		\o 1.1

    99      \row

   100         \o \l {Qt for Embedded Linux and DirectFB}{DirectFB}

   101 		\o 2.0

   102      \endtable 

   103 

   104 

   105 */