画像リソースにバイナリ・アセット・データを含める方法を定義します。

説明

この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 で導入されました。