BrightnessContrast QML Type
Ajusta el brillo y el contraste. Más...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propiedades
- brightness : real
- cached : bool
- contrast : real
- source : variant
Descripción detallada
Nota: El componente MultiEffect proporciona un efecto de brillo y contraste con algunas ventajas de rendimiento. Para código nuevo, debería considerarse como una alternativa al uso de Qt Graphical Effects.
Este efecto ajusta los colores del elemento fuente. El ajuste del brillo cambia la luminancia percibida del elemento fuente. El ajuste del contraste aumenta o disminuye las variaciones de color y brillo.
| Fuente | Efecto aplicado |
|---|---|
|
|
Ejemplo
El siguiente ejemplo muestra cómo aplicar el efecto.
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 } }
Documentación de propiedades
brightness : real
Esta propiedad define cuánto aumenta o disminuye el brillo de la fuente.
El valor oscila entre -1,0 y 1,0. Por defecto, la propiedad está establecida en 0.0 (sin cambios).
| Ejemplos de salida con diferentes valores de brillo | ||
|---|---|---|
|
|
|
| brillo: -0.25 | brillo: 0 | brillo: 0.5 |
| contrast: 0 | contrast: 0 | contrast: 0 |
cached : bool
Esta propiedad permite almacenar en caché los píxeles de salida del efecto para mejorar el rendimiento del renderizado.
Cada vez que se cambian las propiedades de la fuente o del efecto, los píxeles de la caché deben actualizarse. El consumo de memoria se incrementa, ya que se requiere un buffer extra de memoria para almacenar la salida del efecto.
Se recomienda desactivar la caché cuando se animen la fuente o las propiedades del efecto.
Por defecto, la propiedad está establecida en false.
contrast : real
Esta propiedad define cuánto se aumenta o disminuye el contraste de la fuente. La disminución del contraste es lineal, pero el aumento se aplica con una curva no lineal para permitir un ajuste del contraste muy alto en el extremo superior del rango de valores.
| Curva de ajuste del contraste |
|---|
|
El valor oscila entre -1,0 y 1,0. Por defecto, la propiedad está ajustada a 0.0 (sin cambios).
| Ejemplos de salida con diferentes valores de contraste | ||
|---|---|---|
|
|
|
| contraste: -0.5 | contraste: 0 | contraste: 0.5 |
| brightness: 0 | brightness: 0 | brightness: 0 |
source : variant
Esta propiedad define el elemento fuente que proporciona los píxeles de origen para el efecto.
Nota: No se admite que el efecto se incluya a sí mismo, por ejemplo estableciendo source como padre del efecto.
© 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.








