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 |
- Miembros obsoletos
- QtGraphs3D forma parte de las clases C++ deQt Graphs para 3D.
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 } |
Documentación del tipo
enum class QtGraphs3D::CameraPreset
Posiciones predefinidas para la cámara.
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::CameraPreset::NoPreset | 0 | Se utiliza para indicar que no se ha establecido ninguna configuración predefinida o que la escena se ha girado libremente. |
QtGraphs3D::CameraPreset::FrontLow | 1 | Las rotaciones x e y de la cámara son 0. |
QtGraphs3D::CameraPreset::Front | 2 | La rotación X es 0 y la rotación Y es de 22,5 grados. |
QtGraphs3D::CameraPreset::FrontHigh | 3 | La rotación X es 0 y la rotación Y es de 45 grados. |
QtGraphs3D::CameraPreset::LeftLow | 4 | La rotación X es de 90 y la rotación Y es de 0 grados. |
QtGraphs3D::CameraPreset::Left | 5 | La rotación X es de 90 y la rotación Y es de 22,5 grados. |
QtGraphs3D::CameraPreset::LeftHigh | 6 | La rotación en el eje X es de 90 y la rotación en el eje Y es de 45 grados. |
QtGraphs3D::CameraPreset::RightLow | 7 | La rotación en X es de -90 y la rotación en Y es de 0 grados. |
QtGraphs3D::CameraPreset::Right | 8 | La rotación en X es de -90 y la rotación en Y es de 22,5 grados. |
QtGraphs3D::CameraPreset::RightHigh | 9 | La rotación en X es de -90 y la rotación en Y es de 45 grados. |
QtGraphs3D::CameraPreset::BehindLow | 10 | La rotación en el eje X es de 180 y la rotación en el eje Y es de 0 grados. |
QtGraphs3D::CameraPreset::Behind | 11 | La 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::BehindHigh | 12 | La rotación en X es de 180 grados y la rotación en Y es de 45 grados. |
QtGraphs3D::CameraPreset::IsometricLeft | 13 | La 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::IsometricLeftHigh | 14 | La rotación en el eje X es de 45 grados y la rotación en el eje Y es de 45 grados. |
QtGraphs3D::CameraPreset::IsometricRight | 15 | La rotación en X es de -45 grados y la rotación en Y es de 22,5 grados. |
QtGraphs3D::CameraPreset::IsometricRightHigh | 16 | La rotación en el eje X es de -45 grados y la rotación en el eje Y es de 45 grados. |
QtGraphs3D::CameraPreset::DirectlyAbove | 17 | La rotación en el eje X es de 0 grados y la rotación en el eje Y es de 90 grados. |
QtGraphs3D::CameraPreset::DirectlyAboveCW45 | 18 | La rotación en X es de -45 y la rotación en Y es de 90 grados. |
QtGraphs3D::CameraPreset::DirectlyAboveCCW45 | 19 | La rotación X es de 45 y la rotación Y es de 90 grados. |
QtGraphs3D::CameraPreset::FrontBelow | 20 | La 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::LeftBelow | 21 | La rotación X es de 90 grados y la rotación Y es de -45 grados. |
QtGraphs3D::CameraPreset::RightBelow | 22 | La rotación en X es de -90 grados y la rotación en Y es de -45 grados. |
QtGraphs3D::CameraPreset::BehindBelow | 23 | La rotación X es de 180 y la rotación Y es de -45 grados. |
QtGraphs3D::CameraPreset::DirectlyBelow | 24 | La 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.
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::DragMode::Rotate | 0 | Al arrastrar se gira el gráfico. |
QtGraphs3D::DragMode::Pan | 1 | Al 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.
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::ElementType::None | 0 | Elemento no definido. |
QtGraphs3D::ElementType::Series | 1 | Un elemento de una serie. |
QtGraphs3D::ElementType::AxisXLabel | 2 | La etiqueta del eje x. |
QtGraphs3D::ElementType::AxisYLabel | 3 | La etiqueta del eje Y. |
QtGraphs3D::ElementType::AxisZLabel | 4 | La etiqueta del eje z. |
QtGraphs3D::ElementType::CustomItem | 5 | Un elemento personalizado. |
enum class QtGraphs3D::GridLineType
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::GridLineType::Shader | 0 | Las líneas de la cuadrícula se representan con la GPU en un shader. |
QtGraphs3D::GridLineType::Geometry | 1 | Las líneas de la cuadrícula se representan con modelos 3D. |
enum class QtGraphs3D::OptimizationHint
La sugerencia de optimización para el renderizado.
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::OptimizationHint::Default | 0 | Ofrece el conjunto completo de funciones con instanciación y un buen rendimiento. |
QtGraphs3D::OptimizationHint::Legacy | 1 | Ofrece 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
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::RenderingMode::DirectToBackground | 0 | Indica 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::Indirect | 1 | Indica 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».
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::SelectionFlag::None | 0x00 | Modo de selección desactivado. |
QtGraphs3D::SelectionFlag::Item | 0x01 | La selección resalta un único elemento. |
QtGraphs3D::SelectionFlag::Row | 0x02 | La selección resalta una sola fila. |
QtGraphs3D::SelectionFlag::ItemAndRow | Item | Row | Indicador de combinación para resaltar tanto el elemento como la fila con colores diferentes. |
QtGraphs3D::SelectionFlag::Column | 0x04 | La selección resalta una sola columna. |
QtGraphs3D::SelectionFlag::ItemAndColumn | Item | Column | Indicador de combinación para resaltar tanto el elemento como la columna con colores diferentes. |
QtGraphs3D::SelectionFlag::RowAndColumn | Row | Column | Indicador de combinación para resaltar tanto la fila como la columna. |
QtGraphs3D::SelectionFlag::ItemRowAndColumn | Item | Row | Column | Indicador de combinación para resaltar elemento, fila y columna. |
QtGraphs3D::SelectionFlag::Slice | 0x08 | Al 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:
|
QtGraphs3D::SelectionFlag::MultiSeries | 0x10 | 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 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.
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::ShadowQuality::None | 0 | Las sombras están desactivadas. |
QtGraphs3D::ShadowQuality::Low | 1 | Las sombras se representan con baja calidad. |
QtGraphs3D::ShadowQuality::Medium | 2 | Las sombras se representan con calidad media. |
QtGraphs3D::ShadowQuality::High | 3 | Las sombras se representan con alta calidad. |
QtGraphs3D::ShadowQuality::SoftLow | 4 | Las sombras se representan con baja calidad y bordes suavizados. |
QtGraphs3D::ShadowQuality::SoftMedium | 5 | Las sombras se representan con calidad media y bordes suavizados. |
QtGraphs3D::ShadowQuality::SoftHigh | 6 | Las 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.
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::SliceCaptureType::NoImage | 0 | El tipo de corte que se va a capturar no está definido. |
QtGraphs3D::SliceCaptureType::RowImage | 1 | Captura de corte por filas. |
QtGraphs3D::SliceCaptureType::ColumnImage | 2 | Captura 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 ».
| Constante | Valor | Descripción |
|---|---|---|
QtGraphs3D::TransparencyTechnique::Default | 0 | Indica 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::Approximate | 1 | Indica 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::Accurate | 2 | Indica 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.