En esta página

QtGraphs3D Namespace

El módulo QtGraphs3D proporciona enumeraciones que utiliza la API 3D de QtGraphs. Más información...

Encabezado: #include <qgraphs3dnamespace.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs

Tipos

enum class CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
(since 6.12) enum class DragMode { Rotate, Pan }
enum class ElementType { None, Series, AxisXLabel, AxisYLabel, AxisZLabel, CustomItem }
enum class GridLineType { Shader, Geometry }
enum class OptimizationHint { Default, Legacy }
enum class RenderingMode { DirectToBackground, Indirect }
enum class SelectionFlag { None, Item, Row, ItemAndRow, Column, …, MultiSeries }
flags SelectionFlags
enum class ShadowQuality { None, Low, Medium, High, SoftLow, …, SoftHigh }
(since 6.10) enum class SliceCaptureType { NoImage, RowImage, ColumnImage }
(since 6.9) enum class TransparencyTechnique { Default, Approximate, Accurate }

Descripción detallada

Documentación del tipo

enum class QtGraphs3D::CameraPreset

Posiciones predefinidas para la cámara.

ConstanteValorDescripción
QtGraphs3D::CameraPreset::NoPreset0Se utiliza para indicar que no se ha establecido ninguna configuración predefinida o que la escena se ha girado libremente.
QtGraphs3D::CameraPreset::FrontLow1Las rotaciones x e y de la cámara son 0.
QtGraphs3D::CameraPreset::Front2La rotación X es 0 y la rotación Y es de 22,5 grados.
QtGraphs3D::CameraPreset::FrontHigh3La rotación X es 0 y la rotación Y es de 45 grados.
QtGraphs3D::CameraPreset::LeftLow4La rotación X es de 90 y la rotación Y es de 0 grados.
QtGraphs3D::CameraPreset::Left5La rotación X es de 90 y la rotación Y es de 22,5 grados.
QtGraphs3D::CameraPreset::LeftHigh6La rotación en el eje X es de 90 y la rotación en el eje Y es de 45 grados.
QtGraphs3D::CameraPreset::RightLow7La rotación en X es de -90 y la rotación en Y es de 0 grados.
QtGraphs3D::CameraPreset::Right8La rotación en X es de -90 y la rotación en Y es de 22,5 grados.
QtGraphs3D::CameraPreset::RightHigh9La rotación en X es de -90 y la rotación en Y es de 45 grados.
QtGraphs3D::CameraPreset::BehindLow10La rotación en el eje X es de 180 y la rotación en el eje Y es de 0 grados.
QtGraphs3D::CameraPreset::Behind11La rotación en el eje X es de 180 grados y la rotación en el eje Y es de 22,5 grados.
QtGraphs3D::CameraPreset::BehindHigh12La rotación en X es de 180 grados y la rotación en Y es de 45 grados.
QtGraphs3D::CameraPreset::IsometricLeft13La rotación en el eje X es de 45 grados y la rotación en el eje Y es de 22,5 grados.
QtGraphs3D::CameraPreset::IsometricLeftHigh14La rotación en el eje X es de 45 grados y la rotación en el eje Y es de 45 grados.
QtGraphs3D::CameraPreset::IsometricRight15La rotación en X es de -45 grados y la rotación en Y es de 22,5 grados.
QtGraphs3D::CameraPreset::IsometricRightHigh16La rotación en el eje X es de -45 grados y la rotación en el eje Y es de 45 grados.
QtGraphs3D::CameraPreset::DirectlyAbove17La rotación en el eje X es de 0 grados y la rotación en el eje Y es de 90 grados.
QtGraphs3D::CameraPreset::DirectlyAboveCW4518La rotación en X es de -45 y la rotación en Y es de 90 grados.
QtGraphs3D::CameraPreset::DirectlyAboveCCW4519La rotación X es de 45 y la rotación Y es de 90 grados.
QtGraphs3D::CameraPreset::FrontBelow20La rotación en el eje X es de 0 y la rotación en el eje Y es de -45 grados. En Q3DBarsWidgetItem, a partir de «FrontBelow», estas opciones solo funcionan para gráficos que incluyan valores negativos. Para valores únicamente positivos, actúan como «CameraPreset...Low».
QtGraphs3D::CameraPreset::LeftBelow21La rotación X es de 90 grados y la rotación Y es de -45 grados.
QtGraphs3D::CameraPreset::RightBelow22La rotación en X es de -90 grados y la rotación en Y es de -45 grados.
QtGraphs3D::CameraPreset::BehindBelow23La rotación X es de 180 y la rotación Y es de -45 grados.
QtGraphs3D::CameraPreset::DirectlyBelow24La rotación X es de 0 grados y la rotación Y es de -90 grados. Actúa como «FrontLow» para barras que solo contienen valores positivos.

