QHeightMapSurfaceDataProxy Class
Q3DSurfaceWidgetItem 의 기본 프록시 클래스. 더 보기...
| 헤더: | #include <QHeightMapSurfaceDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML에서: | HeightMapSurfaceDataProxy |
| 상속: | QSurfaceDataProxy |
- 상속된 멤버를 포함한 모든 멤버 목록
- QHeightMapSurfaceDataProxy는 3D용Qt Graphs C++ 클래스의 일부입니다.
속성
|
공개 함수
| QHeightMapSurfaceDataProxy(QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr) | |
| virtual | ~QHeightMapSurfaceDataProxy() override |
| 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 Graphs 의 ‘3D 데이터 처리’항목도 참조하십시오 .
속성 설명서
autoScaleY : bool
높이 값을 Y축에 맞춰 조정합니다.
기본값은 ` false`입니다.
이 속성이 ` true`로 설정되면, 높이 값이 ` minYValue `과 ` maxYValue` 사이의 Y축에 맞도록 스케일링됩니다.
액세스 함수:
| bool | autoScaleY() const |
| void | setAutoScaleY(bool enabled) |
알림 신호:
| 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) |
maxYValue : float
이 속성은 생성된 표면 점들의 최대 Y 값을 저장합니다.
기본값은 10.0 입니다.
이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요한 경우 해당 최소값이 조정됩니다.
액세스 함수:
| 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) |
minYValue : float
이 속성은 생성된 표면 점의 최소 Y 값을 저장합니다.
기본값은 0.0 입니다.
이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요한 경우 해당 최대값이 조정됩니다.
액세스 함수:
| 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도 참조하십시오 .
[override 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.