このページでは

C

プラットフォームのデフォルト変数の定義

プラットフォームのデフォルト変数を定義するために、QMLプロジェクトの設定ファイルを作成する必要があります。

プラットフォームポートには、ボードやディスプレイの構成に応じて、BoardDefaults.qmlprojectconfig ファイルを複数作成することができます。すべての設定をサポートするために、以下の命名規則を使用してください:

BoardDefaults_<color_depth>bpp<_default>.qmlprojectconfig

という命名規則を使用してください:

  • color_depth の値は、QUL_COLOR_DEPTHCMake 変数に設定する必要があります。この値は、プラットフォームcmake ディレクトリに複数の qmlprojectconfig ファイルがある場合に、利用可能なコンフィギュレーションを選択するためにも使用されます。
  • 複数のコンフィギュレーションがある場合、デフォルトのコンフィギュレーションを示すために、そのうちの1つにdefault キーワードを使用します。

次の表は、さまざまなシナリオ例と、それに対応するコンフィギュレーションファイル名について説明したものです:

シナリオ動作
BoardDefaults.qmlprojectconfig ファイルが 1 つだけ存在する。
  • 📁 cmake
    • 🗎 BoardDefaults.qmlprojectconfig
color_depth の情報がファイル名の一部でないこのようなシナリオでは、CMake コマンドにQUL_COLOR_DEPTHオプションを明示的に指定します。
BoardDefaults_<color_depth>.qmlprojectconfig ファイルは1つしか存在しません。
  • 📁 cmake
    • 🗎 BoardDefaults_32bpp.qmlprojectconfig
ファイル名にcolor_depth の情報を含むコンフィギュレーションを使用する場合、CMake コマンドに-DQUL_COLOR_DEPTH オプションを指定する必要はありません。
複数のBoardDefaults_<color_depth>.qmlprojectconfig ファイルが存在します。そのどれにもdefault キーワードが含まれていません。
  • 📁 cmake
    • 🗎 BoardDefaults_8bpp.qmlprojectconfig
    • 🗎 BoardDefaults_16bpp.qmlprojectconfig
    • 🗎 BoardDefaults_32bpp.qmlprojectconfig
複数の qmlprojectconfig ファイルがファイル名にcolor_depth 情報を含むこのシナリオでは、CMake コマンドにQUL_COLOR_DEPTHオプションを明示的に指定します。
複数のBoardDefaults_<color_depth>.qmlprojectconfig ファイルが存在します。そのうちの 1 つにdefault キーワードが含まれています。
  • 📁 cmake
    • 🗎 BoardDefaults_8bpp_default.qmlprojectconfig
    • 🗎 BoardDefaults_16bpp.qmlprojectconfig
    • 🗎 BoardDefaults_32bpp.qmlprojectconfig
コンフィギュレーションのいずれかがファイル名に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のマニュアルを参照してください。


Qt のライセンスによっては利用可能です。