Qt Quick 3D - Ejemplo de efecto personalizado
Muestra cómo crear efectos de posprocesamiento personalizados.

El ejemplo implementa sus propios efectos de posprocesamiento personalizados, que luego se aplican a la escena mediante SceneEnvironment::effects. Muestra tanto el tipo más sencillo de efectos, que solo cuentan con un sombreador de fragmentos, como el caso más avanzado, en el que están presentes tanto un sombreador de vértices como uno de fragmentos, con datos que se pasan entre ambos.
El efecto sencillo utiliza únicamente un único sombreador de fragmentos y añade una entrada de textura procedente de un archivo de imagen:
Effect {
id: eff1
property TextureInput tex: TextureInput {
id: qtLogo
texture: Texture { source: "qt_logo_rect.png" }
}
passes: Pass {
shaders: Shader {
id: fs1
stage: Shader.Fragment
shader: "effect.frag"
}
}
}Este efecto utiliza un sombreador de fragmentos muy sencillo, que simplemente toma la textura de entrada que contiene la escena y la multiplica por la textura de la imagen:
void MAIN()
{
vec4 c = texture(tex, TEXTURE_UV);
FRAGCOLOR = c * texture(INPUT, INPUT_UV);
}Los fragmentos de código de los sombreadores en los archivos « .vert » y « .frag » están escritos utilizando las palabras clave integradas, tal y como se describe en la documentación de Effect. Las propiedades personalizadas con tipos básicos, así como las propiedades con el tipo « TextureInput », se exponen automáticamente a los sombreadores como uniformes y muestreadores.
El segundo efecto es más complejo. Especifica tanto un shader de vértices como uno de fragmentos, así como dos propiedades: uRed y uGreen, con una animación en uRed:
Effect {
id: eff2
property real uRed: 0.0
SequentialAnimation {
running: radioEff2.checked || radioEff3.checked
loops: Animation.Infinite
NumberAnimation { target: eff2; property: "uRed"; from: 0; to: 1; duration: 2000 }
NumberAnimation { target: eff2; property: "uRed"; from: 1; to: 0; duration: 2000 }
}
property real uGreen: 1.0
Shader {
id: vs2
stage: Shader.Vertex
shader: "effect2.vert"
}
Shader {
id: fs2
stage: Shader.Fragment
shader: "effect2.frag"
}
passes: Pass {
shaders: [ vs2, fs2 ]
}
}El sombreador de fragmentos de este efecto crea una distorsión modificando las coordenadas de muestreo. El cálculo utiliza center_vec, una variable VARYING establecida por el sombreador de vértices que contiene el vector, corregido según la relación de aspecto, desde el centro de la pantalla hasta el fragmento actual. Por último, el sombreador ajusta el color utilizando los uniformes uRed y uGreen. Ten en cuenta que estos uniformes no tienen que declararse en el sombreador:
VARYING vec2 center_vec;
void MAIN()
{
float radius = 0.25;
float dist_to_center = length(center_vec) / radius;
vec2 texcoord = INPUT_UV;
if (dist_to_center <= 1.0) {
float rotation_amount = (1.0 - dist_to_center) * (1.0 - dist_to_center);
float r = radians(360.0) * rotation_amount / 4.0 * FRAMEBUFFER_Y_UP;
float cos_r = cos(r);
float sin_r = sin(r);
mat2 rotation = mat2(cos_r, sin_r, -sin_r, cos_r);
texcoord = vec2(0.5, 0.5) + rotation * (INPUT_UV - vec2(0.5, 0.5));
}
vec4 c = texture(INPUT, texcoord);
c.r *= uRed;
c.g *= uGreen;
FRAGCOLOR = c;
}© 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.