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: |
Propiedades
- cached : alias
- color : alias
- horizontalOffset : real
- radius : int
- samples : alias
- source : alias
- spread : alias
- transparentBorder : alias
- verticalOffset : real
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.
| Fuente | Efecto aplicado |
|---|---|
|
|
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 | ||
|---|---|---|
|
|
|
| color: #000000 | color: #0000ff | color: #aa000000 |
| radius: 8 | radius: 8 | radius: 8 |
| samples: 17 | samples: 17 | samples: 17 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 20 | verticalOffset: 20 | verticalOffset: 20 |
| spread: 0 | spread: 0 | spread: 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` | ||
|---|---|---|
|
|
|
| horizontalOffset: -20 | horizontalOffset: 0 | horizontalOffset: 20 |
| radius: 4 | radius: 4 | radius: 4 |
| samples: 9 | samples: 9 | samples: 9 |
| color: #000000 | color: #000000 | color: #000000 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
| spread: 0 | spread: 0 | spread: 0 |
| Ejemplos de resultados con diferentes valores de « verticalOffset » | ||
|---|---|---|
|
| |
| horizontalOffset: 0 | horizontalOffset: 0 | |
| radius: 4 | radius: 8 | |
| samples: 9 | samples: 17 | |
| color: #000000 | color: #000000 | |
| verticalOffset: 0 | verticalOffset: 20 | |
| spread: 0 | spread: 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:
| Radio | Muestras |
|---|---|
| 0 (sin desenfoque) | 1 |
| 1 | 3 |
| 2 | 5 |
| 3 | 7 |
Por defecto, la propiedad está configurada en « floor(samples/2) ».
| Ejemplos de resultados con diferentes valores de radio | ||
|---|---|---|
|
|
|
| radio: 0 | radio: 6 | radio: 12 |
| samples: 25 | samples: 25 | samples: 25 |
| color: #000000 | color: #000000 | color: #000000 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 20 | verticalOffset: 20 | verticalOffset: 20 |
| spread: 0 | spread: 0 | spread: 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:
| Radio | Muestras |
|---|---|
| 0 (sin desenfoque) | 1 |
| 1 | 3 |
| 2 | 5 |
| 3 | 7 |
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 | ||
|---|---|---|
|
|
|
| difusión: 0,0 | difusión: 0,5 | difusión: 1,0 |
| radius: 8 | radius: 8 | radius: 8 |
| samples: 17 | samples: 17 | samples: 17 |
| color: #000000 | color: #000000 | color: #000000 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 20 | verticalOffset: 20 | verticalOffset: 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
}
}
}
}
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 » | ||
|---|---|---|
|
|
|
| horizontalOffset: -20 | horizontalOffset: 0 | horizontalOffset: 20 |
| radius: 4 | radius: 4 | radius: 4 |
| samples: 9 | samples: 9 | samples: 9 |
| color: #000000 | color: #000000 | color: #000000 |
| desplazamiento vertical: 0 | desplazamiento vertical: 0 | desplazamiento vertical: 0 |
| spread: 0 | spread: 0 | spread: 0 |
| Ejemplos de resultados con diferentes valores de «verticalOffset» | ||
|---|---|---|
|
| |
| horizontalOffset: 0 | horizontalOffset: 0 | |
| radius: 4 | radius: 8 | |
| samples: 9 | samples: 17 | |
| color: #000000 | color: #000000 | |
| desplazamiento vertical: 0 | desplazamiento vertical: 20 | |
| spread: 0 | spread: 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.













