QtGraphs3D Namespace

QtGraphs3D 모듈은 QtGraphs 의 3D API에서 사용하는 열거형을 제공합니다. 더 보기...

헤더:	`#include <qgraphs3dnamespace.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake:	`QT += graphs`

사용 중단된 멤버
QtGraphs3D는 3D용Qt Graphs C++ 클래스의 일부입니다.

유형

enum class	CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
`(since 6.12)` enum class	DragMode { Rotate, Pan }
enum class	ElementType { None, Series, AxisXLabel, AxisYLabel, AxisZLabel, CustomItem }
enum class	GridLineType { Shader, Geometry }
enum class	OptimizationHint { Default, Legacy }
enum class	RenderingMode { DirectToBackground, Indirect }
enum class	SelectionFlag { None, Item, Row, ItemAndRow, Column, …, MultiSeries }
flags	SelectionFlags
enum class	ShadowQuality { None, Low, Medium, High, SoftLow, …, SoftHigh }
`(since 6.10)` enum class	SliceCaptureType { NoImage, RowImage, ColumnImage }
`(since 6.9)` enum class	TransparencyTechnique { Default, Approximate, Accurate }

상세 설명

타입 문서

enum class QtGraphs3D::CameraPreset

카메라용 사전 정의된 위치.

상수	값	설명
`QtGraphs3D::CameraPreset::NoPreset`	`0`	프리셋이 설정되지 않았거나 씬이 자유롭게 회전되었음을 나타내는 데 사용됩니다.
`QtGraphs3D::CameraPreset::FrontLow`	`1`	카메라의 x 및 y 회전 각도가 모두 0입니다.
`QtGraphs3D::CameraPreset::Front`	`2`	X 회전은 0이고 y 회전은 22.5도입니다.
`QtGraphs3D::CameraPreset::FrontHigh`	`3`	X 회전은 0이고 Y 회전은 45도입니다.
`QtGraphs3D::CameraPreset::LeftLow`	`4`	X 회전은 90도이고 Y 회전은 0도입니다.
`QtGraphs3D::CameraPreset::Left`	`5`	X 회전은 90도이고 Y 회전은 22.5도입니다.
`QtGraphs3D::CameraPreset::LeftHigh`	`6`	X 회전은 90도이고 Y 회전은 45도입니다.
`QtGraphs3D::CameraPreset::RightLow`	`7`	X 회전 각도는 -90도이고 Y 회전 각도는 0도입니다.
`QtGraphs3D::CameraPreset::Right`	`8`	X 회전 각도는 -90도이고 Y 회전 각도는 22.5도입니다.
`QtGraphs3D::CameraPreset::RightHigh`	`9`	X 회전 각도는 -90도이고 Y 회전 각도는 45도입니다.
`QtGraphs3D::CameraPreset::BehindLow`	`10`	X 회전 각도는 180도이고 Y 회전 각도는 0도입니다.
`QtGraphs3D::CameraPreset::Behind`	`11`	X 회전 각도는 180도이고, Y 회전 각도는 22.5도입니다.
`QtGraphs3D::CameraPreset::BehindHigh`	`12`	X 회전 각도는 180도이고 Y 회전 각도는 45도입니다.
`QtGraphs3D::CameraPreset::IsometricLeft`	`13`	X 회전 각도는 45도이고, Y 회전 각도는 22.5도입니다.
`QtGraphs3D::CameraPreset::IsometricLeftHigh`	`14`	X 회전 각도는 45도이고 Y 회전 각도는 45도입니다.
`QtGraphs3D::CameraPreset::IsometricRight`	`15`	X 회전 각도는 -45도이고 Y 회전 각도는 22.5도입니다.
`QtGraphs3D::CameraPreset::IsometricRightHigh`	`16`	X 회전 각도는 -45도이고 Y 회전 각도는 45도입니다.
`QtGraphs3D::CameraPreset::DirectlyAbove`	`17`	X 회전 각도는 0도이고 Y 회전 각도는 90도입니다.
`QtGraphs3D::CameraPreset::DirectlyAboveCW45`	`18`	X 축 회전은 -45도이고 Y 축 회전은 90도입니다.
`QtGraphs3D::CameraPreset::DirectlyAboveCCW45`	`19`	X 회전 각도는 45도이고 Y 회전 각도는 90도입니다.
`QtGraphs3D::CameraPreset::FrontBelow`	`20`	X 회전 각도는 0도이고, Y 회전 각도는 -45도입니다. FrontBelow 버전의 Q3DBarsWidgetItem 부터 이 설정은 음수 값이 포함된 그래프에서만 작동합니다. 양수 값만 포함된 경우 CameraPreset...Low와 동일하게 작동합니다.
`QtGraphs3D::CameraPreset::LeftBelow`	`21`	X 회전 각도는 90도이고 y 회전 각도는 -45도입니다.
`QtGraphs3D::CameraPreset::RightBelow`	`22`	X 회전 각도는 -90도이고 y 회전 각도는 -45도입니다.
`QtGraphs3D::CameraPreset::BehindBelow`	`23`	X 회전 각도는 180도이고 y 회전 각도는 -45도입니다.
`QtGraphs3D::CameraPreset::DirectlyBelow`	`24`	X 회전 각도는 0도이고 y 회전 각도는 -90도입니다. 양수 값만 포함된 막대의 경우 FrontLow와 동일하게 작동합니다.

`[since 6.12]` enum class QtGraphs3D::DragMode

그래프에서 발생하는 마우스 또는 터치 드래그 이벤트가 어떻게 해석될지 결정합니다.

상수	값	설명
`QtGraphs3D::DragMode::Rotate`	`0`	드래그하면 그래프가 회전합니다.
`QtGraphs3D::DragMode::Pan`	`1`	드래그 시 그래프가 이동합니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

enum class QtGraphs3D::ElementType

그래프 내 요소의 유형.

상수	값	설명
`QtGraphs3D::ElementType::None`	`0`	정의된 요소 없음.
`QtGraphs3D::ElementType::Series`	`1`	시리즈의 항목.
`QtGraphs3D::ElementType::AxisXLabel`	`2`	x축 레이블.
`QtGraphs3D::ElementType::AxisYLabel`	`3`	y축 레이블.
`QtGraphs3D::ElementType::AxisZLabel`	`4`	z축 레이블.
`QtGraphs3D::ElementType::CustomItem`	`5`	사용자 정의 항목.

enum class QtGraphs3D::GridLineType

상수	값	설명
`QtGraphs3D::GridLineType::Shader`	`0`	격자선은 셰이더 내에서 GPU를 사용하여 렌더링됩니다.
`QtGraphs3D::GridLineType::Geometry`	`1`	격자선은 3D 모델과 함께 렌더링됩니다.

enum class QtGraphs3D::OptimizationHint

렌더링에 대한 최적화 힌트.

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

enum class QtGraphs3D::RenderingMode

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

enum class QtGraphs3D::SelectionFlag
flags QtGraphs3D::SelectionFlags

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

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

SelectionFlags 유형은 QFlags<SelectionFlag>에 대한 typedef입니다. 이 유형은 SelectionFlag 값들의 OR 조합을 저장합니다.

enum class QtGraphs3D::ShadowQuality

그림자의 품질.

상수	값	설명
`QtGraphs3D::ShadowQuality::None`	`0`	그림자가 비활성화됩니다.
`QtGraphs3D::ShadowQuality::Low`	`1`	그림자가 낮은 품질로 렌더링됩니다.
`QtGraphs3D::ShadowQuality::Medium`	`2`	그림자가 중간 품질로 렌더링됩니다.
`QtGraphs3D::ShadowQuality::High`	`3`	그림자가 고화질로 렌더링됩니다.
`QtGraphs3D::ShadowQuality::SoftLow`	`4`	그림자가 낮은 품질로 렌더링되며 가장자리가 부드럽게 처리됩니다.
`QtGraphs3D::ShadowQuality::SoftMedium`	`5`	그림자가 가장자리가 부드럽게 처리된 중간 품질로 렌더링됩니다.
`QtGraphs3D::ShadowQuality::SoftHigh`	`6`	그림자가 가장 높은 품질로 렌더링되며 가장자리가 부드럽게 처리됩니다.

`[since 6.10]` enum class QtGraphs3D::SliceCaptureType

이미지에서 가져올 슬라이스의 유형.

상수	값	설명
`QtGraphs3D::SliceCaptureType::NoImage`	`0`	캡처할 슬라이스 유형이 정의되지 않았습니다.
`QtGraphs3D::SliceCaptureType::RowImage`	`1`	행에 대한 슬라이스를 캡처합니다.
`QtGraphs3D::SliceCaptureType::ColumnImage`	`2`	열에 대한 캡처 슬라이스.

이 열거형은 Qt 6.10에서 도입되었습니다.

`[since 6.9]` enum class QtGraphs3D::TransparencyTechnique

사용할 투명도 기법을 지정합니다. 기본값은 ` Default`입니다. 투명한 표면 그래프를 렌더링할 때는 ` Approximate ` 또는 ` Accurate`을 사용하십시오. 다른 그래프 유형의 경우 ` Default `을 사용해야 합니다.

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

이 열거형은 Qt 6.9에서 도입되었습니다.

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