C
QUL_RESOURCE_IMAGE_PIXEL_FORMAT
警告: 此 CMake 源属性自 2.4 版以来已弃用,请考虑使用 ImageFiles.MCU.resourceImagePixelFormat 代替。
注意: 可以使用 QmlProject
在 BoardDefaults.qmlprojectconfig
文件中设置板级默认值。有关信息,请参阅 定义平台默认变量 和 QmlProject 用户手册。
描述
默认情况下,Qt Quick Ultralite 会根据平台设置和源图像属性自动尝试选择最佳像素格式。
您可以更改图像像素格式,在图像输出质量、其二进制大小和应用程序的内存占用之间取得平衡。
尽管位深度越高图像质量越好,但这种图像需要更多数据存储在应用程序二进制文件中。这会影响您的设备闪存使用,并根据 QUL_RESOURCE_CACHE_POLICY 设置影响 RAM 使用。另一方面,使用较低的位深度会导致图像质量下降,但对二进制大小和内存占用的影响很小。
注意: 将 QUL_RESOURCE_IMAGE_PIXEL_FORMAT 设置为 RGB332 的图像在所有 Qt Quick Ultralite 参考平台上都不会使用硬件加速渲染。这可能导致应用程序在渲染速度(每秒帧数)方面性能不佳。
随着在 Qt Quick Ultralite 1.7 中引入 SpriteLayer、ImageLayer 和 ItemLayer API,根据要与之一起使用的图层选择图像像素格式可能成为必要。在某些平台(如 RH850)上,精灵层要求所有包含的项目和图像层具有兼容的像素格式。此外,当计划在 16 位项目层中显示不透明图像时,使用 32 位颜色深度可能会是浪费。
此属性可以设置图像的首选像素格式。
请求的像素格式必须与图像内容匹配。例如,带有 alpha 通道的图像不可能有 RGB888 像素格式。
可能的值有
- XRGB8888
- RGB888
- RGB565
- RGB332
- ARGB8888
- ARGB4444
- Alpha8
- RGB888RLE
- XRGB8888RLE
- ARGB8888RLE
- 自动无损压缩
- 自动
默认值是 "自动"。
像素格式RGB888RLE、XRGB8888RLE和ARGB888RLE专门用于使用无损运行长度编码(RLE)压缩算法的图像。与使用QUL_RESOURCE_COMPRESSION的图像不同,这些图像在渲染过程中动态解码,因此无需任何额外存储。限制是,RLE像素格式不支持缩放、旋转、剪切和透视变换。
像素格式自动无损压缩
允许资源编译器根据图像内容(不透明或透明)和平台默认值(QUL_PLATFORM_DEFAULT_RESOURCE_COMPRESSED_LOSSLESS_PIXEL_FORMAT_OPAQUE或QUL_PLATFORM_DEFAULT_RESOURCE_COMPRESSED_LOSSLESS_PIXEL_FORMAT_ALPHA)自动选择无损压缩的像素格式。
注意:RGB888目前以与XRGB8888相同的方式实现(资源是32位的)。
自
此属性在Qt Quick Ultralite 2.0中引入。
另请参阅 默认资源属性。
在特定Qt许可证下提供。
了解更多信息。