On this page

C

Qt Quick Ultralite Safe Renderer QML Types

The Qt Quick Ultralite Safe Renderer module provides QML types that are used for safety-critical items in Qt Quick Ultralite applications. It aims to be compatible with Qt Safe Renderer QML Types.

Using the Module

To use the Qt Quick Ultralite Safe Renderer QML types, add Qul::SafeRenderer to the list of module files in your in your .qmlproject.

ModuleFiles {
    MCU.qulModules: ["Qul::SafeRenderer"]
}

Note: Qul::SafeRenderer must be added to the main QML project, even when safe items are placed in a separate module.

After adding the module files, add the following import statement to your .qml file:

import QtQuickUltralite.SafeRenderer

Define APP_SAFE_RENDERER to enable the Safe Renderer Bitmap (SRB) decoder when using a generated entrypoint.

Add the SRB decoder to the image decoders list when using a custom main:

// ...
#include <qul/imagedecoders/saferendererbitmapdecoder.h>

int main()
{
    Qul::initHardware();

    static SafeRendererBitmapDecoder srbDecoder;
    Qul::Application::addImageDecoder(&srbDecoder);

    Qul::initPlatform();
    Qul::Application app;
    // ...

Linking an Application to the CMake Target

Note: This step applies to deprecated CMake APIs only.

When using CMake projects, link your application to the Qul::SafeRenderer CMake target.

target_link_libraries(app PRIVATE Qul::SafeRenderer)

For more information on safety-critical items in Qt Quick Ultralite applications, see Creating an Qt Quick Ultralite application with safety-critical items.

QML Types

SafeImage

Provides a safety-critical QML image type that can be validated using Qt Safe Renderer's output verification

SafePicture

Provides a safety-critical QML picture type that can be validated using Qt Safe Renderer's output verification

SafeText

Provides a safety-critical QML text type that can be validated using Qt Safe Renderer's output verification

Available under certain Qt licenses.
Find out more.