BrightnessContrast QML Type

明るさとコントラストを調整します。もっと見る...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

プロパティ

詳細説明

このエフェクトは、ソースアイテムの色を調整します。明るさの調整は、ソースアイテムの知覚される輝度を変更します。コントラスト調整は、色と明るさの変化を増減します。

ソース適用される効果

適用例

次の例は、効果を適用する方法を示しています。

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

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

    BrightnessContrast {
        anchors.fill: bug
        source: bug
        brightness: 0.5
        contrast: 0.5
    }
}

プロパティの説明

brightness : real

このプロパティは、ソースの明るさの増減を定義します。

値の範囲は-1.0~1.0です。デフォルトでは、このプロパティは0.0 (変化なし)に設定されています。

明るさの値を変えた出力例

明るさ:-0.25 明るさ:0 明るさ:0.5
contrast:0contrast:0contrast:0

cached : bool

このプロパティは、レンダリングのパフォーマンスを向上させるために、エフェクトの出力ピクセルをキャッシュできるようにします。

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

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

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


contrast : real

このプロパティは、ソースのコントラストを増減する量を定義します。コントラストの減少は線形ですが、増加は、値の範囲の高端で非常に高いコントラスト調整を可能にするために、非線形曲線で適用されます。

コントラスト調整カーブ

値の範囲は-1.0~1.0です。デフォルトでは、このプロパティは0.0 (変化なし)に設定されています。

コントラスト値を変えた出力例

コントラスト:-0.5 コントラスト:0 コントラスト: 0.5
brightness:0brightness:0brightness:0

source : variant

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

注意: 例えば、source をエフェクトの親に設定することで、エフェクト自身を含めることはサポートされていません。


©2024 The Qt Company Ltd. ここに含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。