이 페이지에서

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