[since 6.12] enum class QtGraphs3D::DragMode

Determina cómo se interpretan los eventos de arrastre con el ratón o mediante la función táctil en el gráfico.

ConstanteValorDescripción
QtGraphs3D::DragMode::Rotate0Al arrastrar se gira el gráfico.
QtGraphs3D::DragMode::Pan1Al arrastrar, se desplaza el gráfico.

Esta enumeración se introdujo en Qt 6.12.

enum class QtGraphs3D::ElementType

Tipo de un elemento del gráfico.

ConstanteValorDescripción
QtGraphs3D::ElementType::None0Elemento no definido.
QtGraphs3D::ElementType::Series1Un elemento de una serie.
QtGraphs3D::ElementType::AxisXLabel2La etiqueta del eje x.
QtGraphs3D::ElementType::AxisYLabel3La etiqueta del eje Y.
QtGraphs3D::ElementType::AxisZLabel4La etiqueta del eje z.
QtGraphs3D::ElementType::CustomItem5Un elemento personalizado.

enum class QtGraphs3D::GridLineType

ConstanteValorDescripción
QtGraphs3D::GridLineType::Shader0Las líneas de la cuadrícula se representan con la GPU en un shader.
QtGraphs3D::GridLineType::Geometry1Las líneas de la cuadrícula se representan con modelos 3D.

enum class QtGraphs3D::OptimizationHint

La sugerencia de optimización para el renderizado.

ConstanteValorDescripción
QtGraphs3D::OptimizationHint::Default0Ofrece el conjunto completo de funciones con instanciación y un buen rendimiento.
QtGraphs3D::OptimizationHint::Legacy1Ofrece el conjunto completo de funciones con un rendimiento razonable. Se debe utilizar si OptimizationHint.Default ofrece un rendimiento deficiente o no funciona.

enum class QtGraphs3D::RenderingMode

ConstanteValorDescripción
QtGraphs3D::RenderingMode::DirectToBackground0Indica que el gráfico se representará directamente sobre el fondo de la ventana y que los elementos QML se representarán encima de él. Si se utiliza un elemento QML no transparente como fondo, el gráfico quedará oculto. Borra toda la ventana antes de representar el gráfico, incluidas las áreas situadas fuera del gráfico. Si el formato de superficie de la ventana admite suavizado, se utilizará (véase QQuick3D::idealSurfaceFormat()). Este modo de representación ofrece el mejor rendimiento, a costa de un comportamiento de QML no estándar. Por ejemplo, los gráficos no obedecen el orden Z de los elementos QML y el valor de opacidad no tiene efecto sobre ellos.
QtGraphs3D::RenderingMode::Indirect1Indica que el gráfico se renderizará primero en una superficie fuera de pantalla que, a continuación, se dibujará durante el renderizado normal de los elementos QML. La imagen renderizada se suaviza mediante el método de multimuestreo si el entorno actual lo admite y el valor de la propiedad msaaSamples es mayor que cero. Este modo de renderizado ofrece buena calidad y un comportamiento normal de los elementos QML a costa del rendimiento.

enum class QtGraphs3D::SelectionFlag
flags QtGraphs3D::SelectionFlags

Modos de selección de elementos. Los valores de esta enumeración se pueden combinar con el operador «OR».

