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
- lastError : enumeration
- projectionPlaneV : vector3d
- projectionPlaneW : vector3d
- source : url
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.
| |
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.
