이 페이지에서

Scene3D QML Type

Scene3D 타입은 시각화되는 3D 씬에 대한 설명을 제공합니다. 더 보기...

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

이 타입은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 타입을 사용하지 않는 것을 강력히 권장합니다.

속성

상세 설명

3D 장면에는 하나의 활성 카메라와 하나의 활성 광원이 포함되어 있습니다. 시각화된 데이터는 고정된 위치에 있는 것으로 가정합니다.

또한 3D 씬은 시각화 렌더링이 수행되는 뷰포트, 메인 3D 데이터 시각화 뷰가 위치한 뷰포트 내의 주 서브뷰포트, 그리고 데이터의 2D 슬라이스 뷰가 위치한 보조 서브뷰포트를 추적합니다.

또한 이 씬에는 보조 2D 슬라이스 뷰가 현재 활성화되어 있는지 여부를 추적하는 플래그가 있습니다.

참고: 모든 시각화 기능이 보조 2D 슬라이스 뷰를 지원하는 것은아닙니다 .

속성 문서

activeCamera : Camera3D

3D 씬에서 현재 활성화된 카메라입니다. 이 속성에 Camera3D가 설정되면, 해당 카메라가 씬의 자식 노드로 자동으로 추가됩니다.

activeLight : Light3D

3D 씬에서 현재 활성화된 라이트입니다. 이 속성에 Light3D가 설정되면, 해당 라이트가 씬의 자식으로 자동 추가됩니다.

devicePixelRatio : real

입력 좌표를 픽셀 좌표로 매핑할 때 사용되는 현재 장치 픽셀 비율입니다.

graphPositionQuery : point

씬에서 그래프 위치 쿼리로 처리해야 하는 사용자 입력의 좌표입니다. 이 속성이 ` invalidSelectionPoint` 이외의 값으로 설정된 경우, 그래프는 주 뷰포트 내의 주어진 지점에 그래프 위치를 매칭하려고 시도합니다. 렌더링 패스가 완료된 후, 이 속성은 기본 상태인 ` invalidSelectionPoint`로 복원됩니다. 쿼리된 그래프 위치는 다음 렌더링 패스가 끝난 후 ` AbstractGraph3D::queriedGraphPosition ` 속성에서 확인할 수 있습니다.

특정 화면 위치와 일치하는 단일한 올바른 3D 좌표는 없으므로, 일관성을 유지하기 위해 쿼리는 항상 그래프를 둘러싼 보이지 않는 상자의 안쪽 면을 기준으로 수행됩니다.

참고: 막대 그래프의 경우 그래프 바닥 수준에서만 그래프 위치 쿼리가 가능합니다.

AbstractGraph3D::queriedGraphPosition도 참조하십시오 .

invalidSelectionPoint : point

선택 시 유효하지 않은 지점을 제공하는 상수 속성입니다.

primarySubViewport : rect

데이터 시각화의 주 뷰가 표시되는 뷰포트 내부의 현재 서브뷰포트 사각형입니다.

slicingActive 가 false 인 경우, 기본 서브 뷰포트는 뷰포트와 동일해집니다. slicingActive 가 true 인 경우, 기본 서브 뷰포트가 명시적으로 설정되지 않았다면 뷰포트의 5분의 1 크기가 됩니다.

참고: primarySubViewport를 뷰포트보다 크거나 뷰포트 범위를 벗어날 정도로설정하면 , 뷰포트의 크기도 그에 따라 조정됩니다.

secondarySubViewport : rect

* * * 뷰포트 내부의 보조 뷰포트 사각형입니다. 보조 뷰포트*는 일부 시각화에서 2D 슬라이스 뷰를 그리는 데 사용됩니다. 명시적으로 설정되지 않은 경우* null이 됩니다. slicingActive 가 true 인 경우, * 뷰포트와 동일해집니다. *

참고: 보조 서브 뷰포트가 * 뷰포트보다 크거나 뷰포트 외부에 있는경우 , 뷰포트의 크기가 그에 따라 조정됩니다.

secondarySubviewOnTop : bool

2D 슬라이싱 뷰와 3D 뷰 중 어느 쪽이 위에 표시될지 지정합니다.

selectionQueryPosition : point

씬에서 선택 영역으로 처리해야 할 사용자 입력의 좌표입니다. 이 속성이 ` invalidSelectionPoint` 이외의 값으로 설정되면, 그래프는 기본 뷰포트 내에서 지정된 지점에 있는 데이터 항목을 선택하려고 시도합니다. 렌더링 단계가 끝나면 이 속성은 기본 상태인 ` invalidSelectionPoint`으로 복원됩니다.

slicingActive : bool

현재 2D 슬라이싱 보기가 활성화되어 있는지 여부를 지정합니다. true 인 경우, AbstractGraph3D::selectionMode 에서 AbstractGraph3D.SelectionRow 또는 AbstractGraph3D.SelectionColumn 중 하나에 유효한 선택 항목이 설정되어 있어야 합니다.

참고: 모든 시각화에서 2D 슬라이싱 보기를 지원하는 것은아닙니다 .

viewport : rect [read-only]

모든 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.