Q3DScene Class
La clase Q3DScene proporciona una descripción de la escena 3D que se está visualizando. Más información...
| Encabezado: | #include <Q3DScene> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | Scene3D |
| Heredan de: | QObject |
- Lista de todos los miembros, incluidos los heredados
- Q3DScene forma parte de las clases C++ deQt Graphs para 3D.
Propiedades
|
|
Funciones públicas
| Q3DScene(QObject *parent = nullptr) | |
| virtual | ~Q3DScene() override |
| qreal | devicePixelRatio() const |
| QPoint | graphPositionQuery() const |
| QPoint | invalidSelectionPoint() const |
| bool | isPointInPrimarySubView(QPoint point) |
| bool | isPointInSecondarySubView(QPoint point) |
| bool | isSecondarySubviewOnTop() const |
| bool | isSlicingActive() const |
| QRect | primarySubViewport() const |
| QRect | secondarySubViewport() const |
| QPoint | selectionQueryPosition() const |
| void | setDevicePixelRatio(qreal pixelRatio) |
| void | setGraphPositionQuery(QPoint point) |
| void | setPrimarySubViewport(QRect primarySubViewport) |
| void | setSecondarySubViewport(QRect secondarySubViewport) |
| void | setSecondarySubviewOnTop(bool isSecondaryOnTop) |
| void | setSelectionQueryPosition(QPoint point) |
| void | setSlicingActive(bool isSlicing) |
| QRect | viewport() const |
Señales
| void | devicePixelRatioChanged(qreal pixelRatio) |
| void | graphPositionQueryChanged(QPoint position) |
| void | primarySubViewportChanged(QRect subViewport) |
| void | secondarySubViewportChanged(QRect subViewport) |
| void | secondarySubviewOnTopChanged(bool isSecondaryOnTop) |
| void | selectionQueryPositionChanged(QPoint position) |
| void | slicingActiveChanged(bool isSlicingActive) |
| void | viewportChanged(QRect viewport) |
Descripción detallada
La escena 3D contiene una única cámara activa y una única fuente de luz activa. Se supone que los datos visualizados se encuentran en una ubicación fija.
La escena 3D también realiza un seguimiento de la ventana de visualización en la que se lleva a cabo el renderizado de los gráficos, de la subventana principal dentro de la ventana de visualización donde se encuentra la vista principal de los gráficos 3D y de la subventana secundaria donde se encuentra la vista en corte 2D de los datos. Por defecto, el tamaño de las subventanas de visualización se ajusta mediante la función ` Q3DScene`. Para anular este comportamiento, es necesario escuchar las señales ` viewportChanged()` y ` slicingActiveChanged()` y recalcular el tamaño de las subventanas de visualización en consecuencia.
Además, la escena dispone de un indicador que permite saber si la vista secundaria de corte en 2D está activa o no en ese momento.
Nota: No todos los gráficos admiten la vista secundaria de corte 2D.
Documentación de propiedades
devicePixelRatio : qreal
Esta propiedad contiene la relación de píxeles del dispositivo que se utiliza al convertir las coordenadas de entrada en coordenadas de píxeles.
Funciones de acceso:
| qreal | devicePixelRatio() const |
| void | setDevicePixelRatio(qreal pixelRatio) |
Señal de notificación:
| void | devicePixelRatioChanged(qreal pixelRatio) |
graphPositionQuery : QPoint
Esta propiedad contiene las coordenadas de la entrada del usuario que la escena debe procesar como una consulta de posición en el gráfico.
Si esta propiedad se establece en un valor distinto de ` invalidSelectionPoint()`, el gráfico intenta hacer coincidir una posición del gráfico con las coordenadas especificadas dentro de la ventana de visualización principal. Tras la pasada de renderizado, esta propiedad vuelve a su estado predeterminado, ` invalidSelectionPoint()`. La posición del gráfico consultada se puede leer en la propiedad ` Q3DGraphsWidgetItem::queriedGraphPosition ` tras la siguiente pasada de renderizado.
No existe una única coordenada 3D correcta que se corresponda con una posición concreta en pantalla, por lo que, en aras de 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 consultas de posición en el nivel del suelo del gráfico.
Funciones de acceso:
| QPoint | graphPositionQuery() const |
| void | setGraphPositionQuery(QPoint point) |
Señal de notificación:
| void | graphPositionQueryChanged(QPoint position) |
Véase también Q3DGraphsWidgetItem::queriedGraphPosition.
[read-only] invalidSelectionPoint : const QPoint
Esta propiedad contiene un punto que representa una posición de selección no válida.
Funciones de acceso:
| QPoint | invalidSelectionPoint() const |
primarySubViewport : QRect
Esta propiedad contiene el rectángulo de la subventana de visualización actual dentro de la ventana de visualización a la que se dirige la vista principal de los gráficos.
Si no se ha establecido explícitamente la subventana de visualización principal, esta ocupará una quinta parte de viewport().
Nota: Si se establece primarySubViewport con un tamaño mayor que el del visor o fuera de este, el visor se redimensionará en consecuencia.
Funciones de acceso:
| QRect | primarySubViewport() const |
| void | setPrimarySubViewport(QRect primarySubViewport) |
Señal de notificador:
| void | primarySubViewportChanged(QRect subViewport) |
secondarySubViewport : QRect
Esta propiedad contiene el rectángulo de la ventana de visualización secundaria dentro de la ventana de visualización.
La ventana de visualización secundaria se utiliza para dibujar la vista de corte 2D en algunos gráficos. Si no se ha establecido explícitamente, tendrá el mismo tamaño que la ventana de visualización.
Nota: Si la subventana de visualización secundaria es mayor que la ventana de visualización o se encuentra fuera de ella, el tamaño de la ventana de visualización se ajustará en consecuencia.
Funciones de acceso:
| QRect | secondarySubViewport() const |
| void | setSecondarySubViewport(QRect secondarySubViewport) |
Señal de notificación:
| void | secondarySubViewportChanged(QRect subViewport) |
secondarySubviewOnTop : bool
Esta propiedad determina si se muestra en primer plano la vista de corte en 2D o la vista en 3D.
Funciones de acceso:
| bool | isSecondarySubviewOnTop() const |
| void | setSecondarySubviewOnTop(bool isSecondaryOnTop) |
Señal de notificación:
| void | secondarySubviewOnTopChanged(bool isSecondaryOnTop) |
selectionQueryPosition : QPoint
Esta propiedad contiene las coordenadas de la entrada del usuario que la escena debe procesar como una selección.
Si esta propiedad se establece en un valor distinto de « invalidSelectionPoint » (), el gráfico intenta seleccionar un elemento de datos, una etiqueta de eje o un elemento personalizado en las coordenadas especificadas dentro de la ventana gráfica principal. Tras la pasada de renderizado, la propiedad vuelve a su estado predeterminado de « invalidSelectionPoint » ().
Funciones de acceso:
| QPoint | selectionQueryPosition() const |
| void | setSelectionQueryPosition(QPoint point) |
Señal de notificación:
| void | selectionQueryPositionChanged(QPoint position) |
Véase también Q3DGraphsWidgetItem::selectedElement.
slicingActive : bool
Esta propiedad indica si la vista de corte en 2D está activa en este momento.
Si se establece « true », « Q3DGraphsWidgetItem::selectionMode » debe tener « QtGraphs3D::SelectionFlag::Row » o « QtGraphs3D::SelectionFlag::Column » configurado con una selección válida.
Nota: No todos los gráficos admiten la vista de corte en 2D.
Funciones de acceso:
| bool | isSlicingActive() const |
| void | setSlicingActive(bool isSlicing) |
Señal de notificación:
| void | slicingActiveChanged(bool isSlicingActive) |
[read-only] viewport : QRect
Esta propiedad contiene un valor de solo lectura que representa el rectángulo actual de la ventana de visualización, al que se dirige todo el renderizado 3D.
Funciones de acceso:
| QRect | viewport() const |
Señal de notificación:
| void | viewportChanged(QRect viewport) |
Documentación de las funciones de miembro
[explicit] Q3DScene::Q3DScene(QObject *parent = nullptr)
Crea una escena básica con una luz y una cámara. Se puede especificar un parámetro opcional « parent », que se pasa al constructor « QObject ».
[override virtual noexcept] Q3DScene::~Q3DScene()
Elimina la escena 3D y todos los objetos que contiene.
QPoint Q3DScene::invalidSelectionPoint() const
Devuelve un objeto ` QPoint ` que indica una posición de selección no válida.
Nota: Funcióngetter para la propiedad invalidSelectionPoint.
bool Q3DScene::isPointInPrimarySubView(QPoint point)
Devuelve si el point dado se encuentra dentro de la subvista principal o no. Devuelve true si el punto se encuentra dentro de la subvista principal.
Nota: Si las subvistas están superpuestas y el punto point dado se encuentra dentro de ambas, el resultado es true únicamente cuando la subvista principal está en la parte superior.
bool Q3DScene::isPointInSecondarySubView(QPoint point)
Devuelve si el punto dado ` point ` se encuentra dentro de la subvista secundaria o no. Devuelve ` true ` si el punto está dentro de la subvista secundaria.
Nota: Si las subvistas se superponen y el « point » dado se encuentra dentro de ambas, el resultado es « true » solo cuando la subvista secundaria está en la parte superior.
© 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.