En esta página

Wiggly

Muestra cómo utilizar un efecto creado con el « Qt Quick Effect Maker» (QQEM).

Wiggly muestra cómo utilizar un efecto de shader, creado con el « Qt Quick Effect Maker» (QQEM), en tu aplicación « Qt Quick ». Una sencilla interfaz de usuario de tipo « Qt Quick » permite modificar el texto ondulado y el tamaño de la onda, así como aplicar el efecto de nube eléctrica.

Texto ondulado que dice «HELLO WORLD» con degradado de arcoíris y efecto de onda

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Conceptos básicos de la aplicación

La mayor parte del ejemplo se encuentra y está configurada en el archivo main.qml. En primer lugar, crea un elemento que se utilizará como fuente para el efecto.

Rectangle {
    id: sourceItem
    anchors.centerIn: parent
    width: textItem.width + 60 * mainWindow.px
    height: textItem.height + 30 * mainWindow.px
    color: "#d0d0d0d0"
    border.color: "#d0ffffff"
    border.width: 4 * mainWindow.px
    radius: 20 * mainWindow.px
    layer.enabled: true
    layer.smooth: true
    visible: false
    Text {
        id: textItem
        anchors.centerIn: parent
        text: wigglyTextField.text
        font.family: font1.font.family
        font.pixelSize: Math.min(200 * mainWindow.px, 0.8 * mainWindow.width / text.length)
    }
}

El elemento es un « Rectangle » que contiene un elemento « Text ». El tamaño del rectángulo depende del número de caracteres del texto, para que encaje bien en la ventana de la aplicación. Las líneas importantes aquí son ` layer.enabled: true `, que crea la textura fuera de pantalla para el efecto, y `visible: false `, que oculta este elemento, ya que el efecto sustituirá su contenido. Si el elemento está visible, tiene este aspecto sin el efecto de ondulación:

Etiqueta en la que aparece el texto «WIGGLY»

A continuación, crea la barra de herramientas de configuración que se utilizará para controlar el efecto.

Barra de herramientas de configuración con un campo de texto, dos controles deslizantes y un interruptor de palanca

TextField {
    id: wigglyTextField
    anchors.verticalCenter: parent.verticalCenter
    width: mainWindow.width * 0.3
    text: "Wiggly"
}
Slider {
    id: wigglyAmountYSlider
    anchors.verticalCenter: parent.verticalCenter
    width: mainWindow.width * 0.15
    from: 0
    to: 100
    value: 40
}
Slider {
    id: wigglyAmountXSlider
    anchors.verticalCenter: parent.verticalCenter
    width: mainWindow.width * 0.15
    from: 0
    to: 100
    value: 20
}
Switch {
    id: electricSwitch
    anchors.verticalCenter: parent.verticalCenter
}

Estos componentes utilizan los controles «Qt Quick », apilados dentro de un elemento « Row ». El primero es un « TextField », que puedes utilizar para cambiar el texto ondulado. A continuación, hay elementos « Slider » independientes, para controlar el tamaño de la onda en las coordenadas X e Y. El último control es un « Switch », para activar el efecto de nubes eléctricas.

WigglyEffect {
    id: wigglyEffect
    source: sourceItem
    anchors.fill: sourceItem
    timeRunning: true
    wigglyAmountX: wigglyAmountXSlider.value
    wigglyAmountY: wigglyAmountYSlider.value
    electricCloudColor.a: electricSwitch.checked ? 1.0 : 0.0
    wigglyShadows: 0.5
}

Este WigglyEffect se aplica al sourceItem definido anteriormente. El código establece timeRunning en «true» para animar el efecto. Por último, conecta algunas propiedades del efecto de sombreado a los componentes de control.

También puedes consultar el archivo « WigglyEffect.qml » para obtener más detalles sobre el efecto. Sin embargo, ese archivo lo crea la herramienta QQEM, por lo que normalmente no deberías modificarlo manualmente. En su lugar, utiliza el « Qt Quick Effect Maker» tal y como se indica en la siguiente sección.

Modificación del efecto en QQEM

Como se ha mencionado anteriormente, el efecto «WigglyEffect» se ha creado utilizando el generador de efectos « Qt Quick ». Para obtener más información sobre la instalación de QQEM, consulta la documentación «Instalación del generador de efectos Qt Quick ».

