Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QAbstract3DSeries Class

QAbstract3DSeries 클래스는 모든 3D 데이터 시계의 기반 클래스입니다. 더 보기...

헤더: #include <QAbstract3DSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
QML에서: Abstract3DSeries
상속: QObject
상속받는 클래스:

QBar3DSeries, QScatter3DSeries 및 QSurface3DSeries

공개 유형

enum class LightingMode { Shaded, Unshaded }
enum class Mesh { UserDefined, Bar, Cube, Pyramid, Cone, …, Point }
enum class SeriesType { None, Bar, Scatter, Surface }

속성

공개 함수

virtual ~QAbstract3DSeries() override
QColor baseColor() const
QLinearGradient baseGradient() const
QGraphsTheme::ColorStyle colorStyle() const
bool isItemLabelVisible() const
bool isMeshSmooth() const
bool isVisible() const
QString itemLabel()
QString itemLabelFormat() const
QAbstract3DSeries::LightingMode lightingMode() const
QAbstract3DSeries::Mesh mesh() const
QQuaternion meshRotation() const
QColor multiHighlightColor() const
QLinearGradient multiHighlightGradient() const
QString name() const
void setBaseColor(QColor color)
void setBaseGradient(const QLinearGradient &gradient)
void setColorStyle(QGraphsTheme::ColorStyle style)
void setItemLabelFormat(const QString &format)
void setItemLabelVisible(bool visible)
void setLightingMode(QAbstract3DSeries::LightingMode lightingMode)
void setMesh(QAbstract3DSeries::Mesh mesh)
void setMeshAxisAndAngle(QVector3D axis, float angle)
void setMeshRotation(const QQuaternion &rotation)
void setMeshSmooth(bool enable)
void setMultiHighlightColor(QColor color)
void setMultiHighlightGradient(const QLinearGradient &gradient)
void setName(const QString &name)
void setSingleHighlightColor(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(QColor color)
void baseGradientChanged(const QLinearGradient &gradient)
void colorStyleChanged(QGraphsTheme::ColorStyle style)
void itemLabelChanged(const QString &label)
void itemLabelFormatChanged(const QString &format)
void itemLabelVisibleChanged(bool visible)
void lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode)
void meshChanged(QAbstract3DSeries::Mesh mesh)
void meshRotationChanged(const QQuaternion &rotation)
void meshSmoothChanged(bool enabled)
void multiHighlightColorChanged(QColor color)
void multiHighlightGradientChanged(const QLinearGradient &gradient)
void nameChanged(const QString &name)
void singleHighlightColorChanged(QColor color)
void singleHighlightGradientChanged(const QLinearGradient &gradient)
void userDefinedMeshChanged(const QString &fileName)
void visibleChanged(bool visible)

상세 설명

지원되는 각 시계열 유형마다 상속된 클래스가 있습니다: QBar3DSeries, QScatter3DSeries 및 QSurface3DSeries.

자세한 내용은 Qt Graphs 의 3D 데이터 처리를 참조하십시오.

멤버 유형 설명서

enum class QAbstract3DSeries::LightingMode

사전 설정된 조명 모드

일정값설명
QAbstract3DSeries::LightingMode::Shaded0그래프가 실시간 조명에 반응합니다
QAbstract3DSeries::LightingMode::Unshaded-1그래프가 실시간 조명에 반응하지 않음

enum class QAbstract3DSeries::Mesh

사전 정의된 메쉬 유형. 모든 스타일이 모든 그래프 유형에서 사용 가능한 것은 아닙니다.

상수값설명
QAbstract3DSeries::Mesh::UserDefined0사용자 정의 메쉬로, ` QAbstract3DSeries::userDefinedMesh ` 속성을 통해 설정됩니다.
QAbstract3DSeries::Mesh::Bar1기본 직사각형 막대.
QAbstract3DSeries::Mesh::Cube2기본 큐브.
QAbstract3DSeries::Mesh::Pyramid34면 피라미드.
QAbstract3DSeries::Mesh::Cone4기본 원뿔.
QAbstract3DSeries::Mesh::Cylinder5기본 원통.
QAbstract3DSeries::Mesh::BevelBar6약간 경사진(둥근) 직사각형 막대.
QAbstract3DSeries::Mesh::BevelCube7약간 모서리가 깎인(둥근) 정육면체.
QAbstract3DSeries::Mesh::Sphere8구.
QAbstract3DSeries::Mesh::Minimal9가장 단순한 3D 메쉬: 삼각 피라미드. Q3DScatterWidgetItem 에서만 사용 가능합니다.
QAbstract3DSeries::Mesh::Arrow10위쪽을 가리키는 화살표.
QAbstract3DSeries::Mesh::Point112D 점. Q3DScatterWidgetItem 에서만 사용할 수 있습니다. 그림자는 이 스타일에 영향을 미치지 않습니다. 색상 스타일 QGraphsTheme::ColorStyle::ObjectGradient 은 이 스타일에서 지원되지 않습니다.

enum class QAbstract3DSeries::SeriesType

시리즈의 유형.

상수값설명
QAbstract3DSeries::SeriesType::None0시리즈 유형 없음.
QAbstract3DSeries::SeriesType::Bar1Q3DBarsWidgetItem 의 시리즈 유형.
QAbstract3DSeries::SeriesType::Scatter2Q3DScatterWidgetItem 의 시계열 유형.
QAbstract3DSeries::SeriesType::Surface3Q3DSurfaceWidgetItem 의 시리즈 유형.

