QAbstract3DSeries Class
QAbstract3DSeries 클래스는 모든 3D 데이터 계열의 기본 클래스입니다. 더 보기...
| Header: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML에서: | Abstract3DSeries |
| 상속합니다: | QObject |
| 상속합니다: |
- 상속된 멤버를 포함한 모든 멤버 목록
- QAbstract3DSeries는 Qt Graphs 3D용 C++ 클래스의 일부입니다.
공용 유형
| 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::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 | 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 | 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::Mesh
미리 정의된 메쉬 유형. 모든 그래프 유형에 모든 스타일을 사용할 수 있는 것은 아닙니다.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstract3DSeries::Mesh::UserDefined | 0 | QAbstract3DSeries::userDefinedMesh 속성을 통해 설정하는 사용자 정의 메시입니다. |
QAbstract3DSeries::Mesh::Bar | 1 | 기본 직사각형 막대. |
QAbstract3DSeries::Mesh::Cube | 2 | 기본 큐브. |
QAbstract3DSeries::Mesh::Pyramid | 3 | 4면 피라미드. |
QAbstract3DSeries::Mesh::Cone | 4 | 기본 원뿔. |
QAbstract3DSeries::Mesh::Cylinder | 5 | 기본 원통. |
QAbstract3DSeries::Mesh::BevelBar | 6 | 약간 경 사진 (둥근) 직사각형 막대. |
QAbstract3DSeries::Mesh::BevelCube | 7 | 약간 경 사진 (둥근) 큐브. |
QAbstract3DSeries::Mesh::Sphere | 8 | 구체. |
QAbstract3DSeries::Mesh::Minimal | 9 | 최소한의 3D 메시: 삼각형 피라미드. Q3DScatterWidgetItem 에서만 사용할 수 있습니다. |
QAbstract3DSeries::Mesh::Arrow | 10 | 위쪽을 가리키는 화살표. |
QAbstract3DSeries::Mesh::Point | 11 | 2D 점. Q3DScatterWidgetItem 에서만 사용 가능. 그림자는 이 스타일에 영향을 주지 않습니다. 색상 스타일 QGraphsTheme::ColorStyle::ObjectGradient 은 이 스타일에서 지원되지 않습니다. |
enum class QAbstract3DSeries::SeriesType
시리즈 유형.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstract3DSeries::SeriesType::None | 0 | 시리즈 유형이 없습니다. |
QAbstract3DSeries::SeriesType::Bar | 1 | Q3DBarsWidgetItem 의 시리즈 유형입니다. |
QAbstract3DSeries::SeriesType::Scatter | 2 | Q3DScatterWidgetItem 의 직렬 유형입니다. |
QAbstract3DSeries::SeriesType::Surface | 3 | Q3DSurfaceWidgetItem 의 시리즈 유형입니다. |
속성 문서
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 : const 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 을참조하세요 .
mesh : QAbstract3DSeries::Mesh
이 속성은 시리즈에 있는 항목의 메시를 보유합니다.
QSurface3DSeries 의 경우 이 속성은 선택 포인터를 보유합니다.
메시가 메시 사용자 정의인 경우 항목이 올바르게 렌더링되려면 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 프로퍼티를 통해 설정된 부드러운 버전이 사용됩니다. 이 프로퍼티는 메시가 메시 사용자 정의로 설정된 경우 사용되는 커스텀 메시에는 영향을 미치지 않습니다. 기본값은 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도 참조하십시오 .
© 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.
