QHeightMapSurfaceDataProxy Class
Q3DSurface 의 기본 프록시 클래스. 더 보기...
| 헤더: | #include <QHeightMapSurfaceDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| 출시일: | QtDataVisualization 1.0 |
| QML에서: | HeightMapSurfaceDataProxy |
| 상속: | QSurfaceDataProxy |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
속성
|
공개 함수
| QHeightMapSurfaceDataProxy(QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr) | |
| virtual | ~QHeightMapSurfaceDataProxy() |
| bool | autoScaleY() const |
| QImage | heightMap() const |
| QString | heightMapFile() const |
| float | maxXValue() const |
| float | maxYValue() const |
| float | maxZValue() const |
| float | minXValue() const |
| float | minYValue() const |
| float | minZValue() const |
| void | setAutoScaleY(bool enabled) |
| void | setHeightMap(const QImage &image) |
| void | setHeightMapFile(const QString &filename) |
| void | setMaxXValue(float max) |
| void | setMaxYValue(float max) |
| void | setMaxZValue(float max) |
| void | setMinXValue(float min) |
| void | setMinYValue(float min) |
| void | setMinZValue(float min) |
| void | setValueRanges(float minX, float maxX, float minZ, float maxZ) |
신호
| void | autoScaleYChanged(bool enabled) |
| void | heightMapChanged(const QImage &image) |
| void | heightMapFileChanged(const QString &filename) |
| void | maxXValueChanged(float value) |
| void | maxYValueChanged(float value) |
| void | maxZValueChanged(float value) |
| void | minXValueChanged(float value) |
| void | minYValueChanged(float value) |
| void | minZValueChanged(float value) |
상세 설명
QHeightMapSurfaceDataProxy는 표면과 관련된 높이 맵 데이터 처리를 담당합니다. 이 클래스는 높이 맵을 표면 플롯으로 시각화할 수 있는 방법을 제공합니다.
높이 맵에는 X축이나 Z축 값이 포함되어 있지 않으므로, 해당 값들은 minXValue, maxXValue, minZValue, maxZValue 속성을 사용하여 별도로 지정해야 합니다. X값은 이미지의 수평 방향에, Z값은 수직 방향에 해당합니다. 이 속성 중 하나를 설정하면 기존 높이 맵에 대한 비동기적 재해상도가 트리거됩니다.
QSurfaceDataProxy 및 Qt Data Visualization 데이터 처리항목도 참조하십시오 .
속성 문서
[since 6.3] autoScaleY : bool
높이 값을 Y축에 맞춰 조정합니다.
기본값은 false 입니다.
이 속성이 ` true`로 설정되면, 높이 값이 ` minYValue `과 ` maxYValue` 사이의 Y축에 맞도록 스케일링됩니다.
이 열거형은 Qt 6.3에서 도입되었습니다.
액세스 함수:
| bool | autoScaleY() const |
| void | setAutoScaleY(bool enabled) |
Notifier 신호:
| void | autoScaleYChanged(bool enabled) |
minYValue 및 maxYValue도 참조하십시오 .
heightMap : QImage
이 속성은 시각화할 높이 맵 이미지를 저장합니다.
액세스 함수:
| QImage | heightMap() const |
| void | setHeightMap(const QImage &image) |
알림 신호:
| void | heightMapChanged(const QImage &image) |
heightMapFile : QString
이 속성은 시각화할 높이 맵 이미지가 포함된 파일의 이름을 저장합니다.
액세스 함수:
| QString | heightMapFile() const |
| void | setHeightMapFile(const QString &filename) |
알림 신호:
| void | heightMapFileChanged(const QString &filename) |
maxXValue : float
이 속성은 생성된 표면 점의 최대 X 값을 저장합니다.
기본값은 10.0 입니다.
이 속성을 설정할 때, 범위가 유효하게 유지되도록 필요한 경우 해당 최소값이 조정됩니다.
액세스 함수:
| float | maxXValue() const |
| void | setMaxXValue(float max) |
알림 신호:
| void | maxXValueChanged(float value) |
[since 6.3] maxYValue : float
이 속성은 생성된 표면 점의 최대 Y 값을 저장합니다.
기본값은 10.0 입니다.
이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요에 따라 해당 최소값이 조정됩니다.
이 열거형은 Qt 6.3에서 도입되었습니다.
액세스 함수:
| float | maxYValue() const |
| void | setMaxYValue(float max) |
알림 신호:
| void | maxYValueChanged(float value) |
autoScaleY도 참조하십시오 .
maxZValue : float
이 속성은 생성된 표면 점들의 최대 Z 값을 저장합니다.
기본값은 10.0 입니다.
이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요한 경우 해당 최소값이 조정됩니다.
액세스 함수:
| float | maxZValue() const |
| void | setMaxZValue(float max) |
알림 신호:
| void | maxZValueChanged(float value) |
minXValue : float
이 속성은 생성된 표면 점들의 최소 X 값을 저장합니다.
기본값은 0.0 입니다.
이 속성을 설정할 때, 범위가 유효하게 유지되도록 필요한 경우 해당 최대값이 조정됩니다.
액세스 함수:
| float | minXValue() const |
| void | setMinXValue(float min) |
알림 신호:
| void | minXValueChanged(float value) |
[since 6.3] minYValue : float
이 속성은 생성된 표면 점들의 최소 Y 값을 저장합니다.
기본값은 0.0 입니다.
이 속성을 설정할 때, 범위가 유효하게 유지되도록 필요한 경우 해당 최대값이 조정됩니다.
이 열거형은 Qt 6.3에서 도입되었습니다.
액세스 함수:
| float | minYValue() const |
| void | setMinYValue(float min) |
알림 신호:
| void | minYValueChanged(float value) |
autoScaleY도 참조하십시오 .
minZValue : float
이 속성은 생성된 표면 점들의 최소 Z 값을 지정합니다.
기본값은 0.0 입니다.
이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요한 경우 해당 최대값이 조정됩니다.
액세스 함수:
| float | minZValue() const |
| void | setMinZValue(float min) |
알림 신호:
| void | minZValueChanged(float value) |
멤버 함수 설명서
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)
주어진 ` parent`를 사용하여 `QHeightMapSurfaceDataProxy`를 생성합니다.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)
주어진 ` image ` 및 ` parent`을 사용하여 `QHeightMapSurfaceDataProxy`를 생성합니다. 높이 맵은 ` image`을 인수로 전달하여 ` setHeightMap()`를 호출함으로써 설정됩니다.
heightMap도 참조하십시오 .
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)
주어진 이미지 filename 와 parent 를 사용하여 QHeightMapSurfaceDataProxy를 생성합니다. 높이 맵은 filename 를 인수로 전달하여 setHeightMapFile()를 호출함으로써 설정됩니다.
heightMapFile도 참조하십시오 .
[virtual noexcept] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()
QHeightMapSurfaceDataProxy 를 삭제합니다.
void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)
현재 데이터를 image 로 지정된 높이 맵 데이터로 대체합니다.
image 는 여러 형식으로 지정할 수 있지만, 직접 사용할 수 있는 형식이 아닌 경우 변환이 수행됩니다.
참고: 결과가 잘못된 것처럼보인다면 자동 변환에 실패한 것이므로, 값을 설정하기 전에 image 을 직접 변환해 보아야 합니다. 권장 형식은 그레이스케일 QImage::Format_RGB32 입니다.
image 가 그레이스케일인 경우, image 의 높이는 픽셀의 빨간색(red) 성분에서 읽어오며, 그렇지 않은 경우 픽셀의 빨간색, 녹색, 파란색 성분을 바탕으로 계산된 평균값을 사용합니다. 그레이스케일 이미지를 사용하면 대용량 이미지의 데이터 변환 속도가 향상될 수 있습니다.
권장되지 않는 형식: 모든 단색 형식(예: QImage::Format_Mono).
높이 맵은 비동기적으로 해결됩니다. 데이터가 해결되면 QSurfaceDataProxy::arrayReset()이 발생합니다.
참고: heightMap 속성에 대한세터 함수입니다.
heightMap()도 참조하십시오 .
void QHeightMapSurfaceDataProxy::setHeightMapFile(const QString &filename)
현재 데이터를 ` filename`로 지정된 파일의 높이 맵 데이터로 대체합니다.
참고: heightMapFile 속성에 대한세터 함수입니다.
heightMapFile() 및 heightMap도 참조하십시오 .
void QHeightMapSurfaceDataProxy::setValueRanges(float minX, float maxX, float minZ, float maxZ)
모든 최소값(minX, minZ)과 최대값(maxX, maxZ)을 한 번에 설정할 수 있는 편리한 함수입니다. 최소값은 해당 최대값보다 작아야 합니다. 그렇지 않은 경우, 값이 유효하도록 조정됩니다.
© 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.