QtGraphs3D Namespace

El módulo QtGraphs3D proporciona enums utilizados por QtGraphs' 3D API. Más...

Cabecera:	`#include <QtGraphs3D>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake:	`QT += graphs`

Miembros obsoletos
QtGraphs3D es parte de Qt Graphs C++ Classes for 3D.

Tipos

enum class	CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
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 de tipos

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 una posición predefinida, o que la escena se ha rotado 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 22,5 grados.
`QtGraphs3D::CameraPreset::FrontHigh`	`3`	La rotación X es 0 y la rotación y es 45 grados.
`QtGraphs3D::CameraPreset::LeftLow`	`4`	La rotación X es 90 y la rotación y es 0 grados.
`QtGraphs3D::CameraPreset::Left`	`5`	La rotación X es 90 y la rotación y es 22,5 grados.
`QtGraphs3D::CameraPreset::LeftHigh`	`6`	La rotación X es 90 y la rotación y es 45 grados.
`QtGraphs3D::CameraPreset::RightLow`	`7`	La rotación X es -90 y la rotación y es 0 grados.
`QtGraphs3D::CameraPreset::Right`	`8`	La rotación X es -90 y la rotación y es 22,5 grados.
`QtGraphs3D::CameraPreset::RightHigh`	`9`	La rotación X es -90 y la rotación y es 45 grados.
`QtGraphs3D::CameraPreset::BehindLow`	`10`	La rotación X es 180 y la rotación y es 0 grados.
`QtGraphs3D::CameraPreset::Behind`	`11`	La rotación X es 180 y la rotación y es 22,5 grados.
`QtGraphs3D::CameraPreset::BehindHigh`	`12`	La rotación X es 180 y la rotación y es 45 grados.
`QtGraphs3D::CameraPreset::IsometricLeft`	`13`	La rotación X es 45 y la rotación y es 22,5 grados.
`QtGraphs3D::CameraPreset::IsometricLeftHigh`	`14`	La rotación X es 45 y la rotación y es 45 grados.
`QtGraphs3D::CameraPreset::IsometricRight`	`15`	La rotación X es -45 y la rotación y es 22,5 grados.
`QtGraphs3D::CameraPreset::IsometricRightHigh`	`16`	La rotación X es -45 y la rotación y es 45 grados.
`QtGraphs3D::CameraPreset::DirectlyAbove`	`17`	La rotación X es 0 y la rotación y es 90 grados.
`QtGraphs3D::CameraPreset::DirectlyAboveCW45`	`18`	La rotación X es -45 y la rotación y es 90 grados.
`QtGraphs3D::CameraPreset::DirectlyAboveCCW45`	`19`	La rotación X es 45 y la rotación y es 90 grados.
`QtGraphs3D::CameraPreset::FrontBelow`	`20`	La rotación X es 0 y la rotación y es -45 grados. En Q3DBarsWidgetItem a partir de FrontBelow sólo funcionan para gráficos que incluyan valores negativos. Actúan como CameraPreset...Low para valores sólo positivos.
`QtGraphs3D::CameraPreset::LeftBelow`	`21`	La rotación X es 90 y la rotación y es -45 grados.
`QtGraphs3D::CameraPreset::RightBelow`	`22`	La rotación X es -90 y la rotación y es -45 grados.
`QtGraphs3D::CameraPreset::BehindBelow`	`23`	La rotación X es 180 y la rotación y es -45 grados.
`QtGraphs3D::CameraPreset::DirectlyBelow`	`24`	La rotación X es 0 y la rotación y es -90 grados. Actúa como FrontLow para barras sólo positivas.

enum class QtGraphs3D::ElementType

Tipo de un elemento del gráfico.

Constante	Valor	Descripción
`QtGraphs3D::ElementType::None`	`0`	Ningún elemento 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 cuadrícula se renderizan con la GPU en un shader.
`QtGraphs3D::GridLineType::Geometry`	`1`	Las líneas de cuadrícula se renderizan con modelos 3D.

enum class QtGraphs3D::OptimizationHint

La pista de optimización para el renderizado.

Constante	Valor	Descripción
`QtGraphs3D::OptimizationHint::Default`	`0`	Proporciona el conjunto completo de características con instanciación a un buen rendimiento.
`QtGraphs3D::OptimizationHint::Legacy`	`1`	Proporciona todas las funciones con un rendimiento razonable. Se utiliza si OptimizationHint.Default funciona mal 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 sobre él. El uso de elementos QML no transparentes como fondo ocultará el gráfico. Borra toda la ventana antes de renderizar el gráfico, incluyendo las áreas fuera del gráfico. Si el formato de superficie de la ventana admite antialiasing, se utilizará (véase QQuick3D::idealSurfaceFormat()). Este modo de renderizado ofrece el mejor rendimiento a costa de un comportamiento 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 la pantalla que luego se dibujará durante el renderizado normal de elementos QML. La imagen renderizada es antialiased utilizando el método multisampling si está soportado en el entorno actual y el valor de la propiedad msaaSamples es mayor que cero. Este modo de renderizado ofrece una buena calidad y un comportamiento normal de los elementos QML a expensas del rendimiento.

enum class QtGraphs3D::SelectionFlag
flags QtGraphs3D::SelectionFlags

Modos de selección de elementos. Los valores de esta enumeración pueden combinarse 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`	Bandera 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`	Bandera de combinación para resaltar tanto el elemento como la columna con diferentes colores.
`QtGraphs3D::SelectionFlag::RowAndColumn`	`Row \| Column`	Bandera de combinación para resaltar tanto la fila como la columna.
`QtGraphs3D::SelectionFlag::ItemRowAndColumn`	`Item \| Row \| Column`	Bandera de combinación para resaltar el elemento, la fila y la columna.
`QtGraphs3D::SelectionFlag::Slice`	`0x08`	Esta opción indica que el gráfico debe encargarse automáticamente del manejo de la vista en corte. Si desea controlar usted mismo la vista en segmentos a través de Q3DScene, no active esta opción. Al activar este indicador de modo, debe activarse también `Row` o `Column`, pero no ambos. Sólo Q3DBarsWidgetItem y Q3DSurfaceWidgetItem permiten la visualización de cortes. Cuando se activa este indicador, se entra en el modo de corte en las siguientes situaciones: Cuando la selección se cambia explícitamente a través de la API de series a un elemento visible. Cuando la selección se cambia haciendo clic en el gráfico Cuando el modo de selección cambia y el elemento seleccionado es visible
`QtGraphs3D::SelectionFlag::MultiSeries`	`0x10`	Activar este modo significa que se resaltan los elementos de todas las series en la misma posición, en lugar de sólo el elemento seleccionado. La selección real en las otras series no cambia. Cuando se activa este modo, uno o más de los indicadores básicos de selección (`Item`, `Row`, o `Column`) también deben estar activados. La selección multiserie no es compatible con Q3DScatterWidgetItem.

El tipo SelectionFlags es un typedef para QFlags<SelectionFlag>. Almacena una combinación OR de valores 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 renderizan en baja calidad.
`QtGraphs3D::ShadowQuality::Medium`	`2`	Las sombras se representan en calidad media.
`QtGraphs3D::ShadowQuality::High`	`3`	Las sombras se representan en alta calidad.
`QtGraphs3D::ShadowQuality::SoftLow`	`4`	Las sombras se renderizan en baja calidad con bordes suavizados.
`QtGraphs3D::ShadowQuality::SoftMedium`	`5`	Las sombras se renderizan en calidad media con bordes suavizados.
`QtGraphs3D::ShadowQuality::SoftHigh`	`6`	Las sombras se renderizan en alta calidad con bordes suavizados.

`[since 6.10]` enum class QtGraphs3D::SliceCaptureType

Tipo de rebanada para agarrar a una imagen.

Constante	Valor	Descripción
`QtGraphs3D::SliceCaptureType::NoImage`	`0`	El tipo de slice a capturar no está definido.
`QtGraphs3D::SliceCaptureType::RowImage`	`1`	Capturar slice para filas.
`QtGraphs3D::SliceCaptureType::ColumnImage`	`2`	Capturar slice para columnas.

Este enum se introdujo en Qt 6.10.

`[since 6.9]` enum class QtGraphs3D::TransparencyTechnique

Especifica qué técnica de transparencia utilizar. El valor por defecto es Default. Al renderizar gráficos de superficie transparentes, utilice Approximate o Accurate. Default debe utilizarse para otros tipos de gráficos.

Constante	Valor	Descripción
`QtGraphs3D::TransparencyTechnique::Default`	`0`	Indica que no se utilizan técnicas de transparencia independientes del orden. Ofrece el mejor rendimiento. Se utiliza cuando los gráficos no contienen transparencia o cuando un gráfico de barras o de dispersión también utiliza instanciación, es decir, optimizationHint es {QtGraphs3D::OptimizationHint::Default}.
`QtGraphs3D::TransparencyTechnique::Approximate`	`1`	Indica que un gráfico intenta una aproximación de transparencia independiente del orden. Este método es más rápido que `Accurate` y funciona en hardware antiguo, pero puede dar resultados imprecisos. Se utiliza cuando se necesita la transparencia independiente del orden, pero el coste de rendimiento tiene que ser menor que cuando se utiliza la transparencia exacta independiente del orden.
`QtGraphs3D::TransparencyTechnique::Accurate`	`2`	Indica que se utiliza la transparencia precisa independiente del orden. Se utiliza cuando se necesita una transparencia perfecta.

Este enum 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.