C
プラットフォームのデフォルト変数の定義
プラットフォームのデフォルト変数を定義するために、QMLプロジェクトの設定ファイルを作成する必要があります。
プラットフォームポートには、ボードやディスプレイの構成に応じて、BoardDefaults.qmlprojectconfig ファイルを複数作成することができます。すべての設定をサポートするために、以下の命名規則を使用してください:
BoardDefaults_<color_depth>bpp<_default>.qmlprojectconfig
という命名規則を使用してください:
color_depthの値は、QUL_COLOR_DEPTHCMake 変数に設定する必要があります。この値は、プラットフォームcmakeディレクトリに複数の qmlprojectconfig ファイルがある場合に、利用可能なコンフィギュレーションを選択するためにも使用されます。- 複数のコンフィギュレーションがある場合、デフォルトのコンフィギュレーションを示すために、そのうちの1つに
defaultキーワードを使用します。
次の表は、さまざまなシナリオ例と、それに対応するコンフィギュレーションファイル名について説明したものです:
| シナリオ | 動作 |
|---|---|
BoardDefaults.qmlprojectconfig ファイルが 1 つだけ存在する。
| color_depth の情報がファイル名の一部でないこのようなシナリオでは、CMake コマンドにQUL_COLOR_DEPTHオプションを明示的に指定します。 |
BoardDefaults_<color_depth>.qmlprojectconfig ファイルは1つしか存在しません。
| ファイル名にcolor_depth の情報を含むコンフィギュレーションを使用する場合、CMake コマンドに-DQUL_COLOR_DEPTH オプションを指定する必要はありません。 |
複数のBoardDefaults_<color_depth>.qmlprojectconfig ファイルが存在します。そのどれにもdefault キーワードが含まれていません。
| 複数の qmlprojectconfig ファイルがファイル名にcolor_depth 情報を含むこのシナリオでは、CMake コマンドにQUL_COLOR_DEPTHオプションを明示的に指定します。 |
複数のBoardDefaults_<color_depth>.qmlprojectconfig ファイルが存在します。そのうちの 1 つにdefault キーワードが含まれています。
| コンフィギュレーションのいずれかがファイル名にdefault キーワードを含む場合、それが自動的に選択されます。別のものを選択するには、CMakeコマンドにQUL_COLOR_DEPTHオプションを明示的に指定します。 |
注意: qmlprojectconfig ファイルが規約に従って命名されていない場合は、CMake コマンドに-DQUL_PLATFORM_BOARD_DEFAULTS_QMLPROJECTCONFIG=<path_to_qmlprojectconfig_file> オプションを明示的に指定してください。
最小限の設定ファイルを以下に示す。ITは、少なくともあなたのプラットフォームで使用するカラーフォーマットを指定する必要があります:
import QmlProject 1.2
Project {
MCU.Config {
platformAlphaPixelFormat: "ARGB8888"
platformOpaquePixelFormat: "RGB565"
}
}これらの説明やその他のオプションについてはQmlProjectのマニュアルを参照してください。