Scene3D QML Type
El tipo Scene3D proporciona una descripción de la escena 3D que se está visualizando. Más...
| Import Statement: | import QtGraphs |
| In C++: | Q3DScene |
- Lista de todos los miembros, incluidos los heredados
- Scene3D es parte de Qt Graphs Tipos QML para 3D.
Propiedades
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
Señales
- devicePixelRatioChanged(qreal pixelRatio)
- graphPositionQueryChanged(point position)
- primarySubViewportChanged(rect subViewport)
- secondarySubViewportChanged(rect subViewport)
- secondarySubviewOnTopChanged(bool isSecondaryOnTop)
- selectionQueryPositionChanged(point position)
- slicingActiveChanged(bool isSlicingActive)
- viewportChanged(rect viewport)
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 los gráficos, la ventana secundaria primaria dentro de la ventana en la que se encuentra la vista principal de los gráficos 3D y la ventana secundaria en la que se encuentra la vista en 2D de los datos.
Además, la escena tiene un indicador para saber si la vista 2D secundaria está activa o no.
Nota: No todos los gráficos soportan la vista de corte 2D secundaria.
Documentación de propiedades
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 GraphsItem3D::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 GraphsItem3D::queriedGraphPosition.
invalidSelectionPoint : point [read-only]
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 los gráficos.
Si la subvista primaria no se ha establecido 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
La ventana gráfica secundaria se utiliza para dibujar la vista de corte 2D en algunos gráficos. Si no se ha establecido explícitamente, será igual al tamaño de 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, Graphs3D::selectionMode debe tener los valores Graphs3D.SelectionRow o Graphs3D.SelectionColumn establecidos en una selección válida.
Nota: No todos los gráficos admiten la vista de corte 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 la ventana gráfica 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.
