이 페이지에서

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.