ShaderEffectSource QML Type
Convierte un Qt Quick elemento en una textura y lo muestra. Más...
| Import Statement: | import QtQuick |
| Inherits: |
Propiedades
- format : enumeration
- hideSource : bool
- live : bool
- mipmap : bool
- recursive : bool
- samples : int
- sourceItem : Item
- sourceRect : rect
- textureMirroring : enumeration
- textureSize : size
- wrapMode : enumeration
Métodos
- void scheduleUpdate()
Descripción detallada
El tipo ShaderEffectSource renderiza un « sourceItem » en una textura y lo muestra en la escena. El « sourceItem » se dibuja en la textura como si fuera un elemento raíz totalmente opaco. Por lo tanto, el propio « sourceItem » puede ser invisible, pero seguir apareciendo en la textura.
Puedes utilizar ShaderEffectSource como:
- una fuente de textura en un ShaderEffect. Esto permite aplicar efectos de sombreador personalizados a cualquier Qt Quick elemento.
- una caché para un elemento complejo. El elemento complejo se puede renderizar una sola vez en la textura, que luego se puede animar libremente sin necesidad de volver a renderizar el elemento complejo en cada fotograma.
- una capa de opacidad. ShaderEffectSource te permite aplicar opacidad a los elementos como grupo, en lugar de a cada elemento individualmente.
| |
El tipo ShaderEffectSource no redirige ninguna entrada del ratón o del teclado a sourceItem. Si ocultas sourceItem estableciendo visible en false o opacity en cero, dejará de reaccionar a las entradas. En los casos en los que ShaderEffectSource esté destinado a sustituir a sourceItem, lo habitual es ocultar sourceItem sin dejar de gestionar las entradas. Para ello, puedes utilizar la propiedad hideSource.
Se pueden combinar el ShaderEffectSource y el MultiEffect:
- Para utilizar el mismo elemento de origen en varios efectos y mantenerlo sin cambios.
- Para utilizar una parte del elemento de origen, mediante ShaderEffectSource.sourceRect.
- Para reducir la resolución del elemento de origen, por ejemplo, con el fin de mejorar el rendimiento, utilizando la propiedad « ShaderEffectSource.textureSize ».
Nota: ShaderEffectSource depende de la compatibilidad con el multimuestreo de FBO para aplicar suavizado a los bordes. Si el hardware subyacente no lo admite —como ocurre con la mayoría de los chips gráficos integrados—, los bordes renderizados dentro de un ShaderEffectSource no se suavizarán. Una forma de solucionar esto es duplicar el tamaño de la fuente del efecto y renderizarla con ` smooth: true ` (este es el valor predeterminado de «smooth»). Esto equivaldrá a un multimuestreo 4x, a costa de un menor rendimiento y un mayor consumo de memoria.
Advertencia: En la mayoría de los casos, el uso de un ShaderEffectSource reducirá el rendimiento y, en todos los casos, aumentará el uso de memoria de vídeo. El renderizado a través de un ShaderEffectSource también podría dar lugar a una menor calidad, ya que algunas implementaciones de OpenGL admiten el backbuffer con muestreo múltiple, pero no los objetos framebuffer con muestreo múltiple.
Documentación de la propiedad
format : enumeration
Esta propiedad define el formato de la textura de fondo. Modificar esta propiedad resulta más útil cuando el elemento se utiliza como textura de origen de un « ShaderEffect ».
| Constante | Descripción |
|---|---|
ShaderEffectSource.RGBA8 | |
ShaderEffectSource.RGBA16F | |
ShaderEffectSource.RGBA32F | |
ShaderEffectSource.Alpha | A partir de Qt 6.0, este valor ya no se utiliza y, en la práctica, tiene el mismo efecto que « RGBA8 ». |
ShaderEffectSource.RGB | A partir de Qt 6.0, este valor ya no se utiliza y, en la práctica, tiene el mismo efecto que RGBA8. |
ShaderEffectSource.RGBA | A partir de Qt 6.0, este valor no se utiliza y, en la práctica, tiene el mismo efecto que RGBA8. |
hideSource : bool
Si esta propiedad tiene el valor «true», el « sourceItem » queda oculto, aunque seguirá representándose en la textura. A diferencia de lo que ocurre al ocultar el « sourceItem » estableciendo « visible » en «false», establecer esta propiedad en «true» no impedirá que las entradas del ratón o del teclado lleguen a « sourceItem ». Esta propiedad resulta útil cuando el « ShaderEffectSource » está anclado encima del « sourceItem » y está destinado a sustituirlo.
live : bool
Si esta propiedad tiene el valor «true», la textura se actualiza cada vez que se actualiza el objeto « sourceItem ». De lo contrario, se mostrará una imagen fija, incluso si se asigna un nuevo elemento a « sourceItem ». La propiedad tiene el valor «true» de forma predeterminada.
mipmap : bool
Si esta propiedad es verdadera, se generan mipmaps para la textura.
Nota: Algunas implementaciones de OpenGL ES 2 no admiten el mipmapping de texturas que no sean potencias de dos.
recursive : bool
Establece esta propiedad en «true» si la fuente de efecto de sombreado ( ShaderEffectSource ) tiene una dependencia de sí misma. Las fuentes de efecto de sombreado (ShaderEffectSources) forman una cadena de dependencias, en la que una fuente de efecto de sombreado ( ShaderEffectSource ) puede formar parte de la fuente de efecto de sombreado ( sourceItem ) de otra. Si hay un bucle en esta cadena, una fuente de efecto de sombreado ( ShaderEffectSource ) podría acabar intentando renderizar en la misma textura que está utilizando como fuente, lo cual no está permitido por OpenGL. Cuando esta propiedad se establece en «true», se asigna una textura adicional para que ShaderEffectSource pueda conservar una copia de la textura del fotograma anterior. De este modo, puede renderizar en una textura y utilizar la textura del fotograma anterior como fuente.
Si se establecen en «true» tanto esta propiedad como « live », el grafo de escena se renderizará de forma continua. Dado que el « ShaderEffectSource » depende de sí mismo, actualizarlo hace que vuelva a marcarse como «sucio» inmediatamente.
samples : int
Esta propiedad permite solicitar un renderizado con muestreo múltiple.
Por defecto, el multimuestreo se activa siempre que esté habilitado para toda la ventana, siempre que el renderizador de grafos de escena utilizado y la API gráfica subyacente lo admitan.
Al establecer el valor en 2, 4, etc., se puede solicitar el renderizado con multimuestreo para una parte de la escena sin habilitarlo para toda la escena. De esta forma, el multimuestreo se aplica únicamente a un subárbol determinado, lo que puede suponer una mejora significativa del rendimiento, ya que no se aplica a otras partes de la escena.
Nota: Habilitar el multisampling puede resultar potencialmente costoso, independientemente del tamaño de la capa, ya que conlleva un coste de rendimiento y memoria que depende del hardware y del controlador.
Nota: Esta propiedad solo funciona cuando hay compatibilidad con los búferes de renderizado con multimuestreo y las operaciones de blit del búfer de fotogramas. De lo contrario, el valor se ignora sin aviso.
sourceItem : Item
Esta propiedad contiene el elemento que se va a representar en la textura. Si se establece en «null» mientras « live » está en «true», se liberarán los recursos de la textura.
sourceRect : rect
Esta propiedad define qué área rectangular de sourceItem se va a renderizar en la textura. El rectángulo de origen puede ser más grande que el propio sourceItem. Si el rectángulo es nulo, que es el valor por defecto, se renderiza todo sourceItem en la textura.
textureMirroring : enumeration
Esta propiedad define cómo debe reflejarse la textura OpenGL generada. El valor por defecto es « ShaderEffectSource.MirrorVertically ». El reflejo personalizado puede resultar útil si se accede directamente a la textura generada mediante shaders personalizados, como los especificados en « ShaderEffect ». El reflejo no tiene ningún efecto sobre la representación en la interfaz de usuario del propio elemento « ShaderEffectSource ».
| Constante | Descripción |
|---|---|
ShaderEffectSource.NoMirroring | Sin simetría |
ShaderEffectSource.MirrorHorizontally | La textura generada se invierte a lo largo del eje X. |
ShaderEffectSource.MirrorVertically | La textura generada se invierte a lo largo del eje Y. |
textureSize : size
Esta propiedad contiene el tamaño en píxeles solicitado de la textura. Si está vacía, que es el valor por defecto, se utiliza el tamaño del rectángulo de origen.
Nota: Este valor se expresa en píxeles, ya que controla directamente el tamaño de un objeto de textura.
Nota: Algunas plataformas tienen un límite en cuanto al tamaño mínimo que pueden tener los objetos de framebuffer, lo que significa que el tamaño real de la textura podría ser mayor que el solicitado.
wrapMode : enumeration
Esta propiedad define los modos de repetición de OpenGL asociados a la textura. Modificar esta propiedad resulta más útil cuando el elemento se utiliza como textura de origen de un « ShaderEffect ».
El valor predeterminado es « ShaderEffectSource.ClampToEdge ».
| Constante | Descripción |
|---|---|
ShaderEffectSource.ClampToEdge | GL_CLAMP_TO_EDGE tanto en horizontal como en vertical |
ShaderEffectSource.RepeatHorizontally | GL_REPEAT en horizontal, GL_CLAMP_TO_EDGE en vertical |
ShaderEffectSource.RepeatVertically | GL_CLAMP_TO_EDGE en horizontal, GL_REPEAT en vertical |
ShaderEffectSource.Repeat | GL_REPEAT tanto en horizontal como en vertical Nota: Algunas implementaciones de OpenGL ES 2 no admiten el modo de repetición GL_REPEAT con texturas que no sean potencias de dos. |
Documentación del método
void scheduleUpdate()
Programa un nuevo renderizado de la textura para el siguiente fotograma. Utiliza esta opción para actualizar la textura cuando ` live ` sea falso.
© 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.
