QAbstract3DGraph Class
La clase QAbstract3DGraph proporciona una ventana y un bucle de renderizado para gráficos. Más...
| Cabecera: | #include <QAbstract3DGraph> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| Hereda de | QWindow y QOpenGLFunctions (protegido) |
| Heredado de: |
Tipos públicos
(since QtDataVisualization 1.1) enum | ElementType { ElementNone, ElementSeries, ElementAxisXLabel, ElementAxisYLabel, ElementAxisZLabel, ElementCustomItem } |
(since Qt Data Visualization 1.1) enum | OptimizationHint { OptimizationDefault, OptimizationStatic } |
| flags | OptimizationHints |
| enum | SelectionFlag { SelectionNone, SelectionItem, SelectionRow, SelectionItemAndRow, SelectionColumn, …, SelectionMultiSeries } |
| flags | SelectionFlags |
| enum | ShadowQuality { ShadowQualityNone, ShadowQualityLow, ShadowQualityMedium, ShadowQualityHigh, ShadowQualitySoftLow, …, ShadowQualitySoftHigh } |
Propiedades
|
|
Funciones públicas
| virtual | ~QAbstract3DGraph() |
| QAbstract3DInputHandler * | activeInputHandler() const |
| Q3DTheme * | activeTheme() const |
(since QtDataVisualization 1.1) int | addCustomItem(QCustom3DItem *item) |
| void | addInputHandler(QAbstract3DInputHandler *inputHandler) |
| void | addTheme(Q3DTheme *theme) |
| qreal | aspectRatio() const |
| void | clearSelection() |
| qreal | currentFps() const |
(since QtDataVisualization 1.2) QList<QCustom3DItem *> | customItems() const |
| bool | hasContext() const |
(since 6.3) bool | hasSeries(QAbstract3DSeries *series) const |
| qreal | horizontalAspectRatio() const |
| QList<QAbstract3DInputHandler *> | inputHandlers() const |
| bool | isOrthoProjection() const |
| bool | isPolar() const |
| bool | isReflection() const |
| QLocale | locale() const |
| qreal | margin() const |
| bool | measureFps() const |
| QAbstract3DGraph::OptimizationHints | optimizationHints() const |
| QVector3D | queriedGraphPosition() const |
| float | radialLabelOffset() const |
| qreal | reflectivity() const |
(since QtDataVisualization 1.1) void | releaseCustomItem(QCustom3DItem *item) |
| void | releaseInputHandler(QAbstract3DInputHandler *inputHandler) |
| void | releaseTheme(Q3DTheme *theme) |
(since QtDataVisualization 1.1) void | removeCustomItem(QCustom3DItem *item) |
(since QtDataVisualization 1.1) void | removeCustomItemAt(const QVector3D &position) |
(since QtDataVisualization 1.1) void | removeCustomItems() |
(since QtDataVisualization 1.1) QImage | renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize()) |
| Q3DScene * | scene() const |
(since QtDataVisualization 1.1) QAbstract3DAxis * | selectedAxis() const |
(since QtDataVisualization 1.1) QCustom3DItem * | selectedCustomItem() const |
(since QtDataVisualization 1.1) int | selectedCustomItemIndex() const |
| QAbstract3DGraph::ElementType | selectedElement() const |
(since QtDataVisualization 1.1) int | selectedLabelIndex() const |
| QAbstract3DGraph::SelectionFlags | selectionMode() const |
| void | setActiveInputHandler(QAbstract3DInputHandler *inputHandler) |
| void | setActiveTheme(Q3DTheme *theme) |
| void | setAspectRatio(qreal ratio) |
| void | setHorizontalAspectRatio(qreal ratio) |
| void | setLocale(const QLocale &locale) |
| void | setMargin(qreal margin) |
| void | setMeasureFps(bool enable) |
| void | setOptimizationHints(QAbstract3DGraph::OptimizationHints hints) |
| void | setOrthoProjection(bool enable) |
| void | setPolar(bool enable) |
| void | setRadialLabelOffset(float offset) |
| void | setReflection(bool enable) |
| void | setReflectivity(qreal reflectivity) |
| void | setSelectionMode(QAbstract3DGraph::SelectionFlags mode) |
| void | setShadowQuality(QAbstract3DGraph::ShadowQuality quality) |
| QAbstract3DGraph::ShadowQuality | shadowQuality() const |
| virtual bool | shadowsSupported() const |
| QList<Q3DTheme *> | themes() const |
Señales
| void | activeInputHandlerChanged(QAbstract3DInputHandler *inputHandler) |
| void | activeThemeChanged(Q3DTheme *theme) |
| void | aspectRatioChanged(qreal ratio) |
| void | currentFpsChanged(qreal fps) |
| void | horizontalAspectRatioChanged(qreal ratio) |
| void | localeChanged(const QLocale &locale) |
| void | marginChanged(qreal margin) |
| void | measureFpsChanged(bool enabled) |
| void | optimizationHintsChanged(QAbstract3DGraph::OptimizationHints hints) |
| void | orthoProjectionChanged(bool enabled) |
| void | polarChanged(bool enabled) |
| void | queriedGraphPositionChanged(const QVector3D &data) |
| void | radialLabelOffsetChanged(float offset) |
| void | reflectionChanged(bool enabled) |
| void | reflectivityChanged(qreal reflectivity) |
| void | selectedElementChanged(QAbstract3DGraph::ElementType type) |
| void | selectionModeChanged(QAbstract3DGraph::SelectionFlags mode) |
| void | shadowQualityChanged(QAbstract3DGraph::ShadowQuality quality) |
Relacionados No miembros
| QSurfaceFormat | qDefaultSurfaceFormat(bool antialias) |
Descripción detallada
Esta clase es una subclase de QWindow y proporciona un bucle de renderizado para los gráficos que la heredan.
No es necesario utilizar esta clase directamente, sino una de sus subclases.
El anti-aliasing está activado por defecto en C++, excepto en entornos OpenGL ES2, donde el anti-aliasing no está soportado por Qt Data Visualization. Para especificar un antialiasing no predeterminado para un gráfico, proporcione un formato de superficie personalizado como parámetro del constructor. Puede utilizar la función de conveniencia qDefaultSurfaceFormat() para crear el objeto de formato de superficie.
Nota: QAbstract3DGraph establece la bandera de ventana Qt::FramelessWindowHint por defecto. Si desea mostrar las ventanas del gráfico como ventanas independientes con un marco de ventana normal, desactive este indicador después de construir el gráfico. Por ejemplo:
Véase también Q3DBars, Q3DScatter, Q3DSurface, y Qt Data Visualization C++ Classes.
Documentación de tipos de miembros
[since QtDataVisualization 1.1] enum QAbstract3DGraph::ElementType
Tipo de un elemento del gráfico.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DGraph::ElementNone | 0 | Ningún elemento definido. |
QAbstract3DGraph::ElementSeries | 1 | Una serie (es decir, un elemento de una serie). |
QAbstract3DGraph::ElementAxisXLabel | 2 | La etiqueta del eje x. |
QAbstract3DGraph::ElementAxisYLabel | 3 | La etiqueta del eje y. |
QAbstract3DGraph::ElementAxisZLabel | 4 | La etiqueta del eje z. |
QAbstract3DGraph::ElementCustomItem | 5 | Un elemento personalizado. |
Este enum se introdujo en QtDataVisualization 1.1.
[since Qt Data Visualization 1.1] enum QAbstract3DGraph::OptimizationHint
flags QAbstract3DGraph::OptimizationHints
Sugerencia de optimización para el renderizado.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DGraph::OptimizationDefault | 0 | Proporciona el conjunto completo de características con un rendimiento razonable. |
QAbstract3DGraph::OptimizationStatic | 1 | Optimiza la representación de conjuntos de datos estáticos a expensas de algunas características. |
Este enum se introdujo en Qt Data Visualization 1.1.
El tipo OptimizationHints es un typedef para QFlags<OptimizationHint>. Almacena una combinación OR de valores OptimizationHint.
enum QAbstract3DGraph::SelectionFlag
flags QAbstract3DGraph::SelectionFlags
Modos de selección de elementos. Los valores de esta enumeración pueden combinarse con el operador OR.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DGraph::SelectionNone | 0 | Modo de selección desactivado. |
QAbstract3DGraph::SelectionItem | 1 | La selección resalta un único elemento. |
QAbstract3DGraph::SelectionRow | 2 | La selección resalta una sola fila. |
QAbstract3DGraph::SelectionItemAndRow | SelectionItem | SelectionRow | Bandera de combinación para resaltar tanto el elemento como la fila con colores diferentes. |
QAbstract3DGraph::SelectionColumn | 4 | La selección resalta una sola columna. |
QAbstract3DGraph::SelectionItemAndColumn | SelectionItem | SelectionColumn | Bandera de combinación para resaltar tanto el elemento como la columna con diferentes colores. |
QAbstract3DGraph::SelectionRowAndColumn | SelectionRow | SelectionColumn | Bandera de combinación para resaltar tanto la fila como la columna. |
QAbstract3DGraph::SelectionItemRowAndColumn | SelectionItem | SelectionRow | SelectionColumn | Bandera de combinación para resaltar el elemento, la fila y la columna. |
QAbstract3DGraph::SelectionSlice | 8 | Esta opción indica que el gráfico debe encargarse automáticamente del manejo de la vista en corte. Si desea controlar usted mismo la vista en segmentos a través de Q3DScene, no active esta opción. Al activar este indicador de modo, debe activarse también SelectionRow o SelectionColumn, pero no ambos. Sólo Q3DBars y Q3DSurface permiten la visualización de cortes. Cuando se activa este indicador, se entra en el modo de corte en las siguientes situaciones:
|
QAbstract3DGraph::SelectionMultiSeries | 16 | Activar este modo significa que se resaltan los elementos de todas las series en la misma posición, en lugar de sólo el elemento seleccionado. La selección real en las otras series no cambia. Cuando se activa este modo, uno o más de los indicadores básicos de selección (SelectionItem, SelectionRow, o SelectionColumn) también deben estar activados. La selección multiserie no es compatible con Q3DScatter. |
El tipo SelectionFlags es un typedef para QFlags<SelectionFlag>. Almacena una combinación OR de valores SelectionFlag.
enum QAbstract3DGraph::ShadowQuality
Calidad de las sombras.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DGraph::ShadowQualityNone | 0 | Las sombras están desactivadas. |
QAbstract3DGraph::ShadowQualityLow | 1 | Las sombras se renderizan en baja calidad. |
QAbstract3DGraph::ShadowQualityMedium | 2 | Las sombras se representan en calidad media. |
QAbstract3DGraph::ShadowQualityHigh | 3 | Las sombras se representan en alta calidad. |
QAbstract3DGraph::ShadowQualitySoftLow | 4 | Las sombras se renderizan en baja calidad con bordes suavizados. |
QAbstract3DGraph::ShadowQualitySoftMedium | 5 | Las sombras se renderizan en calidad media con bordes suavizados. |
QAbstract3DGraph::ShadowQualitySoftHigh | 6 | Las sombras se renderizan en alta calidad con bordes suavizados. |
Documentación de propiedades
activeInputHandler : QAbstract3DInputHandler*
Esta propiedad contiene el manejador de entrada activo utilizado en el gráfico.
Funciones de acceso:
| QAbstract3DInputHandler * | activeInputHandler() const |
| void | setActiveInputHandler(QAbstract3DInputHandler *inputHandler) |
Señal del notificador:
| void | activeInputHandlerChanged(QAbstract3DInputHandler *inputHandler) |
activeTheme : Q3DTheme*
Esta propiedad contiene el tema activo del gráfico.
Funciones de acceso:
| Q3DTheme * | activeTheme() const |
| void | setActiveTheme(Q3DTheme *theme) |
Señal del notificador:
| void | activeThemeChanged(Q3DTheme *theme) |
[since QtDataVisualization 1.1] aspectRatio : qreal
Esta propiedad contiene 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 Q3DBars.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Funciones de acceso:
| qreal | aspectRatio() const |
| void | setAspectRatio(qreal ratio) |
Notifier signal:
| void | aspectRatioChanged(qreal ratio) |
Véase también horizontalAspectRatio.
[read-only, since QtDataVisualization 1.1] currentFps : qreal
Esta propiedad contiene los resultados de renderizado del último segundo.
Los resultados se almacenan en esta propiedad de sólo lectura cuando la medición de FPS está activada. 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.
Funciones de acceso:
| qreal | currentFps() const |
Señal del notificador:
| void | currentFpsChanged(qreal fps) |
Véase también measureFps.
[since QtDataVisualization 1.2] horizontalAspectRatio : qreal
Esta propiedad contiene 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. Por defecto es 0.0.
No tiene efecto en Q3DBars, 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.
Funciones de acceso:
| qreal | horizontalAspectRatio() const |
| void | setHorizontalAspectRatio(qreal ratio) |
Señal notificadora:
| void | horizontalAspectRatioChanged(qreal ratio) |
Véase también aspectRatio, polar, Q3DBars::barThickness, y Q3DBars::barSpacing.
[since QtDataVisualization 1.2] locale : QLocale
Esta propiedad contiene 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.
Funciones de acceso:
| QLocale | locale() const |
| void | setLocale(const QLocale &locale) |
Señal de notificador:
| void | localeChanged(const QLocale &locale) |
Véase también QValue3DAxis::labelFormat.
[since QtDataVisualization 1.2] margin : qreal
Esta propiedad contiene el 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.
Funciones de acceso:
| qreal | margin() const |
| void | setMargin(qreal margin) |
Señal de notificador:
| void | marginChanged(qreal margin) |
[since QtDataVisualization 1.1] measureFps : bool
Esta propiedad mantiene si el renderizado se realiza de forma continua en lugar de bajo demanda.
Si true, el renderizado es continuo y se actualiza el valor de la propiedad currentFps. Por defecto es false.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Funciones de acceso:
| bool | measureFps() const |
| void | setMeasureFps(bool enable) |
Señal notificadora:
| void | measureFpsChanged(bool enabled) |
Véase también currentFps.
optimizationHints : OptimizationHints
Esta propiedad indica si se utiliza el modo por defecto o el modo estático para la optimización del renderizado.
El modo por defecto proporciona el conjunto completo de características a un nivel razonable de rendimiento. El modo estático optimiza el renderizado de gráficos y es ideal para grandes conjuntos de datos no cambiantes. 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.
Funciones de acceso:
| QAbstract3DGraph::OptimizationHints | optimizationHints() const |
| void | setOptimizationHints(QAbstract3DGraph::OptimizationHints hints) |
Señal notificadora:
| void | optimizationHintsChanged(QAbstract3DGraph::OptimizationHints hints) |
Véase también QAbstract3DSeries::mesh.
[since QtDataVisualization 1.1] orthoProjection : bool
Esta propiedad indica si se utiliza 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.
Funciones de acceso:
| bool | isOrthoProjection() const |
| void | setOrthoProjection(bool enable) |
Notifier signal:
| void | orthoProjectionChanged(bool enabled) |
Véase también QAbstract3DAxis::labelAutoRotation y Q3DCamera::cameraPreset.
[since QtDataVisualization 1.2] polar : bool
Esta propiedad mantiene si los ejes horizontales se convierten en ejes polares.
Si true, 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.
Funciones de acceso:
| bool | isPolar() const |
| void | setPolar(bool enable) |
Señal de notificador:
| void | polarChanged(bool enabled) |
Véase también orthoProjection y radialLabelOffset.
[read-only, since QtDataVisualization 1.2] queriedGraphPosition : QVector3D
Esta propiedad contiene los últimos valores de posición del gráfico consultados a lo largo de cada eje.
Esta propiedad de sólo lectura contiene los resultados de Q3DScene::graphPositionQuery. Los valores están normalizados al 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 indicará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.
Funciones de acceso:
| QVector3D | queriedGraphPosition() const |
Señal de notificador:
| void | queriedGraphPositionChanged(const QVector3D &data) |
Véase también Q3DScene::graphPositionQuery.
[since QtDataVisualization 1.2] radialLabelOffset : float
Esta propiedad contiene 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. El valor por defecto es 1.0.
Esta propiedad se ignora si el valor de la propiedad polar es false.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| float | radialLabelOffset() const |
| void | setRadialLabelOffset(float offset) |
Notifier signal:
| void | radialLabelOffsetChanged(float offset) |
Véase también polar.
[since QtDataVisualization 1.2] reflection : bool
Esta propiedad indica si las reflexiones del suelo están activadas o desactivadas.
Por defecto es false.
Sólo afecta a Q3DBars. Sin embargo, en los gráficos de Q3DBars 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.
Si se utiliza un formato de superficie personalizado, es necesario definir el búfer del stencil (QSurfaceFormat::setStencilBufferSize()) para que las reflexiones funcionen.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| bool | isReflection() const |
| void | setReflection(bool enable) |
Señal de notificador:
| void | reflectionChanged(bool enabled) |
Véase también reflectivity.
[since QtDataVisualization 1.2] reflectivity : qreal
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 Q3DBars.
Esta propiedad se introdujo en QtDataVisualization 1.2.
Funciones de acceso:
| qreal | reflectivity() const |
| void | setReflectivity(qreal reflectivity) |
Notifier signal:
| void | reflectivityChanged(qreal reflectivity) |
Véase también reflection.
[read-only] scene : Q3DScene*
Esta propiedad contiene el puntero Q3DScene que puede ser utilizado para manipular la escena y acceder a los elementos de la escena, como la cámara activa.
Esta propiedad es de sólo lectura.
Funciones de acceso:
| Q3DScene * | scene() const |
[read-only, since QtDataVisualization 1.1] selectedElement : ElementType
Esta propiedad contiene 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 se puede utilizar, por ejemplo, para implementar manejadores de entrada personalizados, como se demuestra en el ejemplo de la Galería Gráfica en la pestaña Scatter Graph.
Esta propiedad se introdujo en QtDataVisualization 1.1.
Funciones de acceso:
| QAbstract3DGraph::ElementType | selectedElement() const |
Señal de notificador:
| void | selectedElementChanged(QAbstract3DGraph::ElementType type) |
Véase también selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Q3DBars::selectedSeries(), Q3DScatter::selectedSeries(), Q3DSurface::selectedSeries(), y Q3DScene::setSelectionQueryPosition().
selectionMode : SelectionFlags
Modo de selección de elementos.
Una combinación de SelectionFlags. Por defecto, SelectionItem. Los distintos tipos de gráficos admiten diferentes modos de selección.
Funciones de acceso:
| QAbstract3DGraph::SelectionFlags | selectionMode() const |
| void | setSelectionMode(QAbstract3DGraph::SelectionFlags mode) |
Señal del notificador:
| void | selectionModeChanged(QAbstract3DGraph::SelectionFlags mode) |
Véase también SelectionFlags.
shadowQuality : ShadowQuality
Esta propiedad contiene la calidad de la sombra.
Es uno de los valores del enum ShadowQuality. Por defecto, ShadowQualityMedium.
Nota: Si el ajuste de la calidad de la sombra a un determinado nivel falla, el nivel se reduce hasta que se establece con éxito. La señal shadowQualityChanged se emite cada vez que se realiza un cambio.
Funciones de acceso:
| QAbstract3DGraph::ShadowQuality | shadowQuality() const |
| void | setShadowQuality(QAbstract3DGraph::ShadowQuality quality) |
Señal notificadora:
| void | shadowQualityChanged(QAbstract3DGraph::ShadowQuality quality) |
Véase también ShadowQuality.
Documentación de las funciones miembro
[virtual noexcept] QAbstract3DGraph::~QAbstract3DGraph()
Destruye QAbstract3DGraph.
[since QtDataVisualization 1.1] int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)
Añade un QCustom3DItem item al gráfico. Graph toma posesión del elemento añadido.
Devuelve el índice del elemento añadido si la operación de 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.
Los elementos se muestran en el orden en que se han insertado. El orden de renderizado debe tenerse en cuenta cuando se tienen elementos sólidos y transparentes.
Esta función se introdujo en QtDataVisualization 1.1.
Véase también removeCustomItems(), removeCustomItem(), removeCustomItemAt(), y customItems().
void QAbstract3DGraph::addInputHandler(QAbstract3DInputHandler *inputHandler)
Añade la dirección inputHandler al gráfico. Los manejadores de entrada añadidos mediante addInputHandler no se utilizan directamente. Sólo se asigna al grafo la propiedad de inputHandler. El inputHandler no debe ser nulo ni estar ya añadido a otro grafo.
Véase también releaseInputHandler() y setActiveInputHandler().
void QAbstract3DGraph::addTheme(Q3DTheme *theme)
Añade el tema theme al gráfico. Los temas añadidos mediante addTheme no se utilizan directamente. Sólo se asigna la propiedad del tema al gráfico. El theme no debe ser nulo ni estar ya añadido a otro gráfico.
Véase también releaseTheme() y setActiveTheme().
void QAbstract3DGraph::clearSelection()
Borra la selección de todas las series adjuntas.
[since QtDataVisualization 1.2] QList<QCustom3DItem *> QAbstract3DGraph::customItems() const
Devuelve la lista de todos los elementos personalizados añadidos.
Esta función se introdujo en QtDataVisualization 1.2.
Véase también addCustomItem().
bool QAbstract3DGraph::hasContext() const
Devuelve true si el contexto OpenGL del gráfico se ha inicializado correctamente. Intentar utilizar un gráfico cuando la inicialización del contexto ha fallado suele provocar un fallo. Una razón común para un fallo en la inicialización del contexto es la falta de soporte suficiente de la plataforma para OpenGL.
[since 6.3] bool QAbstract3DGraph::hasSeries(QAbstract3DSeries *series) const
Devuelve si el series ya ha sido añadido al gráfico.
Esta función se introdujo en Qt 6.3.
QList<QAbstract3DInputHandler *> QAbstract3DGraph::inputHandlers() const
Devuelve la lista de todos los manejadores de entrada añadidos.
Véase también addInputHandler().
[since QtDataVisualization 1.1] void QAbstract3DGraph::releaseCustomItem(QCustom3DItem *item)
Recupera la propiedad de item y elimina item del gráfico.
Nota: Si el mismo elemento es añadido de nuevo al gráfico, la textura o el archivo de textura necesita ser reajustado.
Esta función se introdujo en QtDataVisualization 1.1.
Véase también QCustom3DItem::setTextureImage() y QCustom3DItem::setTextureFile().
void QAbstract3DGraph::releaseInputHandler(QAbstract3DInputHandler *inputHandler)
Devuelve la propiedad de inputHandler al llamante, si se añadió a este gráfico. Si el inputHandler liberado está en uso no habrá ningún manejador de entrada activo después de esta llamada.
Si el manejador de entrada por defecto es liberado y añadido de nuevo más tarde, se comporta como cualquier otro manejador de entrada lo haría.
Véase también addInputHandler() y setActiveInputHandler().
void QAbstract3DGraph::releaseTheme(Q3DTheme *theme)
Libera la propiedad del theme de vuelta al llamante, si fue añadido a este gráfico. Si el theme liberado está en uso, se creará un nuevo tema por defecto y se activará.
Si el tema por defecto se libera y se vuelve a añadir más tarde, se comporta como lo haría cualquier otro tema.
Véase también addTheme() y setActiveTheme().
[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItem(QCustom3DItem *item)
Elimina la página personalizada item. Elimina los recursos asignados.
Esta función se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItemAt(const QVector3D &position)
Elimina todos los elementos personalizados en position. Elimina los recursos asignados a ellos.
Esta función se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItems()
Elimina todos los elementos personalizados. Elimina los recursos asignados a ellos.
Esta función se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] QImage QAbstract3DGraph::renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize())
Renderiza el fotograma actual a una imagen de imageSize. El tamaño por defecto es el tamaño de la ventana. La imagen se renderiza con el nivel de antialiasing indicado en msaaSamples. El nivel por defecto es 0.
Devuelve la imagen renderizada.
Nota: OpenGL ES2 no soporta antialiasing, por lo que msaaSamples se fuerza siempre a 0.
Esta función se introdujo en QtDataVisualization 1.1.
[since QtDataVisualization 1.1] QAbstract3DAxis *QAbstract3DGraph::selectedAxis() const
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 puntero al eje seleccionado, o null.
Esta función se introdujo en QtDataVisualization 1.1.
Véase también selectedElement.
[since QtDataVisualization 1.1] QCustom3DItem *QAbstract3DGraph::selectedCustomItem() const
Puede utilizarse para obtener el elemento personalizado seleccionado tras recibir la señal selectedElementChanged con el tipo QAbstract3DGraph::ElementCustomItem. La propiedad del elemento permanece en el gráfico. La selección es válida hasta la siguiente señal selectedElementChanged.
Devuelve el puntero al elemento personalizado seleccionado, o null.
Esta función se introdujo en QtDataVisualization 1.1.
Véase también selectedElement.
[since QtDataVisualization 1.1] int QAbstract3DGraph::selectedCustomItemIndex() const
Puede utilizarse para consultar el índice del elemento personalizado seleccionado tras recibir la señal selectedElementChanged con el tipo QAbstract3DGraph::ElementCustomItem. La selección es válida hasta la siguiente señal selectedElementChanged.
Devuelve el índice del elemento personalizado seleccionado, o -1.
Esta función se introdujo en QtDataVisualization 1.1.
Véase también selectedElement.
[since QtDataVisualization 1.1] int QAbstract3DGraph::selectedLabelIndex() const
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.
Esta función se introdujo en QtDataVisualization 1.1.
Véase también selectedElement.
void QAbstract3DGraph::setActiveInputHandler(QAbstract3DInputHandler *inputHandler)
Establece inputHandler como el manejador de entrada activo utilizado en el gráfico. Llama implícitamente a addInputHandler() para transferir la propiedad de inputHandler a este gráfico.
Si inputHandler es nulo, ningún manejador de entrada estará activo después de esta llamada.
Nota: Función setter para la propiedad activeInputHandler.
Ver también activeInputHandler(), addInputHandler(), y releaseInputHandler().
void QAbstract3DGraph::setActiveTheme(Q3DTheme *theme)
Establece theme como el tema activo que se utilizará para el gráfico. Llama implícitamente a addTheme() para transferir la propiedad del tema a este gráfico.
Si theme es nulo, se crea un tema temporal por defecto. Este tema temporal se destruye si posteriormente se establece explícitamente algún tema. Las propiedades del tema pueden modificarse incluso después de establecerlo, y las modificaciones surten efecto inmediatamente.
Nota: Función setter para la propiedad activeTheme.
Véase también activeTheme().
[virtual] bool QAbstract3DGraph::shadowsSupported() const
Devuelve true si se admiten sombras con la configuración actual. Las configuraciones OpenGL ES2 no admiten sombras.
QList<Q3DTheme *> QAbstract3DGraph::themes() const
Devuelve la lista de todos los temas añadidos.
Véase también addTheme().
Relacionados No miembros
QSurfaceFormat qDefaultSurfaceFormat(bool antialias)
Esta función de conveniencia se puede utilizar para crear un formato de superficie personalizado adecuado para su uso por Qt Data Visualization gráficos.
El parámetro antialias especifica si se activa o no el antialiasing.
Dé el formato de superficie devuelto por esta función al constructor del gráfico (C++) o establézcalo como formato de ventana para QQuickView (QML) antes de llamar a show() sobre él.
Por ejemplo, desactivar el antialiasing en la aplicación C++:
#include <QtDataVisualization/qutils.h> // ... Q3DBars *graph = new Q3DBars(qDefaultSurfaceFormat(false));
Por ejemplo, activar el antialiasing para los modos de renderizado directo en la aplicación QML:
#include <QtDataVisualization/qutils.h> // ... QQuickView viewer; viewer.setFormat(qDefaultSurfaceFormat(true));
Nota: El antialiasing no está soportado en entornos OpenGL ES2.
© 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.