이 페이지에서

Surface3D QML Type

3D 표면 그래프의 사용법을 설명합니다. 더 보기...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
Inherits:

AbstractGraph3D

Status: Deprecated

이 유형은 더 이상 권장되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않을 것을 강력히 권장합니다.

속성

방법

상세 설명

이 유형을 사용하면 개발자는 Qt Quick 을 통해 표면 플롯을 3D로 렌더링할 수 있습니다.

이 타입을 사용하려면 데이터 시각화 모듈을 임포트해야 합니다:

import QtDataVisualization 1.2

그 후 QML 파일에서 Surface3D를 사용할 수 있습니다:

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Surface3D {
        width: parent.width
        height: parent.height
        Surface3DSeries {
            itemLabelFormat: "Pop density at (@xLabel N, @zLabel E): @yLabel"
            ItemModelSurfaceDataProxy {
                itemModel: dataModel
                // Mapping model roles to surface series rows, columns, and values.
                rowRole: "longitude"
                columnRole: "latitude"
                yPosRole: "pop_density"
            }
        }
    }
    ListModel {
        id: dataModel
        ListElement{ longitude: "20"; latitude: "10"; pop_density: "4.75"; }
        ListElement{ longitude: "21"; latitude: "10"; pop_density: "3.00"; }
        ListElement{ longitude: "22"; latitude: "10"; pop_density: "1.24"; }
        ListElement{ longitude: "23"; latitude: "10"; pop_density: "2.53"; }
        ListElement{ longitude: "20"; latitude: "11"; pop_density: "2.55"; }
        ListElement{ longitude: "21"; latitude: "11"; pop_density: "2.03"; }
        ListElement{ longitude: "22"; latitude: "11"; pop_density: "3.46"; }
        ListElement{ longitude: "23"; latitude: "11"; pop_density: "5.12"; }
        ListElement{ longitude: "20"; latitude: "12"; pop_density: "1.37"; }
        ListElement{ longitude: "21"; latitude: "12"; pop_density: "2.98"; }
        ListElement{ longitude: "22"; latitude: "12"; pop_density: "3.33"; }
        ListElement{ longitude: "23"; latitude: "12"; pop_density: "3.23"; }
        ListElement{ longitude: "20"; latitude: "13"; pop_density: "4.34"; }
        ListElement{ longitude: "21"; latitude: "13"; pop_density: "3.54"; }
        ListElement{ longitude: "22"; latitude: "13"; pop_density: "1.65"; }
        ListElement{ longitude: "23"; latitude: "13"; pop_density: "2.67"; }
    }
}

보다 자세한 사용 예제는 표면 그래프 갤러리를 참조하십시오.

Surface3DSeries, ItemModelSurfaceDataProxy, Bars3D, Scatter3D 및 Qt Data Visualization C++ Classes.

속성 문서

axisX : ValueAxis3D

활성 X축.

축이 지정되지 않으면, 레이블이 없고 범위가 자동으로 조정되는 임시 기본 축이 생성됩니다. 이 임시 축은 다른 축이 명시적으로 동일한 방향으로 설정되면 삭제됩니다.

axisY : ValueAxis3D

활성 Y축.

축이 지정되지 않은 경우, 레이블이 없고 범위가 자동으로 조정되는 임시 기본 축이 생성됩니다. 이 임시 축은 다른 축이 동일한 방향으로 명시적으로 설정되면 제거됩니다.

axisZ : ValueAxis3D

활성 Z축.

축이 지정되지 않은 경우, 레이블이 없고 범위가 자동으로 조정되는 임시 기본 축이 생성됩니다. 이 임시 축은 다른 축이 동일한 방향으로 명시적으로 설정되면 삭제됩니다.

flipHorizontalGrid : bool [since QtDataVisualization 1.2]

일부 사용 사례에서는 가로축 격자가 대부분 표면에 가려지기 때문에, 가로축 격자를 그래프 하단이 아닌 상단에 표시하는 것이 더 유용할 수 있습니다. 이에 대한 대표적인 사용 사례는 위에서 내려다보는 시점의 직교 투영법을 사용하여 2D 스펙트로그램을 표시하는 경우입니다.

false 인 경우, 가로축 격자와 레이블은 그래프의 가로 배경 위에 그려집니다. true 인 경우, 가로축 격자와 레이블은 가로 배경과 반대편에 그려집니다. 기본값은 false 입니다.

이 속성은 QtDataVisualization 1.2에서 도입되었습니다.

selectedSeries : Surface3DSeries

선택된 시계열 또는 null. ` selectionMode `에 ` SelectionMultiSeries ` 플래그가 설정된 경우, 이 속성은 선택된 점을 소유한 시계열을 포함합니다.

seriesList : list<Surface3DSeries> [default]

이 속성은 그래프의 시리어를 포함합니다. 기본적으로 이 속성은 빈 목록을 포함합니다. 시리어를 설정하려면 ` addSeries()` 함수를 사용하거나 그래프의 자식 요소로 정의하십시오.

메서드 설명서

void addSeries(Surface3DSeries series)

series 를 그래프에 추가합니다.

AbstractGraph3D::hasSeries()도 참조하십시오 .

void removeSeries(Surface3DSeries series)

그래프에서 ` series `를 제거합니다.

AbstractGraph3D::hasSeries()도 참조하십시오 .

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