HeightMapSurfaceDataProxy QML Type
| Import Statement: | import QtGraphs |
| In C++: | QHeightMapSurfaceDataProxy |
| Inherits: |
- 所有成员（包括继承成员）列表
- HeightMapSurfaceDataProxy 是Qt Graphs QML Types for 3D 的一部分。
属性
- 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 时，高度值将按比例缩放到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 值之一。
信号文档
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.
