Qt Quick 3D - Ejemplo de efecto personalizado

Muestra cómo crear efectos de posprocesamiento personalizados.

Escena distorsionada con el logotipo rosa de Qt y un suelo a cuadros en la que se aprecian 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;
}

Proyecto de ejemplo en code.qt.io

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