En esta página

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

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.