このページでは

BrightnessContrast QML Type

明るさとコントラストを調整します。詳細…

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

Item

プロパティ

詳細な説明

注: MultiEffect コンポーネントは 、パフォーマンス面でいくつかの利点を持つ輝度およびコントラスト効果を提供します。新規にコードを作成する場合は、Qt XMLのGraphical Effects を使用する代わりに、このコンポーネントの利用を検討すべきです。

このエフェクトは、ソース項目の色を調整します。輝度調整により、ソース項目の知覚される輝度が変化します。コントラスト調整により、色や輝度の変化の度合いが増減します。

ソースエフェクト適用後

葉の上の黒いカブトムシ

明るさとコントラストを調整したカブトムシ

例

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

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.5

brightness: -0.25 brightness: 0 brightness: 0.5
contrast: 0contrast: 0contrast: 0

cached : bool

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

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

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

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

contrast : real

このプロパティは、ソースのコントラストをどの程度増減させるかを定義します。コントラストの減少は線形ですが、増加は非線形の曲線に基づいて適用されるため、値の範囲の上限付近で非常に高いコントラスト調整が可能になります。

コントラスト調整曲線

コントラスト調整曲線を示すグラフ

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

異なるコントラスト値での出力例

コントラストが低下したカブトムシ

通常のコントラストでのカブトムシ

コントラストが強調されたカブトムシ

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

source : variant

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

注: エフェクトの親をソースに設定するなどして、エフェクトが自分自身を含めるようにすることは サポートされていません。

© 2026 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.