En esta página

QAbstract3DGraph Class

La clase QAbstract3DGraph proporciona una ventana y un bucle de renderizado para gráficos. Más información...

Encabezado: #include <QAbstract3DGraph>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.0
Heredado de:QWindow y de ` QOpenGLFunctions ` (protegido)
Heredado por:

Q3DBars, Q3DScatter y Q3DSurface

Estado: Obsoleta

Esta clase está en desuso. Se desaconseja encarecidamente su uso en código nuevo.

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 debería ser necesario utilizar esta clase directamente, sino una de sus subclases.

El suavizado está activado por defecto en C++, excepto en entornos OpenGL ES2, donde « Qt Data Visualization » no admite el suavizado. Para especificar un suavizado distinto del predeterminado para un gráfico, proporciona un formato de superficie personalizado como parámetro del constructor. Puedes utilizar la función de conveniencia « qDefaultSurfaceFormat() » para crear el objeto de formato de superficie.

Nota: QAbstract3DGraph activa de forma predeterminada el indicador de ventana Qt::FramelessWindowHint. Si desea mostrar las ventanas del gráfico como ventanas independientes con un marco de ventana normal, desactive este indicador tras 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 sobre los tipos de miembros

[since QtDataVisualization 1.1] enum QAbstract3DGraph::ElementType

Tipo de un elemento del gráfico.

ConstanteValorDescripción
QAbstract3DGraph::ElementNone0Elemento no 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.

Esta enumeración se introdujo en QtDataVisualization 1.1.

[since Qt Data Visualization 1.1] enum QAbstract3DGraph::OptimizationHint
flags QAbstract3DGraph::OptimizationHints

La sugerencia de optimización para el renderizado.

ConstanteValorDescripción
QAbstract3DGraph::OptimizationDefault0Ofrece el conjunto completo de funciones con un rendimiento razonable.
QAbstract3DGraph::OptimizationStatic1Optimiza la representación de conjuntos de datos estáticos a costa de algunas funciones.

Esta enumeración se introdujo en Qt Data Visualization 1.1.

El tipo OptimizationHints es un typedef de QFlags<OptimizationHint>. Almacena una combinación OR de valores de OptimizationHint.

enum QAbstract3DGraph::SelectionFlag
flags QAbstract3DGraph::SelectionFlags

Modos de selección de elementos. Los valores de esta enumeración se pueden combinar 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 | SelectionRowIndicador combinado para resaltar tanto el elemento como la fila con colores diferentes.
QAbstract3DGraph::SelectionColumn4La selección resalta una sola columna.
QAbstract3DGraph::SelectionItemAndColumnSelectionItem | SelectionColumnIndicador de combinación para resaltar tanto el elemento como la columna con colores diferentes.
QAbstract3DGraph::SelectionRowAndColumnSelectionRow | SelectionColumnIndicador de combinación para resaltar tanto la fila como la columna.
QAbstract3DGraph::SelectionItemRowAndColumnSelectionItem | SelectionRow | SelectionColumnIndicador de combinación para resaltar el elemento, la fila y la columna.
QAbstract3DGraph::SelectionSlice8Al activar este indicador de modo, se indica que el gráfico debe encargarse automáticamente de la gestión de la vista de sección. Si deseas controlar tú mismo la vista por secciones mediante Q3DScene, no actives este indicador. Al activar este indicador de modo, también debe activarse « SelectionRow » o « SelectionColumn », pero no ambos. El corte por secciones solo es compatible con Q3DBars y Q3DSurface. Cuando se activa este indicador, se entra en el modo de corte por secciones en las siguientes situaciones:
  • Cuando la selección se modifica explícitamente a través de la API de series a un elemento visible
  • Cuando se modifica la selección haciendo clic en el gráfico
  • Cuando cambia el modo de selección y el elemento seleccionado está visible
QAbstract3DGraph::SelectionMultiSeries16Al activar este modo, se resaltan los elementos de todas las series que se encuentran en la misma posición, en lugar de solo el elemento seleccionado. La selección real en las demás series no cambia. Al activar este indicador de modo, también debe activarse uno o más de los indicadores de selección básicos (SelectionItem, SelectionRow o SelectionColumn). La selección de varias series no es compatible con Q3DScatter.

El tipo SelectionFlags es un typedef para QFlags<SelectionFlag>. Almacena una combinación OR de valores de SelectionFlag.

enum QAbstract3DGraph::ShadowQuality

Calidad de las sombras.

