このページでは

C

ImageFiles.MCU.resourceImagePixelFormat

画像アセットの優先ピクセル形式を設定します。

説明

このプロパティは、イメージアセットをレンダリングするためのピクセルフォーマットを選択するために使用できます。 Qt Quick Ultraliteは、プラットフォーム設定とイメージプロパティに応じて、イメージに最適なピクセルフォーマットを自動的に選択します。イメージピクセルフォーマットは、イメージ出力品質、バイナリサイズ、アプリケーションのメモリフットプリントのバランスをとるために変更できます。

ビット深度が高いほど画質は向上しますが、そのような画像ではアプリケーション・バイナリに保存するデータが増えます。これはデバイスのフラッシュ使用量に影響し、resourceCachePolicy の設定によっては RAM の消費量にも影響します。一方、ビット深度を低くすると画質が悪くなりますが、バイナリ・サイズとメモリ・フットプリントへの影響は小さくなります。

注: RGB332ピクセル・フォーマットの画像は、ハードウェア・アクセラレーションを使用してレンダリングされません。その結果、レンダリング速度(1秒あたりのフレーム数)の点でアプリケーションのパフォーマンスが最適でなくなる可能性があります。

SpriteLayerImageLayerItemLayer のQMLタイプを使用する場合、使用するレイヤーによって、画像のピクセルフォーマットを選択する必要があります。ある種のプラットフォーム(RH850など)では、スプライトレイヤーはすべてのアイテムとイメージレイヤーに互換性のあるピクセルフォーマットを要求します。16ビットのアイテムレイヤーに不透明なイメージを表示する場合、イメージに32ビットの色深度を使用する必要はありません。

このプロパティは、画像の優先ピクセルフォーマットを設定できる。選択されたピクセル形式は、画像の内容と一致しなければならない。た と えば、RGB888 形式はアルフ ァ チ ャ ン ネルを持つ画像に対 し て選ぶ こ と はで き ません。

RGB888RLEXRGB8888RLEARGB888RLE ピ ク セル形式は、 可逆 RLE (run-length encoding) 圧縮アルゴ リ ズ ム を用い る 画像専用です。リソース圧縮を使用する画像とは異なり、これらは追加のストレージを必要とせず、レンダリング中にその場でデコードされます。

AutomaticCompressedLossless ピクセル形式では、画像の内容(不透明または透明)とプラットフォームのデフォルト値(MCU.Config.platformAlphaCompressedLosslessResourcePixelFormatMCU.Config.platformOpaqueCompressedLosslessResourcePixelFormat)に基づいて、Resource Compiler が可逆圧縮の形式を自動的に選択します。

注: RGB888 は現在、XRGB8888 と同じ方法で実装されています (リソースは 32 ビットです)。

使用法

このプロパティは、その親ノードが受け入れられるすべてのコンテキストで受け入れられます。文字列をとり、デフォルト値は"Automatic" です。

利用可能なオプションは以下の通りです:

  • "XRGB8888"
  • "RGB888"
  • "RGB565"
  • "RGB332"
  • "ARGB8888"
  • "ARGB4444"
  • "Alpha8"
  • "RGB888RLE"
  • "XRGB8888RLE"
  • "ARGB8888RLE"
  • "AutomaticCompressedLossless"
  • "Automatic"

コード例:

ImageFiles {
    MCU.resourceImagePixelFormat: "RGB332"
}

注: このプロパティは、MCU.Configで以下のように定義されていれば、QmlProjectファイル内の全ての画像リソースに適用することもできます:

MCU.Config {
    resourceImagePixelFormat: "RGB332"
}

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

このプロパティはQmlProject API 1.3 で導入されました。

QUL_RESOURCE_IMAGE_PIXEL_FORMATも参照してください

特定の Qt ライセンスの下で利用可能です。
詳細はこちら。