BrightnessContrast QML Type
明るさとコントラストを調整します。詳細…
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
プロパティ
- brightness : real
- cached : bool
- contrast : real
- source : variant
詳細な説明
注: 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 (変更なし)に設定されています。
cached : bool
このプロパティを使用すると、エフェクトの出力ピクセルをキャッシュし、レンダリング性能を向上させることができます。
ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクトの出力を保存するために追加のメモリバッファが必要となるため、メモリ消費量が増加します。
ソースやエフェクトのプロパティがアニメーション化される場合は、キャッシュを無効にすることをお勧めします。
デフォルトでは、このプロパティは「false 」に設定されています。
contrast : real
このプロパティは、ソースのコントラストをどの程度増減させるかを定義します。コントラストの減少は線形ですが、増加は非線形の曲線に基づいて適用されるため、値の範囲の上限付近で非常に高いコントラスト調整が可能になります。
| コントラスト調整曲線 |
|---|
|
値の範囲は-1.0から1.0です。デフォルトでは、このプロパティは0.0 (変更なし)に設定されています。
| 異なるコントラスト値での出力例 | ||
|---|---|---|
|
|
|
| contrast: -0.5 | contrast: 0 | コントラスト: 0.5 |
| brightness: 0 | brightness: 0 | brightness: 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.