ConstanteValorDescripción
QAbstract3DGraph::ShadowQualityNone0Las sombras están desactivadas.
QAbstract3DGraph::ShadowQualityLow1Las sombras se representan con baja calidad.
QAbstract3DGraph::ShadowQualityMedium2Las sombras se representan con calidad media.
QAbstract3DGraph::ShadowQualityHigh3Las sombras se representan con alta calidad.
QAbstract3DGraph::ShadowQualitySoftLow4Las sombras se representan con baja calidad y bordes suavizados.
QAbstract3DGraph::ShadowQualitySoftMedium5Las sombras se representan con calidad media y bordes suavizados.
QAbstract3DGraph::ShadowQualitySoftHigh6Las sombras se representan con alta calidad y bordes suavizados.

Documentación de propiedades

activeInputHandler : QAbstract3DInputHandler*

Esta propiedad contiene el controlador de entrada activo que se utiliza en el gráfico.

Funciones de acceso:

QAbstract3DInputHandler *activeInputHandler() const
void setActiveInputHandler(QAbstract3DInputHandler *inputHandler)

Señal de 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 de notificación:

void activeThemeChanged(Q3DTheme *theme)

[since QtDataVisualization 1.1] aspectRatio : qreal

Esta propiedad contiene la relación de escala del gráfico entre el eje más largo del plano horizontal y el eje y.

El valor por defecto es 2.0.

Nota: Notiene ningún efecto en Q3DBars.

Esta enumeración se introdujo en QtDataVisualization 1.1.

Funciones de acceso:

qreal aspectRatio() const
void setAspectRatio(qreal ratio)

Señal de notificador:

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 solo lectura cuando se activa la medición de FPS. Este valor tarda al menos un segundo en actualizarse tras activar la medición.

Esta enumeración se introdujo en QtDataVisualization 1.1.

Funciones de acceso:

qreal currentFps() const

Señal de notificación:

void currentFpsChanged(qreal fps)

Véase también measureFps.

[since QtDataVisualization 1.2] horizontalAspectRatio : qreal

Esta propiedad establece la relación de escala del gráfico entre el eje x y el eje z.

El valor « 0.0 » indica un escalado automático según los rangos de los ejes. El valor predeterminado es « 0.0 ».

No tiene ningún efecto en Q3DBars, que gestiona el escalado en el plano horizontal mediante las propiedades « barThickness » y « barSpacing ». Los gráficos polares también ignoran esta propiedad.

Esta enumeración se introdujo en QtDataVisualization 1.2.

Funciones de acceso:

qreal horizontalAspectRatio() const
void setHorizontalAspectRatio(qreal ratio)

Señal de notificación:

void horizontalAspectRatioChanged(qreal ratio)

Véase también aspectRatio, polar, Q3DBars::barThickness y Q3DBars::barSpacing.

[since QtDataVisualization 1.2] locale : QLocale

Esta propiedad almacena la configuración regional que se utiliza para dar formato a diversas etiquetas numéricas.

Por defecto, se utiliza la configuración regional « "C" ».

Esta enumeración se introdujo en QtDataVisualization 1.2.

Funciones de acceso:

QLocale locale() const
void setLocale(const QLocale &locale)

Señal de notificación:

void localeChanged(const QLocale &locale)

Véase también QValue3DAxis::labelFormat.

[since QtDataVisualization 1.2] margin : qreal

Esta propiedad contiene 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 enumeración 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 determina si la visualización se realiza de forma continua en lugar de bajo demanda.

Si se establece en « true », el renderizado es continuo y se actualiza el valor de la propiedad « currentFps ». El valor por defecto es « false ».

Esta enumeración se introdujo en QtDataVisualization 1.1.

Funciones de acceso:

bool measureFps() const
void setMeasureFps(bool enable)

Señal de notificador:

void measureFpsChanged(bool enabled)

Véase también currentFps.

optimizationHints : OptimizationHints

Esta propiedad se mantiene independientemente de si se utiliza el modo predeterminado o el modo estático para la optimización de 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 cambian. 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.

Funciones de acceso:

QAbstract3DGraph::OptimizationHints optimizationHints() const
void setOptimizationHints(QAbstract3DGraph::OptimizationHints hints)

Señal de notificador:

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.

El valor por defecto es « false ».

Nota: Las sombras se desactivarán si se establece en true.

Esta enumeración se introdujo en QtDataVisualization 1.1.

Funciones de acceso:

bool isOrthoProjection() const
void setOrthoProjection(bool enable)

Señal de notificador:

void orthoProjectionChanged(bool enabled)

Véase también « QAbstract3DAxis::labelAutoRotation » y « Q3DCamera::cameraPreset ».

