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 をエフェクトの親に設定することによって、エフェクトがそれ自身を含むようにすることはサポートされていません。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.