En esta página

WavefrontMesh QML Type

WavefrontMesh proporciona una malla basada en un archivo .obj de Wavefront. Más información...

Import Statement: import Qt.labs.wavefrontmesh 1.12

Propiedades

Descripción detallada

geometry WavefrontMesh lee la geometría de un archivo .obj de Wavefront y, a partir de ella, genera una malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de malla de m Si se definen, se especificarán mediante projectionPlaneV y projectionPlaneW. De lo contrario, se utilizará la primera cara que se encuentre en los datos para determinar el plano de proyección.

Si el archivo contiene coordenadas de textura, también se utilizarán. De lo contrario, se normalizarán y utilizarán los vértices del objeto.

La malla se puede utilizar en un « ShaderEffect » para definir la geometría sombreada. La geometría se normalizará antes de su uso, por lo que la posición y la escala de los objetos de entrada no influirán en el resultado.

Nota: Algunos exportadores de Wavefront modifican el sistema de coordenadas de la escena de origen antes de exportarla. Esto puede provocar resultados inesperados cuando Qt aplica la proyección. Si los resultados visuales no son los esperados, comprueba los parámetros de exportación y la documentación de la herramienta de edición para ver si este es el caso.

Por ejemplo, el siguiente ejemplo toma un archivo .obj que contiene un toro estándar y visualiza las coordenadas de textura generadas automáticamente.

Forma de toro con coordenadas de textura en gradiente

import QtQuick 2.\1
import Qt.labs.wavefrontmesh 1.\1

ShaderEffect {
    width: 200
    height: 200
    mesh: WavefrontMesh {
        source: "torus.obj"
        projectionPlaneV: Qt.vector3d(0, 1, 0)
        projectionPlaneW: Qt.vector3d(1, 0, 0)
    }
    vertexShader: "
            uniform highp mat4 qt_Matrix;
            attribute highp vec4 qt_Vertex;
            attribute highp vec2 qt_MultiTexCoord0;
            varying highp vec2 coord;
            void main() {
                coord = qt_MultiTexCoord0;
                gl_Position = qt_Matrix * qt_Vertex;
            }"
    fragmentShader: "
            varying highp vec2 coord;
            uniform lowp float qt_Opacity;
            void main() {
                gl_FragColor = vec4(coord.x, coord.y, 0.0, 1.0);
            }"

}

Nota: Dado que la entrada es un toro 3D, debemos definir el plano de proyección. Esto no sería necesario si se utilizara una forma 2D como entrada. En este caso utilizamos el plano XY, debido a la orientación de la entrada.

Documentación de propiedades

lastError : enumeration

Esta propiedad contiene el último error, si lo hubiera, que se produjo al analizar el código fuente o al construir la malla.

  • WavefrontMesh.NoError No se ha producido ningún error.
  • WavefrontMesh.InvalidSourceError El archivo de origen no se ha reconocido como un archivo .obj válido.
  • WavefrontMesh.UnsupportedFaceShapeError Las caras del archivo de origen son de un tipo no compatible. WavefrontMesh solo admite triángulos y cuadriláteros convexos.
  • WavefrontMesh.UnsupportedIndexSizeError La forma del archivo de origen es demasiado grande. Solo se admiten índices de 16 bits.
  • WavefrontMesh.FileNotFoundError No se ha encontrado el archivo de origen.
  • WavefrontMesh.MissingPositionAttributeError Falta el atributo «qt_Vertex» en los shaders.
  • WavefrontMesh.MissingTextureCoordinateAttributeError El nombre del atributo de coordenadas de textura en los sombreadores es incorrecto. Utiliza «qt_MultiTexCoord0».
  • WavefrontMesh.MissingPositionAndTextureCoordinateAttributesError Faltan tanto el atributo «qt_Vertex» como el «qt_MultiTexCoord0» en los sombreadores.
  • WavefrontMesh.TooManyAttributesError Los shaders esperan demasiados atributos (el máximo son dos: posición, «qt_Vertex», y coordenadas de textura, «qt_MultiTexCoord0»).
  • WavefrontMesh.InvalidPlaneDefinitionError Los vectores V y W del plano no pueden ser nulos ni paralelos entre sí.

projectionPlaneV : vector3d

Dado que el formato .obj de Wavefront describe un objeto en el espacio 3D, las coordenadas deben proyectarse en 2D antes de que puedan visualizarse en Qt Quick.

Esto se llevará a cabo en WavefrontMesh mediante una proyección ortográfica sobre un plano adecuado.

El vector «projectionPlaneV» es uno de los dos vectores del plano en el espacio 3D. Si este o « projectionPlaneW » se establecen en (0, 0, 0) (el valor por defecto), el plano se detectará en función de la primera cara que se encuentre en el conjunto de datos.

Nota: «projectionPlaneV» y « projectionPlaneW » no pueden ser vectores paralelos.

projectionPlaneW : vector3d

Dado que el formato .obj de Wavefront describe un objeto en el espacio 3D, las coordenadas deben proyectarse en 2D antes de poder visualizarse en Qt Quick.

Esto se llevará a cabo en WavefrontMesh mediante una proyección ortográfica sobre un plano adecuado.

El vector «projectionPlaneW» es uno de los dos vectores del plano en el espacio 3D. Si este, o « projectionPlaneV », se establece en (0, 0, 0) (el valor por defecto), el plano se detectará basándose en la primera cara que se encuentre en el conjunto de datos.

Nota: « projectionPlaneV » y «projectionPlaneW» no pueden ser vectores paralelos.

source : url

Esta propiedad contiene la URL de la fuente. Debe tratarse de un archivo local o de un archivo qrc. La fuente se leerá como un archivo .obj de Wavefront y se actualizará la geometría.

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