HeightMapSurfaceDataProxy QML Type
| Import Statement: | import QtGraphs |
| In C++: | QHeightMapSurfaceDataProxy |
| Inherits: |
- 所有成员列表（包括继承的成员）
- HeightMapSurfaceDataProxy 是Qt Graphs 3D QML 类型的一部分。
属性
- autoScaleY : real
- heightMapFile : string
- maxXValue : real
- maxYValue : real
- maxZValue : real
- minXValue : real
- minYValue : real
- minZValue : real
- type : AbstractDataProxy.DataType
信号
- autoScaleYChanged(bool enabled)
- heightMapFileChanged(string filename)
- maxXValueChanged(real value)
- maxYValueChanged(real value)
- maxZValueChanged(real value)
- minXValueChanged(real value)
- minYValueChanged(real value)
- minZValueChanged(real value)
详细说明
QHeightMapSurfaceDataProxy 负责处理与曲面相关的高程图数据。它能够将高程图以曲面图的形式进行可视化展示。
如需更完整的说明，请参阅QHeightMapSurfaceDataProxy 。
另请参阅 Qt Graphs 中的“3D 数据处理”。
属性文档
autoScaleY : real
将高度值按Y轴进行缩放。默认值为false 。当此属性设置为true 时，高度值将被缩放以适应Y轴上minYValue 到maxYValue 之间的范围。
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.
