QtGraphs3D Namespace

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

Header:	`#include <QtGraphs3D>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake:	`QT += graphs`

QtGraphs3D는 Qt Graphs 3D용 C++ 클래스의 일부입니다.

유형

enum class	CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
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 }

함수

(until 6.9) QSurfaceFormat qDefaultSurfaceFormat(bool antialias)

상세 설명

유형 문서

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도입니다. 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 역할을 합니다.

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

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

Constant	값	설명
`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 항목 동작을 제공합니다.

열거형 클래스 QtGraphs3D::SelectionFlag
플래그 QtGraphs3D::SelectionFlags

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

Constant	값	설명
`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 값의 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`	그림자는 가장자리가 부드럽게 처리된 고품질로 렌더링됩니다.

기능 문서

`[until 6.9]` QSurfaceFormat qDefaultSurfaceFormat(bool antialias)

이 기능은 버전 6.9에서 더 이상 사용되지 않을 예정입니다.

QQuick3D::idealSurfaceFormat() 사용

이 편의 함수는 Qt Graphs 그래프에 사용하기 적합한 사용자 정의 표면 형식을 만드는 데 사용할 수 있습니다.

antialias 매개변수는 앤티앨리어싱 활성화 여부를 지정합니다.

이 함수가 반환한 서페이스 형식을 그래프 생성자(C++)에 제공하거나 QQuickView (QML)의 창 형식으로 설정한 후 show() 을 호출하세요.

예를 들어, C++ 애플리케이션에서 앤티앨리어싱을 비활성화합니다:

#include <QtGraphs/qutils.h>

// ...

QSurfaceFormat::setDefaultFormat(qDefaultSurfaceFormat(true));

예를 들어, QML 애플리케이션에서 직접 렌더링 모드에 앤티앨리어싱을 활성화합니다:

#include <QtGraphs/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));

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