C
QUL_COPY_TO_RAM
Copy image data to RAM for faster access.
Description
The following is a list of possible values:
| Value | Result |
|---|---|
"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:
| Value | Macro |
|---|---|
"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.