AbstractGraph3D QML Type
Tipo básico para visualizaciones en 3D. Más información...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| Inherited By: | |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- aspectRatio : real
(since QtDataVisualization 1.1) - currentFps : int
(since QtDataVisualization 1.1) - customItemList : list<Custom3DItem>
(since QtDataVisualization 1.1) - horizontalAspectRatio : real
(since QtDataVisualization 1.2) - inputHandler : AbstractInputHandler3D
- locale : locale
(since QtDataVisualization 1.2) - margin : real
(since QtDataVisualization 1.2) - measureFps : bool
(since QtDataVisualization 1.1) - msaaSamples : int
- optimizationHints : AbstractGraph3D.OptimizationHints
(since QtDataVisualization 1.1) - orthoProjection : bool
(since QtDataVisualization 1.1) - polar : bool
(since QtDataVisualization 1.2) - queriedGraphPosition : vector3d
(since QtDataVisualization 1.2) - radialLabelOffset : real
(since QtDataVisualization 1.2) - reflection : bool
(since QtDataVisualization 1.2) - reflectivity : real
(since QtDataVisualization 1.2) - scene : Scene3D
- selectedElement : AbstractGraph3D.ElementType
(since QtDataVisualization 1.1) - selectionMode : AbstractGraph3D.SelectionMode
- shadowQuality : AbstractGraph3D.ShadowQuality
- shadowsSupported : bool
- theme : Theme3D
Métodos
- int addCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void clearSelection()
- bool hasSeries(Abstract3DSeries series)
(since 6.3) - void releaseCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItemAt(vector3d position)
(since QtDataVisualization 1.1) - void removeCustomItems()
(since QtDataVisualization 1.1) - Abstract3DAxis selectedAxis()
(since QtDataVisualization 1.1) - Custom3DItem selectedCustomItem()
(since QtDataVisualization 1.1) - int selectedCustomItemIndex()
(since QtDataVisualization 1.1) - int selectedLabelIndex()
(since QtDataVisualization 1.1)
Descripción detallada
El tipo base para todas las visualizaciones en 3D de QtDataVisualization.
Este tipo no se puede crear, pero contiene propiedades que son comunes a todas las visualizaciones en 3D.
Véase también Bars3D, Scatter3D, Surface3D y Qt Data Visualization C++ Classes.
Documentación de propiedades
aspectRatio : real [since QtDataVisualization 1.1]
La relación de escala del gráfico entre el eje más largo en el plano horizontal y el eje y. El valor por defecto es « 2.0 ».
Nota: Notiene ningún efecto en Bars3D.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Véase también horizontalAspectRatio.
currentFps : int [since QtDataVisualization 1.1]
Cuando se activa la medición de FPS, los resultados del último segundo se almacenan en esta propiedad de solo lectura. Este valor tarda al menos un segundo en actualizarse tras activar la medición.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Véase también measureFps.
customItemList : list<Custom3DItem> [since QtDataVisualization 1.1]
La lista de elementos de tipo « Custom3DItem » añadidos al gráfico. El gráfico asume la propiedad de los elementos añadidos.
Esta propiedad se introdujo en QtDataVisualization 1.1.
horizontalAspectRatio : real [since QtDataVisualization 1.2]
La relación de escala del gráfico entre el eje x y el eje z. El valor « 0.0 » indica una escala automática según los rangos de los ejes. El valor por defecto es « 0.0 ».
Nota: Notiene ningún efecto en Bars3D, que gestiona el escalado en el plano horizontal mediante las propiedades barThickness y barSpacing. Los gráficos polares también ignoran esta propiedad.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también « aspectRatio », « polar », « Bars3D::barThickness » y « Bars3D::barSpacing ».
inputHandler : AbstractInputHandler3D
El controlador de entrada activo utilizado en el gráfico. Puedes desactivar los controladores de entrada predeterminados estableciendo esta propiedad en null.
locale : locale [since QtDataVisualization 1.2]
Establece la configuración regional utilizada para dar formato a diversas etiquetas numéricas. El valor predeterminado es la configuración regional « "C" ».
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también ValueAxis3D::labelFormat.
margin : real [since QtDataVisualization 1.2]
El valor absoluto que se utiliza para el espacio que queda entre el borde del área trazable del gráfico y el borde del fondo del gráfico.
Si el valor del margen es negativo, los márgenes se determinan automáticamente y pueden variar en función del tamaño de los elementos de la serie y del tipo de gráfico. El valor se interpreta como una fracción del rango del eje y si las proporciones del gráfico no se han modificado con respecto a los valores predeterminados. El valor predeterminado es -1.0.
Nota: Establecer un margen para un gráfico de dispersión menor que el margen determinado automáticamente puede provocar que los elementos de dispersión situados en los bordes del gráfico se superpongan con el fondo del gráfico.
Nota: En los gráficos de dispersión y de superficie, si el margen es pequeño en comparación con el tamaño de las etiquetas de los ejes, las posiciones de las etiquetas de los extremos de los ejes se ajustan para evitar que se superpongan con las etiquetas de los extremos de los ejes adyacentes.
Esta propiedad se introdujo en QtDataVisualization 1.2.
measureFps : bool [since QtDataVisualization 1.1]
Si se establece ` true`, la visualización se realiza de forma continua en lugar de bajo demanda, y se actualiza el valor de la propiedad ` currentFps `. El valor por defecto es ` false`.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Véase también currentFps.
msaaSamples : int
El número de muestras utilizadas en el antialiasing multimuestra cuando renderingMode es « RenderIndirect ». Cuando renderingMode es « RenderDirectToBackground » o « RenderDirectToBackground_NoClear », el valor de esta propiedad es de solo lectura y devuelve el número de muestras especificado por el formato de superficie de la ventana. El valor por defecto es « 4 ».
Véase también renderingMode.
optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]
Si se utiliza el modo predeterminado o el modo estático para optimizar la representación.
El modo predeterminado ofrece todas las funciones con un nivel de rendimiento razonable. El modo estático optimiza la representación de los gráficos y es ideal para conjuntos de datos grandes que no varían. Es más lento con cambios dinámicos en los datos y rotaciones de elementos. La selección no está optimizada, por lo que no es recomendable utilizar el modo estático con conjuntos de datos muy grandes. La optimización estática solo funciona en gráficos de dispersión. El valor por defecto es OptimizationDefault.
Nota: En algunos entornos, es posible que los gráficos de gran tamaño que utilizan la optimización estática no se representen, ya que todos los elementos se representan mediante una única llamada de dibujo, y los distintos controladores gráficos admiten diferentes recuentos máximos de vértices por llamada. Esto suele ser un problema en plataformas de 32 bits y OpenGL ES2. Para solucionar este problema, elige una malla de elementos con un número reducido de vértices o utiliza la malla de puntos.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Véase también Abstract3DSeries::mesh y QAbstract3DGraph::OptimizationHint.
orthoProjection : bool [since QtDataVisualization 1.1]
Si se establece en « true », se utilizará la proyección ortográfica para mostrar el gráfico. El valor por defecto es « false ».
Nota: Las sombras se desactivarán si se establece en true.
Esta propiedad se introdujo en QtDataVisualization 1.1.
polar : bool [since QtDataVisualization 1.2]
Si se establece true, los ejes horizontales se transforman en ejes polares. El eje x pasa a ser el eje angular y el eje z, el eje radial. El modo polar no está disponible para los gráficos de barras.
El valor por defecto es false.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también « orthoProjection » y « radialLabelOffset ».
queriedGraphPosition : vector3d [since QtDataVisualization 1.2]
Esta propiedad de solo lectura contiene los últimos valores de posición del gráfico a lo largo de cada eje consultados mediante Scene3D::graphPositionQuery. Los valores están normalizados para que estén comprendidos en el intervalo [-1, 1]. Si la posición consultada se encontraba fuera de los límites del gráfico, los valores no reflejarán la posición real, sino que corresponderán a una posición indefinida fuera del intervalo [-1, 1]. El valor permanecerá indefinido hasta que se realice una consulta.
No existe una única coordenada 3D correcta que se corresponda con una posición concreta en la pantalla, por lo que, en aras de la coherencia, las consultas siempre se realizan respecto a los lados interiores de un rectángulo invisible que rodea el gráfico.
Nota: Los gráficosde barras solo permiten consultar la posición del gráfico a la altura de la base del mismo, por lo que el valor de y es siempre cero en los gráficos de barras y las consultas válidas solo pueden realizarse en posiciones de la pantalla que contengan la base del gráfico.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también Scene3D::graphPositionQuery.
radialLabelOffset : real [since QtDataVisualization 1.2]
Esta propiedad especifica el desplazamiento horizontal normalizado de las etiquetas del eje polar radial. El valor 0.0 indica que las etiquetas deben dibujarse junto a la línea de la cuadrícula del eje angular correspondiente al ángulo 0. El valor 1.0 indica que las etiquetas se dibujan en su ubicación habitual, en el borde del fondo del gráfico. Esta propiedad se ignora si el valor de la propiedad «polar» es false. El valor por defecto es 1.0.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también polar.
reflection : bool [since QtDataVisualization 1.2]
Activa o desactiva los reflejos en el suelo. El valor predeterminado es « false ».
Nota: Soloafecta a Bars3D. Sin embargo, en los gráficos Bars3D que contienen valores tanto positivos como negativos, no se admiten reflejos para los elementos personalizados que se cruzan con el plano del suelo. En ese caso, se deben desactivar los reflejos para evitar una representación incorrecta.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también reflectivity.
reflectivity : real [since QtDataVisualization 1.2]
Establece la reflectividad del suelo. Cuanto mayor sea el valor, más reflectante será el suelo. El rango válido es [0...1]. El valor por defecto es 0.5.
Nota: Soloafecta a Bars3D.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también reflection.
scene : Scene3D
El puntero Scene3D que se puede utilizar para manipular la escena y acceder a los elementos de la misma, como la cámara activa.
Esta propiedad es de solo lectura.
selectedElement : AbstractGraph3D.ElementType [since QtDataVisualization 1.1]
El elemento seleccionado en el gráfico.
Esta propiedad se puede utilizar para consultar el tipo del elemento seleccionado. El tipo es válido hasta que se realice una nueva selección en el gráfico y se emita la señal « selectedElementChanged ».
La señal se puede utilizar, por ejemplo, para implementar un manejo de entradas personalizado, tal y como se muestra en el ejemplo «Axis Handling ».
Esta propiedad se introdujo en QtDataVisualization 1.1.
Véanse también « selectedLabelIndex()», « selectedAxis()», « selectedCustomItemIndex()», « selectedCustomItem()», « Bars3D::selectedSeries », « Scatter3D::selectedSeries », « Scene3D::selectionQueryPosition » y « QAbstract3DGraph::ElementType ».
selectionMode : AbstractGraph3D.SelectionMode
El modo de selección activo en la visualización. Uno de los valores de la enumeración QAbstract3DGraph::SelectionFlag.
Véase también QAbstract3DGraph::SelectionFlag.
shadowQuality : AbstractGraph3D.ShadowQuality
La calidad de las sombras. Uno de los valores de la enumeración QAbstract3DGraph::ShadowQuality.
Véase también QAbstract3DGraph::ShadowQuality.
shadowsSupported : bool
Esta propiedad de solo lectura indica si la configuración actual admite sombras. Las configuraciones de OpenGL ES2 no admiten sombras.
theme : Theme3D
El tema activo del gráfico.
Véase también Theme3D.
Documentación del método
[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)
Añade un Custom3DItem item al gráfico. El gráfico asume la propiedad del elemento añadido.
Devuelve el índice del elemento añadido si la adición se ha realizado correctamente, -1 si se intenta añadir un elemento nulo, y el índice del elemento si se intenta añadir un elemento que ya está presente.
Este método se introdujo en QtDataVisualization 1.1.
Véase también removeCustomItems(), removeCustomItem() y removeCustomItemAt().
void clearSelection()
Borra la selección de todas las series asociadas.
[since 6.3] bool hasSeries(Abstract3DSeries series)
Devuelve si el objeto « series » ya se ha añadido al gráfico.
Este método se introdujo en Qt 6.3.
[since QtDataVisualization 1.1] void releaseCustomItem(Custom3DItem item)
Recupera la propiedad de « item » y elimina « item » del gráfico.
Nota: Si se vuelve a añadir el mismo elemento al gráfico, es necesario volver a configurar el archivo de textura.
Este método se introdujo en QtDataVisualization 1.1.
Véase también Custom3DItem::textureFile.
[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)
Elimina el objeto personalizado ` item`. Borra los recursos que se le han asignado.
Este método se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] void removeCustomItemAt(vector3d position)
Elimina todos los elementos personalizados de position. Borra los recursos que se les han asignado.
Este método se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] void removeCustomItems()
Elimina todos los elementos personalizados. Borra los recursos que tenían asignados.
Este método se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] Abstract3DAxis selectedAxis()
Se puede utilizar para obtener el eje seleccionado tras recibir una señal « selectedElementChanged » con cualquier tipo de etiqueta. La selección es válida hasta la siguiente señal « selectedElementChanged ».
Devuelve el eje seleccionado o nulo.
Este método se introdujo en QtDataVisualization 1.1.
Véase también selectedElement.
[since QtDataVisualization 1.1] Custom3DItem selectedCustomItem()
Se puede utilizar para obtener el elemento personalizado seleccionado tras recibir una señal « selectedElementChanged » de tipo « ElementCustomItem ». La propiedad del elemento sigue perteneciendo al gráfico. La selección es válida hasta la siguiente señal « selectedElementChanged ».
Devuelve el elemento personalizado seleccionado o `null`.
Este método se introdujo en QtDataVisualization 1.1.
Véase también selectedElement.
[since QtDataVisualization 1.1] int selectedCustomItemIndex()
Se puede utilizar para consultar el índice del elemento personalizado seleccionado tras recibir una señal « selectedElementChanged » de tipo « ElementCustomItem ». La selección es válida hasta la siguiente señal « selectedElementChanged ».
Devuelve el índice del elemento personalizado seleccionado o -1.
Este método se introdujo en QtDataVisualization 1.1.
Véase también selectedElement.
[since QtDataVisualization 1.1] int selectedLabelIndex()
Se puede utilizar para consultar el índice de la etiqueta seleccionada tras recibir una señal « selectedElementChanged » con cualquier tipo de etiqueta. La selección es válida hasta la siguiente señal « selectedElementChanged ».
Devuelve el índice de la etiqueta seleccionada o -1.
Este método se introdujo en QtDataVisualization 1.1.
Véase también selectedElement.
© 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.