ImageLayer QML Type

単一の画像で構成されるレイヤー。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

列挙型

• RenderingHints

プロパティ

• platformId : int
• renderingHints : RenderingHints
• source : image

詳細説明

単一の画像ソースを持つレイヤーを定義します。指定された画像については、ImageFiles.MCU.Experimental.resourceSplitImageOptimization を無効にする必要があります。

画像レイヤーを使用すると、動的なフレームバッファ用にメモリを割り当てることなく、Flash から画面へ静的な画像データを表示できます。

ImageLayer アイテムは、Screen またはSpriteLayer のアイテム内に含まれている必要があります。

使用例：

ApplicationScreens {
    Screen {
        ImageLayer {
            source: "qrc:/images/background.png"
        }
    }
}

プラットフォーム固有の制限事項については、各プラットフォームのボードドキュメントページを参照してください：

• Infineon TRAVEO T2G プラットフォームの制限事項
• Renesas RH850 カスタムレイヤーの要件
• NXP i.MX RT1170 カスタムレイヤーの要件

関連項目： ApplicationScreens 、Screen 、ItemLayer 、SpriteLayer 、および「ハードウェアレイヤーを使用したパフォーマンスの向上」。

列挙に関するドキュメント

RenderingHints

画像のレンダリングに関するレンダリングヒットのリストを提供します

プロパティのドキュメント

platformId : int

プラットフォームに対してレイヤーを識別するための固有の値。

プラットフォーム固有のAPIを使用して、カスタムレイヤーのプロパティを設定するために使用します。

renderingHints : RenderingHints

画像レイヤーのレンダリング最適化に関するヒント。

これらのヒントは、プラットフォーム層エンジンによって、アプリケーションにとって最適な方法でレイヤーを設定するために使用されます。デフォルトのレンダリングヒントはプラットフォームごとに異なります。プラットフォームによってデフォルトが指定されていない場合は、ImageLayer.OptimizeForSize が使用されます。

特定のプラットフォームにおけるレンダリング最適化ヒントの影響については、そのプラットフォームのボードドキュメントページを参照してください：

• Infineon TRAVEO T2G におけるレイヤーごとのレンダリングモードの選択

source : image

url というQMLの基本型はサポートされていないため、image という別の基本型が存在します。これは、ImageLayer オブジェクトのsource プロパティの型です。

ImageLayer 絶対リソースURI（例: "qrc:/images/map.png"）を受け入れます。このリソースを利用可能にするには、qulrcc ツールでコンパイルされている必要があります。

コンパイル時に認識されない文字列がソースとして設定される場合Qt Quick Ultralite は、指定された文字列のリソースハンドルを見つけるために実行時検索を実行します。

たとえば、次のコードでは実行時の検索が行われます。

ImageLayer {
    source: "qrc:/" + "foo.png"
}

検索に失敗した場合、sourceプロパティは空の状態にリセットされ、何もレンダリングされなくなります。

OnDemand キャッシュポリシーで圧縮または設定された画像は、画像キャッシュに保存されるため、使用しないことをお勧めします。画像キャッシュの容量がすべての関連画像を収容するのに十分でない場合、これらの画像が削除される可能性があり、予期しない結果につながる恐れがあります。

「リソースの管理」および「画像リソースの取り扱い」も参照してください 。

特定の Qt ライセンスの下で利用可能です。
詳細はこちら。