diff options
Diffstat (limited to 'src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc')
| -rw-r--r-- | src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc | 50 |
1 files changed, 11 insertions, 39 deletions
diff --git a/src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc b/src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc index 9d5c4aaf09..d4c0c0eb2b 100644 --- a/src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc +++ b/src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc @@ -1,29 +1,5 @@ -/**************************************************************************** -** -** Copyright (C) 2017 The Qt Company Ltd. -** Contact: https://www.qt.io/licensing/ -** -** This file is part of the documentation of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:FDL$ -** Commercial License Usage -** Licensees holding valid commercial Qt licenses may use this file in -** accordance with the commercial license agreement provided with the -** Software or, alternatively, in accordance with the terms contained in -** a written agreement between you and The Qt Company. For licensing terms -** and conditions see https://www.qt.io/terms-conditions. For further -** information use the contact form at https://www.qt.io/contact-us. -** -** GNU Free Documentation License Usage -** Alternatively, this file may be used under the terms of the GNU Free -** Documentation License version 1.3 as published by the Free Software -** Foundation and appearing in the file included in the packaging of -** this file. Please review the following information to ensure -** the GNU Free Documentation License version 1.3 requirements -** will be met: https://www.gnu.org/licenses/fdl-1.3.html. -** $QT_END_LICENSE$ -** -****************************************************************************/ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! \title Scene Graph Adaptations @@ -41,7 +17,7 @@ in form of plugins (openvg) or built-in to the Qt Quick library From Qt 5.14 onwards, the default adaptation gains the option of rendering via a graphics abstraction layer, the Qt Rendering Hardware Interface (RHI), -provided by the \l QtGui module. When enabled, no direct OpenGL calls are made. +provided by the \l [QtGui]{Qt GUI} module. When enabled, no direct OpenGL calls are made. Rather, the scene graph renders by using the APIs provided by the abstraction layer, which is then translated into OpenGL, Vulkan, Metal, or Direct 3D calls. Shader handling is also unified by writing shader code once, compiling to @@ -122,10 +98,11 @@ graphics. For more details, see \page qtquick-visualcanvas-adaptations-software.html The Software adaptation is an alternative renderer for \l {Qt Quick} 2 that uses the Raster paint -engine to render the contents of the scene graph, instead of OpenGL. Consequently, some features -and optimizations are not available. Most Qt Quick 2 applications can run without any modification, -but any attempts to use unsupported features are ignored. By using the Software adaptation, it is -possible to run Qt Quick 2 applications on hardware and platforms that do not have OpenGL support. +engine to render the contents of the scene graph, instead of a hardware-accelerated 3D graphics API. +Consequently, some features and optimizations are not available. Most Qt Quick 2 applications can run +without any modification, but any attempts to use unsupported features are ignored. +By using the Software adaptation, it is possible to run Qt Quick 2 applications on hardware and +platforms that do not have \l{topics-graphics}{hardware-accelerated 3D graphics API} support. The Software adaptation was previously known as the Qt Quick 2D Renderer. However, unlike the 2D Renderer, this new, integrated version supports partial updates. This means that a full update @@ -145,14 +122,9 @@ even though they are not visible. \section2 Rendering Text The text rendering with the Software adaptation is based on software rasterization and does not -respond as well to transformations such as scaling, compared to when using OpenGL. The quality is -similar to choosing \l [QML] {Text::renderType}{Text.NativeRendering} with \l [QML] {Text} items. - -\section2 Qt Multimedia VideoOutput - -The Qt Multimedia module's VideoOutput item is not supported with the Software adaptation. This -is because VideoOutput uses the QVideoRendererControl item which requires custom QSGGeometryNode -behavior, which is only present in the default OpenGL adaptation. +respond as well to transformations such as scaling, compared to when using a hardware-accelerated +3D graphics API. The quality is similar to choosing \l [QML] {Text::renderType}{Text.NativeRendering} +with \l [QML] {Text} items. */ |