Scene3D QML Type
El tipo Scene3D proporciona una descripción de la escena 3D que se está visualizando. Más...
| Import Statement: | import QtDataVisualization 1.11 |
| Since: | QtDataVisualization 1.0 |
| In C++: | Q3DScene |
Propiedades
- activeCamera : Camera3D
- activeLight : Light3D
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
- viewport : rect
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 en la que se realiza el renderizado de la visualización, la ventana secundaria primaria dentro de la ventana en la que se encuentra la vista principal de visualización de los datos 3D y la ventana secundaria en la que se encuentra la vista de corte 2D de los datos.
Además, la escena tiene un indicador para saber si la vista 2D secundaria está activa o no.
Nota: No todas las visualizaciones admiten la vista de corte 2D secundaria.
Documentación de propiedades
activeCamera : Camera3D
La cámara actualmente activa en la escena 3D. Cuando se establece un Camera3D en la propiedad, se añade automáticamente como hijo de la escena.
activeLight : Light3D
La luz actualmente activa en la escena 3D. Cuando se establece un Light3D en la propiedad, se añade automáticamente como hijo de la escena.
devicePixelRatio : real
La relación de píxeles actual del dispositivo que se utiliza al asignar coordenadas de entrada a coordenadas de píxeles.
graphPositionQuery : point
Las coordenadas de la entrada del usuario que deben ser procesadas por la escena como una consulta de posición del gráfico. Si esta propiedad tiene 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 primaria. Tras el pase de renderizado, esta propiedad vuelve a su estado por defecto invalidSelectionPoint. La posición del gráfico consultada puede leerse en la propiedad AbstractGraph3D::queriedGraphPosition tras el siguiente pase de renderizado.
No existe una única coordenada 3D correcta que coincida con una posición de pantalla concreta, por lo que, para ser coherentes, las consultas se realizan siempre contra los lados interiores de una caja invisible que rodea el gráfico.
Nota: Los gráficos de barras sólo permiten realizar consultas de posición a nivel del suelo del gráfico.
Véase también AbstractGraph3D::queriedGraphPosition.
invalidSelectionPoint : point
Una propiedad constante que proporciona un punto inválido para la selección.
primarySubViewport : rect
El rectángulo de la subvista actual dentro de la ventana donde se encuentra la vista principal de la visualización de datos.
Si slicingActive es false, la subvista primaria será igual a la ventana gráfica. Si slicingActive es true y la subvista primaria no se ha definido explícitamente, será una quinta parte de la ventana gráfica.
Nota: Si se establece primarySubViewport más grande o fuera de la ventana gráfica, ésta se redimensionará en consecuencia.
secondarySubViewport : rect
* * El rectángulo de la ventana secundaria dentro de la ventana. La ventana secundaria * se utiliza para dibujar la vista en 2D en algunas visualizaciones. Si no se ha * establecido explícitamente, será nulo. Si slicingActive es true, será * igual a la ventana gráfica. *
Nota: Si la ventana secundaria es mayor o está fuera de la * ventana gráfica, ésta se redimensionará en consecuencia.
secondarySubviewOnTop : bool
Define si se dibuja encima la vista de corte 2D o la vista 3D.
selectionQueryPosition : point
Las coordenadas de la entrada del usuario que deben ser procesadas por la escena como una selección. Si esta propiedad tiene un valor distinto de invalidSelectionPoint, el gráfico intenta seleccionar un elemento de datos en el punto dado dentro de la ventana gráfica primaria. Después del pase de renderizado, la propiedad vuelve a su estado por defecto de invalidSelectionPoint.
slicingActive : bool
Define si la vista de corte 2D está actualmente activa. Si true, AbstractGraph3D::selectionMode debe tener AbstractGraph3D.SelectionRow o AbstractGraph3D.SelectionColumn en una selección válida.
Nota: No todas las visualizaciones admiten la vista de corte 2D.
viewport : rect [read-only]
El rectángulo de la vista actual donde 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.
