En esta página

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:

QCustom3DLabel y QCustom3DVolume

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.