Scene3D QML Type
Scene3D 유형은 시각화 중인 3D 장면에 대한 설명을 제공합니다. 더 보기...
| Import Statement: | import QtGraphs |
| In C++: | Q3DScene |
- 상속된 멤버를 포함한 모든 멤버 목록
- Scene3D는 Qt Graphs 3D용 QML 유형의 일부입니다.
속성
- devicePixelRatio : qreal
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
신호
- devicePixelRatioChanged(qreal pixelRatio)
- graphPositionQueryChanged(point position)
- primarySubViewportChanged(rect subViewport)
- secondarySubViewportChanged(rect subViewport)
- secondarySubviewOnTopChanged(bool isSecondaryOnTop)
- selectionQueryPositionChanged(point position)
- slicingActiveChanged(bool isSlicingActive)
- viewportChanged(rect viewport)
자세한 설명
3D 씬에는 하나의 활성 카메라와 하나의 활성 광원이 포함됩니다. 시각화된 데이터는 고정된 위치에 있다고 가정합니다.
또한 3D 씬은 그래프 렌더링이 수행되는 뷰포트, 기본 3D 그래프 뷰가 있는 뷰포트 내부의 기본 하위 뷰포트, 데이터의 2D 슬라이스 뷰가 있는 보조 하위 뷰포트를 추적합니다.
또한 씬에는 보조 2D 슬라이싱 뷰가 현재 활성화되어 있는지 여부를 추적하기 위한 플래그가 있습니다.
참고: 모든 그래프가 보조 2D 슬라이싱 뷰를 지원하는 것은 아닙니다.
속성 문서
devicePixelRatio : qreal |
입력 좌표를 픽셀 좌표에 매핑할 때 사용되는 현재 디바이스 픽셀 비율입니다.
graphPositionQuery : point |
씬에서 그래프 위치 쿼리로 처리해야 하는 사용자 입력의 좌표입니다. 이 프로퍼티가 invalidSelectionPoint 이외의 값으로 설정되면 그래프는 그래프 위치를 기본 뷰포트 내의 지정된 지점에 일치시키려고 시도합니다. 렌더링 패스가 끝나면 이 프로퍼티는 기본 상태인 invalidSelectionPoint 로 반환됩니다. 쿼리된 그래프 위치는 다음 렌더링 패스 후에 GraphsItem3D::queriedGraphPosition 프로퍼티에서 읽을 수 있습니다.
특정 화면 위치와 일치하는 하나의 정확한 3D 좌표는 없으므로 일관성을 유지하기 위해 쿼리는 항상 그래프를 둘러싼 보이지 않는 상자의 안쪽 면을 기준으로 수행됩니다.
참고: 막대 그래프는 그래프 바닥 수준에서만 그래프 위치 쿼리를 허용합니다.
GraphsItem3D::queriedGraphPosition 를참조하세요 .
invalidSelectionPoint : point |
선택에 유효하지 않은 지점을 제공하는 상수 속성입니다.
primarySubViewport : rect |
그래프의 기본 보기를 대상으로 하는 뷰포트 내부의 현재 하위 뷰포트 사각형입니다.
주 하위 뷰포트가 명시적으로 설정되지 않은 경우 뷰포트의 1/5이 됩니다.
참고: primarySubViewport를 뷰포트보다 크거나 뷰포트 외부로 설정하면 그에 따라 뷰포트의 크기가 조정됩니다.
secondarySubViewport : rect |
보조 뷰포트는 일부 그래프에서 2D 슬라이스 뷰를 그리는 데 사용됩니다. 명시적으로 설정하지 않은 경우 뷰포트의 크기와 동일합니다.
참고: 보조 하위 뷰포트가 뷰포트보다 크거나 뷰포트 외부에 있는 경우 뷰포트의 크기가 그에 따라 조정됩니다.
secondarySubviewOnTop : bool |
2D 슬라이싱 뷰 또는 3D 뷰를 위에 그릴지 여부를 정의합니다.
selectionQueryPosition : point |
씬에서 선택으로 처리해야 하는 사용자 입력의 좌표입니다. 이 프로퍼티가 invalidSelectionPoint 이외의 값으로 설정되면 그래프는 기본 뷰포트 내의 지정된 지점에서 데이터 항목을 선택하려고 시도합니다. 렌더링 패스가 끝나면 프로퍼티는 기본 상태인 invalidSelectionPoint 로 반환됩니다.
slicingActive : bool |
2D 슬라이싱 뷰가 현재 활성화되어 있는지 여부를 정의합니다. true 인 경우 Graphs3D::selectionMode에 Graphs3D.SelectionRow 또는 Graphs3D.SelectionColumn 가 유효한 선택으로 설정되어 있어야 합니다.
참고: 모든 그래프가 2D 슬라이싱 보기를 지원하는 것은 아닙니다.
신호 문서
devicePixelRatioChanged(qreal pixelRatio) |
이 신호는 devicePixelRatio 가 pixelRatio 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onDevicePixelRatioChanged 입니다.
graphPositionQueryChanged(point position) |
graphPositionQuery 이 position 으로 변경될 때 이 신호가 전송됩니다.
참고: 해당 핸들러는 onGraphPositionQueryChanged 입니다.
primarySubViewportChanged(rect subViewport) |
primarySubViewport 이 subViewport 으로 변경될 때 이 신호가 전송됩니다.
참고: 해당 핸들러는 onPrimarySubViewportChanged 입니다.
secondarySubViewportChanged(rect subViewport) |
secondarySubViewport 이 subViewport 으로 변경될 때 이 신호가 전송됩니다.
참고: 해당 핸들러는 onSecondarySubViewportChanged 입니다.
secondarySubviewOnTopChanged(bool isSecondaryOnTop) |
secondarySubviewOnTop 이 isSecondaryOnTop 으로 변경될 때 이 신호가 전송됩니다.
참고: 해당 핸들러는 onSecondarySubviewOnTopChanged 입니다.
selectionQueryPositionChanged(point position) |
selectionQueryPosition 이 position 으로 변경될 때 이 신호가 전송됩니다.
참고: 해당 핸들러는 onSelectionQueryPositionChanged 입니다.
slicingActiveChanged(bool isSlicingActive) |
slicingActive 이 isSlicingActive 으로 변경될 때 이 신호가 전송됩니다.
참고: 해당 핸들러는 onSlicingActiveChanged 입니다.
viewportChanged(rect viewport) |
이 신호는 뷰포트가 viewport 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onViewportChanged 입니다.
© 2025 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.
