En esta página

Displace QML Type

Mueve los píxeles del elemento de origen según el mapa de desplazamiento indicado. Más...

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

Item

Propiedades

Descripción detallada

FuenteFuente de desplazamientoEfecto aplicado

Escarabajo negro sobre una hoja

Mapa de desplazamiento con degradados rojos y verdes

Beetle con efecto de desplazamiento 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
    }

    Rectangle {
        id: displacement
        color: Qt.rgba(0.5, 0.5, 1.0, 1.0)
        anchors.fill: parent
        visible: false
        Image {
            anchors.centerIn: parent
            source: "images/glass_normal.png"
            sourceSize: Qt.size(parent.width/2, parent.height/2)
            smooth: true
        }
    }

    Displace {
        anchors.fill: bug
        source: bug
        displacementSource: displacement
        displacement: 0.1
    }
}

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

displacement : real

Esta propiedad define la escala del desplazamiento. Cuanto mayor sea la escala, mayor será el desplazamiento de los píxeles. Si se establece el valor en 0,0, no se produce ningún desplazamiento.

El valor oscila entre -1,0 (desplazamiento máximo invertido, según displacementSource) y 1,0 (desplazamiento máximo, según displacementSource). Por defecto, la propiedad está establecida en 0.0 (sin desplazamiento).

Ejemplos de resultados con diferentes valores de desplazamiento

Escarabajo desplazado hacia el interior

Beetle sin cilindrada

Escarabajo desplazado hacia fuera

desplazamiento: -0,2 desplazamiento: 0,0 desplazamiento: 0,2

displacementSource : variant

Esta propiedad define el elemento que se va a utilizar como mapa de desplazamiento. El elemento «displacementSource» se renderiza en el búfer de píxeles intermedio. Los valores de los componentes rojo y verde del resultado determinan el desplazamiento de los píxeles del elemento de origen.

El formato del mapa de desplazamiento es similar al de los mapas normales en el espacio tangente, que pueden crearse con la mayoría de las herramientas de modelado 3D. Muchas herramientas de procesamiento de imágenes incluyen la posibilidad de generar mapas normales. Como alternativa, el mapa de desplazamiento para este efecto también puede ser un elemento QML al que se le haya asignado el color adecuado. Al igual que cualquier elemento QML, puede animarse. Se recomienda que el tamaño del mapa de desplazamiento coincida con el tamaño del « source ».

Los datos de desplazamiento se interpretan en formato RGBA. Para cada píxel: el canal rojo almacena el desplazamiento en el eje x, y el canal verde almacena el desplazamiento en el eje y. Los canales azul y alfa se ignoran para este efecto.

Suponiendo que un valor de 1,0 en el canal rojo corresponde al rojo intenso (siendo 0,0 la ausencia total de rojo), este efecto considera que un valor de 0,5 en el componente del píxel no provoca desplazamiento alguno. Los valores superiores a 0,5 desplazan los píxeles hacia la izquierda, mientras que los valores inferiores a 0,5 los desplazan hacia la derecha. De manera similar, los valores del canal verde superiores a 0,5 desplazan los píxeles hacia arriba, y los valores inferiores a 0,5 los desplazan hacia abajo. La cantidad real de desplazamiento en píxeles depende de la propiedad « displacement ».

source : variant

Esta propiedad define el elemento de origen de los píxeles que se van a desplazar según los datos de displacementSource.

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.