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: | |
| 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) |
Elementos no miembros relacionados
| 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:
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.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DGraph::ElementNone | 0 | Elemento no 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. |
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.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DGraph::OptimizationDefault | 0 | Ofrece el conjunto completo de funciones con un rendimiento razonable. |
QAbstract3DGraph::OptimizationStatic | 1 | Optimiza 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».
| 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 | Indicador combinado 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 | Indicador de combinación para resaltar tanto el elemento como la columna con colores diferentes. |
QAbstract3DGraph::SelectionRowAndColumn | SelectionRow | SelectionColumn | Indicador de combinación para resaltar tanto la fila como la columna. |
QAbstract3DGraph::SelectionItemRowAndColumn | SelectionItem | SelectionRow | SelectionColumn | Indicador de combinación para resaltar el elemento, la fila y la columna. |
QAbstract3DGraph::SelectionSlice | 8 | Al 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:
|
QAbstract3DGraph::SelectionMultiSeries | 16 | Al 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.
| Constante | Valor | Descripción |
|---|---|---|
QAbstract3DGraph::ShadowQualityNone | 0 | Las sombras están desactivadas. |
QAbstract3DGraph::ShadowQualityLow | 1 | Las sombras se representan con baja calidad. |
QAbstract3DGraph::ShadowQualityMedium | 2 | Las sombras se representan con calidad media. |
QAbstract3DGraph::ShadowQualityHigh | 3 | Las sombras se representan con alta calidad. |
QAbstract3DGraph::ShadowQualitySoftLow | 4 | Las sombras se representan con baja calidad y bordes suavizados. |
QAbstract3DGraph::ShadowQualitySoftMedium | 5 | Las sombras se representan con calidad media y bordes suavizados. |
QAbstract3DGraph::ShadowQualitySoftHigh | 6 | Las 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.