このページについて

C

MCU.Config.binaryAssetOptions

画像リソースのバイナリアセットデータをどのように組み込むかを定義します。

説明

この QmlProject プロパティは、画像リソースのバイナリアセットデータをアプリケーションバイナリに組み込む方法を制御します。

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

  • COMPILE - `qulrcc `:生成された C++ ファイル(qulrcc_assets.cpp )内で、バイナリアセットデータを `uint64_t ` 値の配列として出力します。このオプションを選択すると、コンパイル時間が長くなる可能性があり、C++ ファイルが大きくなりすぎるとコンパイラがメモリ不足になる場合があります。
  • SYMBOLS - カスタムリンカーオプションを使用して、生成されたアセットデータバイナリファイルから直接、各ストレージセクションに必要なシンボルを提供します。このオプションは、IARおよびGreenHillsのコンパイラツールチェーンでのみサポートされています。また、GreenHillsのコンパイラツールチェーンを使用する場合は、リンカースクリプトに若干の変更が必要です。
  • INCBIN - `qulrcc ` はアセンブリソースファイル(qulrcc_assets_s.S )を生成し、`incbin ` ディレクティブを使用してアセットバイナリファイルをロードします。このオプションは、GCC コンパイラツールチェーンでのみサポートされています。

GreenHillsでの変数の使用

SYMBOLS オプションは、rawimport リンカオプションと組み合わせて使用し、アセットバイナリファイルを含めます。さらに、リンカスクリプトでは、アセットバイナリデータを対応するセクションに配置し、対応するシンボルを指定する必要があります。

以下は、デフォルトの"QulResourceData" リソース格納セクションの例です。

QulResourceData ALIGN(128) :{qul_resources_QulResourceData.bin(.raw)} >.
qul_resources_QulResourceData_instance = addr(QulResourceData);

Greenhills ツールチェーンをサポートするリファレンスプラットフォーム用のリンカースクリプトには、必要な変更が反映されています。

使用方法

このプロパティは、メインアプリケーションの.qmlproject ファイル、またはターゲットプラットフォーム用のBoardDefaults.qmlprojectconfig で指定できます。引数として文字列を受け取り、デフォルト値は"Automatic" です。

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

  • "Automatic"
  • "incbin"
  • "symbols"
  • "winresource"
  • "compile"

コード例:

MCU.Config {
    binaryAssetOptions: "symbols"
}

このプロパティは

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

ImageFiles.MCU.resourceStorageSectionおよびQUL_BINARY_ASSET_OPTIONSも参照してください

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