InnerShadow QML Type
Genera una sombra coloreada y difuminada en el interior del elemento de origen. Más...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propiedades
- cached : bool
- color : color
- fast : bool
- horizontalOffset : real
- radius : real
- samples : int
- source : variant
- spread : real
- verticalOffset : real
Descripción detallada
Por defecto, el efecto genera una imagen de sombra de alta calidad, por lo que es posible que la velocidad de renderizado de la sombra no sea la máxima posible. La velocidad de renderizado se reduce especialmente si los bordes de la sombra están muy suavizados. Para los casos de uso que requieran una mayor velocidad de renderizado y en los que no sea necesaria la máxima calidad visual posible, se puede establecer la propiedad « fast » en «true».
| Fuente | Efecto aplicado |
|---|---|
|
|
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
}
InnerShadow {
anchors.fill: butterfly
radius: 8.0
samples: 16
horizontalOffset: -3
verticalOffset: 3
color: "#b0000000"
source: butterfly
}
}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 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 : color
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: #ffffff | color: #ff0000 |
| radius: 16 | radius: 16 | radius: 16 |
| samples: 24 | samples: 24 | samples: 24 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
| spread: 0,2 | spread: 0,2 | spread: 0,2 |
fast : bool
Esta propiedad selecciona el algoritmo de desenfoque que se utiliza para crear el efecto de suavidad. Si se establece en «true», se activa el algoritmo rápido; si se establece en «false», se obtiene un resultado de mayor calidad.
Por defecto, la propiedad está configurada en « false ».
| Ejemplos de resultados con diferentes valores de «fast» | ||
|---|---|---|
|
| |
| rápido: falso | rápido: verdadero | |
| radius: 16 | radius: 16 | |
| samples: 24 | samples: 24 | |
| color: #000000 | color: #000000 | |
| horizontalOffset: 0 | horizontalOffset: 0 | |
| verticalOffset: 0 | verticalOffset: 0 | |
| spread: 0,2 | spread: 0,2 |
horizontalOffset : real
Las propiedades «HorizontalOffset» y « verticalOffset » definen el desplazamiento de la sombra renderizada con respecto a la posición del elemento « InnerShadow ». A menudo, el elemento « InnerShadow » se ancla de manera 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 renderiza íntegramente dentro 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: 16 | radius: 16 | radius: 16 |
| samples: 24 | samples: 24 | samples: 24 |
| color: #000000 | color: #000000 | color: #000000 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
| spread: 0 | spread: 0 | spread: 0 |
radius : real
El radio define la suavidad de la sombra. Un radio mayor hace que los bordes de la sombra se vean más difuminados.
Dependiendo del valor del radio, el valor de la propiedad « samples » debe fijarse en un valor lo suficientemente grande como para garantizar la calidad visual.
El valor oscila entre 0,0 (sin desenfoque) e infinito. Por defecto, la propiedad está establecida en « 0.0 » (sin desenfoque).
| Ejemplos de resultados con diferentes valores de radio | ||
|---|---|---|
|
|
|
| radio: 0 | radio: 6 | radio: 12 |
| samples: 24 | samples: 24 | samples: 24 |
| color: #000000 | color: #000000 | color: #000000 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
| spread: 0 | spread: 0 | spread: 0 |
samples : int
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; por ejemplo, si el radio se anima entre 0,0 y 4,0, las muestras deberían establecerse en 8.
El valor oscila entre 0 y 32. Por defecto, la propiedad está establecida en 0.
Esta propiedad no está pensada para ser animada. Cambiar esta propiedad puede provocar que se recompilen los shaders de OpenGL subyacentes.
Cuando la propiedad « fast » está establecida en «true», esta propiedad no tiene ningún efecto.
source : variant
Esta propiedad define el elemento de origen que se va a utilizar como fuente para la sombra generada.
Nota: Noes posible que el efecto se incluya a sí mismo, por ejemplo, estableciendo como origen el elemento padre del efecto.
spread : real
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.5.
| Ejemplos de resultados con diferentes valores de extensión | ||
|---|---|---|
|
|
|
| difusión: 0,0 | difusión: 0,3 | difusión: 0,5 |
| radius: 16 | radius: 16 | radius: 16 |
| samples: 24 | samples: 24 | samples: 24 |
| color: #000000 | color: #000000 | color: #000000 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
verticalOffset : real
Las propiedades `HorizontalOffset` y `verticalOffset` definen el desplazamiento de la sombra renderizada con respecto a la posición del elemento ` InnerShadow `. A menudo, el elemento « InnerShadow » 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 íntegramente dentro del elemento de origen. Al modificar las propiedades de desplazamiento, la sombra se puede posicionar 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: 16 | radius: 16 | radius: 16 |
| samples: 24 | samples: 24 | samples: 24 |
| color: #000000 | color: #000000 | color: #000000 |
| desplazamiento vertical: 0 | desplazamiento vertical: 0 | desplazamiento vertical: 0 |
| spread: 0 | 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.















