LevelAdjust QML Type
Ajusta los niveles de color en el espacio de color RGBA. Más...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propiedades
- cached : bool
- gamma : variant
- maximumInput : color
- maximumOutput : color
- minimumInput : color
- minimumOutput : color
- source : variant
Descripción detallada
Este efecto ajusta los colores del elemento fuente por separado para cada canal de color. Se puede ajustar el contraste del elemento fuente y alterar el balance de color.
| 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: butterfly source: "images/butterfly.png" sourceSize: Qt.size(parent.width, parent.height) smooth: true visible: false } LevelAdjust { anchors.fill: butterfly source: butterfly minimumOutput: "#00ffffff" maximumOutput: "#ff000000" } }
Documentación de propiedades
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 : variant
Esta propiedad define el factor de cambio para cómo se altera el valor de cada canal de color del píxel según la ecuación:
result.rgb = pow(original.rgb, 1.0 / gamma.rgb);
Establecer los valores de gamma por debajo de QtVector3d(1.0, 1.0, 1.0) oscurece la imagen, los valores por encima de QtVector3d(1.0, 1.0, 1.0) la aclaran.
El valor va desde QtVector3d(0.0, 0.0, 0.0) (más oscuro) hasta inf (más claro). Por defecto, la propiedad se establece en QtVector3d(1.0, 1.0, 1.0) (sin cambios).
| Ejemplos de salida con diferentes valores de gamma | ||
|---|---|---|
|
|
|
| gamma: Qt.vector3d(1.0, 1.0, 1.0) | gamma: Qt.vector3d(1.0, 0.4, 2.0) | gamma: Qt.vector3d(1.0, 0.1, 4.0) |
| minimumInput: #000000 | minimumInput: #000000 | minimumInput: #000000 |
| maximumInput: #ffffff | maximumInput: #ffffff | maximumInput: #ffffff |
| minimumOutput: #000000 | minimumOutput: #000000 | minimumOutput: #000000 |
| maximumOutput: #ffffff | maximumOutput: #ffffff | maximumOutput: #ffffff |
| Curvas de luminancia del canal de color de píxeles de las imágenes anteriores. | ||
|---|---|---|
|
|
|
| Eje X: luminancia original del píxel | ||
| Eje Y: luminancia del canal de color con el efecto aplicado |
maximumInput : color
Esta propiedad define el nivel máximo de entrada para cada canal de color. Establece el punto blanco, todos los píxeles que tengan un valor superior a esta propiedad se renderizan como blancos (por canal de color). Disminuir el valor aclara las áreas claras.
El valor oscila entre "#ffffffff" y "#00000000". Por defecto, la propiedad está establecida en "#ffffffff" (sin cambios).
| Ejemplos de salida con diferentes valores de maximumInput | ||
|---|---|---|
|
|
|
| maximumInput: #FFFFFFFF | maximumInput: #FFFFFF80 | maximumInput: #FFFFFF30 |
| minimumInput: #000000 | minimumInput: #000000 | minimumInput: #000000 |
| minimumOutput: #000000 | minimumOutput: #000000 | minimumOutput: #000000 |
| maximumOutput: #ffffff | maximumOutput: #ffffff | maximumOutput: #ffffff |
| gamma: Qt.vector3d(1.0, 1.0, 1.0) | gamma: Qt.vector3d(1.0, 1.0, 1.0) | gamma: Qt.vector3d(1.0, 1.0, 1.0) |
| Curvas de luminancia del canal de color del píxel de las imágenes anteriores. | ||
|---|---|---|
|
|
|
| Eje X: luminancia original del píxel | ||
| Eje Y: luminancia del canal de color con el efecto aplicado |
maximumOutput : color
Esta propiedad define el nivel máximo de salida para cada canal de color. Disminuir el valor oscurece las áreas claras, reduciendo el contraste.
El valor oscila entre "#ffffffff" y "#00000000". Por defecto, la propiedad está establecida en "#ffffffff" (sin cambios).
| Ejemplos de salida con diferentes valores de maximumOutput | ||
|---|---|---|
|
|
|
| maximumOutput: #FFFFFFFF | maximumOutput: #FFFFFF80 | maximumOutput: #FFFFFF30 |
| minimumInput: #000000 | minimumInput: #000000 | minimumInput: #000000 |
| maximumInput: #ffffff | maximumInput: #ffffff | maximumInput: #ffffff |
| minimumOutput: #000000 | minimumOutput: #000000 | minimumOutput: #000000 |
| gamma: Qt.vector3d(1.0, 1.0, 1.0) | gamma: Qt.vector3d(1.0, 1.0, 1.0) | gamma: Qt.vector3d(1.0, 1.0, 1.0) |
| Curvas de luminancia del canal de color del píxel de las imágenes anteriores. | ||
|---|---|---|
|
|
|
| Eje X: luminancia original del píxel | ||
| Eje Y: luminancia del canal de color con el efecto aplicado |
minimumInput : color
Esta propiedad define el nivel mínimo de entrada para cada canal de color. Establece el punto negro, todos los píxeles que tengan un valor inferior a esta propiedad se renderizan como negros (por canal de color). Aumentando el valor se oscurecen las zonas oscuras.
El valor oscila entre "#00000000" y "#ffffffff". Por defecto, la propiedad está establecida en "#00000000" (sin cambios).
| Ejemplos de salida con diferentes valores de minimumInput | ||
|---|---|---|
|
|
|
| minimumInput: #00000000 | minimumInput: #00000040 | entradaMínima: #00000070 |
| maximumInput: #ffffff | maximumInput: #ffffff | maximumInput: #ffffff |
| minimumOutput: #000000 | minimumOutput: #000000 | minimumOutput: #000000 |
| maximumOutput: #ffffff | maximumOutput: #ffffff | maximumOutput: #ffffff |
| gamma: Qt.vector3d(1.0, 1.0, 1.0) | gamma: Qt.vector3d(1.0, 1.0, 1.0) | gamma: Qt.vector3d(1.0, 1.0, 1.0) |
| Curvas de luminancia del canal de color del píxel de las imágenes anteriores. | ||
|---|---|---|
|
|
|
| Eje X: luminancia original del píxel | ||
| Eje Y: luminancia del canal de color con el efecto aplicado |
minimumOutput : color
Esta propiedad define el nivel mínimo de salida para cada canal de color. Aumentar el valor aclara las zonas oscuras, reduciendo el contraste.
El valor oscila entre "#00000000" y "#ffffffff". Por defecto, la propiedad está establecida en "#00000000" (sin cambios).
| Ejemplos de salida con diferentes valores de minimumOutput | ||
|---|---|---|
|
|
|
| minimumOutput: #00000000 | minimumOutput: #00000070 | minimumOutput: #000000A0 |
| minimumInput: #000000 | minimumInput: #000000 | minimumInput: #000000 |
| maximumInput: #ffffff | maximumInput: #ffffff | maximumInput: #ffffff |
| maximumOutput: #ffffff | maximumOutput: #ffffff | maximumOutput: #ffffff |
| gamma: Qt.vector3d(1.0, 1.0, 1.0) | gamma: Qt.vector3d(1.0, 1.0, 1.0) | gamma: Qt.vector3d(1.0, 1.0, 1.0) |
| Curvas de luminancia del canal de color del píxel de las imágenes anteriores. | ||
|---|---|---|
|
|
|
| Eje X: luminancia original del píxel | ||
| Eje Y: luminancia del canal de color con el efecto aplicado |
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.



























