QCustom3DItem Class
La clase QCustom3DItem añade un elemento personalizado a un gráfico. Más información...
| Encabezado: | #include <QCustom3DItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.1 |
| En QML: | Custom3DItem |
| Heredado de: | QObject |
| Heredado por: | |
| Estado: | Obsoleto |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Propiedades
|
|
Funciones públicas
| QCustom3DItem(QObject *parent = nullptr) | |
| QCustom3DItem(const QString &meshFile, const QVector3D &position, const QVector3D &scaling, const QQuaternion &rotation, const QImage &texture, QObject *parent = nullptr) | |
| virtual | ~QCustom3DItem() |
| bool | isPositionAbsolute() const |
| bool | isScalingAbsolute() const |
| bool | isShadowCasting() const |
| bool | isVisible() const |
| QString | meshFile() const |
| QVector3D | position() const |
| QQuaternion | rotation() |
| QVector3D | scaling() const |
| void | setMeshFile(const QString &meshFile) |
| void | setPosition(const QVector3D &position) |
| void | setPositionAbsolute(bool positionAbsolute) |
| void | setRotation(const QQuaternion &rotation) |
| void | setRotationAxisAndAngle(const QVector3D &axis, float angle) |
| void | setScaling(const QVector3D &scaling) |
| void | setScalingAbsolute(bool scalingAbsolute) |
| void | setShadowCasting(bool enabled) |
| void | setTextureFile(const QString &textureFile) |
| void | setTextureImage(const QImage &textureImage) |
| void | setVisible(bool visible) |
| QString | textureFile() const |
Señales
| void | meshFileChanged(const QString &meshFile) |
| void | positionAbsoluteChanged(bool positionAbsolute) |
| void | positionChanged(const QVector3D &position) |
| void | rotationChanged(const QQuaternion &rotation) |
| void | scalingAbsoluteChanged(bool scalingAbsolute) |
| void | scalingChanged(const QVector3D &scaling) |
| void | shadowCastingChanged(bool shadowCasting) |
| void | textureFileChanged(const QString &textureFile) |
| void | visibleChanged(bool visible) |
Descripción detallada
Un elemento personalizado tiene una malla, una posición, un escalado y una rotación personalizados, además de una textura opcional.
Véase también QAbstract3DGraph::addCustomItem().
Documentación de propiedades
meshFile : QString
Esta propiedad contiene el nombre del archivo de malla del objeto.
El elemento del archivo debe estar en formato Wavefront OBJ e incluir vértices, normales y coordenadas UV. Además, debe estar organizado en 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á.
Funciones de acceso:
| QString | meshFile() const |
| void | setMeshFile(const QString &meshFile) |
Señal de notificación:
| void | meshFileChanged(const QString &meshFile) |
position : QVector3D
Esta propiedad almacena la posición del elemento como un objeto ` QVector3D`.
El valor por defecto es « QVector3D(0.0, 0.0, 0.0) ».
La posición del elemento se especifica en coordenadas de datos o en coordenadas absolutas, dependiendo 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 de cualquier rango de eje no se representan si positionAbsolute es false, a menos que el elemento sea un QCustom3DVolume que quedaría parcialmente visible y scalingAbsolute también sea false. En ese caso, se representará la parte visible del volumen.
Funciones de acceso:
| QVector3D | position() const |
| void | setPosition(const QVector3D &position) |
Señal de notificador:
| void | positionChanged(const QVector3D &position) |
Véase también positionAbsolute.
positionAbsolute : bool
Esta propiedad determina 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 representarán, mientras que los elementos con coordenadas de datos solo se representarán si se encuentran dentro de los rangos de los ejes.
Funciones de acceso:
| bool | isPositionAbsolute() const |
| void | setPositionAbsolute(bool positionAbsolute) |
Señal de notificación:
| void | positionAbsoluteChanged(bool positionAbsolute) |
Véase también position.
rotation : QQuaternion
Esta propiedad almacena la rotación del elemento como un objeto de tipo « QQuaternion ».
El valor por defecto es « QQuaternion(0.0, 0.0, 0.0, 0.0) ».
Funciones de acceso:
| QQuaternion | rotation() |
| void | setRotation(const QQuaternion &rotation) |
Señal de notificación:
| void | rotationChanged(const QQuaternion &rotation) |
scaling : QVector3D
Esta propiedad almacena el escalado del elemento como un objeto ` QVector3D`.
El valor predeterminado es « QVector3D(0.1, 0.1, 0.1) ».
El escalado del elemento se realiza en valores de datos o en valores absolutos, dependiendo 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 respecto a los valores predeterminados.
Funciones de acceso:
| QVector3D | scaling() const |
| void | setScaling(const QVector3D &scaling) |
Señal de notificación:
| void | scalingChanged(const QVector3D &scaling) |
Véase también scalingAbsolute.
[since QtDataVisualization 1.2] scalingAbsolute : bool
Esta propiedad determina si el escalado de los elementos debe gestionarse en valores de datos o en valores absolutos.
El valor predeterminado es « true ».
Los elementos con escalado absoluto se representarán con el mismo tamaño, independientemente de los rangos de los ejes. Los elementos con escalado basado en datos cambiarán su tamaño aparente según 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 basado en datos se calcula sobre el elemento sin rotar. Del mismo modo, para los elementos QCustom3DVolume, el recorte de rango se calcula sobre el elemento sin rotar.
Nota: Solo se admite el escalado absoluto para los elementos QCustom3DLabel 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 enumeración se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| bool | isScalingAbsolute() const |
| void | setScalingAbsolute(bool scalingAbsolute) |
Señal de notificador:
| void | scalingAbsoluteChanged(bool scalingAbsolute) |
Véase también scaling y positionAbsolute.
shadowCasting : bool
Esta propiedad determina si se habilita la proyección de sombras para el elemento.
El valor por defecto es « true ». Si se establece en « false », el elemento no proyecta sombras independientemente de « QAbstract3DGraph::ShadowQuality ».
Funciones de acceso:
| bool | isShadowCasting() const |
| void | setShadowCasting(bool enabled) |
Señal de notificación:
| void | shadowCastingChanged(bool shadowCasting) |
textureFile : QString
Esta propiedad contiene el nombre del archivo de textura del elemento.
Si ni esta propiedad ni la imagen de textura están definidas, se utilizará una textura gris lisa.
Nota: Para ahorrar memoria, el objeto « QImage » cargado desde el archivo se borra una vez creada la textura.
Funciones de acceso:
| QString | textureFile() const |
| void | setTextureFile(const QString &textureFile) |
Señal de notificación:
| void | textureFileChanged(const QString &textureFile) |
visible : bool
Esta propiedad determina la visibilidad del elemento.
El valor por defecto es « true ».
Funciones de acceso:
| bool | isVisible() const |
| void | setVisible(bool visible) |
Señal del notificador:
| void | visibleChanged(bool visible) |
Documentación de funciones de miembro
[explicit] QCustom3DItem::QCustom3DItem(QObject *parent = nullptr)
Crea un elemento 3D personalizado con el ` parent` especificado.
[explicit] QCustom3DItem::QCustom3DItem(const QString &meshFile, const QVector3D &position, const QVector3D &scaling, const QQuaternion &rotation, const QImage &texture, QObject *parent = nullptr)
Crea un elemento 3D personalizado con los valores especificados para « meshFile », « position », « scaling », « rotation » y « texture », así como una imagen y, opcionalmente, « parent ».
[virtual noexcept] QCustom3DItem::~QCustom3DItem()
Elimina el elemento 3D personalizado.
[invokable] void QCustom3DItem::setRotationAxisAndAngle(const QVector3D &axis, float angle)
Una función de conveniencia para construir el cuaternión de rotación a partir de axis y angle.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también rotation.
void QCustom3DItem::setTextureImage(const QImage &textureImage)
Establece el valor de « textureImage » como « QImage » para el elemento. La textura predeterminada es gris liso.
Nota: Para ahorrar memoria, el ` QImage ` indicado se borra una vez creada la textura.
© 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.