En esta página

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:

Q3DBars, Q3DScatter, y Q3DSurface

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)
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:

Q3DBars *graphWindow = new Q3DBars;
graphWindow->setFlags(graphWindow->flags() ^ Qt::FramelessWindowHint);

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.

ConstanteValorDescripción
QAbstract3DGraph::ElementNone0Ningún elemento definido.
QAbstract3DGraph::ElementSeries1Una serie (es decir, un elemento de una serie).
QAbstract3DGraph::ElementAxisXLabel2La etiqueta del eje x.
QAbstract3DGraph::ElementAxisYLabel3La etiqueta del eje y.
QAbstract3DGraph::ElementAxisZLabel4La etiqueta del eje z.
QAbstract3DGraph::ElementCustomItem5Un 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.

ConstanteValorDescripción
QAbstract3DGraph::OptimizationDefault0Proporciona el conjunto completo de características con un rendimiento razonable.
QAbstract3DGraph::OptimizationStatic1Optimiza 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.

ConstanteValorDescripción
QAbstract3DGraph::SelectionNone0Modo de selección desactivado.
QAbstract3DGraph::SelectionItem1La selección resalta un único elemento.
QAbstract3DGraph::SelectionRow2La selección resalta una sola fila.
QAbstract3DGraph::SelectionItemAndRowSelectionItem | SelectionRowBandera de combinación para resaltar tanto el elemento como la fila con colores diferentes.
QAbstract3DGraph::SelectionColumn4La selección resalta una sola columna.
QAbstract3DGraph::SelectionItemAndColumnSelectionItem | SelectionColumnBandera de combinación para resaltar tanto el elemento como la columna con diferentes colores.
QAbstract3DGraph::SelectionRowAndColumnSelectionRow | SelectionColumnBandera de combinación para resaltar tanto la fila como la columna.
QAbstract3DGraph::SelectionItemRowAndColumnSelectionItem | SelectionRow | SelectionColumnBandera de combinación para resaltar el elemento, la fila y la columna.
QAbstract3DGraph::SelectionSlice8Esta 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:
  • Cuando la selección se cambia explícitamente a través de la API de series a un elemento visible.
  • Cuando la selección se cambia haciendo clic en el gráfico
  • Cuando el modo de selección cambia y el elemento seleccionado es visible
QAbstract3DGraph::SelectionMultiSeries16Activar 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.

ConstanteValorDescripción
QAbstract3DGraph::ShadowQualityNone0Las sombras están desactivadas.
QAbstract3DGraph::ShadowQualityLow1Las sombras se renderizan en baja calidad.
QAbstract3DGraph::ShadowQualityMedium2Las sombras se representan en calidad media.
QAbstract3DGraph::ShadowQualityHigh3Las sombras se representan en alta calidad.
QAbstract3DGraph::ShadowQualitySoftLow4Las sombras se renderizan en baja calidad con bordes suavizados.
QAbstract3DGraph::ShadowQualitySoftMedium5Las sombras se renderizan en calidad media con bordes suavizados.
QAbstract3DGraph::ShadowQualitySoftHigh6Las 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.