Back to Qt.io
Contact Us Blog Download Qt

QAbstract3DSeries Class

QAbstract3DSeries 클래스는 모든 데이터 계열의 기본 클래스입니다. 더 보기...

Header: #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
상속합니다:

QBar3DSeries, QScatter3DSeries, 및 QSurface3DSeries

공용 유형

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::MeshUserDefined0QAbstract3DSeries::userDefinedMesh 속성을 통해 설정한 사용자 정의 메시입니다.
QAbstract3DSeries::MeshBar1기본 직사각형 막대.
QAbstract3DSeries::MeshCube2기본 큐브.
QAbstract3DSeries::MeshPyramid34면 피라미드.
QAbstract3DSeries::MeshCone4기본 원뿔.
QAbstract3DSeries::MeshCylinder5기본 원통.
QAbstract3DSeries::MeshBevelBar6약간 경 사진 (둥근) 직사각형 막대.
QAbstract3DSeries::MeshBevelCube7약간 경 사진 (둥근) 큐브.
QAbstract3DSeries::MeshSphere8구체.
QAbstract3DSeries::MeshMinimal9최소한의 3D 메시: 삼각형 피라미드. Q3DScatter 에서만 사용할 수 있습니다.
QAbstract3DSeries::MeshArrow10위쪽을 가리키는 화살표.
QAbstract3DSeries::MeshPoint112D 점. Q3DScatter 에서만 사용 가능. 그림자는 이 스타일에 영향을 주지 않습니다. 색상 스타일 Q3DTheme::ColorStyleObjectGradient 은 이 스타일에서 지원되지 않습니다.

enum QAbstract3DSeries::SeriesType

시리즈 유형.

상수값설명
QAbstract3DSeries::SeriesTypeNone0시리즈 유형이 없습니다.
QAbstract3DSeries::SeriesTypeBar1Q3DBars 의 시리즈 유형입니다.
QAbstract3DSeries::SeriesTypeScatter2Q3DScatter 의 직렬 유형입니다.
QAbstract3DSeries::SeriesTypeSurface4Q3DSurface 의 시리즈 유형입니다.

속성 문서

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 : const 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)

알림 신호:

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)

알림 신호:

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 속성을 통해 설정된 부드러운 버전이 사용됩니다. 이 프로퍼티는 메시가 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 일 때 사용됩니다.

참고: 파일은 웨이브프론트 오브젝트 형식이어야 하며 버텍스, 노멀, 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도 참조하십시오 .

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