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 でのSpriteLayer 、ImageLayer 、および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ライセンスの下で利用可能です。
詳細はこちらをご覧ください。