En esta página

DropShadow QML Type

Genera una sombra suave detrás del elemento de origen. 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 sombra con algunas ventajas en cuanto al rendimiento. Para el código nuevo, debería considerarse como una alternativa al uso de Qt XML ` Graphical Effects`.

El efecto DropShadow desenfoca el canal alfa de la entrada, colorea el resultado y lo coloca detrás del objeto de origen para crear una sombra suave. El color de la sombra se puede modificar mediante la propiedad color. La ubicación de la sombra se puede modificar con las propiedades horizontalOffset y verticalOffset.

FuenteEfecto aplicado

Ilustración de una mariposa de colores

Mariposa con sombra proyectada detrás

La sombra suave se crea desenfocando la imagen en tiempo real mediante un desenfoque gaussiano. Realizar el desenfoque en tiempo real es una operación que consume muchos recursos. El desenfoque gaussiano a pantalla completa, incluso con un número moderado de muestras, solo se ejecutará a 60 fps en hardware gráfico de gama alta.

Cuando la fuente es estática, se puede configurar la propiedad cached para asignar otro búfer y evitar así aplicar el desenfoque cada vez que se dibuja.

Nota: Este efecto está disponible cuando se ejecuta con OpenGL.

Ejemplo

El siguiente ejemplo muestra cómo aplicar el efecto.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Rectangle {
        anchors.fill: parent
    }

    Image {
        id: butterfly
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    DropShadow {
        anchors.fill: butterfly
        horizontalOffset: 3
        verticalOffset: 3
        radius: 8.0
        color: "#80000000"
        source: butterfly
    }
}

Documentación de propiedades

cached : alias

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 adicional de memoria 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 ».

color : alias

Esta propiedad define el valor de color RGBA que se utiliza para la sombra.

Por defecto, la propiedad está establecida en "black".

Ejemplos de resultados con diferentes valores de color

Mariposa con sombra negra

Mariposa con sombra azul

Mariposa con sombra semitransparente

color: #000000 color: #0000ff color: #aa000000
radius: 8radius: 8radius: 8
samples: 17samples: 17samples: 17
horizontalOffset: 0horizontalOffset: 0horizontalOffset: 0
verticalOffset: 20verticalOffset: 20verticalOffset: 20
spread: 0spread: 0spread: 0

horizontalOffset : real

Las propiedades «HorizontalOffset» y « verticalOffset » definen el desplazamiento de la sombra renderizada con respecto a la posición del elemento « DropShadow ». A menudo, el elemento « DropShadow » se ancla de forma que ocupe todo el espacio del elemento de origen. En este caso, si las propiedades «HorizontalOffset» y « verticalOffset » se establecen en 0, la sombra se representa exactamente debajo del elemento de origen. Al modificar las propiedades de desplazamiento, la sombra se puede colocar de forma relativa respecto al elemento de origen.

Los valores oscilan entre -inf e inf. Por defecto, las propiedades están establecidas en 0.

Ejemplos de resultados con diferentes valores de `horizontalOffset`

Desplazamiento de la sombra hacia la izquierda

Sombra centrada en la parte inferior

Desplazamiento de la sombra hacia la derecha

horizontalOffset: -20 horizontalOffset: 0 horizontalOffset: 20
radius: 4radius: 4radius: 4
samples: 9samples: 9samples: 9
color: #000000color: #000000color: #000000
verticalOffset: 0verticalOffset: 0verticalOffset: 0
spread: 0spread: 0spread: 0
Ejemplos de resultados con diferentes valores de « verticalOffset »

Sombra centrada en la parte inferior

Sombra con desplazamiento vertical

horizontalOffset: 0 horizontalOffset: 0
radius: 4radius: 8
samples: 9samples: 17
color: #000000color: #000000
verticalOffset: 0verticalOffset: 20
spread: 0spread: 0

radius : int

El radio define la suavidad de la sombra. Un radio mayor hace que los bordes de la sombra parezcan más difuminados.

El desenfoque ideal se consigue seleccionando samples y radius de tal forma que samples = 1 + radius * 2, por ejemplo:

RadioMuestras
0 (sin desenfoque)1
13
25
37

Por defecto, la propiedad está configurada en « floor(samples/2) ».

Ejemplos de resultados con diferentes valores de radio

Sombra nítida con radio 0

Sombra suave con un radio de 6

Sombra muy suave con un radio de 12

radio: 0 radio: 6 radio: 12
samples: 25samples: 25samples: 25
color: #000000color: #000000color: #000000
horizontalOffset: 0horizontalOffset: 0horizontalOffset: 0
verticalOffset: 20verticalOffset: 20verticalOffset: 20
spread: 0spread: 0spread: 0

