QAbstract3DGraph Class
QAbstract3DGraph 클래스는 그래프를 위한 창과 렌더링 루프를 제공합니다. 더 보기...
| 헤더: | #include <QAbstract3DGraph> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| 출시일: | QtDataVisualization 1.0 |
| 상속: | QWindow QOpenGLFunctions (보호된) |
| 상속하는 클래스: | |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 타입
(since QtDataVisualization 1.1) enum | ElementType { ElementNone, ElementSeries, ElementAxisXLabel, ElementAxisYLabel, ElementAxisZLabel, ElementCustomItem } |
(since Qt Data Visualization 1.1) enum | OptimizationHint { OptimizationDefault, OptimizationStatic } |
| flags | OptimizationHints |
| enum | SelectionFlag { SelectionNone, SelectionItem, SelectionRow, SelectionItemAndRow, SelectionColumn, …, SelectionMultiSeries } |
| flags | SelectionFlags |
| enum | ShadowQuality { ShadowQualityNone, ShadowQualityLow, ShadowQualityMedium, ShadowQualityHigh, ShadowQualitySoftLow, …, ShadowQualitySoftHigh } |
속성
|
|
공개 함수
| virtual | ~QAbstract3DGraph() |
| QAbstract3DInputHandler * | activeInputHandler() const |
| Q3DTheme * | activeTheme() const |
(since QtDataVisualization 1.1) int | addCustomItem(QCustom3DItem *item) |
| void | addInputHandler(QAbstract3DInputHandler *inputHandler) |
| void | addTheme(Q3DTheme *theme) |
| qreal | aspectRatio() const |
| void | clearSelection() |
| qreal | currentFps() const |
(since QtDataVisualization 1.2) QList<QCustom3DItem *> | customItems() const |
| bool | hasContext() const |
(since 6.3) bool | hasSeries(QAbstract3DSeries *series) const |
| qreal | horizontalAspectRatio() const |
| QList<QAbstract3DInputHandler *> | inputHandlers() const |
| bool | isOrthoProjection() const |
| bool | isPolar() const |
| bool | isReflection() const |
| QLocale | locale() const |
| qreal | margin() const |
| bool | measureFps() const |
| QAbstract3DGraph::OptimizationHints | optimizationHints() const |
| QVector3D | queriedGraphPosition() const |
| float | radialLabelOffset() const |
| qreal | reflectivity() const |
(since QtDataVisualization 1.1) void | releaseCustomItem(QCustom3DItem *item) |
| void | releaseInputHandler(QAbstract3DInputHandler *inputHandler) |
| void | releaseTheme(Q3DTheme *theme) |
(since QtDataVisualization 1.1) void | removeCustomItem(QCustom3DItem *item) |
(since QtDataVisualization 1.1) void | removeCustomItemAt(const QVector3D &position) |
(since QtDataVisualization 1.1) void | removeCustomItems() |
(since QtDataVisualization 1.1) QImage | renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize()) |
| Q3DScene * | scene() const |
(since QtDataVisualization 1.1) QAbstract3DAxis * | selectedAxis() const |
(since QtDataVisualization 1.1) QCustom3DItem * | selectedCustomItem() const |
(since QtDataVisualization 1.1) int | selectedCustomItemIndex() const |
| QAbstract3DGraph::ElementType | selectedElement() const |
(since QtDataVisualization 1.1) int | selectedLabelIndex() const |
| QAbstract3DGraph::SelectionFlags | selectionMode() const |
| void | setActiveInputHandler(QAbstract3DInputHandler *inputHandler) |
| void | setActiveTheme(Q3DTheme *theme) |
| void | setAspectRatio(qreal ratio) |
| void | setHorizontalAspectRatio(qreal ratio) |
| void | setLocale(const QLocale &locale) |
| void | setMargin(qreal margin) |
| void | setMeasureFps(bool enable) |
| void | setOptimizationHints(QAbstract3DGraph::OptimizationHints hints) |
| void | setOrthoProjection(bool enable) |
| void | setPolar(bool enable) |
| void | setRadialLabelOffset(float offset) |
| void | setReflection(bool enable) |
| void | setReflectivity(qreal reflectivity) |
| void | setSelectionMode(QAbstract3DGraph::SelectionFlags mode) |
| void | setShadowQuality(QAbstract3DGraph::ShadowQuality quality) |
| QAbstract3DGraph::ShadowQuality | shadowQuality() const |
| virtual bool | shadowsSupported() const |
| QList<Q3DTheme *> | themes() const |
신호
| void | activeInputHandlerChanged(QAbstract3DInputHandler *inputHandler) |
| void | activeThemeChanged(Q3DTheme *theme) |
| void | aspectRatioChanged(qreal ratio) |
| void | currentFpsChanged(qreal fps) |
| void | horizontalAspectRatioChanged(qreal ratio) |
| void | localeChanged(const QLocale &locale) |
| void | marginChanged(qreal margin) |
| void | measureFpsChanged(bool enabled) |
| void | optimizationHintsChanged(QAbstract3DGraph::OptimizationHints hints) |
| void | orthoProjectionChanged(bool enabled) |
| void | polarChanged(bool enabled) |
| void | queriedGraphPositionChanged(const QVector3D &data) |
| void | radialLabelOffsetChanged(float offset) |
| void | reflectionChanged(bool enabled) |
| void | reflectivityChanged(qreal reflectivity) |
| void | selectedElementChanged(QAbstract3DGraph::ElementType type) |
| void | selectionModeChanged(QAbstract3DGraph::SelectionFlags mode) |
| void | shadowQualityChanged(QAbstract3DGraph::ShadowQuality quality) |
관련 비회원
| QSurfaceFormat | qDefaultSurfaceFormat(bool antialias) |
상세 설명
이 클래스는 ` QWindow `의 서브클래스이며, 이를 상속하는 그래프에 대한 렌더 루프를 제공합니다.
이 클래스를 직접 사용할 필요는 없으며, 대신 이 클래스의 하위 클래스 중 하나를 사용해야 합니다.
OpenGL ES2 환경에서 Qt Data Visualization 가 앤티앨리어싱을 지원하지 않는 경우를 제외하고, C++에서는 기본적으로 앤티앨리어싱이 켜져 있습니다. 그래프에 기본값이 아닌 앤티앨리어싱을 지정하려면 생성자 매개변수로 사용자 정의 서피스 포맷을 전달하십시오. 서피스 포맷 객체를 생성하려면 편의 함수 ` qDefaultSurfaceFormat() `를 사용할 수 있습니다.
참고: QAbstract3DGraph는 기본적으로 Qt::FramelessWindowHint 윈도우 플래그를 활성화합니다. 그래프 윈도우를 일반적인 윈도우 프레임이 있는 독립형 윈도우로 표시하려면, 그래프를 생성한 후 이 플래그를 해제하십시오. 예:
관련 항목: Q3DBars, Q3DScatter, Q3DSurface 및 Qt Data Visualization C++ Classes.
멤버 유형 설명서
[since QtDataVisualization 1.1] enum QAbstract3DGraph::ElementType
그래프 내 요소의 유형.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstract3DGraph::ElementNone | 0 | 정의된 요소가 없습니다. |
QAbstract3DGraph::ElementSeries | 1 | 시리즈(즉, 시리즈의 항목). |
QAbstract3DGraph::ElementAxisXLabel | 2 | x축 레이블. |
QAbstract3DGraph::ElementAxisYLabel | 3 | y축 레이블. |
QAbstract3DGraph::ElementAxisZLabel | 4 | z축 레이블. |
QAbstract3DGraph::ElementCustomItem | 5 | 사용자 정의 항목. |
이 열거형은 QtDataVisualization 1.1에서 도입되었습니다.
[since Qt Data Visualization 1.1] enum QAbstract3DGraph::OptimizationHint
flags QAbstract3DGraph::OptimizationHints
렌더링에 대한 최적화 힌트.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstract3DGraph::OptimizationDefault | 0 | 합리적인 성능으로 전체 기능 세트를 제공합니다. |
QAbstract3DGraph::OptimizationStatic | 1 | 일부 기능을 희생하여 정적 데이터 세트의 렌더링을 최적화합니다. |
이 열거형은 Qt Data Visualization 1.1에서 도입되었습니다.
OptimizationHints 유형은 QFlags<OptimizationHint>에 대한 typedef입니다. 이 유형은 OptimizationHint 값들의 OR 조합을 저장합니다.
enum QAbstract3DGraph::SelectionFlag
flags QAbstract3DGraph::SelectionFlags
항목 선택 모드. 이 열거형의 값들은 OR 연산자와 결합할 수 있습니다.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstract3DGraph::SelectionNone | 0 | 선택 모드가 비활성화되었습니다. |
QAbstract3DGraph::SelectionItem | 1 | 선택 시 단일 항목이 강조 표시됩니다. |
QAbstract3DGraph::SelectionRow | 2 | 선택 시 단일 행이 강조 표시됩니다. |
QAbstract3DGraph::SelectionItemAndRow | SelectionItem | SelectionRow | 항목과 행을 서로 다른 색상으로 강조 표시하기 위한 조합 플래그입니다. |
QAbstract3DGraph::SelectionColumn | 4 | 선택 시 단일 열이 강조 표시됩니다. |
QAbstract3DGraph::SelectionItemAndColumn | SelectionItem | SelectionColumn | 항목과 열을 서로 다른 색상으로 강조 표시하기 위한 조합 플래그입니다. |
QAbstract3DGraph::SelectionRowAndColumn | SelectionRow | SelectionColumn | 행과 열을 모두 강조 표시하기 위한 조합 플래그입니다. |
QAbstract3DGraph::SelectionItemRowAndColumn | SelectionItem | SelectionRow | SelectionColumn | 항목, 행 및 열을 모두 강조 표시하기 위한 조합 플래그입니다. |
QAbstract3DGraph::SelectionSlice | 8 | 이 모드 플래그를 설정하면 그래프가 슬라이스 뷰 처리를 자동으로 수행해야 함을 나타냅니다. Q3DScene을 통해 슬라이스 뷰를 직접 제어하려는 경우, 이 플래그를 설정하지 마십시오. 이 모드 플래그를 설정할 때는 SelectionRow 또는 SelectionColumn 중 하나만 설정해야 하며, 두 개를 모두 설정해서는 안 됩니다. 슬라이싱은 Q3DBars 및 Q3DSurface에서만 지원됩니다. 이 플래그가 설정되면 다음과 같은 상황에서 슬라이스 모드로 진입합니다:
|
QAbstract3DGraph::SelectionMultiSeries | 16 | 이 모드를 설정하면 선택된 항목뿐만 아니라 동일한 위치에 있는 모든 시리즈의 항목이 강조 표시됩니다. 다른 시리즈의 실제 선택 상태는 변경되지 않습니다. 이 모드 플래그를 설정할 때는 기본 선택 플래그 중 하나 이상(SelectionItem, SelectionRow 또는 SelectionColumn)도 함께 설정해야 합니다. Q3DScatter에서는 다중 시리즈 선택이 지원되지 않습니다. |
SelectionFlags 유형은 QFlags<SelectionFlag>에 대한 typedef입니다. 이 유형은 SelectionFlag 값들의 OR 조합을 저장합니다.
enum QAbstract3DGraph::ShadowQuality
그림자의 품질.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstract3DGraph::ShadowQualityNone | 0 | 그림자가 비활성화됩니다. |
QAbstract3DGraph::ShadowQualityLow | 1 | 그림자가 낮은 품질로 렌더링됩니다. |
QAbstract3DGraph::ShadowQualityMedium | 2 | 그림자가 중간 품질로 렌더링됩니다. |
QAbstract3DGraph::ShadowQualityHigh | 3 | 그림자가 고화질로 렌더링됩니다. |
QAbstract3DGraph::ShadowQualitySoftLow | 4 | 그림자가 낮은 품질로 렌더링되며 가장자리가 부드럽게 처리됩니다. |
QAbstract3DGraph::ShadowQualitySoftMedium | 5 | 그림자가 가장자리가 부드럽게 처리된 중간 품질로 렌더링됩니다. |
QAbstract3DGraph::ShadowQualitySoftHigh | 6 | 그림자가 가장 높은 품질로 렌더링되며 가장자리가 부드럽게 처리됩니다. |
속성 설명서
activeInputHandler : QAbstract3DInputHandler*
이 속성은 그래프에서 사용되는 활성 입력 핸들러를 보관합니다.
액세스 함수:
| QAbstract3DInputHandler * | activeInputHandler() const |
| void | setActiveInputHandler(QAbstract3DInputHandler *inputHandler) |
알림 신호:
| void | activeInputHandlerChanged(QAbstract3DInputHandler *inputHandler) |
activeTheme : Q3DTheme*
이 속성은 그래프의 현재 테마를 저장합니다.
액세스 함수:
| Q3DTheme * | activeTheme() const |
| void | setActiveTheme(Q3DTheme *theme) |
알림 신호:
| void | activeThemeChanged(Q3DTheme *theme) |
[since QtDataVisualization 1.1] aspectRatio : qreal
이 속성은 수평면의 가장 긴 축과 y축 간의 그래프 확대/축소 비율을 나타냅니다.
기본값은 2.0 입니다.
참고: Q3DBars에는 영향을미치지 않습니다.
이 열거형은 QtDataVisualization 1.1에서 도입되었습니다.
액세스 함수:
| qreal | aspectRatio() const |
| void | setAspectRatio(qreal ratio) |
알림 신호:
| void | aspectRatioChanged(qreal ratio) |
horizontalAspectRatio도 참조하십시오 .
[read-only, since QtDataVisualization 1.1] currentFps : qreal
이 속성은 지난 1초 동안의 렌더링 결과를 저장합니다.
FPS 측정이 활성화되면 결과가 이 읽기 전용 속성에 저장됩니다. 측정이 활성화된 후 이 값이 업데이트되기까지는 최소 1초가 소요됩니다.
이 열거형은 QtDataVisualization 1.1에서 도입되었습니다.
액세스 함수:
| qreal | currentFps() const |
알림 신호:
| void | currentFpsChanged(qreal fps) |
measureFps도 참조하십시오 .
[since QtDataVisualization 1.2] horizontalAspectRatio : qreal
이 속성은 x축과 z축 간의 그래프 확대/축소 비율을 지정합니다.
0.0 의 값은 축 범위에 따라 자동으로 크기가 조정됨을 나타냅니다. 기본값은 0.0 입니다.
Q3DBars에는 영향을 미치지 않는데, Q3DBars는 barThickness 및 barSpacing 속성을 통해 수평축의 크기 조정을 처리하기 때문입니다. 극좌표 그래프도 이 속성을 무시합니다.
이 열거형은 QtDataVisualization 1.2에서 도입되었습니다.
액세스 함수:
| qreal | horizontalAspectRatio() const |
| void | setHorizontalAspectRatio(qreal ratio) |
알림 신호:
| void | horizontalAspectRatioChanged(qreal ratio) |
aspectRatio, polar, Q3DBars::barThickness 및 Q3DBars::barSpacing도 참조하십시오 .
[since QtDataVisualization 1.2] locale : QLocale
이 속성은 다양한 숫자 레이블의 서식에 사용되는 로케일을 저장합니다.
기본값은 ' "C" ' 로케일입니다.
이 열거형은 QtDataVisualization 1.2에서 도입되었습니다.
액세스 함수:
| QLocale | locale() const |
| void | setLocale(const QLocale &locale) |
알림 신호:
| void | localeChanged(const QLocale &locale) |
QValue3DAxis::labelFormat도 참조하십시오 .
[since QtDataVisualization 1.2] margin : qreal
이 속성은 그래프 그리기 가능 영역의 가장자리와 그래프 배경의 가장자리 사이에 남겨질 여백의 절대값을 지정합니다.
여백 값이 음수인 경우, 여백은 자동으로 결정되며 시리즈 내 항목의 크기와 그래프 유형에 따라 달라질 수 있습니다. 그래프 종횡비가 기본값에서 변경되지 않은 경우, 이 값은 y축 범위의 비율로 해석됩니다. 기본값은 -1.0 입니다.
참고: 산점도 그래프의 여백을 자동으로 결정된 여백보다 작게설정하면 , 그래프 가장자리에 위치한 산점도 항목이 그래프 배경과 겹칠 수 있습니다.
참고: 산점도 및 표면그래프에서 , 여백이 축 레이블 크기에 비해 작을 경우, 인접한 축의 가장자리 레이블과의 중복을 피하기 위해 축의 가장자리 레이블 위치가 조정됩니다.
이 열거형은 QtDataVisualization 1.2에서 도입되었습니다.
액세스 함수:
| qreal | margin() const |
| void | setMargin(qreal margin) |
Notifier 신호:
| void | marginChanged(qreal margin) |
[since QtDataVisualization 1.1] measureFps : bool
이 속성은 렌더링이 필요에 따라 수행되는 것이 아니라 지속적으로 수행되는지 여부를 나타냅니다.
true 인 경우, 렌더링은 연속적으로 수행되며 currentFps 속성의 값이 업데이트됩니다. 기본값은 false 입니다.
이 열거형은 QtDataVisualization 1.1에서 도입되었습니다.
액세스 함수:
| bool | measureFps() const |
| void | setMeasureFps(bool enable) |
Notifier 신호:
| void | measureFpsChanged(bool enabled) |
currentFps도 참조하십시오 .
optimizationHints : OptimizationHints
이 속성은 렌더링 최적화를 위해 기본 모드 또는 정적 모드 중 어느 것이 사용되든 상관없이 적용됩니다.
기본 모드는 합리적인 수준의 성능을 유지하면서 모든 기능을 제공합니다. 정적 모드는 그래프 렌더링을 최적화하며, 변경되지 않는 대용량 데이터 세트에 이상적입니다. 데이터가 동적으로 변경되거나 항목이 회전할 경우 처리 속도가 느려집니다. 선택 기능은 최적화되지 않으므로, 대용량 데이터 세트에 정적 모드를 사용하는 것은 권장되지 않습니다. 정적 최적화는 산점도 그래프에서만 작동합니다. 기본값은 ` OptimizationDefault`입니다.
참고: 일부환경에서는 정적 최적화를 사용하는 대규모 그래프가 렌더링되지 않을 수 있습니다. 모든 항목이 단일 드로우 콜을 통해 렌더링되는데, 그래픽 드라이버마다 콜당 지원되는 최대 정점 수가 다르기 때문입니다. 이 문제는 주로 32비트 및 OpenGL ES2 플랫폼에서 발생합니다. 이 문제를 해결하려면 정점 수가 적은 아이템 메시를 선택하거나 포인트 메시를 사용하십시오.
액세스 함수:
| QAbstract3DGraph::OptimizationHints | optimizationHints() const |
| void | setOptimizationHints(QAbstract3DGraph::OptimizationHints hints) |
알림 신호:
| void | optimizationHintsChanged(QAbstract3DGraph::OptimizationHints hints) |
[since QtDataVisualization 1.1] orthoProjection : bool
이 속성은 그래프를 표시할 때 정투영을 사용할지 여부를 결정합니다.
기본값은 ' false'입니다.
참고: 이 속성을 true 로 설정하면그림자가 비활성화됩니다.
이 열거형은 QtDataVisualization 1.1에서 도입되었습니다.
액세스 함수:
| bool | isOrthoProjection() const |
| void | setOrthoProjection(bool enable) |
알림 신호:
| void | orthoProjectionChanged(bool enabled) |
QAbstract3DAxis::labelAutoRotation 및 Q3DCamera::cameraPreset도 참조하십시오 .
[since QtDataVisualization 1.2] polar : bool
이 속성은 가로축이 극좌표축으로 변경되더라도 유지됩니다.
true 인 경우, x축은 각도축이 되고 z축은 반경축이 됩니다. 막대 그래프에서는 극좌표 모드를 사용할 수 없습니다.
기본값은 ` false`입니다.
이 열거형은 QtDataVisualization 1.2에서 도입되었습니다.
액세스 함수:
| bool | isPolar() const |
| void | setPolar(bool enable) |
알림 신호:
| void | polarChanged(bool enabled) |
orthoProjection 및 radialLabelOffset도 참조하십시오 .
[read-only, since QtDataVisualization 1.2] queriedGraphPosition : QVector3D
이 속성은 각 축을 따라 쿼리된 최신 그래프 위치 값을 저장합니다.
이 읽기 전용 속성은 ` Q3DScene::graphPositionQuery`의 결과를 포함합니다. 값은 ` [-1, 1]` 범위로 정규화됩니다. 쿼리된 위치가 그래프 경계 외부인 경우, 값은 실제 위치를 반영하지 않고 대신 ` [-1, 1]` 범위 외부의 정의되지 않은 위치를 나타냅니다. 쿼리가 수행될 때까지 값은 정의되지 않은 상태로 유지됩니다.
특정 화면 위치에 대응하는 유일한 올바른 3D 좌표는 없으므로, 일관성을 유지하기 위해 쿼리는 항상 그래프를 둘러싼 보이지 않는 상자의 안쪽 면을 기준으로 수행됩니다.
참고: 막대 그래프의 경우 그래프 바닥 수준에서만 그래프 위치를 쿼리할 수 있으므로, 막대 그래프의 y값은 항상 0이며 유효한 쿼리는 그래프의 바닥이 포함된 화면 위치에서만 수행될 수 있습니다.
이 열거형은 QtDataVisualization 1.2에서 도입되었습니다.
액세스 함수:
| QVector3D | queriedGraphPosition() const |
알림 신호:
| void | queriedGraphPositionChanged(const QVector3D &data) |
Q3DScene::graphPositionQuery도 참조하십시오 .
[since QtDataVisualization 1.2] radialLabelOffset : float
이 속성은 방사형 극좌표축의 축 레이블에 대한 정규화된 수평 오프셋을 저장합니다.
0.0 값은 레이블이 0각도 각도축 격자선 옆에 그려져야 함을 나타냅니다. 1.0 값은 레이블이 그래프 배경의 가장자리라는 일반적인 위치에 그려져야 함을 나타냅니다. 기본값은 1.0 입니다.
polar 속성 값이 false 인 경우 이 속성은 무시됩니다.
이 열거형은 QtDataVisualization 1.2에서 도입되었습니다.
액세스 함수:
| float | radialLabelOffset() const |
| void | setRadialLabelOffset(float offset) |
알림 신호:
| void | radialLabelOffsetChanged(float offset) |
polar도 참조하십시오 .
[since QtDataVisualization 1.2] reflection : bool
이 속성은 바닥 반사 효과를 켜거나 끄는지를 결정합니다.
기본값은 ' false'입니다.
Q3DBars에만 적용됩니다. 그러나 양수 및 음수 값을 모두 포함하는 Q3DBars 그래프에서, 바닥 평면과 교차하는 사용자 정의 항목에 대해서는 반사가 지원되지 않습니다. 이 경우, 잘못된 렌더링을 방지하기 위해 반사 기능을 비활성화해야 합니다.
사용자 정의 표면 형식을 사용하는 경우, 반사가 작동하려면 스텐실 버퍼를 정의해야 합니다(QSurfaceFormat::setStencilBufferSize()).
이 열거형은 QtDataVisualization 1.2에서 도입되었습니다.
액세스 함수:
| bool | isReflection() const |
| void | setReflection(bool enable) |
알림 신호:
| void | reflectionChanged(bool enabled) |
reflectivity도 참조하십시오 .
[since QtDataVisualization 1.2] reflectivity : qreal
바닥 반사율.
숫자가 클수록 바닥의 반사율이 높아집니다. 유효 범위는 [0...1] 입니다. 기본값은 0.5 입니다.
참고: Q3DBars에만영향을 미칩니다 .
이 열거형은 QtDataVisualization 1.2에서 도입되었습니다.
액세스 함수:
| qreal | reflectivity() const |
| void | setReflectivity(qreal reflectivity) |
알림 신호:
| void | reflectivityChanged(qreal reflectivity) |
reflection도 참조하십시오 .
[read-only] scene : Q3DScene*
이 속성은 씬을 조작하고 활성 카메라와 같은 씬 요소에 접근하는 데 사용할 수 있는 Q3DScene 포인터를 포함합니다.
이 속성은 읽기 전용입니다.
액세스 함수:
| Q3DScene * | scene() const |
[read-only, since QtDataVisualization 1.1] selectedElement : ElementType
이 속성은 그래프에서 선택된 요소를 저장합니다.
이 속성을 사용하여 선택된 요소의 유형을 조회할 수 있습니다. 이 유형은 그래프에서 새로운 선택이 이루어지고 ' selectedElementChanged ' 신호가 발신될 때까지 유효합니다.
이 신호는 예를 들어, ‘ Scatter Graph ’ 탭의 Graph Gallery 예제에서 시연된 바와 같이 사용자 정의 입력 핸들러를 구현하는 데 사용할 수 있습니다.
이 열거형은 QtDataVisualization 1.1에서 도입되었습니다.
액세스 함수:
| QAbstract3DGraph::ElementType | selectedElement() const |
Notifier 신호:
| void | selectedElementChanged(QAbstract3DGraph::ElementType type) |
selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Q3DBars::selectedSeries(), Q3DScatter::selectedSeries(), Q3DSurface::selectedSeries(), Q3DScene::setSelectionQueryPosition()도 참조하십시오 .
selectionMode : SelectionFlags
항목 선택 모드.
SelectionFlags 의 조합입니다. 기본적으로 SelectionItem 입니다. 그래프 유형에 따라 지원하는 선택 모드가 다릅니다.
액세스 함수:
| QAbstract3DGraph::SelectionFlags | selectionMode() const |
| void | setSelectionMode(QAbstract3DGraph::SelectionFlags mode) |
알림 신호:
| void | selectionModeChanged(QAbstract3DGraph::SelectionFlags mode) |
SelectionFlags도 참조하십시오 .
shadowQuality : ShadowQuality
이 속성은 그림자의 품질을 나타냅니다.
ShadowQuality 열거형 값 중 하나입니다. 기본값은 ShadowQualityMedium 입니다.
참고: 그림자 품질을 특정 수준으로 설정하는데 실패하면 , 성공적으로 설정될 때까지 수준이 낮아집니다. 변경이 발생할 때마다 shadowQualityChanged 신호가 발생합니다.
액세스 함수:
| QAbstract3DGraph::ShadowQuality | shadowQuality() const |
| void | setShadowQuality(QAbstract3DGraph::ShadowQuality quality) |
알림 신호:
| void | shadowQualityChanged(QAbstract3DGraph::ShadowQuality quality) |
참조: ShadowQuality.
멤버 함수 문서
[virtual noexcept] QAbstract3DGraph::~QAbstract3DGraph()
QAbstract3DGraph 를 삭제합니다.
[since QtDataVisualization 1.1] int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)
그래프에 QCustom3DItem item 을 추가합니다. 그래프는 추가된 항목에 대한 소유권을 갖습니다.
추가 작업이 성공하면 추가된 항목의 인덱스를 반환하고, null 항목을 추가하려고 시도한 경우 -1을 반환하며, 이미 추가된 항목을 다시 추가하려고 시도한 경우 해당 항목의 인덱스를 반환합니다.
항목은 삽입된 순서대로 렌더링됩니다. 불투명 항목과 투명 항목이 혼재된 경우 렌더링 순서를 고려해야 합니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
removeCustomItems(), removeCustomItem(), removeCustomItemAt(), customItems()도 참조하십시오 .
void QAbstract3DGraph::addInputHandler(QAbstract3DInputHandler *inputHandler)
지정된 inputHandler 를 그래프에 추가합니다. addInputHandler를 통해 추가된 입력 핸들러는 직접 사용되지 않습니다. 그래프에는 inputHandler 의 소유권만 전달됩니다. inputHandler 는 null이거나 이미 다른 그래프에 추가되어서는 안 됩니다.
releaseInputHandler() 및 setActiveInputHandler()도 참조하십시오 .
void QAbstract3DGraph::addTheme(Q3DTheme *theme)
지정된 테마 객체( theme )를 그래프에 추가합니다. addTheme를 통해 추가된 테마는 직접 사용되지 않습니다. 그래프에는 해당 테마의 소유권만 부여됩니다. 테마 객체( theme )는 null이거나 이미 다른 그래프에 추가된 상태여서는 안 됩니다.
releaseTheme() 및 setActiveTheme()도 참조하십시오 .
void QAbstract3DGraph::clearSelection()
연결된 모든 시리즈에서 선택 항목을 지웁니다.
[since QtDataVisualization 1.2] QList<QCustom3DItem *> QAbstract3DGraph::customItems() const
추가된 모든 사용자 정의 항목의 목록을 반환합니다.
이 함수는 QtDataVisualization 1.2에서 도입되었습니다.
addCustomItem()도 참조하십시오 .
bool QAbstract3DGraph::hasContext() const
그래프의 OpenGL 컨텍스트가 성공적으로 초기화되면 ` true `를 반환합니다. 컨텍스트 초기화에 실패한 상태에서 그래프를 사용하려고 하면 대개 프로그램이 중단됩니다. 컨텍스트 초기화 실패의 일반적인 원인은 OpenGL에 대한 플랫폼 지원이 충분하지 않기 때문입니다.
[since 6.3] bool QAbstract3DGraph::hasSeries(QAbstract3DSeries *series) const
series 가 이미 그래프에 추가되었는지 여부를 반환합니다.
이 함수는 Qt 6.3에서 도입되었습니다.
QList<QAbstract3DInputHandler *> QAbstract3DGraph::inputHandlers() const
추가된 모든 입력 핸들러의 목록을 반환합니다.
addInputHandler()도 참조하십시오 .
[since QtDataVisualization 1.1] void QAbstract3DGraph::releaseCustomItem(QCustom3DItem *item)
지정된 ‘ item ’의 소유권을 되찾고, 그래프에서 ‘ item ’를 제거합니다.
참고: 동일한 항목을 그래프에 다시 추가할경우 , 텍스처 또는 텍스처 파일을 다시 설정해야 합니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
QCustom3DItem::setTextureImage() 및 QCustom3DItem::setTextureFile()도 참조하십시오 .
void QAbstract3DGraph::releaseInputHandler(QAbstract3DInputHandler *inputHandler)
inputHandler 가 이 그래프에 추가된 경우, 해당 객체의 소유권을 호출자에게 반환합니다. 반환된 inputHandler 가 사용 중인 경우, 이 호출 후에는 활성 상태인 입력 핸들러가 없게 됩니다.
기본 입력 핸들러가 해제되었다가 나중에 다시 추가되면, 다른 입력 핸들러와 동일하게 동작합니다.
addInputHandler() 및 setActiveInputHandler()도 참조하십시오 .
void QAbstract3DGraph::releaseTheme(Q3DTheme *theme)
theme 가 이 그래프에 추가된 경우, 해당 의 소유권을 호출자에게 반환합니다. 반환된 theme 가 사용 중인 경우, 새로운 기본 테마가 생성되어 활성 상태로 설정됩니다.
기본 테마가 해제되었다가 나중에 다시 추가되면, 다른 테마와 마찬가지로 동작합니다.
addTheme() 및 setActiveTheme()도 참조하십시오 .
[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItem(QCustom3DItem *item)
사용자 정의 item 를 제거합니다. 이에 할당된 리소스를 삭제합니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItemAt(const QVector3D &position)
position 에 있는 모든 사용자 정의 항목을 제거합니다. 해당 항목에 할당된 리소스를 삭제합니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItems()
모든 사용자 정의 항목을 제거합니다. 해당 항목에 할당된 리소스를 삭제합니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
[since QtDataVisualization 1.1] QImage QAbstract3DGraph::renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize())
현재 프레임을 imageSize 형식의 이미지로 렌더링합니다. 기본 크기는 창 크기입니다. 이미지는 msaaSamples 에 지정된 안티앨리어싱 수준으로 렌더링됩니다. 기본 수준은 0 입니다.
렌더링된 이미지를 반환합니다.
참고: OpenGL ES2는 앤티앨리어싱을 지원하지 않으므로, msaaSamples 는 항상 0 로 강제 설정됩니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
[since QtDataVisualization 1.1] QAbstract3DAxis *QAbstract3DGraph::selectedAxis() const
어떤 레이블 유형이든 상관없이 ‘ selectedElementChanged ’ 신호를 수신한 후, 선택된 축을 가져오는 데 사용할 수 있습니다. 선택 상태는 다음 ‘ selectedElementChanged ’ 신호가 전송될 때까지 유효합니다.
선택된 축에 대한 포인터를 반환하거나 null을 반환합니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
selectedElement도 참조하십시오 .
[since QtDataVisualization 1.1] QCustom3DItem *QAbstract3DGraph::selectedCustomItem() const
QAbstract3DGraph::ElementCustomItem 유형의 ` selectedElementChanged ` 신호를 수신한 후, 선택된 사용자 정의 항목을 가져오는 데 사용할 수 있습니다. 항목의 소유권은 그래프에 남아 있습니다. 선택 상태는 다음 ` selectedElementChanged ` 신호가 발생할 때까지 유효합니다.
선택된 사용자 정의 항목에 대한 포인터를 반환하거나 null을 반환합니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
selectedElement도 참조하십시오 .
[since QtDataVisualization 1.1] int QAbstract3DGraph::selectedCustomItemIndex() const
QAbstract3DGraph::ElementCustomItem 유형의 ‘ selectedElementChanged ’ 신호를 수신한 후, 선택된 사용자 정의 항목의 인덱스를 조회하는 데 사용할 수 있습니다. 선택 상태는 다음 ‘ selectedElementChanged ’ 신호가 발생할 때까지 유효합니다.
선택된 사용자 정의 항목의 인덱스를 반환하거나, -1을 반환합니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
selectedElement도 참조하십시오 .
[since QtDataVisualization 1.1] int QAbstract3DGraph::selectedLabelIndex() const
모든 라벨 유형에서 ‘ selectedElementChanged ’ 신호를 수신한 후, 선택된 라벨의 인덱스를 조회하는 데 사용할 수 있습니다. 선택 상태는 다음 ‘ selectedElementChanged ’ 신호가 발생할 때까지 유효합니다.
선택된 레이블의 인덱스를 반환하거나, -1을 반환합니다.
이 함수는 QtDataVisualization 1.1에서 도입되었습니다.
selectedElement도 참조하십시오 .
void QAbstract3DGraph::setActiveInputHandler(QAbstract3DInputHandler *inputHandler)
inputHandler 를 그래프에서 사용되는 활성 입력 핸들러로 설정합니다. addInputHandler()를 암시적으로 호출하여 inputHandler 의 소유권을 이 그래프로 이전합니다.
inputHandler 가 null인 경우, 이 호출 후에는 활성 입력 핸들러가 없습니다.
참고: activeInputHandler 속성에 대한세터 함수입니다.
참조: activeInputHandler(), addInputHandler(), releaseInputHandler().
void QAbstract3DGraph::setActiveTheme(Q3DTheme *theme)
theme 를 그래프에 사용될 활성 테마로 설정합니다. addTheme()를 암시적으로 호출하여 테마의 소유권을 이 그래프로 이전합니다.
theme 가 null인 경우, 임시 기본 테마가 생성됩니다. 이 임시 테마는 나중에 어떤 테마라도 명시적으로 설정되면 파기됩니다. 테마의 속성은 설정 후에도 수정할 수 있으며, 수정 내용은 즉시 적용됩니다.
참고: activeTheme 속성에 대한세터 함수입니다.
참조: activeTheme().
[virtual] bool QAbstract3DGraph::shadowsSupported() const
현재 구성에서 그림자가 지원되는 경우 ` true `을 반환합니다. OpenGL ES2 구성은 그림자를 지원하지 않습니다.
QList<Q3DTheme *> QAbstract3DGraph::themes() const
추가된 모든 테마의 목록을 반환합니다.
addTheme()도 참조하십시오 .
관련 비회원 항목
QSurfaceFormat qDefaultSurfaceFormat(bool antialias)
이 편의 함수를 사용하면 Qt Data Visualization 그래프에 적합한 사용자 정의 표면 형식을 생성할 수 있습니다.
antialias 매개변수는 앤티앨리어싱이 활성화될지 여부를 지정합니다.
show() 를 호출하기 전에, 이 함수가 반환하는 표면 형식을 그래프 생성자(C++)에 전달하거나 QQuickView (QML)의 창 형식으로 설정하십시오.
예를 들어, C++ 애플리케이션에서 앤티앨리어싱을 비활성화하려면:
#include <QtDataVisualization/qutils.h>
// ...
Q3DBars *graph = new Q3DBars(qDefaultSurfaceFormat(false));예를 들어, QML 애플리케이션에서 직접 렌더링 모드에 대해 앤티앨리어싱을 활성화하려면:
#include <QtDataVisualization/qutils.h>
// ...
QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));참고: OpenGL ES2 환경에서는앤티앨리어싱이 지원되지 않습니다.
© 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.
