En esta página

BrightnessContrast QML Type

Ajusta el brillo y el contraste. Más...

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

Item

Propiedades

Descripción detallada

Nota: El componente « MultiEffect » proporciona un efecto de brillo y contraste con algunas ventajas en cuanto al rendimiento. Para código nuevo, debería considerarse como una alternativa al uso de Qt Graphical Effects.

Este efecto ajusta los colores del elemento de origen. El ajuste de brillo modifica la luminancia percibida del elemento de origen. El ajuste de contraste aumenta o disminuye las variaciones de color y brillo.

FuenteEfecto aplicado

Escarabajo negro sobre una hoja

Escarabajo con brillo y contraste ajustados

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 en qué medida se aumenta o se reduce 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 resultados con diferentes valores de brillo

Escarabajo oscuro, brillo -0,25

Escarabajo con brillo normal

Escarabajo iluminado, brillo 0,5

brillo: -0,25 brillo: 0 brillo: 0,5
contrast: 0contrast: 0contrast: 0

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 el resultado del efecto.

Se recomienda desactivar la caché cuando se animen las propiedades de la fuente o del efecto.

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

contrast : real

Esta propiedad define en qué medida se aumenta o se reduce el contraste de la fuente. La reducción del contraste es lineal, pero el aumento se aplica mediante una curva no lineal para permitir un ajuste de contraste muy elevado en el extremo superior del rango de valores.

Curva de ajuste del contraste

Gráfico que muestra la curva de ajuste del contraste

El valor oscila entre -1,0 y 1,0. De forma predeterminada, la propiedad está establecida en « 0.0 » (sin cambios).

Ejemplos de resultado con diferentes valores de contraste

Escarabajo con contraste reducido

Escarabajo con contraste normal

Escarabajo con mayor contraste

contraste: -0,5 contraste: 0 contraste: 0,5
brightness: 0brightness: 0brightness: 0

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 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.