속성 설명서

baseColor : QColor

이 속성은 시리즈의 기본 색상을 지정합니다.

액세스 함수:

QColor baseColor() const
void setBaseColor(QColor color)

알림 신호:

void baseColorChanged(QColor color)

colorStyle 및 QGraphsTheme::seriesColors도 참조하십시오 .

baseGradient : QLinearGradient

이 속성은 시계의 기본 그라데이션을 저장합니다.

액세스 함수:

QLinearGradient baseGradient() const
void setBaseGradient(const QLinearGradient &gradient)

알림 신호:

void baseGradientChanged(const QLinearGradient &gradient)

colorStyle 및 QGraphsTheme::seriesGradients도 참조하십시오 .

colorStyle : QGraphsTheme::ColorStyle

이 속성은 시리즈의 색상 스타일을 지정합니다.

액세스 함수:

QGraphsTheme::ColorStyle colorStyle() const
void setColorStyle(QGraphsTheme::ColorStyle style)

알림 신호:

void colorStyleChanged(QGraphsTheme::ColorStyle style)

QGraphsTheme::ColorStyle도 참조하십시오 .

[read-only] itemLabel : QString

이 속성은 서식이 적용된 항목 레이블을 저장합니다.

선택된 항목이 없거나 선택된 항목이 표시되지 않는 경우, 빈 문자열을 반환합니다.

액세스 함수:

QString itemLabel()

알림 신호:

void itemLabelChanged(const QString &label)

itemLabelFormat도 참조하십시오 .

itemLabelFormat : QString

이 속성은 이 시리즈에 포함된 데이터 항목의 레이블 형식을 지정합니다.

이 형식은 항목이 선택된 경우와 같이 단일 항목 레이블에 사용됩니다. 형식이 해석되는 방식은 시리즈 유형에 따라 다릅니다.

액세스 함수:

QString itemLabelFormat() const
void setItemLabelFormat(const QString &format)

알림 신호:

void itemLabelFormatChanged(const QString &format)

QBar3DSeries, QScatter3DSeries 및 QSurface3DSeries도 참조하십시오 .

itemLabelVisible : bool

이 속성은 그래프에서 항목 레이블의 표시 여부를 결정합니다.

true 인 경우, 항목 레이블은 그래프 내에 떠 있는 레이블로 표시됩니다. 그렇지 않은 경우, 항목 레이블은 표시되지 않습니다. 외부 컨트롤에 항목 레이블을 표시하려면 이 속성을 false 로 설정합니다. 기본값은 true 입니다.

액세스 함수:

bool isItemLabelVisible() const
void setItemLabelVisible(bool visible)

알림 신호:

void itemLabelVisibleChanged(bool visible)

itemLabelFormat 및 itemLabel도 참조하십시오 .

[since 6.10] lightingMode : QAbstract3DSeries::LightingMode

이 속성은 시리얼의 조명 모드를 저장합니다.

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

액세스 함수:

QAbstract3DSeries::LightingMode lightingMode() const
void setLightingMode(QAbstract3DSeries::LightingMode lightingMode)

Notifier 신호:

void lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode)

LightingMode도 참조하십시오 .

mesh : QAbstract3DSeries::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(QColor color)

알림 신호:

void multiHighlightColorChanged(QColor color)

colorStyle 및 QGraphsTheme::multiHighlightColor도 참조하십시오 .

multiHighlightGradient : QLinearGradient

이 속성은 시리즈의 여러 항목에 적용되는 강조 표시 그라데이션을 지정합니다.

액세스 함수:

QLinearGradient multiHighlightGradient() const
void setMultiHighlightGradient(const QLinearGradient &gradient)

알림 신호:

void multiHighlightGradientChanged(const QLinearGradient &gradient)

colorStyle 및 QGraphsTheme::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(QColor color)

알림 신호:

void singleHighlightColorChanged(QColor color)

관련 항목: colorStyle 및 QGraphsTheme::singleHighlightColor.

singleHighlightGradient : QLinearGradient

이 속성은 시계의 단일 항목 강조 그라데이션을 지정합니다.

액세스 함수:

QLinearGradient singleHighlightGradient() const
void setSingleHighlightGradient(const QLinearGradient &gradient)

알림 신호:

void singleHighlightGradientChanged(const QLinearGradient &gradient)

colorStyle 및 QGraphsTheme::singleHighlightGradient도 참조하십시오 .

[read-only] type : const QAbstract3DSeries::SeriesType

이 속성은 시계의 유형을 나타냅니다.

액세스 함수:

QAbstract3DSeries::SeriesType type() const

userDefinedMesh : QString

이 속성은 오브젝트에 대한 사용자 정의 메쉬의 파일 이름을 저장합니다.

이 사용자 정의 메시는 ` mesh `가 `MeshUserDefined`로 설정된 경우 사용됩니다.

참고: 파일은 QtQuick3D 메시 형식이어야 합니다. 다른 3D 모델 형식에서 메시를 생성하려면 balsam 변환 도구를 사용하십시오.

액세스 함수:

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 visibleChanged(bool visible)

멤버 함수 설명서

[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()

추상 3D 시리즈를 삭제합니다.

[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(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.