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 값은 세로 방향에 해당합니다. 이러한 속성 중 하나를 설정하면 기존 높이 맵의 비동기 재해상도가 트리거됩니다.

QSurfaceDataProxyQt Graphs 3D로 데이터 처리하기를참조하세요 .

속성 문서

autoScaleY : bool

높이 값을 Y축으로 배율합니다.

기본값은 false 입니다.

이 속성을 true 으로 설정하면 높이 값은 minYValuemaxYValue 사이의 Y 축에 맞게 배율이 조정됩니다.

기능에 액세스합니다:

bool autoScaleY() const
void setAutoScaleY(bool enabled)

알림 신호:

void autoScaleYChanged(bool enabled)

minYValuemaxYValue참조하세요 .

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)

주어진 imageparent 로 QHeightMapSurfaceDataProxy 를 구축합니다. 높이 맵은 setHeightMap()를 호출하여 image 로 설정합니다.

heightMap도 참조하십시오 .

[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)

주어진 이미지 filenameparent 로부터 QHeightMapSurfaceDataProxy 를 구축합니다. 높이 맵은 setHeightMapFile()를 호출하여 filename 로 설정합니다.

heightMapFile도 참조하십시오 .

[override virtual noexcept] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()

QHeightMapSurfaceDataProxy 을 파괴합니다.

void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)

현재 데이터를 image 에 지정된 높이 맵 데이터로 바꿉니다.

image 을 지정할 수 있는 형식은 여러 가지가 있지만 직접 사용할 수 있는 형식이 아닌 경우 변환이 이루어집니다.

참고: 결과가 잘못된 것 같으면 자동 변환이 실패한 것이므로 설정하기 전에 image 을 직접 변환해 보아야 합니다. 기본 형식은 회색조로 된 QImage::Format_RGB32 입니다.

image 의 높이는 image 이 회색조인 경우 픽셀의 빨간색 구성 요소에서 읽습니다. 그렇지 않으면 픽셀의 빨강, 녹색 및 파랑 구성 요소에서 계산된 평균입니다. 그레이 스케일 이미지를 사용하면 큰 이미지의 데이터 변환 속도가 향상될 수 있습니다.

권장되지 않는 형식: 모든 모노 형식(예: 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)

최소값(minXminZ)과 최대값(maxXmaxZ)을 동시에 설정할 수 있는 편리한 기능입니다. 최소값은 해당 최대값보다 작아야 합니다. 그렇지 않으면 값이 유효하도록 조정됩니다.

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