En esta página

Scene3D QML Type (Uncreatable)

El tipo `Scene3D` proporciona una descripción de la escena 3D que se está visualizando. Más información...

Import Statement: import QtGraphs
In C++: Q3DScene

Nota: Se trata de un tipo no creable. No se puede instanciar en QML.

Propiedades

Señales

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 en 3D, y de la subventana secundaria, donde se encuentra la vista en 2D seccionada de los datos.

Además, la escena dispone de un indicador para saber si la vista de corte en 2D secundaria está activa en ese momento o no.

Nota: No todos los gráficos admiten la vista de corte en 2D secundaria.

Documentación de propiedades

devicePixelRatio : real

La relación de píxeles del dispositivo actual que se utiliza al convertir las coordenadas de entrada en coordenadas de píxeles.

graphPositionQuery : point

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 el punto dado dentro de la ventana gráfica 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 GraphsItem3D::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, 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.

Véase también GraphsItem3D::queriedGraphPosition.

invalidSelectionPoint : point [read-only]

Una propiedad constante que proporciona un punto no válido para la selección.

primarySubViewport : rect

El rectángulo del subventana de visualización actual dentro de la ventana de visualización, al que se dirige la vista principal de los gráficos.

Si no se ha establecido explícitamente la subventana principal, ocupará una quinta parte de la ventana de visualización.

Nota: Si se establece primarySubViewport con un tamaño mayor que el del área de visualización o fuera de ella, el área de visualización se redimensionará en consecuencia.

secondarySubViewport : rect

La ventana de visualización secundaria se utiliza para dibujar la vista de corte en 2D en algunos gráficos. Si no se ha configurado explícitamente, tendrá el mismo tamaño que la ventana de visualización.

Nota: Si la subventana 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.

secondarySubviewOnTop : bool

Determina si se muestra en primer plano la vista de corte en 2D o la vista en 3D.

selectionQueryPosition : point

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 en el punto indicado dentro de la ventana gráfica principal. Tras la pasada de renderizado, la propiedad vuelve a su estado predeterminado: « invalidSelectionPoint ».

slicingActive : bool

Define si la vista de corte en 2D está activa actualmente. Si se establece en « true », Graphs3D::selectionMode debe tener el parámetro « Graphs3D.SelectionRow » o « Graphs3D.SelectionColumn » configurado con una selección válida.

Nota: No todos los gráficos admiten la vista de corte en 2D.

Documentación de señales

devicePixelRatioChanged(qreal pixelRatio)

Esta señal se emite cuando devicePixelRatio cambia a pixelRatio.

Nota: El controlador correspondiente es onDevicePixelRatioChanged.

graphPositionQueryChanged(point position)

Esta señal se emite cuando graphPositionQuery cambia a position.

Nota: El controlador correspondiente es onGraphPositionQueryChanged.

primarySubViewportChanged(rect subViewport)

Esta señal se emite cuando primarySubViewport cambia a subViewport.

Nota: El controlador correspondiente es onPrimarySubViewportChanged.

secondarySubViewportChanged(rect subViewport)

Esta señal se emite cuando secondarySubViewport cambia a subViewport.

Nota: El controlador correspondiente es onSecondarySubViewportChanged.

secondarySubviewOnTopChanged(bool isSecondaryOnTop)

Esta señal se emite cuando secondarySubviewOnTop cambia a isSecondaryOnTop.

Nota: El controlador correspondiente es onSecondarySubviewOnTopChanged.

selectionQueryPositionChanged(point position)

Esta señal se emite cuando selectionQueryPosition cambia a position.

Nota: El controlador correspondiente es onSelectionQueryPositionChanged.

slicingActiveChanged(bool isSlicingActive)

Esta señal se emite cuando slicingActive cambia a isSlicingActive.

Nota: El controlador correspondiente es onSlicingActiveChanged.

viewportChanged(rect viewport)

Esta señal se emite cuando el área de visualización cambia a viewport.

Nota: El controlador correspondiente es onViewportChanged.

© 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.