En esta página

Scene3D QML Type

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

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
In C++: Q3DScene
Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

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

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

Nota: No todas las visualizaciones admiten la vista de corte en 2D secundaria.

Documentación de propiedades

activeCamera : Camera3D

La cámara actualmente activa en la escena 3D. Cuando se establece un objeto `Camera3D` en la propiedad, se añade automáticamente como elemento secundario de la escena.

activeLight : Light3D

La luz actualmente activa en la escena 3D. Cuando se establece un objeto «Light3D» en la propiedad, se añade automáticamente como elemento secundario de la escena.

devicePixelRatio : real

La relación de píxeles del dispositivo actual que se utiliza al asignar las coordenadas de entrada a las 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 puede leerse en la propiedad « AbstractGraph3D::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.

Véase también AbstractGraph3D::queriedGraphPosition.

invalidSelectionPoint : point

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, donde se muestra la vista principal de la visualización de datos.

Si slicingActive es false, el subventana principal será igual a la ventana de visualización. Si slicingActive es true y la subventana principal no se ha establecido explícitamente, será una quinta parte de la ventana de visualización.

Nota: Si se establece primarySubViewport con un tamaño mayor que el del viewport o fuera de él, el tamaño del viewport se redimensionará en consecuencia.

secondarySubViewport : rect

* * * 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 en corte 2D en algunas visualizaciones. Si no * se ha establecido explícitamente, será nula. Si slicingActive es true, será * igual a 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 », « AbstractGraph3D::selectionMode » debe tener el « AbstractGraph3D.SelectionRow » o el « AbstractGraph3D.SelectionColumn » configurado con una selección válida.

Nota: No todas las visualizaciones admiten la vista de corte en 2D.

viewport : rect [read-only]

El rectángulo de la ventana de visualización actual al que se dirige todo el renderizado 3D.

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