summaryrefslogtreecommitdiffstats
path: root/src/doc/src/qtquick2drenderer-limitations.qdoc
blob: 3b1c84ce474bbe146d8591e8f546192d4060dee2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
/****************************************************************************
**
** Copyright (C) 2014 Digia Plc
** All rights reserved.
** For any questions to Digia, please use the contact form at
** http://qt.digia.com/
**
** This file is part of Qt Quick 2d Renderer.
**
** Licensees holding valid Qt Enterprise licenses may use this file in
** accordance with the Qt Enterprise License Agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.
**
** If you have questions regarding the use of this file, please use
** the contact form at http://qt.digia.com/
**
****************************************************************************/

/*!
    \page qtquick2drenderer-limitations.html
    \previouspage qtquick2drenderer-installation-guide.html
    \nextpage qtquick2drenderer-performance.html

    \title Limitations

    Qt Quick 2 was designed to take full advantage of OpenGL to make the most
    out of available graphics hardware.  By not relying on OpenGL, \RENDERER
    presents certain limitations regarding the available features.

    Since \RENDERER does not use OpenGL, there are some features that cannot be
    supported.  The following are known limitations:

    \section1 Shader Effects
    ShaderEffect components in QtQuick 2 can not be rendered with \RENDERER.

    \section1 Qt Graphical Effects Module
    QtGraphicalEffects uses ShaderEffect items to render effects.  If you use a
    graphical effect from QtGraphicalEffects, then you should not hide the source
    item so that the original item can still be rendered.

    \section1 Particle Effects
    It is not possible to render particle effects with \RENDERER. Whenever
    possible, remove particles completely from the scene. Otherwise they will still
    require some processing, even though they are not visible with \RENDERER.

    \target Sprites
    \section1 Sprites
    The Sprite item depends on inaccessible OpenGL functions and will
    not be visible.

    \target Text
    \section1 Text
    The text rendering with \RENDERER is based on software rasterization and does
    not respond as well to transformations such as scaling as when using OpenGL.
    The quality is similar to choosing \c Text.NativeRendering with QtQuick.Text
    items.

*/