Image QML Type

これらのプロパティは、実際に描画される画像のサイズを保持します。ほとんどの場合、width やheight と同じですが、Image.PreserveAspectFit やImage.PreserveAspectCrop を使用する場合、paintedWidth やpaintedHeight は、Image アイテムのwidth やheight よりも小さくなったり大きくなったりします。

画像の水平方向と垂直方向の配置を設定します。デフォルトでは、画像は中央揃えになります。

horizontalAlignment の有効な値はImage.AlignLeft 、Image.AlignRight 、Image.AlignHCenter です。verticalAlignment の有効な値はImage.AlignTop 、Image.AlignBottom 、Image.AlignVCenter です。

currentFrame は現在表示 さ れてい る フ レーム。デフォルトは 。画像に複数のフレームが含まれている場合は、 と の間の数値を設定することで、別のフレームを表示することができます。0 0 frameCount - 1

frameCount は画像のフレーム数です。たいていの画像にはフレームが1つしかありません。

ローカルファイルシステム上の画像を別スレッドで非同期に読み込むかどうかを指定します。デフォルト値はfalseで、画像の読み込み中にユーザーインターフェイスのスレッドがブロックされます。asynchronous を true に設定すると、画像がすぐに表示されることよりも、レスポンシブなユーザインタフェースを維持する方が望ましい場合に便利です。

このプロパティは、ローカルファイルシステムから読み込まれた画像に対してのみ有効であることに注意してください。ネットワークリソース（HTTPなど）を介して読み込まれた画像は、常に非同期で読み込まれます。

このプロパティは、EXIFオリエンテーションなどの画像変換メタデータを画像に自動的に適用するかどうかを保持します。

デフォルトでは、このプロパティは false に設定されています。

画像をキャッシュするかどうかを指定します。デフォルト値はtrueです。cache を false に設定すると、大きな画像を扱うときに便利です。小さな 'ui 要素' 画像を犠牲にしてキャッシュされないようにするためです。

このプロパティを設定することで、ソース画像のサイズがアイテムと異なる場合の動作を定義できます。

Image {
    width: 130; height: 100
    source: "qtlogo.png"
}

Image {
    width: 130; height: 100
    fillMode: Image.PreserveAspectFit
    source: "qtlogo.png"
}

Image {
    width: 130; height: 100
    fillMode: Image.PreserveAspectCrop
    source: "qtlogo.png"
    clip: true
}

Image {
    width: 120; height: 120
    fillMode: Image.Tile
    horizontalAlignment: Image.AlignLeft
    verticalAlignment: Image.AlignTop
    source: "qtlogo.png"
}

Image {
    width: 120; height: 120
    fillMode: Image.TileVertically
    verticalAlignment: Image.AlignTop
    source: "qtlogo.png"
}

Image {
    width: 120; height: 120
    fillMode: Image.TileHorizontally
    verticalAlignment: Image.AlignLeft
    source: "qtlogo.png"
}

デフォルトでは、clip はfalse であることに注意してください。これは、fillMode がPreserveAspectCrop に設定されていても、アイテムがその境界矩形の外側に描画される可能性があることを意味します。

Qt Quick Examples - Image Elementsも参照してください 。

このプロパティは、拡大縮小や変形時に画像がミップマップフィルタリングを使用するかどうかを保持します。

ミップマップフィルタリングは、平滑化よりも縮小時の視覚的品質が向上しますが、（画像の初期化時とレンダリング時の両方で）パフォーマンスが犠牲になる可能性があります。

デフォルトでは、このプロパティは false に設定されています。

smoothも参照してください 。

このプロパティは、画像を水平方向に反転させる（事実上ミラー画像を表示する）かどうかを保持します。

デフォルト値は false です。

このプロパティは、画像を垂直方向に反転させる（実質的にミラー画像を表示する）かどうかを保持します。

デフォルト値は false です。

このプロパティは Qt 6.2 で導入されました。

このプロパティは、0.0 (何もロードされていない) から 1.0 (完了) までの、画像のロードの進行状況を保持します。

statusも参照してください 。

このプロパティは、source プロパティが変更され、読み込みが非同期で行われる場合の動作を定義します。これは、asynchronous プロパティがtrue に設定されている場合、または画像がローカル・ファイル・システム上にない場合です。

retainWhileLoading がfalse （デフォルト）の場合、古い画像は即座に破棄され、新しい画像のロード中にコンポーネントはクリアされます。true に設定すると、古い画像は保持され、新しい画像の準備ができるまで表示されたままになります。

このプロパティを有効にすると、新しい画像の読み込みに時間がかかる場合にちらつきを避けることができます。その代償として、新しい画像がロードされている間、二重のバッファリングのためにメモリが余分に使用されます。

