QAbstract3DSeries Class
QAbstract3DSeries 클래스는 모든 데이터 시계의 기본 클래스입니다. 더 보기...
| 헤더: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| 출시일: | QtDataVisualization 1.0 |
| QML에서: | Abstract3DSeries |
| 상속: | QObject |
| 상속받는 클래스: | |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 유형
| enum | Mesh { MeshUserDefined, MeshBar, MeshCube, MeshPyramid, MeshCone, …, MeshPoint } |
| enum | SeriesType { SeriesTypeNone, SeriesTypeBar, SeriesTypeScatter, SeriesTypeSurface } |
속성
|
|
공개 함수
| virtual | ~QAbstract3DSeries() |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| Q3DTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | itemLabel() const |
| QString | itemLabelFormat() const |
| QAbstract3DSeries::Mesh | mesh() const |
| QQuaternion | meshRotation() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| QString | name() const |
| void | setBaseColor(const QColor &color) |
| void | setBaseGradient(const QLinearGradient &gradient) |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
| void | setItemLabelFormat(const QString &format) |
| void | setItemLabelVisible(bool visible) |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
| void | setMeshAxisAndAngle(const QVector3D &axis, float angle) |
| void | setMeshRotation(const QQuaternion &rotation) |
| void | setMeshSmooth(bool enable) |
| void | setMultiHighlightColor(const QColor &color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setName(const QString &name) |
| void | setSingleHighlightColor(const QColor &color) |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
| void | setUserDefinedMesh(const QString &fileName) |
| void | setVisible(bool visible) |
| QColor | singleHighlightColor() const |
| QLinearGradient | singleHighlightGradient() const |
| QAbstract3DSeries::SeriesType | type() const |
| QString | userDefinedMesh() const |
신호
| void | baseColorChanged(const QColor &color) |
| void | baseGradientChanged(const QLinearGradient &gradient) |
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
| void | itemLabelChanged(const QString &label) |
| void | itemLabelFormatChanged(const QString &format) |
| void | itemLabelVisibilityChanged(bool visible) |
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
| void | meshRotationChanged(const QQuaternion &rotation) |
| void | meshSmoothChanged(bool enabled) |
| void | multiHighlightColorChanged(const QColor &color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | nameChanged(const QString &name) |
| void | singleHighlightColorChanged(const QColor &color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | userDefinedMeshChanged(const QString &fileName) |
| void | visibilityChanged(bool visible) |
상세 설명
지원되는 각 시리즈 유형( QBar3DSeries, QScatter3DSeries, QSurface3DSeries)에 대해 상속된 클래스가 있습니다.
자세한 내용은 Qt Data Visualization 데이터 처리를 참조하십시오.
멤버 유형 설명서
enum QAbstract3DSeries::Mesh
사전 정의된 메쉬 유형. 모든 스타일이 모든 시각화 유형에서 사용 가능한 것은 아닙니다.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstract3DSeries::MeshUserDefined | 0 | QAbstract3DSeries::userDefinedMesh 속성을 통해 설정된 사용자 정의 메쉬. |
QAbstract3DSeries::MeshBar | 1 | 기본 직사각형 막대. |
QAbstract3DSeries::MeshCube | 2 | 기본 큐브. |
QAbstract3DSeries::MeshPyramid | 3 | 4면 피라미드. |
QAbstract3DSeries::MeshCone | 4 | 기본 원뿔. |
QAbstract3DSeries::MeshCylinder | 5 | 기본 원통. |
QAbstract3DSeries::MeshBevelBar | 6 | 약간 경사진(둥근) 직사각형 막대. |
QAbstract3DSeries::MeshBevelCube | 7 | 약간 경사진(둥근) 정육면체. |
QAbstract3DSeries::MeshSphere | 8 | 구. |
QAbstract3DSeries::MeshMinimal | 9 | 가장 단순한 3D 메쉬: 삼각 피라미드. Q3DScatter에서만 사용 가능합니다. |
QAbstract3DSeries::MeshArrow | 10 | 위쪽을 가리키는 화살표. |
QAbstract3DSeries::MeshPoint | 11 | 2D 점. Q3DScatter에서만 사용할 수 있습니다. 그림자는 이 스타일에 영향을 미치지 않습니다. 이 스타일은 색상 스타일 Q3DTheme::ColorStyleObjectGradient 을 지원하지 않습니다. |
enum QAbstract3DSeries::SeriesType
시리즈의 유형.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstract3DSeries::SeriesTypeNone | 0 | 시계열 유형 없음. |
QAbstract3DSeries::SeriesTypeBar | 1 | Q3DBars의 시리즈 유형. |
QAbstract3DSeries::SeriesTypeScatter | 2 | Q3DScatter의 시계열 유형. |
QAbstract3DSeries::SeriesTypeSurface | 4 | Q3DSurface에 대한 시리즈 유형. |
속성 문서
baseColor : QColor
이 속성은 시리즈의 기본 색상을 지정합니다.
액세스 함수:
| QColor | baseColor() const |
| void | setBaseColor(const QColor &color) |
알림 신호:
| void | baseColorChanged(const QColor &color) |
colorStyle 및 Q3DTheme::baseColors도 참조하십시오 .
baseGradient : QLinearGradient
이 속성은 시계의 기본 그라데이션을 저장합니다.
액세스 함수:
| QLinearGradient | baseGradient() const |
| void | setBaseGradient(const QLinearGradient &gradient) |
알림 신호:
| void | baseGradientChanged(const QLinearGradient &gradient) |
colorStyle 및 Q3DTheme::baseGradients도 참조하십시오 .
colorStyle : Q3DTheme::ColorStyle
이 속성은 시리즈의 색상 스타일을 지정합니다.
액세스 함수:
| Q3DTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
알림 신호:
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
Q3DTheme::ColorStyle도 참조하십시오 .
[read-only, since QtDataVisualization 1.1] itemLabel : QString
이 속성은 서식이 적용된 항목 레이블을 포함합니다.
선택된 항목이 없거나 선택된 항목이 표시되지 않는 경우, 빈 문자열을 반환합니다.
이 열거형은 QtDataVisualization 1.1에서 도입되었습니다.
액세스 함수:
| QString | itemLabel() const |
알림 신호:
| void | itemLabelChanged(const QString &label) |
itemLabelFormat도 참조하십시오 .
itemLabelFormat : QString
이 속성은 이 시리즈에 포함된 데이터 항목의 레이블 형식을 지정합니다.
이 형식은 항목이 선택된 경우와 같이 단일 항목 레이블에 사용됩니다. 형식이 해석되는 방식은 시계열 유형(QBar3DSeries, QScatter3DSeries, QSurface3DSeries)에 따라 달라집니다.
액세스 함수:
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Notifier 신호:
| void | itemLabelFormatChanged(const QString &format) |
[since QtDataVisualization 1.1] itemLabelVisible : bool
이 속성은 그래프에서 항목 레이블의 표시 여부를 결정합니다.
true 인 경우, 항목 레이블은 그래프 내에 플로팅 레이블로 표시됩니다. 그렇지 않은 경우, 항목 레이블은 표시되지 않습니다. 외부 컨트롤에 항목 레이블을 표시하려면 이 속성을 false 로 설정합니다. 기본값은 true 입니다.
이 열거형은 QtDataVisualization 1.1에서 도입되었습니다.
액세스 함수:
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
알림 신호:
| void | itemLabelVisibilityChanged(bool visible) |
itemLabelFormat 및 itemLabel도 참조하십시오 .
mesh : Mesh
이 속성은 시리즈에 포함된 항목들의 메쉬를 저장합니다.
QSurface3DSeries의 경우, 이 속성은 선택 포인터를 저장합니다.
메시가 ` MeshUserDefined`인 경우, 항목이 올바르게 렌더링되려면 ` userDefinedMesh ` 속성도 설정되어야 합니다. 기본값은 그래프 유형에 따라 다릅니다.
액세스 함수:
| QAbstract3DSeries::Mesh | mesh() const |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
Notifier 신호:
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
meshRotation : QQuaternion
이 속성은 시리즈의 모든 항목에 적용되는 메쉬 회전 값을 저장합니다.
회전 값은 정규화된 QQuaternion 이어야 합니다. 항목별 회전을 지원하는 시리즈 유형의 경우, 각 회전이 서로 곱해집니다. QBar3DSeries는 y축을 중심으로 하지 않는 회전은 무시합니다. QSurface3DSeries는 선택 포인터에만 회전을 적용합니다. 기본값은 회전이 없습니다.
액세스 함수:
| QQuaternion | meshRotation() const |
| void | setMeshRotation(const QQuaternion &rotation) |
알림 신호:
| void | meshRotationChanged(const QQuaternion &rotation) |
meshSmooth : bool
이 속성은 미리 정의된 메시의 평활화된 버전이 사용되는지 여부를 지정합니다.
true 인 경우, mesh 속성을 통해 설정된 매끄러운 버전이 사용됩니다. 이 속성은 mesh가 MeshUserDefined 로 설정되었을 때 사용되는 사용자 정의 메쉬에는 영향을 미치지 않습니다. 기본값은 false 입니다.
액세스 함수:
| bool | isMeshSmooth() const |
| void | setMeshSmooth(bool enable) |
알림 신호:
| void | meshSmoothChanged(bool enabled) |
multiHighlightColor : QColor
이 속성은 시리즈의 여러 항목에 적용되는 강조 표시 색상을 지정합니다.
액세스 함수:
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(const QColor &color) |
알림 신호:
| void | multiHighlightColorChanged(const QColor &color) |
colorStyle 및 Q3DTheme::multiHighlightColor도 참조하십시오 .
multiHighlightGradient : QLinearGradient
이 속성은 시리즈의 여러 항목에 적용되는 강조 표시 그라데이션을 나타냅니다.
액세스 함수:
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
알림 신호:
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
colorStyle 및 Q3DTheme::multiHighlightGradient도 참조하십시오 .
name : QString
이 속성은 시리즈 이름을 저장합니다.
시리즈 이름은 @seriesName 태그와 함께 항목 레이블 형식으로 사용할 수 있습니다.
액세스 함수:
| QString | name() const |
| void | setName(const QString &name) |
알림 신호:
| void | nameChanged(const QString &name) |
itemLabelFormat도 참조하십시오 .
singleHighlightColor : QColor
이 속성은 시리즈의 개별 항목 강조 표시 색상을 지정합니다.
액세스 함수:
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(const QColor &color) |
알림 신호:
| void | singleHighlightColorChanged(const QColor &color) |
관련 항목: colorStyle 및 Q3DTheme::singleHighlightColor.
singleHighlightGradient : QLinearGradient
이 속성은 시계의 단일 항목 강조 그라데이션을 지정합니다.
액세스 함수:
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
알림 신호:
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
colorStyle 및 Q3DTheme::singleHighlightGradient도 참조하십시오 .
[read-only] type : const SeriesType
이 속성은 시계의 유형을 나타냅니다.
액세스 함수:
| QAbstract3DSeries::SeriesType | type() const |
userDefinedMesh : QString
이 속성은 오브젝트에 대한 사용자 정의 메쉬의 파일 이름을 저장합니다.
이 사용자 정의 메시는 ' mesh '가 ' MeshUserDefined'로 설정된 경우 사용됩니다.
참고: 파일은 Wavefront OBJ 형식이어야 하며, 정점, 법선 및 UV 정보를 포함해야 합니다. 또한 삼각형으로 구성되어야 합니다.
액세스 함수:
| QString | userDefinedMesh() const |
| void | setUserDefinedMesh(const QString &fileName) |
알림 신호:
| void | userDefinedMeshChanged(const QString &fileName) |
visible : bool
이 속성은 시리즈의 표시 여부를 지정합니다.
이 속성이 ` false`인 경우, 시리즈가 렌더링되지 않습니다. 기본값은 ` true`입니다.
액세스 함수:
| bool | isVisible() const |
| void | setVisible(bool visible) |
알림 신호:
| void | visibilityChanged(bool visible) |
멤버 함수 설명서
[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
추상적인 3D 시리즈를 삭제합니다.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const QVector3D &axis, float angle)
axis 와 angle 를 사용하여 메쉬 회전 쿼터니언을 생성하는 편의 함수입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
meshRotation도 참조하십시오 .
© 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.