[since QtDataVisualization 1.2] polar : bool

Esta propiedad se mantiene tanto si los ejes horizontales se transforman en ejes polares.

Si se establece 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.

El valor por defecto es false.

Esta enumeración se introdujo en QtDataVisualization 1.2.

Funciones de acceso:

bool isPolar() const
void setPolar(bool enable)

Señal de notificación:

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 solo lectura contiene los resultados de Q3DScene::graphPositionQuery. Los valores se normalizan al 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 indicarán 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 de la pantalla, por lo que, para mantener 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 enumeración se introdujo en QtDataVisualization 1.2.

Funciones de acceso:

QVector3D queriedGraphPosition() const

Señal de notificación:

void queriedGraphPositionChanged(const QVector3D &data)

Véase también Q3DScene::graphPositionQuery.

[since QtDataVisualization 1.2] radialLabelOffset : float

Esta propiedad contiene 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 en el ángulo 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 enumeración se introdujo en QtDataVisualization 1.2.

Funciones de acceso:

float radialLabelOffset() const
void setRadialLabelOffset(float offset)

Señal de notificador:

void radialLabelOffsetChanged(float offset)

Véase también polar.

[since QtDataVisualization 1.2] reflection : bool

Esta propiedad determina si los reflejos en el suelo están activados o desactivados.

El valor predeterminado es « false ».

Solo afecta a Q3DBars. Sin embargo, en los gráficos de Q3DBars que contienen valores tanto positivos como negativos, no se admiten los reflejos para los elementos personalizados que se cruzan con el plano del suelo. En ese caso, se deben desactivar los reflejos para evitar un renderizado incorrecto.

Si se utiliza un formato de superficie personalizado, es necesario definir el búfer de plantilla (QSurfaceFormat::setStencilBufferSize()) para que funcionen los reflejos.

Esta enumeración 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.

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 Q3DBars.

Esta enumeración se introdujo en QtDataVisualization 1.2.

Funciones de acceso:

qreal reflectivity() const
void setReflectivity(qreal reflectivity)

Señal de notificación:

void reflectivityChanged(qreal reflectivity)

Véase también reflection.

[read-only] scene : Q3DScene*

Esta propiedad contiene el puntero Q3DScene que se puede utilizar para manipular la escena y acceder a sus elementos, como la cámara activa.

Esta propiedad es de solo 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 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 controladores de entrada personalizados, tal y como se muestra en el ejemplo de la Galería de gráficos, en la pestaña « Scatter Graph ».

Esta enumeración 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 de notificación:

void selectionModeChanged(QAbstract3DGraph::SelectionFlags mode)

Véase también SelectionFlags.

shadowQuality : ShadowQuality

Esta propiedad define la calidad de la sombra.

Uno de los valores de la enumeración ShadowQuality. Por defecto, ShadowQualityMedium.

Nota: Si no se consigue establecer la calidad de la sombra en un nivel determinado, el nivel se reduce hasta que se establezca correctamente. 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 de notificación:

void shadowQualityChanged(QAbstract3DGraph::ShadowQuality quality)

Véase también ` ShadowQuality`.

Documentación de funciones de miembro

[virtual noexcept] QAbstract3DGraph::~QAbstract3DGraph()

Destruye « QAbstract3DGraph ».

[since QtDataVisualization 1.1] int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)

Añade un objeto `QCustom3DItem` de tipo ` item ` al gráfico. El gráfico asume la propiedad 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 que ya está presente.

Los elementos se representan en el orden en que se han insertado. Es necesario tener en cuenta el orden de representación cuando hay elementos opacos 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 el objeto ` inputHandler ` indicado al gráfico. Los controladores de entrada añadidos mediante `addInputHandler` no se utilizan directamente. Solo se transfiere al gráfico la propiedad del objeto ` inputHandler `. El objeto ` inputHandler ` no debe ser `null` ni estar ya añadido a otro gráfico.

Véase también releaseInputHandler() y setActiveInputHandler().

void QAbstract3DGraph::addTheme(Q3DTheme *theme)

Añade el theme indicado al gráfico. Los temas añadidos mediante addTheme no se utilizan directamente. Solo 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 asociadas.

