<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- adaptations.qdoc -->
<title>Qt Quick Software Adaptation | Qt Quick 5.9</title>
<link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
<script type="text/javascript">
document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
// loading style sheet breaks anchors that were jumped to before
// so force jumping to anchor again
setTimeout(function() {
var anchor = location.hash;
// need to jump to different anchor first (e.g. none)
location.hash = "#";
setTimeout(function() {
location.hash = anchor;
}, 0);
}, 0);
</script>
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<table><tr>
<td >Qt 5.9</td><td ><a href="qtquick-index.html">Qt Quick</a></td><td >Qt Quick Software Adaptation</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right">Qt 5.9.4 Reference Documentation</td>
</tr></table>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level2"><a href="#shader-effects">Shader Effects</a></li>
<li class="level2"><a href="#qt-graphical-effects-module">Qt Graphical Effects Module</a></li>
<li class="level2"><a href="#particle-effects">Particle Effects</a></li>
<li class="level2"><a href="#rendering-text">Rendering Text</a></li>
<li class="level2"><a href="#qt-multimedia-videooutput">Qt Multimedia VideoOutput</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Qt Quick Software Adaptation</h1>
<span class="subtitle"></span>
<!-- $$$qtquick-visualcanvas-adaptations-software.html-description -->
<div class="descr"> <a name="details"></a>
<p>The Software adaptation is an alternative renderer for <a href="qtquick-index.html">Qt Quick</a> 2 that uses the Raster paint engine to render the contents of the scene graph instead of OpenGL. As a result of not using OpenGL to render the scene graph, some features and optimizations are no longer available. Most Qt Quick 2 applications will run without modification though any attempts to use unsupported features will be 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.</p>
<p>The Software adaptation was previously known as the Qt Quick 2D Renderer. However, unlike the 2D Renderer, the new, integrated version supports partial updates. This means that the full update of the window or screen contents is now avoided, and only the changed areas get flushed. This can significantly improve performance for many applications.</p>
<a name="shader-effects"></a>
<h3 >Shader Effects</h3>
<p><a href="qml-qtquick-shadereffect.html">ShaderEffect</a> components in <a href="qtquick-module.html">QtQuick</a> 2 can not be rendered by the Software adptation.</p>
<a name="qt-graphical-effects-module"></a>
<h3 >Qt Graphical Effects Module</h3>
<p>Qt Graphical Effects uses <a href="qml-qtquick-shadereffect.html">ShaderEffect</a> items to render effects. If you use graphical effects from this module, then you should not hide the source item so that the original item can still be rendered.</p>
<a name="particle-effects"></a>
<h3 >Particle Effects</h3>
<p>It is not possible to render particle effects with the Software adaptation. Whenever possible, remove particles completely from the scene. Otherwise they will still require some processing, even though they are not visible.</p>
<a name="rendering-text"></a>
<h3 >Rendering Text</h3>
<p>The text rendering with the Software adaptation 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 <a href="qml-qtquick-text.html#renderType-prop">Text.NativeRendering</a> with <a href="qml-qtquick-text.html">Text</a> items.</p>
<a name="qt-multimedia-videooutput"></a>
<h3 >Qt Multimedia VideoOutput</h3>
<p>The VideoOutput item of the Qt Multimedia module is not supported with the software adaptation. This is because VideoOutput uses the QVideoRendererControl item which requires custom <a href="qsggeometrynode.html">QSGGeometryNode</a> behavior that is only present in the default OpenGL adaptation.</p>
</div>
<!-- @@@qtquick-visualcanvas-adaptations-software.html -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2017 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
