En esta página

ProceduralMesh QML Type

Permite crear geometría desde QML. Más...

Import Statement: import QtQuick3D.Helpers
Since: Qt 6.6
Inherits:

Geometry

Propiedades

Descripción detallada

ProceduralMesh es un tipo auxiliar que permite crear instancias de Geometry desde QML. El componente Geometry es abstracto y suele crearse desde C++.

component TorusMesh : ProceduralMesh {
    property real rings: 50
    property real segments: 50
    property real radius: 100.0
    property real tubeRadius: 10.0
    property var meshArrays: generateTorus(rings, segments, radius, tubeRadius)
    positions: meshArrays.verts
    normals: meshArrays.normals
    uv0s: meshArrays.uvs
    indexes: meshArrays.indices

    function generateTorus(rings: real, segments: real, radius: real, tubeRadius: real) {
        let verts = []
        let normals = []
        let uvs = []
        let indices = []

        for (let i = 0; i <= rings; ++i) {
            for (let j = 0; j <= segments; ++j) {
                let u = i / rings * Math.PI * 2;
                let v = j / segments * Math.PI * 2;

                let centerX = radius * Math.cos(u);
                let centerZ = radius * Math.sin(u);

                let posX = centerX + tubeRadius * Math.cos(v) * Math.cos(u);
                let posY = tubeRadius * Math.sin(v);
                let posZ = centerZ + tubeRadius * Math.cos(v) * Math.sin(u);

                verts.push(Qt.vector3d(posX, posY, posZ));

                let normal = Qt.vector3d(posX - centerX, posY, posZ - centerZ).normalized();
                normals.push(normal);

                uvs.push(Qt.vector2d(i / rings, j / segments));
            }
        }

        for (let i = 0; i < rings; ++i) {
            for (let j = 0; j < segments; ++j) {
                let a = (segments + 1) * i + j;
                let b = (segments + 1) * (i + 1) + j;
                let c = (segments + 1) * (i + 1) + j + 1;
                let d = (segments + 1) * i + j + 1;

                // Generate two triangles for each quad in the mesh
                // Adjust order to be counter-clockwise
                indices.push(a, d, b);
                indices.push(b, d, c);
            }
        }
        return { verts: verts, normals: normals, uvs: uvs, indices: indices }
    }
}

El código anterior define un componente TorusMesh que puede utilizarse como Geometry para su uso con un componente Model. Cuando se modifican las propiedades ring, segments, radius o tubeRadius, la geometría se actualiza.

El componente ProceduralMesh no es tan flexible ni ofrece el mismo rendimiento que la creación de Geometry en C++, pero lo compensa con su comodidad y simplicidad. Las propiedades son listas de atributos fijas que, al rellenarlas, generan automáticamente los búferes necesarios.

Documentación de las propiedades

binormals : List<QVector3D>

Contiene la lista de atributos de binormales.

colors : List<QVector4D>

Esta propiedad define una lista de valores de color de vértices.

indexes : List<int>

Esta propiedad define una lista de índices para las listas de atributos. Si esta lista permanece vacía, se utilizarán directamente los valores del búfer de vértices.

joints : List<QVector4D>

Esta propiedad define una lista de índices de articulaciones para el skinning.

normals : List<QVector3D>

Contiene la lista de atributos de normales.

positions : List<QVector3D>

La lista de atributos de posiciones. Si esta lista permanece vacía, no se generará ninguna geometría.

primitiveMode : enumeration [default: ProceduralMesh.Triangles]

Esta propiedad define el modo primitivo que se utilizará al renderizar la geometría.

ConstanteDescripción
ProceduralMesh.PointsSe utiliza el modo primitivo de puntos.
ProceduralMesh.LineStripSe utiliza el modo primitivo de franja de líneas.
ProceduralMesh.LinesSe utiliza el modo primitivo de líneas.
ProceduralMesh.TriangleStripSe utiliza el modo primitivo de franja de triángulos.
ProceduralMesh.TriangleFanSe utiliza el modo primitivo de abanico de triángulos.
ProceduralMesh.TrianglesSe utiliza el modo primitivo de triángulos.

Nota: No todos los modos son compatibles con todos los backends de renderizado.

subsets : List<ProceduralMeshSubset>

Esta propiedad define una lista de subconjuntos en los que se dividirán los datos geométricos. Cada subconjunto puede tener su propio material. El orden de este array se corresponde con la lista de materiales del modelo cuando se utiliza esta geometría.

Esta propiedad es opcional y, si se deja vacía, se crea un único subconjunto.

Nota: Cualquier subconjunto que especifique valores fuera del rango de valores de vértices/índices disponibles hará que dicho subconjunto sea ignorado.

tangents : List<QVector3D>

Contiene la lista de atributos de tangentes.

uv0s : List<QVector2D>

Esta propiedad define una lista de coordenadas UV para el primer canal UV (uv0)

uv1s : List<QVector2D>

Esta propiedad define una lista de coordenadas UV para el segundo canal UV (uv1)

weights : List<QVector4D>

Esta propiedad define una lista de pesos de articulaciones para el skinning.

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