Limitations | Qt Quick 2D Renderer 5.7

Qt Quick 2D Renderer | Limitations

Installation Guide ◦ Performance Guide

# 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, 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.

## Sprites

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.

Installation Guide ◦ Performance Guide