C

QUL_COPY_TO_RAM

Copy image data to RAM for faster access.

Description

The following is a list of possible values:

ValueResult
"OnStartup"The data is copied to RAM on startup. Although this enables faster access to data, it might use up your limited RAM.
"OnDemand"The data is copied to the texture cache on demand. The texture cache must be enabled by setting QUL_TEXTURE_CACHE to its total size in bytes.
"Never"The data is not copied to RAM. Drawing an image to the screen from storage may result in reduced performance.

If image data is compressed (QUL_COMPRESSION), the default value is "OnDemand", otherwise it is "OnStartup".

The CMake API maps to the following macros in the platform code:

ValueMacro
"OnStartup"QUL_STATIC_ASSET_SEGMENT
"OnDemand"QUL_STATIC_NO_PRELOAD_ASSET_SEGMENT
"Never"QUL_STATIC_NO_PRELOAD_ASSET_SEGMENT

These macros are platform-dependent. For example, asset preloading is not supported on some boards due to limited amount of RAM. Thus, the "OnDemand" mode is not supported on such boards. See the board-specific documentation pages for more information on asset handling.

The "OnDemand" mode is implemented by QUL_COPY_TO_RAM CMake API, but not by QUL_GLYPHS_COPY_TO_RAM and QUL_FONT_FILES_COPY_TO_RAM.

Note: Source file properties must be set before adding files to the application using the qul_add_resource function.

Since

This property was introduced in Qt Quick Ultralite 1.1.

See also Qt Quick Ultralite image caching, QUL_TEXTURE_CACHE, QUL_COMPRESSION, and Default Resource Properties.

Available under certain Qt licenses.
Find out more.