このページでは

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でSpriteLayerImageLayerItemLayer APIが導入されたため、どのレイヤーで使用するかによって画像のピクセルフォーマットを選択する必要があるかもしれません。特定のプラットフォーム(RH850など)では、スプライトレイヤーは、含まれるすべてのアイテムとイメージレイヤーが互換性のあるピクセルフォーマットを持つ必要があります。また、16ビットのアイテムレイヤーに不透明なイメージを表示する場合、イメージに32ビットの色深度を使用するのは無駄かもしれません。

このプロパティは、画像の優先ピクセルフォーマットを設定することができる。

画像に要求されるピクセルフォーマットは、画像の内容と一致しなければならない。例えば、アルファチャンネルを持つイメージのピクセルフォーマット RGB888 は不可能である。

可能な値は

  • XRGB8888
  • RGB888
  • RGB565
  • RGB332
  • ARGB8888
  • ARGB4444
  • アルファ8
  • RGB888RLE
  • XRGB8888RLE
  • ARGB8888RLE
  • 自動圧縮ロスレス
  • 自動

デフォルト値は "Automatic "です。

ピクセルフォーマット RGB888RLE ・ XRGB8888RLE ・ ARGB888RLE は、 可逆ランレングス符号化 (RLE) 圧縮アルゴ リ ズ ム を用いた画像専用です。QUL_RESOURCE_COMPRESSION を使用した画像とは異なり、これらの画像はレンダリング中にその場でデコードされるため、追加のストレージを必要としません。RLE ピクセル形式では、スケール、回転、シアー、透視変換がサポートされないという制限があります。

ピクセル フォーマットAutomaticCompressedLossless を使用すると、リソース コンパイラーは、画像のコンテンツ (不透明または透明) とプラットフォームのデフォルト値(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 ライセンスによっては利用可能です。