[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 del sistema. Una causa habitual del fallo en la inicialización del contexto es la falta de compatibilidad suficiente de la plataforma con OpenGL.

[since 6.3] bool QAbstract3DGraph::hasSeries(QAbstract3DSeries *series) const

Devuelve si el objeto ` series ` ya se ha 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 controladores de entrada añadidos.

Véase también addInputHandler().

[since QtDataVisualization 1.1] void QAbstract3DGraph::releaseCustomItem(QCustom3DItem *item)

Recupera la propiedad del elemento « item » indicado y elimina el « item » del gráfico.

Nota: Si se vuelve a añadir el mismo elemento al gráfico, es necesario volver a configurar la textura o el archivo de textura.

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 del « inputHandler » al llamante, si se había añadido a este grafo. Si el « inputHandler » liberado está en uso, no habrá ningún controlador de entrada activo tras esta llamada.

Si el controlador de entrada predeterminado se libera y se vuelve a añadir más tarde, se comportará como cualquier otro controlador de entrada.

Véase también « addInputHandler()» y « setActiveInputHandler()».

void QAbstract3DGraph::releaseTheme(Q3DTheme *theme)

Devuelve la propiedad del tema « theme » al llamante, si se había añadido a este gráfico. Si el tema « theme » devuelto está en uso, se creará un nuevo tema predeterminado y se establecerá como activo.

Si el tema predeterminado se libera y se vuelve a añadir más tarde, se comportará como cualquier otro tema.

Véanse también addTheme() y setActiveTheme().

[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItem(QCustom3DItem *item)

Elimina el objeto personalizado ` item`. Borra los recursos que se le han asignado.

Esta función se introdujo en QtDataVisualization 1.1.

[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItemAt(const QVector3D &position)

Elimina todos los elementos personalizados de position. Borra los recursos que tenían asignados.

Esta función se introdujo en QtDataVisualization 1.1.

[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItems()

Elimina todos los elementos personalizados. Borra los recursos que se les habían asignado.

Esta función se introdujo en QtDataVisualization 1.1.

[since QtDataVisualization 1.1] QImage QAbstract3DGraph::renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize())

Genera una imagen del fotograma actual con las características especificadas en imageSize. El tamaño predeterminado es el de la ventana. La imagen se genera con el nivel de suavizado indicado en msaaSamples. El nivel predeterminado es 0.

Devuelve la imagen renderizada.

Nota: OpenGL ES2 no admite antialiasing, por lo que msaaSamples siempre se establece en 0.

Esta función se introdujo en QtDataVisualization 1.1.

[since QtDataVisualization 1.1] QAbstract3DAxis *QAbstract3DGraph::selectedAxis() const

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

Se puede utilizar para obtener el elemento personalizado seleccionado tras recibir una señal « selectedElementChanged » de tipo « QAbstract3DGraph::ElementCustomItem ». La propiedad del elemento sigue correspondiendo al 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

Se puede utilizar para consultar el índice del elemento personalizado seleccionado tras recibir una señal « selectedElementChanged » de 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

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.

Esta función se introdujo en QtDataVisualization 1.1.

Véase también selectedElement.

void QAbstract3DGraph::setActiveInputHandler(QAbstract3DInputHandler *inputHandler)

Establece inputHandler como el controlador 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 controlador de entrada estará activo tras esta llamada.

Nota: Funciónsetter para la propiedad activeInputHandler.

Véase 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 predeterminado temporal. Este tema temporal se elimina si posteriormente se establece explícitamente cualquier otro tema. Las propiedades del tema se pueden modificar incluso después de haberlo establecido, y los cambios surten efecto de forma inmediata.

Nota: Funciónsetter para la propiedad activeTheme.

Véase también activeTheme().

[virtual] bool QAbstract3DGraph::shadowsSupported() const

Devuelve « true » si la configuración actual admite sombras. Las configuraciones de OpenGL ES2 no admiten sombras.

QList<Q3DTheme *> QAbstract3DGraph::themes() const

Devuelve la lista de todos los temas añadidos.

Véase también addTheme().

Elementos relacionados no miembros

QSurfaceFormat qDefaultSurfaceFormat(bool antialias)

Esta función práctica se puede utilizar para crear un formato de superficie personalizado adecuado para su uso en gráficos de Qt Data Visualization.

El parámetro antialias especifica si el suavizado está activado o no.

Pasa el formato de superficie devuelto por esta función al constructor del gráfico (C++) o configúralo como formato de ventana para « QQuickView » (QML) antes de llamar a « show() » en él.

Por ejemplo, para desactivar el suavizado en una aplicación C++:

#include <QtDataVisualization/qutils.h>

// ...

Q3DBars *graph = new Q3DBars(qDefaultSurfaceFormat(false));

Por ejemplo, para habilitar el suavizado en los modos de renderizado directo en una aplicación QML:

#include <QtDataVisualization/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));

Nota: El suavizado no es compatible con 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.