Custom3DItem QML Type
Añade un elemento personalizado a un gráfico. Más...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.1 |
| In C++: | QCustom3DItem |
| Inherited By: | |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- meshFile : string
- position : vector3d
- positionAbsolute : bool
- rotation : quaternion
- scaling : vector3d
- scalingAbsolute : bool
(since QtDataVisualization 1.2) - shadowCasting : bool
- textureFile : string
- visible : bool
Métodos
- void setRotationAxisAndAngle(vector3d axis, real angle)
Descripción detallada
Un elemento personalizado tiene una malla, una posición, una escala y una rotación personalizadas, así como una textura opcional.
Documentación de propiedades
meshFile : string
El nombre del archivo de malla del elemento. El elemento del archivo debe estar en formato Wavefront OBJ e incluir vértices, normales y coordenadas UV. Además, debe estar formado por triángulos. Si al archivo le faltan las normales o las coordenadas UV, la carga fallará y aparecerá un mensaje de error en la salida de la consola, y el elemento no se renderizará.
position : vector3d
La posición del elemento como un tipo « vector3d ». El valor por defecto es « vector3d(0.0, 0.0, 0.0) ».
La posición del elemento se especifica en coordenadas de datos o en coordenadas absolutas, dependiendo del valor de la propiedad « positionAbsolute ». Cuando se utilizan coordenadas absolutas, los valores comprendidos entre -1.0...1.0 se encuentran dentro de los rangos de los ejes.
Nota: Los elementos situados fuera del rango de cualquier eje no se representan si positionAbsolute es false, a menos que el elemento sea un Custom3DVolume que quedaría parcialmente visible y scalingAbsolute también sea false. En ese caso, se representará la parte visible del volumen.
Véase también positionAbsolute y scalingAbsolute.
positionAbsolute : bool
Define si la posición de los elementos se va a gestionar en coordenadas de datos o en coordenadas absolutas. El valor por defecto es « false ». Los elementos con coordenadas absolutas siempre se mostrarán, mientras que los que tienen coordenadas de datos solo se mostrarán si se encuentran dentro de los rangos de los ejes.
Véase también position.
rotation : quaternion
La rotación de artículos como quaternion. El valor predeterminado es quaternion(0.0, 0.0, 0.0, 0.0).
scaling : vector3d
La escala del elemento se define como un tipo « vector3d ». El valor por defecto es « vector3d(0.1, 0.1, 0.1) ».
El escalado de los elementos se especifica en valores de datos o en valores absolutos, dependiendo del valor de la propiedad scalingAbsolute. El vector por defecto, interpretado como valores absolutos, establece el elemento en el 10 % de la altura del gráfico, siempre que la malla del elemento esté normalizada y las relaciones de aspecto del gráfico no se hayan modificado con respecto a los valores por defecto.
Véase también scalingAbsolute.
scalingAbsolute : bool [since QtDataVisualization 1.2]
Define si el escalado de los elementos se debe gestionar en valores de datos o en valores absolutos. El valor predeterminado es « true ». Los elementos con escalado absoluto se mostrarán con el mismo tamaño, independientemente de los rangos de los ejes. Los elementos con escalado de datos cambiarán su tamaño aparente en función de los rangos de los ejes. Si positionAbsolute es true, esta propiedad se ignora y el escalado se interpreta como un valor absoluto. Si el elemento tiene rotación, el escalado de datos se calcula sobre el elemento sin rotar. Del mismo modo, para los elementos Custom3DVolume, el recorte de rango se calcula sobre el elemento sin rotar.
Nota: Solo se admite el escalado absoluto para los elementos Custom3DLabel o para los elementos personalizados utilizados en gráficos polar.
Nota: La malla del elemento personalizado debe normalizarse al rango [-1 ,1]; de lo contrario, el escalado de datos no será preciso.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también scaling y positionAbsolute.
shadowCasting : bool
Define si se habilita la proyección de sombras para el elemento. El valor predeterminado es « true ». Si se establece en « false », el elemento no proyecta sombras, independientemente del valor de « ShadowQuality ».
textureFile : string
El nombre del archivo de textura del elemento. Si no se especifica, se utilizará una textura gris lisa.
Nota: Para ahorrar memoria, el objeto ` QImage ` cargado desde el archivo se borra una vez creada la textura.
visible : bool
La visibilidad del elemento. El valor predeterminado es « true ».
Documentación del método
void setRotationAxisAndAngle(vector3d axis, real angle)
Una función de ayuda para construir el cuaternión de rotación a partir de axis y angle.
Véase también rotation.
© 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.