En esta página

GammaAdjust QML Type

Modifica la luminancia del elemento de origen. Más...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Propiedades

Descripción detallada

GammaAdjust se aplica a cada píxel según la curva predefinida como una expresión de ley de potencia, en la que la propiedad gamma se utiliza como exponente de escala recíproco. Para obtener más detalles, consulta la documentación de la propiedad en gamma.

FuenteEfecto aplicado

Escarabajo negro sobre una hoja

Beetle con ajuste de gamma 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 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 se animen las propiedades de la fuente o del efecto.

De forma predeterminada, la propiedad está establecida en « false ».

gamma : real

Esta propiedad define el factor de variación que determina cómo se modifica 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

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

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

Ejemplos de resultados con diferentes valores de gamma

Escarabajo oscuro, gamma 0,5

Beetle en gamma normal

Escarabajo iluminado, gamma 2.0

gamma: 0,5 gamma: 1,0 gamma: 2,0
Curvas de luminancia de los píxeles de las imágenes anteriores.

Curva de luminancia para un valor de gamma de 0,5

Curva de luminancia para gamma 1,0

Curva de luminancia para gamma 2,0

Curva roja: gamma por defecto (1,0)
Curva amarilla: efecto aplicado
Eje X: luminancia original de los píxeles
Eje Y: luminancia de los píxeles con el efecto aplicado

source : variant

Esta propiedad define el elemento de origen cuya luminancia se va a ajustar.

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