En esta página

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:

Item

Propiedades

Descripción detallada

Este efecto ajusta los colores del elemento de origen por separado para cada canal de color. Se puede ajustar el contraste del elemento de origen y modificar el balance de color.

Elemento de origenEfecto aplicado

Ilustración de una mariposa de colores

Mariposa con ajuste de nivel 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 con el fin de mejorar el rendimiento del renderizado.

Cada vez que se modifican las propiedades de la fuente o del efecto, es necesario actualizar los píxeles de la caché. El consumo de memoria aumenta, ya que se requiere un búfer de memoria adicional para almacenar la salida del efecto.

Se recomienda desactivar la caché cuando las propiedades de la fuente o del efecto estén animadas.

Por defecto, la propiedad está establecida en « false ».

gamma : variant

Esta propiedad define el factor de variación que determina cómo se modifica el valor de cada canal de color de un píxel según la ecuación:

result.rgb = pow(original.rgb, 1.0 / gamma.rgb);

Si se establecen valores de gamma inferiores a QtVector3d(1,0; 1,0; 1,0), la imagen se oscurece; si se establecen valores superiores a QtVector3d(1,0; 1,0; 1,0), la imagen se aclara.

El valor oscila entre QtVector3d(0.0, 0.0, 0.0) (el más oscuro) e inf (el más claro). Por defecto, la propiedad está establecida en QtVector3d(1.0, 1.0, 1.0) (sin cambio).

Ejemplos de resultados con diferentes valores de gamma

Mariposa con el valor predeterminado de gamma

Mariposa con gamma RGB modificada

Mariposa con ajuste gamma extremo

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: #000000minimumInput: #000000minimumInput: #000000
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #ffffff
Curvas de luminancia de los canales de color de los píxeles de las imágenes anteriores.

Curva de luminancia predeterminada

Curva de luminancia gamma modificada

Curva de luminancia gamma extrema

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 al de esta propiedad se representan en blanco (por canal de color). Al reducir el valor, se aclaran las zonas 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`

Sin límite máximo de ajuste de entrada

Umbral máximo de entrada medio

Umbral máximo de entrada bajo

maximumInput: #FFFFFFFF maximumInput: #FFFFFF80 maximumInput: #FFFFFF30
minimumInput: #000000minimumInput: #000000minimumInput: #000000
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #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 de los canales de color de los píxeles de las imágenes anteriores.

Curva de luminancia predeterminada

Curva de luminancia máxima de entrada media

Curva de luminancia máxima de entrada baja

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. Al reducir el valor, las zonas claras se oscurecen, lo que reduce 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»

Sin ajuste de potencia máxima

Nivel máximo de salida medio

Nivel máximo de salida bajo

maximumOutput: #FFFFFFFF maximumOutput: #FFFFFF80 maximumOutput: #FFFFFF30
minimumInput: #000000minimumInput: #000000minimumInput: #000000
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
minimumOutput: #000000minimumOutput: #000000minimumOutput: #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 de los canales de color de los píxeles de las imágenes anteriores.

Curva de luminancia predeterminada

Curva de luminancia máxima de salida media

Curva de luminancia máxima de salida baja

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 al de esta propiedad se representan en negro (por canal de color). Al aumentar 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`

Sin ajuste mínimo de entrada

Umbral mínimo de entrada bajo

Umbral mínimo de entrada elevado

minimumInput: #00000000 minimumInput: #00000040 minimumInput: #00000070
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
minimumOutput: #000000minimumOutput: #000000minimumOutput: #000000
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #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 de los canales de color de los píxeles de las imágenes anteriores.

Curva de luminancia predeterminada

Curva de luminancia mínima de entrada

Curva de luminancia mínima de entrada elevada

Eje X: luminancia original de los píxeles
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. Al aumentar el valor, se aclaran las zonas oscuras, lo que reduce 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»

Sin ajuste mínimo de la potencia de salida

Nivel de salida mínimo medio

Nivel de salida mínimo elevado

minimumOutput: #00000000 minimumOutput: #00000070 minimumOutput: #000000A0
minimumInput: #000000minimumInput: #000000minimumInput: #000000
maximumInput: #ffffffmaximumInput: #ffffffmaximumInput: #ffffff
maximumOutput: #ffffffmaximumOutput: #ffffffmaximumOutput: #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 de los canales de color de los píxeles de las imágenes anteriores.

Curva de luminancia predeterminada

Curva de luminancia mínima de salida

Curva de luminancia mínima de salida elevada

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 de origen que proporciona los píxeles de origen para el efecto.

Nota: Noestá permitido que el efecto se incluya a sí mismo, por ejemplo, estableciendo la fuente como el elemento 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.