Grafo de escena: Metal en QML
Muestra cómo realizar el renderizado directamente con Metal en una escena de Qt Quick.
Qt Quick con texto superpuesto" src="images/metalunderqml-example.jpg" title="Cuadrado-círculo animado renderizado con Metal en una escena de Qt Quick con texto superpuesto"/>
El ejemplo «Metal bajo QML» muestra cómo una aplicación puede utilizar las señales « QQuickWindow::beforeRendering()» y « QQuickWindow::beforeRenderPassRecording()» para dibujar contenido Metal personalizado en una escena « Qt Quick ». Esta señal se emite al inicio de cada fotograma, antes de que el grafo de escena comience su renderizado; por lo tanto, cualquier llamada de dibujo de Metal que se realice en respuesta a esta señal se apilará bajo los elementos « Qt Quick ». Hay dos señales porque los comandos Metal personalizados se registran en el mismo búfer de comandos con el mismo codificador de comandos de renderizado que utiliza el gráfico de escena. La señal beforeRendering() por sí sola no es suficiente para esto, ya que se emite al inicio del fotograma, antes de que haya un MTLRenderCommandEncoder disponible. Al conectarse también a beforeRenderPassRecording(), la aplicación puede acceder a los objetos nativos necesarios.
Como alternativa, las aplicaciones que deseen renderizar contenido Metal sobre la escena de « Qt Quick » pueden hacerlo conectándose a las señales « QQuickWindow::afterRendering()» y « QQuickWindow::afterRenderPassRecording()».
En este ejemplo, también veremos cómo es posible disponer de valores expuestos a QML que afectan al renderizado de Metal. Animamos el valor umbral utilizando un ` NumberAnimation ` en el archivo QML y este valor es utilizado por el programa de sombreado de Metal que dibuja los «squircles».
El ejemplo es equivalente en la mayoría de los aspectos a los ejemplos «OpenGL bajo QML», «Direct3D 11 bajo QML» y «Vulkan bajo QML»; todos ellos renderizan el mismo contenido personalizado, solo que a través de diferentes API nativas.
© 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.