C

QUL_RESOURCE_IMAGE_PIXEL_FORMAT

警告: 此 CMake 源属性自 2.4 版以来已弃用,请考虑使用 ImageFiles.MCU.resourceImagePixelFormat 代替。

注意: 可以使用 QmlProjectBoardDefaults.qmlprojectconfig 文件中设置板级默认值。有关信息,请参阅 定义平台默认变量QmlProject 用户手册

描述

默认情况下,Qt Quick Ultralite 会根据平台设置和源图像属性自动尝试选择最佳像素格式。

您可以更改图像像素格式,在图像输出质量、其二进制大小和应用程序的内存占用之间取得平衡。

尽管位深度越高图像质量越好,但这种图像需要更多数据存储在应用程序二进制文件中。这会影响您的设备闪存使用,并根据 QUL_RESOURCE_CACHE_POLICY 设置影响 RAM 使用。另一方面,使用较低的位深度会导致图像质量下降,但对二进制大小和内存占用的影响很小。

注意: 将 QUL_RESOURCE_IMAGE_PIXEL_FORMAT 设置为 RGB332 的图像在所有 Qt Quick Ultralite 参考平台上都不会使用硬件加速渲染。这可能导致应用程序在渲染速度(每秒帧数)方面性能不佳。

随着在 Qt Quick Ultralite 1.7 中引入 SpriteLayerImageLayerItemLayer 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_OPAQUEQUL_PLATFORM_DEFAULT_RESOURCE_COMPRESSED_LOSSLESS_PIXEL_FORMAT_ALPHA)自动选择无损压缩的像素格式。

注意:RGB888目前以与XRGB8888相同的方式实现(资源是32位的)。

此属性在Qt Quick Ultralite 2.0中引入。

另请参阅 默认资源属性

在特定Qt许可证下提供。
了解更多信息。