Graphs3D QML Type

Graphs3D 네임스페이스 열거형. 더 보기...

Import Statement: import QtGraphs

상속된 멤버를 포함한 모든 멤버 목록
Graphs3D는 3D용Qt Graphs QML 타입의 일부입니다.

상세 설명

Graphs3D 네임스페이스는 QtGraphs 의 3D API에서 사용하는 다음과 같은 열거형을 제공합니다.

Graphs3D.SelectionFlag

항목 선택 모드입니다. 이 열거형의 값은 OR 연산자와 결합할 수 있습니다.

상수	설명
`None`	선택 모드가 비활성화되었습니다.
`Item`	선택 시 단일 항목이 강조 표시됩니다.
`Row`	선택 시 단일 행이 강조 표시됩니다.
`ItemAndRow`	항목과 행을 서로 다른 색상으로 강조 표시하기 위한 조합 플래그입니다.
`Column`	선택 시 단일 열을 강조 표시합니다.
`ItemAndColumn`	항목과 열을 서로 다른 색상으로 강조 표시하기 위한 조합 플래그입니다.
`RowAndColumn`	행과 열을 모두 강조 표시하기 위한 조합 플래그입니다.
`ItemRowAndColumn`	항목, 행 및 열을 모두 강조 표시하기 위한 조합 플래그입니다.
`Slice`	이 모드 플래그를 설정하면 그래프가 슬라이스 뷰 처리를 자동으로 수행해야 함을 나타냅니다. Q3DScene 를 통해 슬라이스 보기를 직접 제어하려면 이 플래그를 설정하지 마십시오. 이 모드 플래그를 설정할 때는 `Row` 또는 `Column` 중 하나만 설정해야 하며, 둘 다 설정해서는 안 됩니다. 슬라이싱은 Bars3D 및 Surface3D 에서만 지원됩니다. 이 플래그가 설정되면 다음과 같은 상황에서 슬라이스 모드로 전환됩니다: 시리즈 API를 통해 선택 범위가 명시적으로 표시된 항목으로 변경될 때 그래프를 클릭하여 선택 항목이 변경될 때 선택 모드가 변경되고 선택된 항목이 표시될 때
`MultiSeries`	이 모드를 설정하면 선택된 항목뿐만 아니라 동일한 위치에 있는 모든 시리즈의 항목이 강조 표시됩니다. 다른 시리즈의 실제 선택 상태는 변경되지 않습니다. 이 모드 플래그를 설정할 때는 기본 선택 플래그 중 하나 이상(`Item`, `Row` 또는 `Column`)도 함께 설정해야 합니다. Scatter3D 에서는 다중 시리즈 선택이 지원되지 않습니다.

Graphs3D.ShadowQuality

그림자의 품질 및 부드러움.

상수	설명
`None`	그림자가 비활성화됩니다.
`Low`	그림자가 낮은 품질로 렌더링됩니다.
`Medium`	그림자가 중간 품질로 렌더링됩니다.
`High`	그림자가 고화질로 렌더링됩니다.
`SoftLow`	그림자가 낮은 품질로 렌더링되며 가장자리가 부드럽게 처리됩니다.
`SoftMedium`	그림자가 가장자리가 부드럽게 처리된 중간 품질로 렌더링됩니다.
`SoftHigh`	그림자가 가장자리가 부드럽게 처리된 고화질로 렌더링됩니다.

Graphs3D.ElementType

그래프 내 요소의 유형입니다.

상수	설명
`None`	정의된 요소가 없습니다.
`Series`	시리즈의 항목.
`AxisXLabel`	x축 레이블.
`AxisYLabel`	y축 레이블.
`AxisZLabel`	z축 레이블.
`CustomItem`	사용자 정의 항목.

Graphs3D.OptimizationHint

렌더링을 위한 최적화 힌트.

상수	설명
`Default`	인스턴싱 기능을 포함한 전체 기능 세트를 우수한 성능으로 제공합니다.
`Legacy`	합리적인 성능으로 전체 기능 세트를 제공합니다. OptimizationHint.Default의 성능이 저조하거나 작동하지 않는 경우에 사용합니다.

Graphs3D.CameraPreset

카메라의 미리 정의된 위치입니다.

