Back to Qt.io
Contact Us Blog Download Qt

AbstractGraph3D QML Type

3D 시각화를 위한 기본 유형입니다. 더 보기...

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
Inherited By:

Bars3D, Scatter3D, and Surface3D

속성

방법

자세한 설명

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초가 걸립니다.

이 속성은 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 입니다.

참고: barThickness 및 barSpacing 속성을 통해 가로 평면에서 배율을 처리하는 Bars3D 에는 영향을 미치지 않습니다. 극좌표 그래프도 이 속성을 무시합니다.

이 프로퍼티는 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

렌더링 모드가 RenderIndirect 일 때 다중 샘플 앤티앨리어싱에 사용되는 샘플 수입니다. 렌더링 모드가 RenderDirectToBackground 또는 RenderDirectToBackground_NoClear 인 경우 이 속성 값은 읽기 전용이며 창 표면 형식에 지정된 샘플 수를 반환합니다. 기본값은 4 입니다.

renderingMode 를참조하십시오 .


optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]

렌더링 최적화를 위해 기본 모드 또는 정적 모드를 사용할지 여부를 결정합니다.

기본 모드는 합리적인 수준의 성능으로 전체 기능 세트를 제공합니다. 정적 모드는 그래프 렌더링을 최적화하며 변경되지 않는 대규모 데이터 집합에 이상적입니다. 동적 데이터 변경 및 항목 회전 시 속도가 느려집니다. 선택이 최적화되지 않으므로 대규모 데이터 집합에 정적 모드를 사용하는 것은 바람직하지 않습니다. 정적 최적화는 분산형 그래프에서만 작동합니다. 기본값은 OptimizationDefault 입니다.

참고: 일부 환경에서는 모든 항목이 단일 그리기 호출을 사용하여 렌더링되고 그래픽 드라이버마다 호출당 최대 버텍스 수를 다르게 지원하기 때문에 정적 최적화를 사용하는 대형 그래프가 렌더링되지 않을 수 있습니다. 이는 주로 32비트 및 OpenGL ES2 플랫폼에서 발생하는 문제입니다. 이 문제를 해결하려면 버텍스 수가 적은 아이템 메쉬를 선택하거나 포인트 메쉬를 사용합니다.

이 속성은 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 신호가 전송될 때까지 유효합니다.

이 신호는 예를 들어 축 처리 예제에서 설명한 것처럼 사용자 정의 입력 처리를 구현하는 데 사용할 수 있습니다.

이 프로퍼티는 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 을 추가합니다. 그래프가 추가된 항목의 소유권을 갖습니다.

추가에 성공하면 추가된 항목의 인덱스를, 널 항목을 추가하려고 하면 -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 를참조하십시오 .


© 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.