AbstractGraph3D QML Type
Tipo base para visualizaciones 3D. Más...
| Import Statement: | import QtDataVisualization 1.11 |
| Since: | QtDataVisualization 1.0 |
| Inherited By: |
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 3D en QtDataVisualization.
Este tipo no es creable, pero contiene propiedades que son compartidas entre las visualizaciones 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 la escala del gráfico entre el eje más largo en el plano horizontal y el eje y. Por defecto es 2.0.
Nota: No tiene efecto en Bars3D.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Véase también horizontalAspectRatio.
currentFps : int [since QtDataVisualization 1.1]
Cuando la medición de FPS está activada, los resultados del último segundo se almacenan en esta propiedad de sólo lectura. Se tarda al menos un segundo en actualizar este valor después de 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 Custom3DItem añadidos al gráfico. El gráfico toma posesión de los elementos añadidos.
Esta propiedad se introdujo en QtDataVisualization 1.1.
horizontalAspectRatio : real [since QtDataVisualization 1.2]
La relación de la escala del gráfico entre el eje x y el eje z. El valor de 0.0 indica un escalado automático según los rangos de los ejes. El valor por defecto es 0.0.
Nota: No tiene efecto en Bars3D, que maneja la escala en el plano horizontal a través de 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 manejador de entrada activo utilizado en el gráfico. Puede desactivar los manejadores de entrada por defecto estableciendo esta propiedad a null.
locale : locale [since QtDataVisualization 1.2]
Establece la configuración regional utilizada para dar formato a varias etiquetas numéricas. Por defecto es "C".
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también ValueAxis3D::labelFormat.
margin : real [since QtDataVisualization 1.2]
Valor absoluto utilizado para el espacio que queda entre el borde del área del gráfico trazable 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 relaciones de aspecto del gráfico no se han modificado respecto a los valores por defecto. Por defecto es -1.0.
Nota: Si se establece un margen más pequeño para un gráfico de dispersión que el margen determinado automáticamente, los elementos de dispersión de los bordes del gráfico pueden solaparse con el fondo del gráfico.
Nota: En los gráficos de dispersión y superficie, si el margen es pequeño en comparación con el tamaño de la etiqueta del eje, las posiciones de las etiquetas de borde de los ejes se ajustan para evitar la superposición con las etiquetas de borde de los ejes vecinos.
Esta propiedad se introdujo en QtDataVisualization 1.2.
measureFps : bool [since QtDataVisualization 1.1]
Si true, el renderizado se realiza de forma continua en lugar de bajo demanda, y se actualiza el valor de la propiedad currentFps. 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 sólo lectura y devuelve el número de muestras especificado por el formato de la superficie de la ventana. Por defecto es 4.
Véase también renderingMode.
optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]
Si se utiliza el modo por defecto o estático para la optimización del renderizado.
El modo por defecto proporciona todas las funciones a un nivel razonable de rendimiento. El modo estático optimiza la representación de gráficos y es ideal para grandes conjuntos de datos que no cambian. Es más lento con cambios de datos dinámicos y rotaciones de elementos. La selección no está optimizada, por lo que no es aconsejable utilizar el modo estático con conjuntos de datos masivos. La optimización estática sólo funciona en gráficos de dispersión. Por defecto es OptimizationDefault.
Nota: En algunos entornos, los gráficos de gran tamaño que utilizan la optimización estática pueden no renderizarse, ya que todos los elementos se renderizan utilizando una única llamada de dibujo, y los distintos controladores gráficos admiten distintos recuentos máximos de vértices por llamada. Esto ocurre principalmente en plataformas de 32 bits y OpenGL ES2. Para solucionar este problema, elige una malla de elementos con un número bajo 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 true, se utilizará la proyección ortográfica para mostrar el gráfico. Por defecto es false.
Nota: Las sombras se desactivarán cuando se establezca a true.
Esta propiedad se introdujo en QtDataVisualization 1.1.
polar : bool [since QtDataVisualization 1.2]
Si true, los ejes horizontales se transforman en ejes polares. El eje x se convierte en el eje angular y el eje z en el eje radial. El modo polar no está disponible para los gráficos de barras.
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 sólo lectura contiene los últimos valores de posición del gráfico a lo largo de cada eje consultado mediante Scene3D::graphPositionQuery. Los valores están normalizados en el rango [-1, 1]. Si la posición consultada estaba fuera de los límites del gráfico, los valores no reflejarán la posición real, sino que serán una posición indefinida fuera del rango [-1, 1]. El valor será indefinido hasta que se realice una consulta.
No existe una única coordenada 3D correcta que coincida con una posición concreta de la pantalla, por lo que, para ser coherentes, las consultas se realizan siempre contra los lados interiores de una caja invisible que rodea el gráfico.
Nota: Los gráficos de barras sólo permiten consultar la posición del gráfico a nivel del suelo del gráfico, por lo que el valor y es siempre cero para los gráficos de barras y las consultas válidas sólo pueden hacerse en posiciones de pantalla que contengan el suelo 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 para las etiquetas de los ejes polares radiales. El valor 0.0 indica que las etiquetas deben dibujarse junto a la línea de rejilla del eje angular 0. El valor 1.0 indica que las etiquetas se dibujan en su lugar habitual en el borde del fondo del gráfico. Esta propiedad se ignora si el valor de la propiedad polar es false. 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 del suelo. Por defecto false.
Nota: Sólo afecta a Bars3D. Sin embargo, en los gráficos de Bars3D que contienen valores positivos y negativos, las reflexiones no son compatibles con los elementos personalizados que intersecan el plano del suelo. En ese caso, las reflexiones deben desactivarse para evitar un renderizado incorrecto.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Véase también reflectivity.
reflectivity : real [since QtDataVisualization 1.2]
Establece la reflectividad del suelo. Los números más grandes hacen que el suelo sea más reflectante. El rango válido es [0...1]. Por defecto es 0.5.
Nota: Sólo afecta a Bars3D.
Esta propiedad fue introducida 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 escena, como la cámara activa.
Esta propiedad es de sólo lectura.
selectedElement : AbstractGraph3D.ElementType [since QtDataVisualization 1.1]
El elemento seleccionado en el gráfico.
Esta propiedad puede utilizarse para consultar el tipo de elemento seleccionado. El tipo es válido hasta que se realiza una nueva selección en el gráfico y se emite la señal selectedElementChanged.
La señal puede utilizarse, por ejemplo, para implementar un manejo de entrada personalizado, como se demuestra en el ejemplo Manejo de Ejes.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Véase 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 del enum QAbstract3DGraph::SelectionFlag.
Véase también QAbstract3DGraph::SelectionFlag.
shadowQuality : AbstractGraph3D.ShadowQuality
La calidad de las sombras. Uno de los valores del enum QAbstract3DGraph::ShadowQuality.
Véase también QAbstract3DGraph::ShadowQuality.
shadowsSupported : bool
Esta propiedad de sólo lectura indica si la configuración actual admite sombras. Las configuraciones 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. Graph toma posesión 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 ya añadido.
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 adjuntas.
[since 6.3] bool hasSeries(Abstract3DSeries series)
Devuelve si el series ya ha sido 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 el mismo elemento se añade de nuevo al gráfico, el archivo de textura necesita ser reajustado.
Este método se introdujo en QtDataVisualization 1.1.
Véase también Custom3DItem::textureFile.
[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)
Elimina la página personalizada item. Elimina los recursos asignados.
Este método se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] void removeCustomItemAt(vector3d position)
Elimina todos los elementos personalizados en position. Elimina los recursos asignados a ellos.
Este método se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] void removeCustomItems()
Elimina todos los elementos personalizados. Elimina los recursos asignados a ellos.
Este método se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] Abstract3DAxis selectedAxis()
Puede utilizarse para obtener el eje seleccionado tras recibir la 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 null.
Este método se introdujo en QtDataVisualization 1.1.
Véase también selectedElement.
[since QtDataVisualization 1.1] Custom3DItem selectedCustomItem()
Puede utilizarse para obtener el elemento personalizado seleccionado tras recibir la señal selectedElementChanged con el tipo ElementCustomItem. La propiedad del elemento permanece en el 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()
Puede utilizarse para consultar el índice del elemento personalizado seleccionado tras recibir la señal selectedElementChanged con el 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()
Puede utilizarse para consultar el índice de la etiqueta seleccionada tras recibir la 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.