상수	설명
`NoPreset`	프리셋이 설정되지 않았거나 씬이 자유롭게 회전되었음을 나타내는 데 사용됩니다.
`FrontLow`	카메라의 x 및 y 회전 각도가 모두 0입니다.
`Front`	X 회전은 0이고 y 회전은 22.5도입니다.
`FrontHigh`	X 회전은 0이고 Y 회전은 45도입니다.
`LeftLow`	X 회전은 90도이고 Y 회전은 0도입니다.
`Left`	X 회전은 90도이고 Y 회전은 22.5도입니다.
`LeftHigh`	X 회전은 90도이고 Y 회전은 45도입니다.
`RightLow`	X 회전 각도는 -90도이고 Y 회전 각도는 0도입니다.
`Right`	X 회전 각도는 -90도이고, Y 회전 각도는 22.5도입니다.
`RightHigh`	X 회전 각도는 -90도이고 Y 회전 각도는 45도입니다.
`BehindLow`	X 회전 각도는 180도이고 Y 회전 각도는 0도입니다.
`Behind`	X 회전 각도는 180도이고 Y 회전 각도는 22.5도입니다.
`BehindHigh`	X 회전 각도는 180도이고 Y 회전 각도는 45도입니다.
`IsometricLeft`	X 회전 각도는 45도이고 Y 회전 각도는 22.5도입니다.
`IsometricLeftHigh`	X 회전 각도는 45도이고 Y 회전 각도는 45도입니다.
`IsometricRight`	X 회전 각도는 -45도이고 Y 회전 각도는 22.5도입니다.
`IsometricRightHigh`	X 회전 각도는 -45도이고 Y 회전 각도는 45도입니다.
`DirectlyAbove`	X 회전 각도는 0도이고 Y 회전 각도는 90도입니다.
`DirectlyAboveCW45`	X 회전 각도는 -45도이고 Y 회전 각도는 90도입니다.
`DirectlyAboveCCW45`	X 회전 각도는 45도이고 Y 회전 각도는 90도입니다.
`FrontBelow`	X 회전 각도는 0도이고 Y 회전 각도는 -45도입니다. FrontBelow부터의 ‘ Bars3D ’에서는 이 설정들이 음수 값을 포함하는 그래프에서만 작동합니다. 양수 값만 포함된 경우에는 CameraPreset...Low와 동일하게 작동합니다.
`LeftBelow`	X 회전 각도는 90도이고 y 회전 각도는 -45도입니다.
`RightBelow`	X 회전 각도는 -90도이고 y 회전 각도는 -45도입니다.
`BehindBelow`	X 회전 각도는 180도이고 Y 회전 각도는 -45도입니다.
`DirectlyBelow`	X 회전 각도는 0도이고 y 회전 각도는 -90도입니다. 양수 값만 포함된 막대 그래프에서는 FrontLow와 동일하게 작동합니다.

Graphs3D.GridLineType

상수	설명
`Shader`	격자선은 셰이더에서 GPU를 사용하여 렌더링됩니다.
`Geometry`	격자선은 3D 모델로 렌더링됩니다.

Graphs3D.RenderingMode

상수 설명

DirectToBackground 그래프가 창 배경에 직접 렌더링되고, QML 항목이 그 위에 렌더링됨을 나타냅니다. 불투명한 QML 항목을 배경으로 사용하면 그래프가 숨겨집니다. 그래프를 렌더링하기 전에 그래프 외부의 영역을 포함하여 창 전체를 지웁니다. 창의 표면 형식이 앤티앨리어싱을 지원하는 경우, 이를 사용합니다( QQuick3D::idealSurfaceFormat() 참조). 이 렌더링 모드는 비표준 QML 동작을 감수하는 대신 최고의 성능을 제공합니다. 예를 들어, 그래프는 QML 항목의 z 순서를 따르지 않으며, 불투명도 값이 그래프에 영향을 미치지 않습니다.

Indirect 그래프가 먼저 오프스크린 서피스에 렌더링된 후, 일반적인 QML 항목 렌더링 과정에서 그려짐을 나타냅니다. 렌더링된 이미지는 현재 환경에서 멀티샘플링 방식이 지원되고 msaaSamples 속성 값이 0보다 큰 경우, 멀티샘플링 방식을 사용하여 앤티앨리어싱 처리됩니다. 이 렌더링 모드는 성능을 희생하는 대신 우수한 품질과 일반적인 QML 항목 동작을 제공합니다.

상수	설명
`DirectToBackground`	그래프가 창 배경에 직접 렌더링되고, QML 항목이 그 위에 렌더링됨을 나타냅니다. 불투명한 QML 항목을 배경으로 사용하면 그래프가 숨겨집니다. 그래프를 렌더링하기 전에 그래프 외부의 영역을 포함하여 창 전체를 지웁니다. 창의 표면 형식이 앤티앨리어싱을 지원하는 경우, 이를 사용합니다( QQuick3D::idealSurfaceFormat() 참조). 이 렌더링 모드는 비표준 QML 동작을 감수하는 대신 최고의 성능을 제공합니다. 예를 들어, 그래프는 QML 항목의 z 순서를 따르지 않으며, 불투명도 값이 그래프에 영향을 미치지 않습니다.
`Indirect`	그래프가 먼저 오프스크린 서피스에 렌더링된 후, 일반적인 QML 항목 렌더링 과정에서 그려짐을 나타냅니다. 렌더링된 이미지는 현재 환경에서 멀티샘플링 방식이 지원되고 msaaSamples 속성 값이 0보다 큰 경우, 멀티샘플링 방식을 사용하여 앤티앨리어싱 처리됩니다. 이 렌더링 모드는 성능을 희생하는 대신 우수한 품질과 일반적인 QML 항목 동작을 제공합니다.

Graphs3D.TransparencyTechnique

상수	설명
`Default`	순서 독립적 투명도 기법이 사용되지 않음을 나타냅니다. 최고의 성능을 제공합니다. 그래프에 투명도가 포함되지 않거나, 막대 그래프나 산점도 그래프가 인스턴싱(instancing)을 함께 사용하는 경우(즉, optimizationHint가 {QtGraphs3D::OptimizationHint::Default}인 경우)에 사용합니다.
`Approximate`	그래프가 순서 독립적 투명도를 근사적으로 구현하려고 시도함을 나타냅니다. 이 방법은 ` `Accurate` `보다 빠르며 구형 하드웨어에서도 작동하지만, 결과가 부정확할 수 있습니다. 순서 독립적 투명도가 필요하지만, 정확한 순서 독립적 투명도를 사용할 때보다 성능 저하가 적어야 할 때 사용합니다.
`Accurate`	정확한 순서 독립적 투명도가 사용됨을 나타냅니다. 완벽한 투명도 렌더링이 필요한 경우에 사용하십시오.

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