GammaAdjust QML Type
Altera la luminancia del elemento fuente. Más...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propiedades
Descripción detallada
GammaAdjust se aplica a cada píxel según la curva predefinida como una expresión de ley de potencia, donde la propiedad gamma se utiliza como exponente de escala recíproca. Consulte la documentación de la propiedad gamma para más detalles.
| 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 } GammaAdjust { anchors.fill: bug source: bug gamma: 0.45 } }
Documentación de la propiedad
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.
gamma : real
Esta propiedad define el factor de cambio de cómo se altera la luminancia de cada píxel según la ecuación:
luminance = pow(original_luminance, 1.0 / gamma); // The luminance is assumed to be between 0.0 and 1.0
Establecer los valores gamma por debajo de 1.0 oscurece la imagen, los valores por encima de 1.0 la aclaran.
El valor oscila entre 0,0 (más oscuro) e inf (más claro). Por defecto, la propiedad está establecida en 1.0 (sin cambios).
| Ejemplos de salida con diferentes valores gamma | ||
|---|---|---|
|
|
|
| gamma: 0.5 | gamma: 1.0 | gamma: 2.0 |
| Curvas de luminancia de píxeles de las imágenes anteriores. | ||
|---|---|---|
|
|
|
| Curva roja: gamma por defecto (1.0) | ||
| Curva amarilla: efecto aplicado | ||
| Eje X: luminancia original del píxel | ||
| Eje Y: luminancia del píxel con el efecto aplicado |
source : variant
Esta propiedad define el elemento fuente para el que se va a ajustar la luminancia.
Nota: No se admite que el efecto se incluya a sí mismo, por ejemplo, estableciendo fuente en el 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.







