SpriteLayer QML Type

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

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

列挙型

• ColorDepth

プロパティ

• depth : ColorDepth
• platformId : int

詳細説明

スプライトレイヤーには、複数の画像レイヤーやアイテムレイヤーを含めることができ、これらはスプライトまたはサブレイヤーと呼ばれます。

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

• スプライトレイヤーごとに含まれるサブレイヤーの数は制限されており、通常は8つ以下です
• サブレイヤーの不透明度は無視されます。
• 重なり合うサブレイヤーは合成されず、最上層のサブレイヤーのピクセルのみが表示されます。
• Infineon TRAVEO T2Gプラットフォームでは：
  • 最大5つのルートレイヤーがサポートされており、そのうち最大3つまでが「SpriteLayer 」レイヤータイプに設定可能です。
  • SpriteLayer には、最大8つのサブレイヤーを含めることができます。つまり、サブレイヤーとルートレイヤーの組み合わせにおいて、アプリケーションが持つことができるItemLayer またはImageLayer のインスタンスは、最大26個までとなります。
• 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ライセンスの下で利用可能です。
詳細はこちらをご覧ください。