SpriteLayer QML Type

複数の画像レイヤーやアイテムレイヤーを含むことができるスプライトレイヤー。詳細...

• 継承されたメンバを含む全メンバのリスト

列挙

• ColorDepth

プロパティ

• depth : ColorDepth
• platformId : int

詳細説明

スプライトレイヤーは、複数のイメージレイヤーとアイテムレイヤーを含むことができ、それらはスプライトまたはサブレイヤーと呼ばれます。

ほとんどのハードウェアプラットフォームでは、アプリケーションが持つことのできるルートレイヤーの数が制限されています。しかし、スプライトレイヤーを使用することで、メモリを節約することができます。スプライトレイヤーは便利ですが、次のような制限があります：

• スプライト・レイヤー1枚あたりのサブレイヤー数には制限があり、通常は8枚以下です。
• サブレイヤーの不透明度は無視されます。
• 重なり合ったサブレイヤーはブレンドされず、一番上のサブレイヤーのピクセルのみが表示されます。
• Infineon TRAVEO T2Gプラットフォーム：
  • 最大5つのルートレイヤーがサポートされ、そのうち最大3つのレイヤーがSpriteLayer 。
  • SpriteLayer 、最大8つのサブレイヤーを持つことができる。つまり、アプリケーションは、サブレイヤーとルートレイヤーの組み合わせで、26個を超えるItemLayer またはImageLayer インスタンスを持つことはできません。
• Renesas RH850プラットフォームの場合：
  • スプライトの色深度はハードウェアレイヤーと互換性がなければなりません。
  • スプライトのX位置は、色深度32ビットのレイヤーでは2ピクセルの倍数に丸められ、色深度16ビットのレイヤーでは4ピクセルに丸められます。

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

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

SpriteLayer アイテムは、Screen アイテムの中に含まれていなければなりません。

使用例

ApplicationScreens {
    Screen {
        SpriteLayer {
            x: 10
            y: 60

            width: 100
            height: 100

            ImageLayer {
                y: 20
                source: "qrc:/images/splash.png"
            }

            ItemLayer {
                y: 40

                width: 100
                height: 60

                Text {
                    text: "Hello World"
                    anchors.centerIn: parent
                }
            }
        }
    }
}

ApplicationScreens 、Screen 、ImageLayer 、ItemLayer 、ハードウェアレイヤーを使用したパフォーマンスの向上も参照 。

列挙ドキュメント

ColorDepth

色の濃さの選択肢のリストを提供する。

プロパティ文書

depth : ColorDepth [default]

レイヤーに使用する色の濃さ。

platformId : int

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

プラットフォーム固有の API で、カスタムレイヤープロパティを設定します。

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