Qt Quick 3D - Ejemplo de submalla
Muestra cómo asignar materiales a las submallas.

Este ejemplo muestra cómo se asignan los materiales a las submallas.
Submallas y materiales
Cuando un « Model » está compuesto por dos o más mallas, estas se denominan submallas. Cada submalla puede tener su propio material, pero no es obligatorio proporcionar más de un material por modelo. Si hay más submallas que materiales, se utiliza el último material de la lista materials para todas las submallas restantes. Cuando un modelo cuenta con un material por submalla, estos se asignan de forma uno a uno, lo que significa que el primer material de la lista se aplica a la primera submalla, el segundo material a la segunda submalla, y así sucesivamente. El orden de las submallas en un modelo depende de cómo se haya creado y exportado dicho modelo mediante la herramienta de modelado 3D utilizada para crearlo.
El siguiente ejemplo muestra dos cubos deformados en los que cada cara del cubo es una submalla independiente.
Si observamos el cubo de la izquierda, vemos que hay una cara de color rojo, mientras que el resto de las caras son verdes; la razón de esto es, por supuesto, que el modelo solo tiene dos materiales: uno rojo y otro verde. En nuestro modelo, la primera submalla resulta ser la cara «superior» del cubo deformado y, dado que el material rojo es el primero de la lista de materiales, adquiere el color rojo tal y como cabría esperar. El segundo material de la lista es el verde, que se asigna a la segunda submalla, que es la cara «frontal» del cubo deformado, y, dado que es el último material de la lista, también será el material utilizado para todas las caras restantes del cubo deformado.

DistortedCube {
x: -4
scale: Qt.vector3d(2, 2, 2)
materials: [ PrincipledMaterial {
baseColor: "red"
lighting: PrincipledMaterial.NoLighting
},
PrincipledMaterial {
baseColor: "green"
lighting: PrincipledMaterial.NoLighting
} ]Si observamos el cubo de la derecha, podemos ver que se le han asignado más colores; esto se debe, por supuesto, a que ahora hemos proporcionado un material para cada una de las seis submallas, cada uno con un color diferente.

Model {
source: "qrc:/meshes/distortedcube.mesh"
PrincipledMaterial {
id: frontTop_material
baseColor: "red"
cullMode: Material.NoCulling
lighting: PrincipledMaterial.NoLighting
}
PrincipledMaterial {
id: frontBottom_material
baseColor: "green"
cullMode: Material.NoCulling
lighting: PrincipledMaterial.NoLighting
}
PrincipledMaterial {
id: leftSide_material
baseColor: "blue"
cullMode: Material.NoCulling
lighting: PrincipledMaterial.NoLighting
}
PrincipledMaterial {
id: rightSide_material
baseColor: "pink"
cullMode: Material.NoCulling
lighting: PrincipledMaterial.NoLighting
}
PrincipledMaterial {
id: backSide_material
baseColor: "orange"
cullMode: Material.NoCulling
lighting: PrincipledMaterial.NoLighting
}
PrincipledMaterial {
id: bottomSide_material
baseColor: "navy"
cullMode: Material.NoCulling
lighting: PrincipledMaterial.NoLighting
}
materials: [
frontTop_material,
frontBottom_material,
leftSide_material,
backSide_material,
rightSide_material,
bottomSide_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.