このページについて

C

QUL_RESOURCE_IMAGE_PIXEL_FORMAT

警告: この CMake ソースプロパティは 2.4 以降で非推奨となっています。代わりにImageFiles.MCU.resourceImagePixelFormatの使用をご検討ください。

注:ボードの デフォルト値は、BoardDefaults.qmlprojectconfig ファイル内のQmlProject を使用して設定できます。プラットフォームのデフォルト変数の定義およびQmlProjectマニュアルを参照してください。

説明

デフォルトでは、Qt Quick Ultralite は、プラットフォーム設定およびソース画像のプロパティに基づいて、画像に最適なピクセル形式を自動的に選択しようとします。

画像の出力品質、バイナリサイズ、およびアプリケーションのメモリ使用量のバランスをとるために、画像のピクセル形式を変更することができます。

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

注: QUL_RESOURCE_IMAGE_PIXEL_FORMAT が RGB332 に設定された画像は Qt Quick Ultralite リファレンスプラットフォームのいずれにおいても、ハードウェアアクセラレーションを使用してレンダリングされません。これにより、レンダリング速度(1秒あたりのフレーム数)の観点から、アプリケーションのパフォーマンスが最適でなくなる可能性があります。

Qt Quick Ultralite 1.7でのSpriteLayerImageLayer 、およびItemLayer APIの導入に伴い、画像を使用するレイヤーに応じてピクセル形式を選択する必要が生じる場合があります。特定のプラットフォーム(RH850など)では、スプライトレイヤーに含まれるすべてのアイテムおよび画像レイヤーが互換性のあるピクセル形式である必要があります。 また、不透明な画像を16ビットのアイテムレイヤーで表示する場合、その画像に32ビットの色深度を使用するのは無駄になる可能性があります。

このプロパティを使用すると、画像に最適なピクセルフォーマットを設定できます。

画像に指定するピクセル形式は、画像の内容と一致している必要があります。例えば、アルファチャンネルを持つ画像に対してピクセル形式「RGB888」を指定することはできません。

指定可能な値は次のとおりです。

  • XRGB8888
  • RGB888
  • RGB565
  • RGB332
  • ARGB8888
  • ARGB4444
  • Alpha8
  • RGB888RLE
  • XRGB8888RLE
  • ARGB8888RLE
  • 自動圧縮ロスレス
  • 自動

デフォルト値は「自動」です。

ピクセル形式 RGB888RLE、XRGB8888RLE、および ARGB888RLE は、ロスレスランレングス符号化 (RLE) 圧縮アルゴリズムを使用する画像専用です。QUL_RESOURCE_COMPRESSION を使用する画像とは異なり、これらの画像はレンダリング中にオンザフライでデコードされるため、追加のストレージは必要ありません。制限として、RLE ピクセル形式では、拡大縮小、回転、せん断、および透視変換がサポートされていません。

ピクセルフォーマット `AutomaticCompressedLossless ` を使用すると、Resource Compilerは、画像の内容(不透明または透明)およびプラットフォームのデフォルト値に基づいて、ロスレス圧縮用のピクセルフォーマットを自動的に選択できます (QUL_PLATFORM_DEFAULT_RESOURCE_COMPRESSED_LOSSLESS_PIXEL_FORMAT_OPAQUEまたはQUL_PLATFORM_DEFAULT_RESOURCE_COMPRESSED_LOSSLESS_PIXEL_FORMAT_ALPHA)に基づいて、リソースコンパイラが自動的に非可逆圧縮用のピクセルフォーマットを選択できるようにします。

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

このプロパティは

このプロパティは、Qt Quick Ultralite 2.0で導入されました。

デフォルトのリソースプロパティも参照してください

特定のQtライセンスの下で利用可能です。
詳細はこちらをご覧ください。