このプロパティは Qt 6.8 で導入されました。

このプロパティは、拡大縮小や変形時に画像をスムースフィルタリングするかどうかを保持します。スムースフィルタリングはより良いビジュアル品質を提供しますが、ハードウェアによっては遅くなる場合があります。画像が自然なサイズで表示される場合、このプロパティは視覚的にもパフォーマンス的にも影響を与えません。

デフォルトでは、このプロパティはtrueに設定されています。

mipmapも参照してください 。

Image は、Qt がサポートする URL スキームから読み込まれる、Qt がサポートするあらゆる画像フォーマットを扱うことができます。

URL は、絶対 URL でも、コンポーネントの URL からの相対 URL でもかまいません。

QQuickImageProvider 、Compressed Texture Files 、Automatic Detection of File Extensionも参照して ください。

このプロパティが設定されている場合、ロードされるソース画像の矩形領域が保持されます。

sourceClipRect はsourceSize プロパティと連動し、画像の一部だけを読み込む必要がある場合にシステムリソースを節約します。

Rectangle {
    width: ...
    height: ...

    Image {
       anchors.fill: parent
       source: "reallyBigImage.svg"
       sourceSize.width: 1024
       sourceSize.height: 1024
       sourceClipRect: Qt.rect(100, 100, 512, 512)
    }
}

上の例では、まず概念的に SVG グラフィックを 1024x1024 に拡大縮小し、次に上端と左端から 100 ピクセルの位置から 512x512 ピクセルの関心領域を切り出している。このようにsourceSize がスケールを決定するが、実際の出力画像は 512x512 ピクセルである。

画像フォーマットによっては、指定した領域だけをレンダリングすることでCPU時間を節約できるものもあります。また、画像全体を最初に読み込んでから、指定した領域に切り抜く必要があるものもある。

このプロパティをクリアして画像全体を再読み込みするには、sourceClipRect をundefined に設定します。

このプロパティは、フルフレーム画像のスケーリングされた幅と高さを保持します。

画像の描画をスケーリングするwidth とheight プロパティとは異なり、このプロパティは、大きな画像が必要以上にメモリを使用しないように、読み込まれた画像に対して保存されるピクセルの最大数を設定します。例えば、イメージのwidth やheight の値に関係なく、メモリ上のイメージが 1024x1024 ピクセルより大きくならないようにします：

Rectangle {
    width: ...
    height: ...

    Image {
       anchors.fill: parent
       source: "reallyBigImage.jpg"
       sourceSize.width: 1024
       sourceSize.height: 1024
    }
}

画像の実寸が sourceSize よ り 大 き い と き は、 画像は縮小 さ れます。サイズの1つの次元だけが0より大きく設定されている場合、もう1つの次元は、ソース画像のアスペクト比を維持するように比例して設定されます。(fillMode はこれとは無関係です）。

sourceSize.widthとsourceSize.heightの両方が設定されている場合、画像は指定されたサイズ内に収まるように縮小され（PreserveAspectCropまたはPreserveAspectFitが使用されていない限り、切り抜き/フィットに最適なサイズに合わせて縮小されます）、画像の縦横比が維持されます。拡大縮小後の画像の実際のサイズは、Item::implicitWidth とItem::implicitHeight で知ることができます。

ソースが本質的にスケーラブルな画像（SVGなど）の場合、このプロパティは本質的なサイズに関係なく、読み込まれる画像のサイズを決定します。SVGのレンダリングは画像に比べて遅いので、このプロパティを動的に変更することは避けてください。

ソースが非拡張画像（例えば JPEG）の場合、読み込まれる画像はこのプロパティが指定するサイズより大きくはならない。いくつかのフォーマット（現在のところ JPEG のみ）では、画像全体が実際にメモリに読み込まれることはない。

sourceClipRect プロパティも設定されている場合、sourceSize がスケールを決定しますが、クリップ矩形のサイズにクリップされます。

sourceSize をundefined に設定することで、画像の自然なサイズにクリアできます。

Qt Quick Examples - Pointer Handlersも参照してください 。

このプロパティは、画像のロード状態を保持します。以下のいずれかになります：

このステータスを使用して、最新情報を提供するか、ステータスの変更に何らかの形で応答してください。例えば、次のようなことができます：

• 状態変化を引き起こす：

  State { name: 'loaded'; when: image.status == Image.Ready }

• onStatusChanged シグナルハンドラを実装する：

  Image {
      id: image
      onStatusChanged: if (image.status == Image.Ready) console.log('Loaded')
  }

• ステータス値にバインドする：

  Text { text: image.status == Image.Ready ? 'Loaded' : 'Not loaded' }

progressも参照して ください。