ConstanteValorDescripción
QtGraphs3D::SelectionFlag::None0x00Modo de selección desactivado.
QtGraphs3D::SelectionFlag::Item0x01La selección resalta un único elemento.
QtGraphs3D::SelectionFlag::Row0x02La selección resalta una sola fila.
QtGraphs3D::SelectionFlag::ItemAndRowItem | RowIndicador de combinación para resaltar tanto el elemento como la fila con colores diferentes.
QtGraphs3D::SelectionFlag::Column0x04La selección resalta una sola columna.
QtGraphs3D::SelectionFlag::ItemAndColumnItem | ColumnIndicador de combinación para resaltar tanto el elemento como la columna con colores diferentes.
QtGraphs3D::SelectionFlag::RowAndColumnRow | ColumnIndicador de combinación para resaltar tanto la fila como la columna.
QtGraphs3D::SelectionFlag::ItemRowAndColumnItem | Row | ColumnIndicador de combinación para resaltar elemento, fila y columna.
QtGraphs3D::SelectionFlag::Slice0x08Al activar este indicador de modo, se indica que el gráfico debe encargarse automáticamente de la gestión de la vista por segmentos. Si deseas controlar tú mismo la vista de segmentos mediante Q3DScene, no actives esta opción. Al activar esta opción de modo, también debe activarse Row o Column, pero no ambas. El corte de segmentos solo es compatible con Q3DBarsWidgetItem y Q3DSurfaceWidgetItem. Cuando se activa esta opción, se entra en el modo de segmentos en las siguientes situaciones:
  • Cuando la selección se modifica explícitamente a través de la API de series para seleccionar un elemento visible
  • Cuando se cambia la selección haciendo clic en el gráfico
  • Cuando cambia el modo de selección y el elemento seleccionado está visible
QtGraphs3D::SelectionFlag::MultiSeries0x10Al 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 deben activarse uno o más de los indicadores de selección básicos (Item, Row o Column). La selección de varias series no es compatible con Q3DScatterWidgetItem.

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

enum class QtGraphs3D::ShadowQuality

Calidad de las sombras.

ConstanteValorDescripción
QtGraphs3D::ShadowQuality::None0Las sombras están desactivadas.
QtGraphs3D::ShadowQuality::Low1Las sombras se representan con baja calidad.
QtGraphs3D::ShadowQuality::Medium2Las sombras se representan con calidad media.
QtGraphs3D::ShadowQuality::High3Las sombras se representan con alta calidad.
QtGraphs3D::ShadowQuality::SoftLow4Las sombras se representan con baja calidad y bordes suavizados.
QtGraphs3D::ShadowQuality::SoftMedium5Las sombras se representan con calidad media y bordes suavizados.
QtGraphs3D::ShadowQuality::SoftHigh6Las sombras se representan con alta calidad y bordes suavizados.

[since 6.10] enum class QtGraphs3D::SliceCaptureType

Tipo de sección que se va a extraer de una imagen.

ConstanteValorDescripción
QtGraphs3D::SliceCaptureType::NoImage0El tipo de corte que se va a capturar no está definido.
QtGraphs3D::SliceCaptureType::RowImage1Captura de corte por filas.
QtGraphs3D::SliceCaptureType::ColumnImage2Captura de segmento para columnas.

Esta enumeración se introdujo en Qt 6.10.

[since 6.9] enum class QtGraphs3D::TransparencyTechnique

Especifica qué técnica de transparencia se debe utilizar. El valor por defecto es « Default ». Al representar gráficos de superficies transparentes, utilice « Approximate » o « Accurate ». Para otros tipos de gráficos, se debe utilizar « Default ».

ConstanteValorDescripción
QtGraphs3D::TransparencyTechnique::Default0Indica que no se utilizan técnicas de transparencia independientes del orden. Ofrece el mejor rendimiento. Úsalo cuando los gráficos no contengan transparencia o cuando un gráfico de barras o de dispersión también utilice instanciación, es decir, cuando optimizationHint sea {QtGraphs3D::OptimizationHint::Default}.
QtGraphs3D::TransparencyTechnique::Approximate1Indica que el gráfico intenta una aproximación a la transparencia independiente del orden. Este método es más rápido que Accurate y funciona en hardware antiguo, pero puede dar lugar a resultados inexactos. Utilízalo cuando se necesite transparencia independiente del orden, pero el coste de rendimiento deba ser menor que al utilizar transparencia independiente del orden precisa.
QtGraphs3D::TransparencyTechnique::Accurate2Indica que se utiliza una transparencia independiente del orden precisa. Úsala cuando se necesite una representación de transparencia perfecta.

Esta enumeración se introdujo en Qt 6.9.

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