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 DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| En QML: | Scene3D |
| Heredado de: | QObject |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Propiedades
|
|
Funciones públicas
| Q3DScene(QObject *parent = nullptr) | |
| virtual | ~Q3DScene() |
| Q3DCamera * | activeCamera() const |
| Q3DLight * | activeLight() const |
| float | devicePixelRatio() const |
| QPoint | graphPositionQuery() const |
| bool | isPointInPrimarySubView(const QPoint &point) |
| bool | isPointInSecondarySubView(const QPoint &point) |
| bool | isSecondarySubviewOnTop() const |
| bool | isSlicingActive() const |
| QRect | primarySubViewport() const |
| QRect | secondarySubViewport() const |
| QPoint | selectionQueryPosition() const |
| void | setActiveCamera(Q3DCamera *camera) |
| void | setActiveLight(Q3DLight *light) |
| void | setDevicePixelRatio(float pixelRatio) |
| void | setGraphPositionQuery(const QPoint &point) |
| void | setPrimarySubViewport(const QRect &primarySubViewport) |
| void | setSecondarySubViewport(const QRect &secondarySubViewport) |
| void | setSecondarySubviewOnTop(bool isSecondaryOnTop) |
| void | setSelectionQueryPosition(const QPoint &point) |
| void | setSlicingActive(bool isSlicing) |
| QRect | viewport() const |
Señales
| void | activeCameraChanged(Q3DCamera *camera) |
| void | activeLightChanged(Q3DLight *light) |
| void | devicePixelRatioChanged(float pixelRatio) |
| void | graphPositionQueryChanged(const QPoint &position) |
| void | primarySubViewportChanged(const QRect &subViewport) |
| void | secondarySubViewportChanged(const QRect &subViewport) |
| void | secondarySubviewOnTopChanged(bool isSecondaryOnTop) |
| void | selectionQueryPositionChanged(const QPoint &position) |
| void | slicingActiveChanged(bool isSlicingActive) |
| void | viewportChanged(const QRect &viewport) |
Miembros públicos estáticos
| QPoint | invalidSelectionPoint() |
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 la subventana principal dentro de la ventana de visualización —donde se encuentra la vista principal de visualización de datos 3D— y de la subventana secundaria, donde se encuentra la vista en corte 2D de los datos. Por defecto, el controlador de tamaño de la vista ( Q3DScene) se encarga de redimensionar las subventanas. Para anular este comportamiento, es necesario escuchar las señales « viewportChanged()» y « slicingActiveChanged()» y recalcular las subventanas en consecuencia.
Además, la escena dispone de un indicador para controlar si la vista de corte 2D secundaria está activa o no en ese momento.
Nota: No todas las visualizaciones admiten la vista secundaria de corte en 2D.
Documentación de propiedades
activeCamera : Q3DCamera*
Esta propiedad contiene la cámara actualmente activa en la escena 3D.
Cuando se establece un nuevo objeto Q3DCamera, este se añade automáticamente como elemento secundario de la escena.
Funciones de acceso:
| Q3DCamera * | activeCamera() const |
| void | setActiveCamera(Q3DCamera *camera) |
Señal de notificación:
| void | activeCameraChanged(Q3DCamera *camera) |
activeLight : Q3DLight*
Esta propiedad contiene la luz actualmente activa en la escena 3D.
Cuando se establece un nuevo objeto Q3DLight, se añade automáticamente como elemento secundario de la escena.
Funciones de acceso:
| Q3DLight * | activeLight() const |
| void | setActiveLight(Q3DLight *light) |
Señal de notificación:
| void | activeLightChanged(Q3DLight *light) |
devicePixelRatio : float
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:
| float | devicePixelRatio() const |
| void | setDevicePixelRatio(float pixelRatio) |
Señal de notificación:
| void | devicePixelRatioChanged(float 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 gráfica principal. Tras la pasada de renderizado, esta propiedad vuelve a su estado predeterminado de invalidSelectionPoint(). La posición del gráfico consultada se puede leer en la propiedad QAbstract3DGraph::queriedGraphPosition tras la siguiente pasada de renderizado.
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 cuadro invisible que rodea el gráfico.
Nota: Los gráficosde barras solo permiten consultas de posición en el nivel de la base del gráfico.
Funciones de acceso:
| QPoint | graphPositionQuery() const |
| void | setGraphPositionQuery(const QPoint &point) |
Señal de notificación:
| void | graphPositionQueryChanged(const QPoint &position) |
Véase también QAbstract3DGraph::queriedGraphPosition.
primarySubViewport : QRect
Esta propiedad contiene el rectángulo del subventana de visualización actual dentro de la ventana de visualización en la que se muestra la vista principal de la visualización de datos.
Si isSlicingActive() es false, la subventana principal es igual a viewport(). Si isSlicingActive() es true y la subventana principal no se ha establecido explícitamente, será una quinta parte de viewport().
Nota: Si se establece primarySubViewport con un valor mayor que el del visor o fuera de los límites de este, el tamaño del visor se ajustará en consecuencia.
Funciones de acceso:
| QRect | primarySubViewport() const |
| void | setPrimarySubViewport(const QRect &primarySubViewport) |
Señal de notificador:
| void | primarySubViewportChanged(const 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 algunas visualizaciones. Si no se ha establecido explícitamente, será igual a QRect. Si isSlicingActive() es true, será igual a viewport.
Nota: Si la subventana secundaria es más grande 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(const QRect &secondarySubViewport) |
Señal de notificación:
| void | secondarySubViewportChanged(const 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(const QPoint &point) |
Señal de notificación:
| void | selectionQueryPositionChanged(const QPoint &position) |
Véase también QAbstract3DGraph::selectedElement.
slicingActive : bool
Esta propiedad indica si la vista de corte en 2D está activa en este momento.
Si « true », « QAbstract3DGraph::selectionMode » debe tener « QAbstract3DGraph::SelectionRow » o « QAbstract3DGraph::SelectionColumn » configurado con una selección válida.
Nota: No todas las visualizaciones admiten la vista de corte 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, donde se realiza todo el renderizado 3D.
Funciones de acceso:
| QRect | viewport() const |
Señal de notificación:
| void | viewportChanged(const 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 ».
[virtual noexcept] Q3DScene::~Q3DScene()
Elimina la escena 3D y todos los objetos que contiene.
[static] QPoint Q3DScene::invalidSelectionPoint()
Devuelve un valor « QPoint », lo que indica una posición de selección no válida.
bool Q3DScene::isPointInPrimarySubView(const QPoint &point)
Devuelve si el punto dado point se encuentra dentro de la subvista principal o no. Devuelve true si el punto está dentro de la subvista principal.
Nota: Si las subvistas están superpuestas y el « point » indicado se encuentra dentro de ambas, el resultado será « true » únicamente cuando la subvista principal se encuentre en la parte superior.
bool Q3DScene::isPointInSecondarySubView(const 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 están superpuestas y el punto point dado se encuentra dentro de ambas, el resultado es true únicamente cuando la subvista secundaria se encuentra 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.