LevelAdjust QML Type

RGBA色空間における色レベルを調整します。詳細...

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

プロパティ

• cached : bool
• gamma : variant
• maximumInput : color
• maximumOutput : color
• minimumInput : color
• minimumOutput : color
• source : variant

詳細説明

このエフェクトでは、ソース項目の色を各色チャンネルごとに個別に調整します。ソース項目のコントラストを調整したり、カラーバランスを変更したりすることができます。

例

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

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

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

    LevelAdjust {
        anchors.fill: butterfly
        source: butterfly
        minimumOutput: "#00ffffff"
        maximumOutput: "#ff000000"
    }
}

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

cached : bool

このプロパティを使用すると、エフェクトの出力ピクセルをキャッシュして、レンダリング性能を向上させることができます。

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

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

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

gamma : variant

このプロパティは、次の式に従って各ピクセルのカラーチャネルの値がどのように変化するかを決定する変化係数を定義します。

result.rgb = pow(original.rgb, 1.0 / gamma.rgb);

QtVector3d(1.0, 1.0, 1.0) 以下のガンマ値を設定すると画像は暗くなり、QtVector3d(1.0, 1.0, 1.0) を超えると明るくなります。

値の範囲は、QtVector3d(0.0, 0.0, 0.0)（最も暗い）から inf（最も明るい）までです。デフォルトでは、このプロパティはQtVector3d(1.0, 1.0, 1.0) （変更なし）に設定されています。

maximumInput : color

このプロパティは、各色チャンネルの最大入力レベルを定義します。これは白色点を設定するもので、このプロパティよりも値が大きいすべてのピクセルは（各色チャンネルごとに）白としてレンダリングされます。この値を小さくすると、明るい部分がさらに明るくなります。

値の範囲は「#ffffffff」から「#00000000」です。デフォルトでは、このプロパティは"#ffffffff" に設定されています（変更なし）。

maximumOutput : color

このプロパティは、各カラーチャンネルの最大出力レベルを定義します。この値を小さくすると、明るい部分が暗くなり、コントラストが低下します。

値の範囲は「#ffffffff」から「#00000000」です。デフォルトでは、このプロパティは"#ffffffff" に設定されています（変更なし）。

minimumInput : color

このプロパティは、各カラーチャンネルの最小入力レベルを定義します。これは黒点を設定するもので、このプロパティよりも値が低いすべてのピクセルは（各カラーチャンネルごとに）黒として描画されます。この値を大きくすると、暗い部分がさらに暗くなります。

値の範囲は「#00000000」から「#ffffffff」です。デフォルトでは、このプロパティは"#00000000" に設定されています（変更なし）。

minimumOutput : color

このプロパティは、各カラーチャンネルの最小出力レベルを定義します。この値を大きくすると、暗い部分が明るくなり、コントラストが低下します。

値の範囲は「#00000000」から「#ffffffff」です。デフォルトでは、このプロパティは"#00000000" に設定されています（変更なし）。

source : variant

このプロパティは、エフェクトのソースピクセルを提供するソースアイテムを定義します。