このページでは

C

ItemLayer QML Type

動的なQt Quick Ultraliteアイテムを含むレイヤー。詳細...

Import Statement: import QtQuickUltralite.Layers
Since: Qt Quick Ultralite 1.7
Inherits:

Item

列挙型

プロパティ

詳細説明

Qt Quick のUltraliteアイテムを表示できるレイヤーを定義します。

複数のアイテムレイヤーを使用することで、ビット深度を下げたり、単一のアイテムレイヤーの代わりにサイズの小さいアイテムレイヤーを使用したりして、メモリ使用量を削減できます。後者の方法は、UI上にコンテンツのない大きな隙間がある場合に使用されます。

また、refreshInterval プロパティを使用して、特定のレイヤーのフレームレートを下げることも可能です。これにより、CPU および GPU の使用率が低下し、優先度の高いレイヤーでのアニメーションがスムーズに実行され続けます。

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

使用例:

ApplicationScreens {
    Screen {
        ItemLayer {
            width: 400
            height: 400

            depth: ItemLayer.Bpp16

            Rectangle {
                anchors.fill: parent
                color: "#3d464d"
            }

            Image {
                anchors.centerIn: parent
                source: "qrc:/images/hello.png"
            }
        }
    }
}

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

注:この 機能、すべてのリファレンスボードのハードウェアでサポートされているとは限りません。詳細については、「サポートされている機能」の表を参照してください。

注:この タイプ Qt Quick Ultraliteに固有のものです。互換性ページも参照してください。

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

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

ColorDepth

色深度の選択肢の一覧を表示します。

定数説明
ItemLayer.Bpp81ピクセルあたり8ビットの色深度、アルファチャンネルなし
ItemLayer.Bpp161 ピクセルあたり 16 ビットの色深度、アルファチャンネルなし
ItemLayer.Bpp16Alpha1 ピクセルあたり 16 ビットの色深度、アルファチャンネルあり
ItemLayer.Bpp241ピクセルあたり24ビットの色深度、アルファチャンネルなし
ItemLayer.Bpp32ピクセルあたり32ビットの色深度、アルファチャンネルなし
ItemLayer.Bpp32Alpha1ピクセルあたり32ビットの色深度、アルファチャンネルあり

RenderingHints

リストまたはレンダリングのヒントを提供します。

定数説明
ItemLayer.NoRenderingHintレンダリングのヒントが指定されていない
ItemLayer.OptimizeForSpeedレイヤーは高速なレンダリング用に最適化されています
ItemLayer.OptimizeForSizeレイヤーは、メモリ使用量を抑えるように最適化されています

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

depth : ColorDepth [default]

そのレイヤーに使用する推奨の色深度。

platformId : int

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

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

refreshInterval : int

レイヤーの再描画間隔(フレーム単位)を指定する値。

リフレッシュレートが低くても更新による視覚的な影響が許容範囲内であれば、アニメーションレイヤーを毎フレーム再描画しないことでパフォーマンスを向上させることができます。

たとえば、この値を2 に設定すると、レイヤーの内容は2フレームに1回だけ再描画されます。

renderingHints : RenderingHints

アイテムレイヤーのレンダリング最適化ヒント。

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

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

特定の Qt ライセンスの下で利用可能です。
詳細はこちらをご覧ください。