InnerShadow QML Type

ソース内部に、色付けされ、ぼかされた影を生成します。詳細...

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

プロパティ

• cached : bool
• color : color
• fast : bool
• horizontalOffset : real
• radius : real
• samples : int
• source : variant
• spread : real
• verticalOffset : real

詳細説明

デフォルトでは、このエフェクトは高品質な影画像を生成するため、影のレンダリング速度は必ずしも最高とは限りません。特に影のエッジが大幅にソフト化されている場合、レンダリング速度は低下します。より高速なレンダリング速度が必要であり、かつ最高レベルの画質が必須ではない用途では、プロパティ「fast 」を「true」に設定することができます。

例

以下の例は、このエフェクトを適用する方法を示しています。

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Rectangle {
        anchors.fill: parent
    }

    Image {
        id: butterfly
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    InnerShadow {
        anchors.fill: butterfly
        radius: 8.0
        samples: 16
        horizontalOffset: -3
        verticalOffset: 3
        color: "#b0000000"
        source: butterfly
    }
}

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

cached : bool

このプロパティを有効にすると、エフェクトの出力ピクセルがキャッシュされ、レンダリング性能が向上します。ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクトの出力を保存するために追加のメモリバッファが必要となるため、メモリ消費量が増加します。

ソースまたはエフェクトのプロパティがアニメーション化される場合は、キャッシュを無効にすることをお勧めします。

デフォルトでは、このプロパティはfalse に設定されています。

color : color

このプロパティは、影に使用されるRGBAカラー値を定義します。

デフォルトでは、このプロパティは"black" に設定されています。

fast : bool

このプロパティは、エフェクトのぼかし効果を生み出すために使用されるぼかしアルゴリズムを選択します。このプロパティを「true」に設定すると高速なアルゴリズムが有効になり、「false」に設定するとより高品質な結果が得られます。

デフォルトでは、このプロパティは「false 」に設定されています。

horizontalOffset : real

HorizontalOffset およびverticalOffset プロパティは、InnerShadow アイテムの位置に対する、レンダリングされる影のオフセットを定義します。 多くの場合、InnerShadow アイテムは、ソース要素全体を覆うように配置されます。この場合、HorizontalOffsetプロパティとverticalOffset プロパティが0に設定されていると、影はソースアイテムの内部に完全に描画されます。オフセットプロパティを変更することで、影をソースアイテムに対して相対的な位置に配置することができます。

値の範囲は -inf から inf です。デフォルトでは、これらのプロパティは0 に設定されています。

radius : real

半径は、影の柔らかさを決定します。半径を大きくすると、影の縁がよりぼやけて見えるようになります。

半径の値に応じて、視覚的な品質を確保するために「samples 」の値を十分に大きく設定する必要があります。

値の範囲は 0.0（ぼかしなし）から inf までです。デフォルトでは、このプロパティは `0.0 `（ぼかしなし）に設定されています。

samples : int

このプロパティは、エッジソフトニングのぼかし計算を行う際に、1ピクセルあたり何サンプルを取得するかを定義します。値が大きいほど画質は向上しますが、レンダリングに時間がかかります。

理想的には、この値は必要な最大半径値の2倍に設定すべきです。たとえば、半径が0.0から4.0の間でアニメーションされる場合、サンプル数は8に設定する必要があります。

値の範囲は0から32です。デフォルトでは、このプロパティは0 に設定されています。

このプロパティはアニメーション化されることを意図していません。このプロパティを変更すると、基盤となる OpenGL シェーダーが再コンパイルされる場合があります。

fast プロパティが true に設定されている場合、このプロパティは効果を持ちません。

source : variant

このプロパティは、生成されるシャドウのソースとして使用されるソース項目を定義します。

spread : real

このプロパティは、光源の縁付近で影の色がどの程度強調されるかを定義します。

値の範囲は 0.0 から 1.0 です。デフォルトでは、このプロパティは0.5 に設定されています。

verticalOffset : real

HorizontalOffset および verticalOffset プロパティは、InnerShadow アイテムの位置に対する、レンダリングされた影のオフセットを定義します。 多くの場合、InnerShadow アイテムは、ソース要素いっぱいに収まるようにアンカー設定されています。この場合、HorizontalOffsetおよびverticalOffsetプロパティが0に設定されていると、影はソースアイテムの内部に完全にレンダリングされます。オフセットプロパティを変更することで、影をソースアイテムに対して相対的な位置に配置することができます。

値の範囲は-infからinfまでです。デフォルトでは、これらのプロパティは0 に設定されています。