En esta página

Editor de materiales personalizados

La herramienta «Editor de materiales»

La herramienta «Editor de materiales» es una herramienta con interfaz gráfica de usuario que facilita la creación de materiales para CustomMaterials en QtQuick3D, ya que ofrece: una vista previa en tiempo real del material, resaltado de sintaxis, informes de errores y la posibilidad de exportar el material a un componente QML de CustomMaterial.

Uso

El Editor de materiales se puede iniciar ejecutando el comando:

$(QTDIR)/bin/materialeditor[.exe]

La ventana del Editor de materiales consta de dos componentes principales: el editor a la izquierda y la vista previa a la derecha.

Ventana del Editor de materiales con los editores de shaders y el panel de vista previa

Edición de shaders

En la vista del editor hay dos editores: uno para el sombreador de vértices y otro para el sombreador de fragmentos. Al editar los fragmentos de sombreador, el resultado de esos cambios se verá inmediatamente en la vista previa. Si no se pudiera compilar el material, aparecerá un mensaje describiendo el problema en el panel de salida.

El lenguaje utilizado para escribir los fragmentos de shader de « CustomMaterial » es GLSL al estilo Vulkan, con algunas palabras clave adicionales específicas de « QtQuick3D », que se identifican fácilmente porque están escritas íntegramente en mayúsculas. El editor también resaltará las palabras clave específicas de « QtQuick3D ».

Para obtener una descripción más detallada del lenguaje utilizado en los fragmentos de shader y de cómo interactúan con el resto del proceso de renderizado, consulta la documentación sobre materiales programables.

Editor de sombreadores de vértices con código de desplazamiento

Propiedades del material

La sección «Propiedades del material» contiene las propiedades QML comunes del material. Estas propiedades y cómo afectan al material se describen con más detalle en la documentación de « CustomMaterial ».

Panel «Propiedades del material» con ajustes de mezcla y sombreado

Vista previa

Además de mostrar cómo se renderiza el material actual, el panel de vista previa contiene una selección de controles que se pueden ajustar para ver cómo se ve el material en diferentes condiciones. Estos controles permiten al usuario: seleccionar un modelo diferente, activar o desactivar el uso de la iluminación basada en imágenes, encender o apagar la luz de la escena y ajustar la rotación del entorno. También es posible girar alrededor del modelo utilizando el ratón.

Panel de vista previa que muestra una esfera con un material personalizado

Uniformes

La tabla de uniformes es donde se enumeran los uniformes utilizados por los sombreadores. Los uniformes se pueden añadir, eliminar o modificar en cualquier momento, pero todos los uniformes utilizados por los fragmentos de sombreador deben añadirse a la tabla de uniformes. Una vez añadido un uniforme, estará disponible para ambos sombreadores. Al exportar el material a un componente QML, los uniformes se convertirán en propiedades del componente de material.

Panel de uniformes con parámetros flotantes

Panel de salida

El panel de salida muestra mensajes de diagnóstico, por ejemplo, errores detectados en los fragmentos de shader.

Panel de salida del shader con mensaje de error

Importación de sombreadores

Los fragmentos de shader se pueden importar a la aplicación; estos tienen la extensión de archivo .vert y .frag y se espera que contengan texto sin formato. Por supuesto, los fragmentos de shader importados deberán adaptarse manualmente si el código del shader no está en un lenguaje o en un formato que ya sea compatible con CustomMaterial (la herramienta no intenta realizar ninguna traducción).

Guardar y cargar proyectos.

El Editor de materiales puede guardar o cargar archivos de proyecto utilizando su propio formato de proyecto. La extensión de los archivos de proyecto del Editor de materiales es .qmp.

Nota: El formato de archivo de proyecto del Editor de materiales no está pensado para su uso en tiempo de ejecución, sino que está destinado exclusivamente a utilizarse con el Editor de materiales.

Exportación.

Para que el material pueda utilizarse desde una aplicación, debe exportarse como un componente QML; esto puede hacerse abriendo el cuadro de diálogo de exportación desde el menú de la aplicación. El cuadro de diálogo de exportación solicitará una carpeta de salida, el nombre del componente de material y el nombre o nombres de los fragmentos de sombreador. Una vez exportado correctamente el material, la carpeta de salida contendrá un componente QML que describe el material, junto con cualquier fragmento de sombreador y textura que necesite dicho material.

Cuadro de diálogo «Exportar material»

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