C

图像层 QML 类型

由单个图像组成的层。更多...

导入语句	import QtQuickUltralite.Layers
自	Qt Quick Ultralite 1.7
继承	Item

定义一个具有单个图像源的层。 ImageFiles.MCU.Experimental.resourceSplitImageOptimization 必须对提供的图像禁用。

图像层可用于从闪存向屏幕显示静态图像数据，而无需为动态帧缓冲区分配内存。

示例用法

ApplicationScreens {
    Screen {
        ImageLayer {
            source: "qrc:/images/background.png"
        }
    }
}

注意： 此功能可能不受所有参考板上的硬件支持。有关更多信息，请参阅支持的特性表。

注意： 此类型仅适用于 Qt Quick Ultralite。有关详细信息，请参阅兼容性页面。

另请参阅 ApplicationScreens、Screen、ItemLayer、SpriteLayer 和使用硬件层提高性能。

platformId : int

用于标识平台的唯一值。

用于与特定平台的 API 配置自定义层属性。

renderingHints : enumeration

图像层的渲染优化提示。

提示由平台层引擎用于以最优化方式配置层。默认渲染提示是平台特定的。如果平台未提供默认值，则使用 LayerBase.OptimizeForSize。

可能值

常量	描述
`LayerBase.NoRenderingHint`	未指定渲染提示
`LayerBase.OptimizeForSpeed`	该层针对快速渲染进行了优化
`LayerBase.OptimizeForSize`	该层针对减少内存使用进行了优化

来源 : 图像

由于QML基本类型中不支持的URL类型存在，存在另一种基本类型称为image，这是ImageLayer对象source属性的类型。

ImageLayer接受绝对资源URI，例如"qrc:/images/map.png"。资源必须使用qulrcc工具编译才可使用。

如果将在编译时未知字符串设置为资源，Qt Quick Ultralite将执行运行时查找以找到指定字符串的资源句柄。

例如以下代码会导致运行时查找：

ImageLayer {
    source: "qrc:/" + "foo.png"
}

失败的查找会将source属性重置为空状态，导致不渲染任何内容。

不建议使用压缩或配置了OnDemand 缓存策略的图像，因为它们存储在图像缓存中。如果图像缓存不足以容纳所有相关图像，可能会删除这些图像，从而导致意外的结果。

注意：Qt Quick Ultralite不支持动态资源。每个资源都必须使用Qt Quick Ultralite资源系统进行注册。

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