QSurface3DSeries Class
QSurface3DSeries 클래스는 3D 표면 그래프에서 데이터 계열을 나타냅니다. 더 보기...
| Header: | #include <QSurface3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| 이후: | QtDataVisualization 1.0 |
| QML에서: | Surface3DSeries |
| 상속합니다: | QAbstract3DSeries |
공용 유형
속성
|
|
공공 기능
| QSurface3DSeries(QObject *parent = nullptr) | |
| QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QSurface3DSeries() |
| QSurfaceDataProxy * | dataProxy() const |
| QSurface3DSeries::DrawFlags | drawMode() const |
| bool | isFlatShadingEnabled() const |
| bool | isFlatShadingSupported() const |
| QPoint | selectedPoint() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
| void | setFlatShadingEnabled(bool enabled) |
| void | setSelectedPoint(const QPoint &position) |
| void | setTexture(const QImage &texture) |
| void | setTextureFile(const QString &filename) |
| void | setWireframeColor(const QColor &color) |
| QImage | texture() const |
| QString | textureFile() const |
| QColor | wireframeColor() const |
신호
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
| void | flatShadingEnabledChanged(bool enable) |
| void | flatShadingSupportedChanged(bool enable) |
| void | selectedPointChanged(const QPoint &position) |
| void | textureChanged(const QImage &image) |
| void | textureFileChanged(const QString &filename) |
| void | wireframeColorChanged(const QColor &color) |
정적 공용 멤버
| QPoint | invalidSelectionPosition() |
상세 설명
이 클래스는 시리즈별 시각적 요소와 시리즈 데이터(데이터 프록시를 통해)를 관리합니다.
시리즈에 대한 데이터 프록시가 명시적으로 설정되어 있지 않으면 시리즈가 기본 프록시를 생성합니다. 다른 프록시를 설정하면 기존 프록시와 여기에 추가된 모든 데이터가 파괴됩니다.
QAbstract3DSeries::mesh 속성을 통해 설정된 개체 메쉬는 서페이스 시리즈에서 선택 포인터 모양을 정의합니다.
QSurface3DSeries는 QAbstract3DSeries::setItemLabelFormat()에 대해 다음 형식 태그를 지원합니다:
| xTitle | x축의 제목 |
| @yTitle | y 축의 제목 |
| @zTitle | z축의 제목 |
| @xLabel | x축의 형식을 사용하여 서식이 지정된 항목 값입니다. 자세한 내용은 QValue3DAxis::setLabelFormat()를 참조하세요. |
| @yLabel | y축의 형식을 사용하여 서식이 지정된 항목 값입니다. 자세한 내용은 QValue3DAxis::setLabelFormat()를 참조하세요. |
| @zLabel | z축 형식을 사용하여 서식이 지정된 항목 값입니다. 자세한 내용은 QValue3DAxis::setLabelFormat()를 참조하세요. |
| 시리즈명 | 시리즈의 이름 |
예를 들어:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Qt Data Visualization 데이터 처리도참조하세요 .
멤버 유형 문서
열거형 QSurface3DSeries::DrawFlag
플래그 QSurface3DSeries::DrawFlags
서페이스의 그리기 모드입니다. 이 열거형의 값은 OR 연산자와 결합할 수 있습니다.
| Constant | 값 | 설명 |
|---|---|---|
QSurface3DSeries::DrawWireframe | 1 | 그리드만 그려집니다. |
QSurface3DSeries::DrawSurface | 2 | 서페이스만 그려집니다. |
QSurface3DSeries::DrawSurfaceAndWireframe | DrawWireframe | DrawSurface | 서페이스와 그리드가 모두 그려집니다. |
DrawFlags 유형은 QFlags<DrawFlag>에 대한 typedef입니다. DrawFlag 값의 OR 조합을 저장합니다.
속성 문서
dataProxy : QSurfaceDataProxy*
이 속성은 활성 데이터 프록시를 보유합니다.
시리즈는 여기에 설정된 모든 프록시의 소유권을 가지며, 새 프록시가 추가되면 이전에 설정된 모든 프록시를 삭제합니다. 프록시는 null이거나 다른 시리즈로 설정할 수 없습니다.
기능에 액세스합니다:
| QSurfaceDataProxy * | dataProxy() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
알림 신호:
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
drawMode : DrawFlags
그리기 모드입니다.
사용 가능한 값은 DrawFlag 의 값입니다. 모든 플래그를 지우는 것은 허용되지 않습니다.
기능에 액세스합니다:
| QSurface3DSeries::DrawFlags | drawMode() const |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
알림 신호:
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
flatShadingEnabled : bool
이 프로퍼티는 표면 플랫 셰이딩 활성화 여부를 유지합니다.
기본적으로 true 로 사전 설정되어 있습니다.
비활성화하면 서페이스의 노멀이 보간되어 가장자리가 둥글게 보입니다. 활성화하면 삼각형의 노멀이 동일하게 유지되어 삼각형의 색이 단색이 됩니다. 이렇게 하면 모델에서 데이터를 더 잘 읽을 수 있습니다.
참고: 평면 음영 표면에는 GL_EXT_gpu_shader4 확장이 포함된 GLSL 버전 1.2 이상이 필요합니다. flatShadingSupported 프로퍼티의 값은 런타임에 플랫 셰이딩이 지원되는지 여부를 나타냅니다.
함수 액세스
| bool | isFlatShadingEnabled() const |
| void | setFlatShadingEnabled(bool enabled) |
알림 신호:
| void | flatShadingEnabledChanged(bool enable) |
[read-only] flatShadingSupported : const bool
이 프로퍼티는 현재 시스템에서 표면 플랫 셰이딩을 지원하는지 여부를 보유합니다.
표면의 플랫 셰이딩을 사용하려면 GL_EXT_gpu_shader4 확장이 포함된 GLSL 버전 1.2 이상이 필요합니다. true 인 경우 표면의 플랫 셰이딩이 지원됩니다.
참고: 이 읽기 전용 프로퍼티는 첫 번째 렌더링 패스 후에 올바른 값으로 설정됩니다. 그 전까지는 항상 true 입니다.
함수에 액세스합니다:
| bool | isFlatShadingSupported() const |
알림 신호:
| void | flatShadingSupportedChanged(bool enable) |
selectedPoint : QPoint
이 속성은 계열에서 선택된 서페이스 격자점을 보유합니다.
함수에 액세스합니다:
| QPoint | selectedPoint() const |
| void | setSelectedPoint(const QPoint &position) |
알림 신호:
| void | selectedPointChanged(const QPoint &position) |
texture : QImage
이 프로퍼티는 표면의 텍스처를 QImage 로 저장합니다.
비어있는 QImage 을 설정하면 텍스처가 지워집니다.
함수에 액세스합니다:
| QImage | texture() const |
| void | setTexture(const QImage &texture) |
알림 신호:
| void | textureChanged(const QImage &image) |
textureFile : QString
이 프로퍼티는 서페이스의 텍스처를 파일로 저장합니다.
빈 파일 이름을 설정하면 텍스처가 지워집니다.
함수에 액세스합니다:
| QString | textureFile() const |
| void | setTextureFile(const QString &filename) |
알림 신호:
| void | textureFileChanged(const QString &filename) |
[since 6.3] wireframeColor : QColor
이 프로퍼티는 표면 와이어프레임의 색을 저장합니다.
이 프로퍼티는 Qt 6.3에 도입되었습니다.
함수 액세스:
| QColor | wireframeColor() const |
| void | setWireframeColor(const QColor &color) |
알림 신호:
| void | wireframeColorChanged(const QColor &color) |
멤버 함수 문서
[explicit] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
부모 parent 를 사용하여 표면 3D 시리즈를 구성합니다.
[explicit] QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
데이터 프록시 dataProxy 와 부모 parent 를 사용하여 표면 3D 시리즈를 구성합니다.
[virtual noexcept] QSurface3DSeries::~QSurface3DSeries()
서피스 3D 시리즈를 삭제합니다.
[static] QPoint QSurface3DSeries::invalidSelectionPosition()
유효하지 않은 선택 위치를 나타내는 QPoint 을 반환합니다. 이 시리즈에서 선택을 지우려면 selectedPoint 속성으로 설정합니다.
QAbstract3DGraph::clearSelection()도 참조하세요 .
void QSurface3DSeries::setSelectedPoint(const QPoint &position)
행과 열로 지정된 계열의 데이터 배열에서 position 위치에 있는 서피스 격자점을 선택합니다.
한 번에 하나의 점만 선택할 수 있습니다.
이 계열에서 선택을 취소하려면 invalidSelectionPosition()를 position 으로 설정합니다. 이 계열이 그래프에 추가되면 사용자 상호 작용에 따라 또는 선택이 유효하지 않게 되는 경우 그래프가 선택 내용을 조정할 수 있습니다.
선택한 점의 행 앞에 있는 계열에서 행을 제거하거나 계열에 행을 삽입하면 동일한 점이 선택된 상태로 유지되도록 선택 영역이 조정됩니다.
참고: 속성에 대한 설정자 함수 selectedPoint.
selectedPoint() 및 QAbstract3DGraph::clearSelection()도 참조하세요 .
© 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.
