AbstractGraph3D QML Type
3D 시각화를 위한 기본 유형. 더 보기...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| Inherited By: | |
| Status: | Deprecated |
이 타입은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 타입을 사용하지 않는 것을 강력히 권장합니다.
속성
- aspectRatio : real
(since QtDataVisualization 1.1) - currentFps : int
(since QtDataVisualization 1.1) - customItemList : list<Custom3DItem>
(since QtDataVisualization 1.1) - horizontalAspectRatio : real
(since QtDataVisualization 1.2) - inputHandler : AbstractInputHandler3D
- locale : locale
(since QtDataVisualization 1.2) - margin : real
(since QtDataVisualization 1.2) - measureFps : bool
(since QtDataVisualization 1.1) - msaaSamples : int
- optimizationHints : AbstractGraph3D.OptimizationHints
(since QtDataVisualization 1.1) - orthoProjection : bool
(since QtDataVisualization 1.1) - polar : bool
(since QtDataVisualization 1.2) - queriedGraphPosition : vector3d
(since QtDataVisualization 1.2) - radialLabelOffset : real
(since QtDataVisualization 1.2) - reflection : bool
(since QtDataVisualization 1.2) - reflectivity : real
(since QtDataVisualization 1.2) - scene : Scene3D
- selectedElement : AbstractGraph3D.ElementType
(since QtDataVisualization 1.1) - selectionMode : AbstractGraph3D.SelectionMode
- shadowQuality : AbstractGraph3D.ShadowQuality
- shadowsSupported : bool
- theme : Theme3D
방법
- int addCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void clearSelection()
- bool hasSeries(Abstract3DSeries series)
(since 6.3) - void releaseCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItemAt(vector3d position)
(since QtDataVisualization 1.1) - void removeCustomItems()
(since QtDataVisualization 1.1) - Abstract3DAxis selectedAxis()
(since QtDataVisualization 1.1) - Custom3DItem selectedCustomItem()
(since QtDataVisualization 1.1) - int selectedCustomItemIndex()
(since QtDataVisualization 1.1) - int selectedLabelIndex()
(since QtDataVisualization 1.1)
상세 설명
QtDataVisualization 의 모든 3D 시각화를 위한 기본 유형입니다.
이 타입은 직접 생성할 수 없지만, 3D 시각화 간에 공유되는 속성을 포함하고 있습니다.
Bars3D, Scatter3D, Surface3D 및 Qt Data Visualization C++ Classes.
속성 설명서
aspectRatio : real [since QtDataVisualization 1.1]
수평면상의 가장 긴 축과 y축 사이의 그래프 배율 비율입니다. 기본값은 2.0 입니다.
참고: Bars3D에는 영향을미치지 않습니다.
이 속성은 QtDataVisualization 1.1에서 도입되었습니다.
horizontalAspectRatio도 참조하십시오 .
currentFps : int [since QtDataVisualization 1.1]
FPS 측정이 활성화되면, 지난 1초 동안의 결과가 이 읽기 전용 속성에 저장됩니다. 측정이 활성화된 후 이 값이 업데이트되기까지는 최소 1초가 소요됩니다.
이 속성은 QtDataVisualization 1.1에서 도입되었습니다.
measureFps도 참조하십시오 .
customItemList : list<Custom3DItem> [since QtDataVisualization 1.1]
그래프에 추가된 Custom3DItem 항목의 목록입니다. 그래프는 추가된 항목에 대한 소유권을 갖습니다.
이 속성은 QtDataVisualization 1.1에서 도입되었습니다.
horizontalAspectRatio : real [since QtDataVisualization 1.2]
x축과 z축 간의 그래프 스케일링 비율입니다. 0.0 값은 축 범위에 따라 자동으로 스케일링됨을 나타냅니다. 기본값은 0.0 입니다.
참고: Bars3D에는 영향을미치지 않습니다 . Bars3D는 barThickness 및 barSpacing 속성을 통해 수평면의 스케일링을 처리합니다. 극좌표 그래프도 이 속성을 무시합니다.
이 속성은 QtDataVisualization 1.2에서 도입되었습니다.
aspectRatio, polar, Bars3D::barThickness 및 Bars3D::barSpacing도 참조하십시오 .
inputHandler : AbstractInputHandler3D
그래프에서 사용되는 활성 입력 핸들러입니다. 이 속성을 null로 설정하면 기본 입력 핸들러를 비활성화할 수 있습니다.
locale : locale [since QtDataVisualization 1.2]
다양한 숫자 레이블의 서식 지정에 사용되는 로케일을 설정합니다. 기본값은 ‘ "C" ’ 로케일입니다.
이 속성은 QtDataVisualization 1.2에서 도입되었습니다.
ValueAxis3D::labelFormat도 참조하십시오 .
margin : real [since QtDataVisualization 1.2]
그래프 그리기 가능 영역의 가장자리와 그래프 배경의 가장자리 사이에 남겨둘 간격에 사용되는 절대값입니다.
여백 값이 음수인 경우, 여백은 자동으로 결정되며 시리즈 내 항목의 크기와 그래프 유형에 따라 달라질 수 있습니다. 그래프 종횡비가 기본값에서 변경되지 않은 경우, 이 값은 y축 범위의 비율로 해석됩니다. 기본값은 -1.0 입니다.
참고: 산점도에서 자동으로 결정된 여백보다 더 작은 여백을설정하면 , 그래프 가장자리에 위치한 산점도 항목이 그래프 배경과 겹칠 수 있습니다.
참고: 산점도 및 표면그래프에서 여백이 축 레이블 크기에 비해 작을 경우, 인접한 축의 가장자리 레이블과의 중복을 방지하기 위해 축의 가장자리 레이블 위치가 조정됩니다.
이 속성은 QtDataVisualization 1.2에서 도입되었습니다.
measureFps : bool [since QtDataVisualization 1.1]
true 인 경우, 렌더링은 요청 시가 아닌 지속적으로 수행되며, currentFps 속성의 값이 업데이트됩니다. 기본값은 false 입니다.
이 속성은 QtDataVisualization 1.1에서 도입되었습니다.
currentFps도 참조하십시오 .
msaaSamples : int
renderingMode가 ‘ RenderIndirect ’일 때 멀티샘플 앤티앨리어싱에 사용되는 샘플 수입니다. renderingMode가 ‘ RenderDirectToBackground ’ 또는 ‘ RenderDirectToBackground_NoClear ’일 경우, 이 속성 값은 읽기 전용이며 창 표면 형식에 지정된 샘플 수를 반환합니다. 기본값은 ‘ 4 ’입니다.
renderingMode도 참조하십시오 .
optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]
렌더링 최적화를 위해 기본 모드 또는 정적 모드 중 어느 것을 사용할지 여부.
기본 모드는 합리적인 수준의 성능으로 전체 기능을 제공합니다. 정적 모드는 그래프 렌더링을 최적화하며, 변경되지 않는 대용량 데이터 세트에 이상적입니다. 데이터가 동적으로 변경되거나 항목이 회전하는 경우에는 속도가 느려집니다. 선택 기능은 최적화되지 않으므로, 방대한 데이터 세트에 정적 모드를 사용하는 것은 권장되지 않습니다. 정적 최적화는 산점도 그래프에서만 작동합니다. 기본값은 ` OptimizationDefault`입니다.
참고: 일부환경에서는 정적 최적화를 사용하는 대규모 그래프가 렌더링되지 않을 수 있습니다. 모든 항목이 단일 드로우 콜을 통해 렌더링되는데, 그래픽 드라이버마다 콜당 지원되는 최대 정점 수가 다르기 때문입니다. 이 문제는 주로 32비트 및 OpenGL ES2 플랫폼에서 발생합니다. 이 문제를 해결하려면 정점 수가 적은 항목 메시를 선택하거나 점(point) 메시를 사용하십시오.
이 속성은 QtDataVisualization 1.1에서 도입되었습니다.
Abstract3DSeries::mesh 및 QAbstract3DGraph::OptimizationHint도 참조하십시오 .
orthoProjection : bool [since QtDataVisualization 1.1]
true 인 경우, 그래프 표시 시 정사영법이 사용됩니다. 기본값은 false 입니다.
참고: true 로 설정하면그림자가 비활성화됩니다.
이 속성은 QtDataVisualization 1.1에서 도입되었습니다.
polar : bool [since QtDataVisualization 1.2]
true 인 경우, 가로축이 극좌표축으로 변경됩니다. x축은 각도축이 되고, z축은 반경축이 됩니다. 막대 그래프에서는 극좌표 모드를 사용할 수 없습니다.
기본값은 ` false`입니다.
이 속성은 QtDataVisualization 1.2에서 도입되었습니다.
orthoProjection 및 radialLabelOffset도 참조하십시오 .
queriedGraphPosition : vector3d [since QtDataVisualization 1.2]
이 읽기 전용 속성에는 ` Scene3D::graphPositionQuery`를 사용하여 쿼리된 각 축을 따라 그래프의 최신 위치 값이 포함됩니다. 이 값들은 [-1, 1] 범위로 정규화됩니다. 쿼리된 위치가 그래프 경계 밖에 있는 경우, 값은 실제 위치를 반영하지 않고 대신 [-1, 1] 범위 밖의 정의되지 않은 위치가 됩니다. 쿼리가 수행될 때까지 이 값은 정의되지 않은 상태로 유지됩니다.
특정 화면 위치에 대응하는 유일한 올바른 3D 좌표는 없으므로, 일관성을 유지하기 위해 쿼리는 항상 그래프를 둘러싼 보이지 않는 상자의 안쪽 면을 기준으로 수행됩니다.
참고: 막대 그래프의 경우 그래프 바닥 수준에서만 그래프 위치를 조회할 수 있으므로, 막대 그래프의 y값은 항상 0이며, 그래프 바닥이 포함된 화면 위치에서만 유효한 조회가 가능합니다.
이 속성은 QtDataVisualization 1.2에서 도입되었습니다.
Scene3D::graphPositionQuery도 참조하십시오 .
radialLabelOffset : real [since QtDataVisualization 1.2]
이 속성은 방사형 극좌표축의 축 레이블에 대한 정규화된 수평 오프셋을 지정합니다. 값 0.0 은 레이블이 0각도 각도축 격자선 옆에 그려져야 함을 나타냅니다. 값 1.0 은 레이블이 그래프 배경의 가장자리라는 일반적인 위치에 그려져야 함을 나타냅니다. 극좌표 속성의 값이 false 인 경우 이 속성은 무시됩니다. 기본값은 1.0 입니다.
이 속성은 QtDataVisualization 1.2에서 도입되었습니다.
polar도 참조하십시오 .
reflection : bool [since QtDataVisualization 1.2]
바닥 반사를 켜거나 끕니다. 기본값은 ‘ false ’입니다.
참고: Bars3D에만적용됩니다 . 그러나 양수 및 음수 값을 모두 포함하는 Bars3D 그래프의 경우, 바닥 평면과 교차하는 사용자 정의 항목에 대해서는 반사가 지원되지 않습니다. 이 경우, 잘못된 렌더링을 방지하기 위해 반사 기능을 비활성화해야 합니다.
이 속성은 QtDataVisualization 1.2에서 도입되었습니다.
reflectivity도 참조하십시오 .
reflectivity : real [since QtDataVisualization 1.2]
바닥의 반사율을 설정합니다. 수치가 클수록 바닥의 반사율이 높아집니다. 유효 범위는 [0...1] 입니다. 기본값은 0.5 입니다.
참고: Bars3D에만적용됩니다 .
이 속성은 QtDataVisualization 1.2에서 도입되었습니다.
reflection도 참조하십시오 .
scene : Scene3D
씬을 조작하고 활성 카메라와 같은 씬 요소에 접근하는 데 사용할 수 있는 Scene3D 포인터입니다.
이 속성은 읽기 전용입니다.
selectedElement : AbstractGraph3D.ElementType [since QtDataVisualization 1.1]
그래프에서 선택된 요소.
이 속성을 사용하여 선택된 요소의 유형을 조회할 수 있습니다. 이 유형은 그래프에서 새로운 선택이 이루어지고 ` selectedElementChanged ` 신호가 발신될 때까지 유효합니다.
이 신호는 예를 들어, 'Axis Handling' 예제에서 보여준 바와 같이 사용자 정의 입력 처리를 구현하는 데 사용할 수 있습니다.
이 속성은 QtDataVisualization 1.1에서 도입되었습니다.
selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Bars3D::selectedSeries, Scatter3D::selectedSeries, Scene3D::selectionQueryPosition 및 QAbstract3DGraph::ElementType도 참조하십시오 .
selectionMode : AbstractGraph3D.SelectionMode
시각화에서 활성 선택 모드입니다. QAbstract3DGraph::SelectionFlag 열거형 값 중 하나입니다.
QAbstract3DGraph::SelectionFlag도 참조하십시오 .
shadowQuality : AbstractGraph3D.ShadowQuality
그림자의 품질. QAbstract3DGraph::ShadowQuality 열거형 값 중 하나입니다.
QAbstract3DGraph::ShadowQuality도 참조하십시오 .
shadowsSupported : bool
이 읽기 전용 속성은 현재 구성에서 그림자가 지원되는지 여부를 나타냅니다. OpenGL ES2 구성에서는 그림자가 지원되지 않습니다.
theme : Theme3D
그래프의 현재 테마입니다.
Theme3D도 참조하십시오 .
메서드 문서
[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)
그래프에 Custom3DItem item 을 추가합니다. 그래프는 추가된 항목에 대한 소유권을 갖습니다.
추가가 성공하면 추가된 항목의 인덱스를 반환하고, null 항목을 추가하려고 시도한 경우 -1을, 이미 추가된 항목을 추가하려고 시도한 경우 해당 항목의 인덱스를 반환합니다.
이 메서드는 QtDataVisualization 1.1에서 도입되었습니다.
removeCustomItems(), removeCustomItem(), removeCustomItemAt()도 참조하십시오 .
void clearSelection()
연결된 모든 시리즈에서 선택 항목을 지웁니다.
[since 6.3] bool hasSeries(Abstract3DSeries series)
series 가 이미 그래프에 추가되었는지 여부를 반환합니다.
이 메서드는 Qt 6.3에서 도입되었습니다.
[since QtDataVisualization 1.1] void releaseCustomItem(Custom3DItem item)
item 의 소유권을 되찾고, 그래프에서 item 를 제거합니다.
참고: 동일한 항목을 그래프에 다시 추가하는경우 , 텍스처 파일을 다시 설정해야 합니다.
이 메서드는 QtDataVisualization 1.1에서 도입되었습니다.
Custom3DItem::textureFile도 참조하십시오 .
[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)
사용자 정의 item 를 제거합니다. 이에 할당된 리소스를 삭제합니다.
이 메서드는 QtDataVisualization 1.1에서 도입되었습니다.
[since QtDataVisualization 1.1] void removeCustomItemAt(vector3d position)
position 에 있는 모든 사용자 정의 항목을 제거합니다. 해당 항목에 할당된 리소스를 삭제합니다.
이 메서드는 QtDataVisualization 1.1에서 도입되었습니다.
[since QtDataVisualization 1.1] void removeCustomItems()
모든 사용자 정의 항목을 제거합니다. 해당 항목에 할당된 리소스를 삭제합니다.
이 메서드는 QtDataVisualization 1.1에서 도입되었습니다.
[since QtDataVisualization 1.1] Abstract3DAxis selectedAxis()
어떤 레이블 유형이든 ‘ selectedElementChanged ’ 신호를 수신한 후 선택된 축을 가져오는 데 사용할 수 있습니다. 선택 상태는 다음 ‘ selectedElementChanged ’ 신호가 전송될 때까지 유효합니다.
선택된 축을 반환하거나 null을 반환합니다.
이 메서드는 QtDataVisualization 1.1에서 도입되었습니다.
selectedElement도 참조하십시오 .
[since QtDataVisualization 1.1] Custom3DItem selectedCustomItem()
ElementCustomItem 유형의 ` selectedElementChanged ` 신호를 수신한 후, 선택된 사용자 정의 항목을 가져오는 데 사용할 수 있습니다. 항목의 소유권은 그래프에 남아 있습니다. 선택 상태는 다음 ` selectedElementChanged ` 신호가 발생할 때까지 유효합니다.
선택된 사용자 정의 항목을 반환하거나 null을 반환합니다.
이 메서드는 QtDataVisualization 1.1에서 도입되었습니다.
selectedElement도 참조하십시오 .
[since QtDataVisualization 1.1] int selectedCustomItemIndex()
ElementCustomItem 유형의 ‘ selectedElementChanged ’ 신호를 수신한 후, 선택된 사용자 정의 항목의 인덱스를 조회하는 데 사용할 수 있습니다. 선택은 다음 ‘ selectedElementChanged ’ 신호가 발생할 때까지 유효합니다.
선택된 사용자 정의 항목의 인덱스를 반환하거나, -1을 반환합니다.
이 메서드는 QtDataVisualization 1.1에서 도입되었습니다.
selectedElement도 참조하십시오 .
[since QtDataVisualization 1.1] int selectedLabelIndex()
어떤 레이블 유형이든 ‘ selectedElementChanged ’ 신호를 수신한 후, 선택된 레이블의 인덱스를 조회하는 데 사용할 수 있습니다. 선택 상태는 다음 ‘ selectedElementChanged ’ 신호가 발생할 때까지 유효합니다.
선택된 레이블의 인덱스를 반환하거나 -1을 반환합니다.
이 메서드는 QtDataVisualization 1.1에서 도입되었습니다.
selectedElement도 참조하십시오 .
© 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.
