Bits of display color depth to build for.

Description

Set this variable to choose between different color depths available for the target QUL_PLATFORM.

Must be set to an available color depth: "4", "8", "16", "24", or "32". The default value depends on the selected platform.

On the desktop platform (QUL_PLATFORM=qt), "4" emulates a 16-level grayscale display, such as an e-paper panel: the screen and all item layers without alpha channel use PixelFormat_Gray4 and are drawn by the Gray4 CPU fallback drawing engine, and opaque images are stored as Gray4.

With -DQUL_PLATFORM_QT_GRAYSCALE=ON, "8" emulates a 256-level grayscale display in the same way, with PixelFormat_Gray8 instead of RGB332.

QUL_ROOT and QUL_TOOLS are used in the command line examples below as if they were set as environment variables. For example:

export QUL_ROOT=$HOME/Qt/QtMCUs/3.0.0
export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs

set QUL_ROOT=C:\Qt\QtMCUs\3.0.0
set QUL_TOOLS=C:\Qt\Tools\QtMCUs

Example

cmake .. -DQul_ROOT=$QUL_ROOT -DQUL_PLATFORM=MIMXRT1050-EVK-baremetal -DQUL_COLOR_DEPTH=16 -DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake -DQUL_TARGET_TOOLCHAIN_DIR=$QUL_TOOLS/arm_gcc_12_3_1 -DQUL_BOARD_SDK_DIR=$QUL_TOOLS/NXP/SDK_2_15_000_EVKB-IMXRT1050 -DCMAKE_BUILD_TYPE=MinSizeRel -DQUL_GENERATORS=../lib/cmake/Qul/QulGenerators.cmake

Since

This variable was introduced in Qt Quick Ultralite 1.0.