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, Qt Quick 2D Renderer presents certain limitations regarding the available features.

Since Qt Quick 2D Renderer does not use OpenGL, there are some features that cannot be supported. The following are known limitations:

Shader Effects

ShaderEffect components in QtQuick 2 can not be rendered with Qt Quick 2D Renderer.

Qt Graphical Effects Module

Qt Graphical Effects uses ShaderEffect 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.

Particle Effects

It is not possible to render particle effects with Qt Quick 2D Renderer. Whenever possible, remove particles completely from the scene. Otherwise they will still require some processing, even though they are not visible with Qt Quick 2D Renderer.


The Sprite item depends on inaccessible OpenGL functions and will not be visible.

Rendering Text

The text rendering with Qt Quick 2D 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 Text.NativeRendering with Text items.

Render Control

QQuickRenderControl depends on OpenGL to function and will not function with Qt Quick 2D Renderer. Using QQuickRenderControl can lead to unexpected behavior and crashes.

© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. 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.