Para modificar los efectos:

  1. Abre el archivo de proyecto de efectos (qep) en la herramienta QQEM.
  2. Modifica los nodos del efecto, las propiedades o el código del shader y observa la vista previa en tiempo real.
  3. Cuando esté listo, exporte el efecto modificado a su aplicación.

Al abrir el proyecto « WigglyEffect/WigglyEffect.qep » en QQEM, deberías ver algo similar a esto:

Qt Quick Effect Maker con la vista de nodos a la izquierda y el código del shader a la derecha

En la parte izquierda, puedes ver el « Node view » con los diferentes nodos de este efecto. La vista de la esquina superior derecha es « Property view », con las propiedades (API) del efecto. La esquina inferior derecha muestra Live view del efecto, con el elemento de origen de vista previa seleccionado actualmente. Para ver la vista previa en directo con el contenido real, añade la imagen de sourceItem a la lista de fuentes en Edit > Preferences y selecciónala en la lista emergente de la barra de herramientas de vista previa.

Para modificar el código del sombreador del efecto ondulado, haz doble clic en el nodo «Wiggly» o selecciónalo y cambia del modo « DESIGN » al modo « CODE ». A continuación, selecciona la pestaña « VERT » para ver el sombreador de vértices, donde se encuentra la mayor parte del código del efecto:

@mesh 63, 1
out vec3 wigglyColor;

float rainbowColor(float phase) {
    return abs(sin(texCoord.x * 2.0 + iTime + phase));
}

@main
{
    float wave = sin(vertCoord.x * 0.01 + iTime * 3.0);
    vertCoord.x += wigglyAmountX * wave;
    vertCoord.y += wigglyAmountY * wave;
    const float tau = 6.28318530718;
    wigglyColor.r = rainbowColor(0.0);
    wigglyColor.g = rainbowColor(1.0/3.0 * tau);
    wigglyColor.b = rainbowColor(2.0/3.0 * tau);
    float shadowAmount = (wigglyAmountX + wigglyAmountY) * wave;
    wigglyColor.rgb += shadowAmount * wigglyShadows * 0.01;
}

La primera línea configura el tamaño de la malla « ShaderEffect ». Esto es necesario, ya que, por defecto, solo hay vértices en las esquinas y el efecto ondulado requiere más vértices en movimiento. A continuación, configura el sombreador de vértices para que genere la variable « wigglyColor », que se utilizará más adelante en el sombreador de fragmentos para aplicar algo de sombra. A continuación, se introduce una función llamada « rainbowColor », que devuelve el color de un único canal en la fase.

Dentro del método «main», el código establece primero la función « vertCoord » para mover las posiciones de los vértices siguiendo una onda sinusoidal. Las siguientes líneas definen los canales rojo, verde y azul del arcoíris ondulado. Las dos últimas líneas aplican luego algo de sombreado siguiendo la onda.

A continuación, selecciona la pestaña « FRAG » para ver el código del sombreador de fragmentos:

@main
{
    fragColor.rgb *= wigglyColor * fragColor.a;
}

El sombreador de fragmentos es muy sencillo y solo multiplica el color de origen actual por el « wigglyColor » recibido del sombreador de vértices.

Se podría haber realizado una mayor parte del procesamiento en el lado del sombreador de fragmentos, pero tener el código en el sombreador de vértices suele ofrecer un mejor rendimiento, ya que el número de vértices es notablemente inferior al número de fragmentos (píxeles). Algunas herramientas, como Shadertoy, solo permiten escribir un shader de fragmento. Sin embargo, dado que Qt Quick y QQEM también admiten shaders de vértice personalizados, deberías intentar aprovecharlos.

Al modificar estos shaders, el resultado de Live view cambia al instante. Para aplicar el shader modificado en la aplicación de ejemplo, selecciona en el menú « File » > « Export ».

Ahora puedes seguir explorando las funciones de QQEM. Por ejemplo, añade nuevos nodos, modifica o añade nuevas propiedades, utiliza estas propiedades en el código del sombreador, etc. A continuación se muestra un ejemplo del aspecto que tiene el efecto al añadir el nodo « LedScreen » al principio del grafo de nodos:

Texto ondulado con efecto de pantalla LED que muestra un patrón de puntos de colores

Archivos:

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