BrightnessContrast QML Type
明るさとコントラストを調整します。もっと見る...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
プロパティ
- brightness : real
- cached : bool
- contrast : real
- source : variant
詳細説明
注意: MultiEffect コンポーネントは、いくつかのパフォーマンス上の利点を持つ明るさとコントラスト効果を提供します。新しいコードでは、QtGraphical 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 (変更なし)に設定されています。
cached : bool
このプロパティは、レンダリングのパフォーマンスを向上させるために、エフェクトの出力ピクセルをキャッシュできるようにします。
ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクト出力を保存するために余分なメモリバッファが必要になるため、メモリ消費量が増加します。
ソースまたはエフェクトプロパティがアニメーションするときは、キャッシュを無効にすることをお勧めします。
デフォルトでは、このプロパティはfalse に設定されています。
contrast : real
このプロパティは、ソースのコントラストをどの程度増減するかを定義する。コントラストの減少は線形であるが、増加は、値の範囲のハイエンドで非常に高いコントラスト調整を可能にするために、非線形曲線で適用される。
| コントラスト調整カーブ |
|---|
|
値の範囲は-1.0~1.0です。デフォルトでは、このプロパティは0.0 (変化なし)に設定されています。
| コントラスト値を変えた出力例 | ||
|---|---|---|
|
|
|
| コントラスト:-0.5 | コントラスト:0 | コントラスト: 0.5 |
| brightness:0 | brightness:0 | brightness:0 |
source : variant
このプロパティは、エフェクトのソースピクセルを提供するソースアイテムを定義します。
注意: 例えば source をエフェクトの親に設定するなど、エフェクトに自分自身を含めることはサポートされていません。
© 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.








