En esta página

Custom3DItem QML Type

Añade un elemento personalizado a un gráfico. Más...

Import Statement: import QtGraphs
In C++: QCustom3DItem
Inherited By:

Custom3DLabel and Custom3DVolume

Propiedades

Señales

Métodos

Descripción detallada

Un elemento personalizado tiene una malla personalizada, una posición, una escala, una rotación y 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 de malla. Se recomienda que los archivos de malla incluyan vértices, normales y coordenadas UV.

position : vector3d

La posición del elemento se define como « 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 de cualquier rango de 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).

rotationAbsolute : bool [since 6.11]

Define si la rotación de los elementos se debe gestionar mediante valores de datos o valores absolutos. El valor por defecto es « true ». Los elementos con rotación absoluta se girarán con las coordenadas predeterminadas, independientemente del eje. Los elementos con rotación basada en datos girarán según las coordenadas del eje.

Esta propiedad se introdujo en Qt 6.11.

Véase también rotation.

scaling : vector3d

La escala del elemento se define como 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 proporciones del gráfico no se hayan modificado con respecto a los valores por defecto.

Nota: Solo se admite el escalado absoluto para elementos de « Custom3DLabel » o para elementos personalizados utilizados en gráficos de « polar ».

Nota: En Qt 6.8 se asumía erróneamente que los modelos se escalaban a un tamaño de 1 (-0,5...0,5) de forma predeterminada, cuando en realidad se escalan al tamaño de 2 (-1...1). Debido a esto, todos los elementos personalizados a partir de Qt 6.9 tienen el doble de tamaño en comparación con Qt 6.8

Véase también scalingAbsolute.

scalingAbsolute : bool

Define si el escalado de los elementos se debe gestionar en función de los valores de los 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 los gráficos de « polar ».

Nota: La malla del elemento personalizado debe normalizarse al rango [-1 ,1]; de lo contrario, el escalado de datos no será preciso.

Véase también scaling y positionAbsolute.

shadowCasting : bool

Define 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 « 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 de Signal

meshFileChanged(string meshFile)

Esta señal se emite cuando meshFile cambia a meshFile.

Nota: El controlador correspondiente es onMeshFileChanged.

positionAbsoluteChanged(bool positionAbsolute)

Esta señal se emite cuando positionAbsolute cambia a positionAbsolute.

Nota: El controlador correspondiente es onPositionAbsoluteChanged.

positionChanged(vector3d position)

Esta señal se emite cuando el elemento position cambia a position.

Nota: El controlador correspondiente es onPositionChanged.

rotationChanged(quaternion rotation)

Esta señal se emite cuando rotation cambia a rotation.

Nota: El controlador correspondiente es onRotationChanged.

scalingAbsoluteChanged(bool scalingAbsolute)

Esta señal se emite cuando scalingAbsolute cambia a scalingAbsolute.

Nota: El controlador correspondiente es onScalingAbsoluteChanged.

scalingChanged(vector3d scaling)

Esta señal se emite cuando scaling cambia a scaling.

Nota: El controlador correspondiente es onScalingChanged.

shadowCastingChanged(bool shadowCasting)

Esta señal se emite cuando shadowCasting cambia a shadowCasting.

Nota: El controlador correspondiente es onShadowCastingChanged.

textureFileChanged(string textureFile)

Esta señal se emite cuando textureFile cambia a textureFile.

Nota: El controlador correspondiente es onTextureFileChanged.

visibleChanged(bool visible)

Esta señal se emite cuando visible cambia a visible.

Nota: El controlador correspondiente es onVisibleChanged.

Documentación del método

void setRotationAxisAndAngle(vector3d axis, real angle)

Una función práctica 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.