Nota: La propiedad « radius » se utiliza para calcular el tamaño del búfer fuera de pantalla del efecto. Los valores más altos provocarán asignaciones de memoria más grandes.

samples : alias

Esta propiedad define el número de muestras que se toman por píxel al calcular el desenfoque de suavizado de bordes. Un valor más alto ofrece mejor calidad, pero ralentiza el renderizado.

Lo ideal es que este valor sea el doble del valor de radio más alto requerido más uno, por ejemplo:

RadioMuestras
0 (sin desenfoque)1
13
25
37

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

Esta propiedad no está pensada para ser animada. Si se modifica esta propiedad, se volverán a compilar los sombreadores OpenGL subyacentes.

source : alias

Esta propiedad define el elemento de origen que se va a utilizar como fuente para la sombra generada.

Nota: Noestá permitido que el efecto se incluya a sí mismo, por ejemplo, estableciendo como origen el elemento padre del efecto.

spread : alias

Esta propiedad define en qué medida se intensifica el color de la sombra cerca de los bordes de la fuente.

El valor oscila entre 0,0 y 1,0. Por defecto, la propiedad está establecida en « 0.0 ».

Ejemplos de resultados con diferentes valores de extensión

Sombra sin extensión

Sombra de cobertura media

Sombra con extensión completa

difusión: 0,0 difusión: 0,5 difusión: 1,0
radius: 8radius: 8radius: 8
samples: 17samples: 17samples: 17
color: #000000color: #000000color: #000000
horizontalOffset: 0horizontalOffset: 0horizontalOffset: 0
verticalOffset: 20verticalOffset: 20verticalOffset: 20

transparentBorder : alias

Esta propiedad determina si el efecto tiene o no un borde transparente.

Cuando se establece en « true », el exterior del elemento se rellena con un borde transparente de 1 píxel de ancho, lo que hace que el muestreo fuera de la textura de origen utilice transparencia en lugar de los píxeles del borde. Sin esta propiedad, una imagen que tenga bordes opacos no obtendrá una sombra difuminada.

En la imagen siguiente, el rectángulo de la izquierda tiene bordes transparentes y bordes difuminados, mientras que el rectángulo de la derecha no:

Por defecto, esta propiedad está establecida en « true ».

import QtQuick
import Qt5Compat.GraphicalEffects

Rectangle {
    width: 180
    height: 100

    Row {
        anchors.centerIn: parent
        spacing: 16

        Rectangle {
            id: normalRect
            width: 60
            height: 60
            radius: 10
            color: "steelblue"
            layer.enabled: true
            layer.effect: DropShadow {
                transparentBorder: false
                horizontalOffset: 8
                verticalOffset: 8
            }
        }

        Rectangle {
            id: transparentBorderRect
            width: 60
            height: 60
            radius: 10
            color: "steelblue"
            layer.enabled: true
            layer.effect: DropShadow {
                transparentBorder: true
                horizontalOffset: 8
                verticalOffset: 8
            }
        }
    }
}

Rectángulos que muestran la diferencia entre los ajustes de borde transparente

verticalOffset : real

Las propiedades `HorizontalOffset` y `verticalOffset` definen el desplazamiento de la sombra renderizada con respecto a la posición del elemento ` DropShadow `. A menudo, el elemento « DropShadow » se ancla de forma que ocupe todo el espacio del elemento de origen. En este caso, si las propiedades «HorizontalOffset» y «verticalOffset» se establecen en 0, la sombra se representa exactamente debajo del elemento de origen. Al modificar las propiedades de desplazamiento, la sombra se puede colocar de forma relativa respecto al elemento de origen.

Los valores oscilan entre -inf e inf. De forma predeterminada, las propiedades están establecidas en « 0 ».

Ejemplos de resultados con diferentes valores de « horizontalOffset »

Desplazamiento de la sombra hacia la izquierda

Sombra centrada en la parte inferior

Desplazamiento de la sombra hacia la derecha

horizontalOffset: -20 horizontalOffset: 0 horizontalOffset: 20
radius: 4radius: 4radius: 4
samples: 9samples: 9samples: 9
color: #000000color: #000000color: #000000
desplazamiento vertical: 0desplazamiento vertical: 0desplazamiento vertical: 0
spread: 0spread: 0spread: 0
Ejemplos de resultados con diferentes valores de «verticalOffset»

Sombra centrada en la parte inferior

Sombra con desplazamiento vertical

horizontalOffset: 0 horizontalOffset: 0
radius: 4radius: 8
samples: 9samples: 17
color: #000000color: #000000
desplazamiento vertical: 0desplazamiento vertical: 20
spread: 0spread: 0

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