【Qt QML入门】Image

Image类型显示一个图像。
使用source属性将图像的源指定为URL。图像可以以Qt支持的任何标准图像格式提供，包括位图格式，如PNG和JPEG，以及矢量图形格式，如SVG。
如果没有指定宽度和高度属性，图像将自动使用加载图像的大小。

import QtQuick
import QtQuick.Window
import QtQml

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")
    Image {
        source: "qrc:/img.png"
        fillMode: Image.PreserveAspectFit
        anchors.fill: parent
    }
}

加载文件的过程默认是同步的，也就是会阻塞UI，直到图片加载完成。

如果想加载比较大的图片，可以启用异步属性，在线程中加载该图像。如果图片是从网络资源获得的，则会自动异步加载，并根据需要更新进度和状态属性。

还有一点需要注意，Image被加载成功后，会在内部被缓存和共享，因此如果几个Image项有相同的源，则只会加载图像的一个副本。

Image的属性：

currentFrame：当前可见的帧。默认值为0。如果图像包含多个帧，则可以将其设置为0

frameCount - 1之间的数字，以显示不同的帧。

frameCount：图像中的帧数。大多数图像只有一帧

horizontalAlignment : enumeration

verticalAlignment : enumeration

设置图像的水平和垂直对齐方式。默认情况下，图像是居中对齐的。

水平对齐的有效值为Image.AlignLeft，Image.AlignRight和Image.AlignHCenter。

垂直对齐的有效值为Image.AlignTop，Image.AlignBottom和Image.AlignVCenter。

paintedHeight : real

paintedWidth : real

保存了实际绘制的图像的大小。在大多数情况下，它与宽度和高度相同，但当使用Image.PreserveAspectFit or an Image.PreserveAspectCrop，paintedWidth或paintedHeight可以小于或大于图像项的宽度和高度。

asynchronous : bool

指定本地文件系统上的映像应该在单独的线程中异步加载。默认值为false，在加载图像时导致用户界面线程阻塞。在维护响应式用户界面比立即显示图像更可取的情况下，将异步设置为true非常有用。
注意，此属性仅对从本地文件系统读取的映像有效。通过网络资源(例如HTTP)加载的图像总是异步加载的。

cache : bool

指定是否应该缓存图像。默认值为true。在处理大图像时，将缓存设置为false很有用，以确保它们不会以牺牲小的“ui元素”图像为代价被缓存。

fillMode : enumeration

Image.Stretch-图像被缩放到适合
Image.PreserveAspectFit -图像被均匀缩放以适合而不裁剪
Image.PreserveAspectCrop -图像被均匀缩放以填充，必要时进行裁剪
Image.Tile-图像是水平和垂直复制
Image.TileVertically-图像水平拉伸和垂直平铺
Image.TileHorizontally-图像垂直拉伸，水平平铺
Image.Pad -图像不被转换

mipmap : bool

此属性保留图像在缩放或转换时是否使用mipmap过滤。
与平滑相比，当按比例缩小时，Mipmap过滤提供了更好的视觉质量，但它可能会以性能为代价(在初始化图像和渲染期间)。
默认情况下，此属性设置为false。

mirror : bool

此属性保留图像是否应该水平反转(有效地显示镜像)。
默认值为false。

progress : real

这个属性保存图片加载的进度，从0.0(没有加载)到1.0(完成)。

smooth : bool

此属性用于确定图像在缩放或转换时是否平滑过滤。平滑过滤提供更好的视觉质量，但在某些硬件上可能会变慢。如果图像以其自然大小显示，则此属性没有视觉或性能效果。
默认情况下，此属性设置为true。

source : url

Image可以处理Qt支持的任何图像格式，从Qt支持的任何URL方案加载。
URL可以是绝对的，也可以是相对于组件的URL的。

sourceClipRect : rect

如果设置了此属性，则保存要加载的源图像的矩形区域。
当只需要加载图像的一部分时，sourceClipRect与sourceSize属性一起工作以节省系统资源。

sourceSize : size

此属性保存全帧图像的缩放宽度和高度。
与缩放图像绘制的宽度和高度属性不同，此属性为加载的图像设置存储的最大像素数，以便大型图像不会使用不必要的内存。

如果图像的实际大小大于sourceSize，则图像按比例缩小。如果只将尺寸的一个维度设置为大于0，则按比例设置另一个维度以保持源图像的长宽比。(fillMode与此无关。)
如果两个sourceSize。宽度和sourceSize。高度设置时，图像将按比例缩小以适应指定的大小(除非使用了PreserveAspectCrop或PreserveAspectFit，否则它将按比例缩小以匹配裁剪/拟合的最佳大小)，保持图像的宽高比。缩放后图像的实际大小可通过Item::implicitWidth和Item::implicitHeight获得。
如果源是一个本质上可伸缩的图像(例如;SVG)，此属性决定所加载图像的大小，而不考虑其固有大小。避免动态更改此属性;呈现SVG比呈现图像要慢。
如果源是一个不可伸缩的图像(例如。JPEG)，则加载的图像将不大于此属性指定的大小。对于某些格式(目前只有JPEG)，整个图像实际上永远不会加载到内存中。
如果还设置了sourceClipRect属性，则sourceSize确定比例，但它将被剪切为剪辑矩形的大小。
通过将sourceSize设置为undefined，可以将sourceSize清除为图像的自然大小。

注意:动态更改此属性会导致图像源被重新加载。

status : enumeration

这个属性保存图像加载的状态。它可以是:

Image.Null-没有设置图像

Image.Ready-图像已加载

Image.Loading-图像当前正在加载

Image.Error-加载图像时发生错误

使用此状态以某种方式提供更新或响应状态更改。