このオプションは、静的フォントエンジンにおけるグリフの自動生成を制御します。StaticText アイテムや動的テキストには影響しません。動的テキストの場合、アプリケーション開発者は必要な文字範囲を明示的に定義する必要があります。StaticText アイテムは、MCU.Config.autoGenerateGlyphs の設定にかかわらず、グリフの選択を自動的に処理します。

説明

デフォルトでは、このプロパティはtrue に設定されており、使用されるすべてのフォント構成において、アプリケーションで使用されるすべての文字のグリフが生成されます。これは、通常、手動でのカバレッジ調整を必要とせず「そのまま動作する」ため、開発時には便利です。

本番環境での展開において、フォントのカバレッジを微調整し、ROMの使用量を最小限に抑えたい場合は、このプロパティをfalse に設定することを推奨します。この場合、fontcompilerは font.unicodeCoverage で定義された文字に対してのみグリフを生成します。

自動生成モードでの事前定義セット

MCU.Config.autoGenerateGlyphs が有効になっている場合、フォントコンパイラはアプリケーションから収集したグリフに加えて、小さな事前定義済み文字セットを自動的に挿入します。これにより、明示的な設定を必要とせずに、一般的なUIパターン（数字、記号、科学表記、省略記号）に対する堅牢性が向上します。

事前定義された文字セットには、常に数字、一般的な数値記号、および U+2026 水平省略記号が含まれます。

const QString predefinedCharacterSet =
    QString("0123456789-+.e") + QChar(0x2026);

自動生成モードにおけるソフトハイフンおよびハイフン候補

ソフトハイフンのサポートは、Qt Quick Ultralite 3.0 以降で利用可能であり、2.12.x シリーズではQt Quick Ultralite 2.12.2 以降で利用可能です。

自動生成モードでは、フォントコンパイラがソフトハイフンの表示に使用できるハイフングリフが存在することを確認します。コンパイラは単一のコードポイントに依存するのではなく、事前に定義されたハイフン候補のリストを参照し、選択されたフォントに存在する最初の候補を追加します。

この検索はタイポグラフィを優先する方式で、専用のハイフン（U+2010）が ASCII ハイフン（U+002D）よりも優先されます。 ソフトハイフンのコードポイント (U+00AD) は、多くのフォントでプレースホルダーやその他の望ましくないグリフにマッピングされているため、あくまで最後の手段としてのみ使用されます。

手動モード

MCU.Config.autoGenerateGlyphs が `false` の場合、追加のグリフは暗黙的に追加されません。アプリケーションがソフトハイフンの動作に依存している場合は、設定された文字セットに適切なハイフンコードポイントを明示的に含める必要があります。

前のセクションにリストされている候補のいずれかを選択できます。実行時、フォントエンジンは、使用するハイフングリフを選択する際に、同じ候補順序を使用します。つまり、フォント内で最初に利用可能な候補が選択されます。

使用方法

このプロパティは、メインアプリケーションの.qmlproject ファイルで指定できます。ブール値をとり、デフォルト値はtrue です。

コード例

MCU.Config {
    autoGenerateGlyphs: false
}

このプロパティは

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