이 페이지에서

HeightMapSurfaceDataProxy QML Type

Surface3D 의 기본 프록시 유형. 더 보기...

Import Statement: import QtGraphs
In C++: QHeightMapSurfaceDataProxy
Inherits:

SurfaceDataProxy

속성

신호

상세 설명

QHeightMapSurfaceDataProxy 표면과 관련된 높이 맵 데이터의 처리를 담당합니다. 높이 맵을 표면 플롯 형태로 시각화해 줍니다.

더 자세한 설명은 QHeightMapSurfaceDataProxy 를 참조하십시오.

Qt Graphs 의 ‘3D 데이터 처리’항목도 참조하십시오 .

속성 설명서

autoScaleY : real

높이 값을 Y축에 맞춰 조정합니다. 기본값은 false 입니다. 이 속성이 true 로 설정되면, 높이 값이 minYValue 과 maxYValue 사이의 Y축에 맞도록 조정됩니다.

heightMapFile : string

시각화할 높이 맵 이미지가 포함된 파일입니다. 이 속성을 설정하면 현재 데이터가 높이 맵 데이터로 대체됩니다.

이미지 파일은 여러 형식으로 지정할 수 있지만, 바로 사용할 수 없는 형식인 경우 변환이 수행됩니다.

참고: 결과가 올바르지 않은경우 , 자동 변환에 실패한 것이므로 설정을 적용하기 전에 직접 이미지를 변환해 보시기 바랍니다. 권장 형식은 그레이스케일 방식의 QImage::Format_RGB32 입니다.

이미지가 그레이스케일인 경우, 이미지의 높이는 픽셀의 적색 성분에서 읽어옵니다. 그렇지 않은 경우, 픽셀의 적색, 녹색, 청색 성분을 바탕으로 계산된 평균값을 사용합니다. 그레이스케일 이미지를 사용하면 대용량 이미지의 데이터 변환 속도가 향상될 수 있습니다.

높이 맵에는 X축이나 Z축 값이 포함되어 있지 않으므로, 이러한 값은 minXValue, maxXValue, minZValue 및 maxZValue 속성을 사용하여 별도로 지정해야 합니다. X값은 이미지의 수평 방향에, Z값은 수직 방향에 해당합니다. 이 속성 중 하나를 설정하면 기존 높이 맵에 대한 비동기적 재해상도 처리가 트리거됩니다.

권장하지 않는 형식: 모든 모노 형식(예: QImage::Format_Mono).

maxXValue : real

생성된 표면 점의 최대 X 값입니다. 기본값은 10.0 입니다. 이 속성을 설정하면, 범위가 유효한 상태를 유지하도록 필요에 따라 해당 최소값이 조정됩니다.

maxYValue : real

생성된 표면 점의 최대 Y값입니다. 기본값은 10.0 입니다. 이 속성을 설정하면, 범위가 유효한 상태를 유지하도록 필요에 따라 해당 최소값이 조정됩니다.

maxZValue : real

생성된 표면 점의 최대 Z 값입니다. 기본값은 10.0 입니다. 이 속성을 설정하면, 범위가 유효한 상태를 유지하도록 필요에 따라 해당 최소값이 조정됩니다.

minXValue : real

생성된 표면 점의 최소 X 값입니다. 기본값은 0.0 입니다. 이 속성을 설정하면 범위가 유효한 상태를 유지하도록 필요에 따라 해당 최대값이 조정됩니다.

minYValue : real

생성된 표면 점의 최소 Y 값입니다. 기본값은 0.0 입니다. 이 속성을 설정하면, 범위가 유효한 상태를 유지하도록 필요에 따라 해당 최대값이 조정됩니다.

minZValue : real

생성된 표면 점의 최소 Z 값입니다. 기본값은 0.0 입니다. 이 속성을 설정하면 범위가 유효한 상태를 유지하도록 필요에 따라 해당 최대값이 조정됩니다.

type : AbstractDataProxy.DataType [read-only]

프록시의 유형입니다. ` QAbstractDataProxy::DataType ` 값 중 하나입니다.

Signal 문서

autoScaleYChanged(bool enabled)

이 신호는 autoScaleY 이 enabled 로 변경될 때 발생합니다.

참고: 이에 해당하는핸들러는 onAutoScaleYChanged 입니다.

heightMapFileChanged(string filename)

이 신호는 heightMapFile 이 filename 로 변경될 때 발생합니다.

참고: 이에 해당하는핸들러는 onHeightMapFileChanged 입니다.

maxXValueChanged(real value)

이 신호는 maxXValue 이 value 로 변경될 때 발생합니다.

참고: 이에 해당하는핸들러는 onMaxXValueChanged 입니다.

maxYValueChanged(real value)

이 신호는 maxYValue 이 value 로 변경될 때 발생합니다.

참고: 이에 해당하는핸들러는 onMaxYValueChanged 입니다.

maxZValueChanged(real value)

이 신호는 maxZValue 이 value 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onMaxZValueChanged 입니다.

minXValueChanged(real value)

이 신호는 minXValue 이 value 로 변경될 때 발생합니다.

참고: 이에 해당하는핸들러는 onMinXValueChanged 입니다.

minYValueChanged(real value)

이 신호는 minYValue 이 value 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onMinYValueChanged 입니다.

minZValueChanged(real value)

이 신호는 minZValue 가 value 로 변경될 때 발생합니다.

참고: 이에 해당하는핸들러는 onMinZValueChanged 입니다.

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