本页内容

HeightMapSurfaceDataProxy QML Type

Surface3D 的基类代理类型。更多内容...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
In C++: QHeightMapSurfaceDataProxy
Inherits:

SurfaceDataProxy

Status: Deprecated

此类型已弃用。我们强烈建议不要在新代码中使用它。

属性

详细说明

HeightMapSurfaceDataProxy 负责处理与曲面相关的高度图数据。它提供了一种将高度图可视化为曲面图的方法。

如需更完整的说明,请参阅QHeightMapSurfaceDataProxy 。

另请参阅 Qt Data Visualization 数据处理。

属性文档

autoScaleY : real [since 6.3]

将高度值按Y轴进行缩放。默认值为false 。当此属性设置为true 时,高度值将被缩放以适应Y轴上minYValue 到maxYValue 之间的范围。

该属性自 Qt 6.3 起引入。

heightMapFile : string

包含待可视化的高度图图像的文件。设置此属性将用高度图数据替换当前数据。

图像文件支持多种格式,但如果文件格式无法直接使用,系统会自动进行转换。

注意:如果 结果看起来有误,说明自动转换失败,您应在设置该文件之前尝试自行转换图像。首选格式为灰度模式的QImage::Format_RGB32 。

若图像为灰度图像,其高度将从像素的红色通道中读取;否则,高度将根据像素的红、绿、蓝三通道的平均值计算得出。对于大型图像,使用灰度图像可提高数据转换速度。

由于高度图不包含 X 轴或 Z 轴的值,因此需要通过minXValue 、maxXValue 、minZValue 和maxZValue 属性分别指定这些值。X 值对应图像的水平方向,Z 值对应垂直方向。设置上述任何属性都会触发对现有高度图的异步重新解析。

不推荐的格式:所有单色格式(例如QImage::Format_Mono )。

maxXValue : real

生成的曲面点的最大X值。默认值为10.0 。设置此属性时,系统会根据需要调整相应的最小值,以确保该范围保持有效。

maxYValue : real [since 6.3]

生成的曲面点最大 Y 值。默认值为10.0 。设置此属性时,系统会根据需要调整相应的最小值,以确保范围保持有效。

该属性自 Qt 6.3 起引入。

maxZValue : real

生成的曲面点的最大 Z 值。默认值为10.0 。设置此属性时,系统会根据需要调整相应的最小值,以确保该范围保持有效。

minXValue : real

生成的曲面点的最小 X 值。默认值为0.0 。设置此属性时,系统会根据需要调整相应的最大值,以确保该范围保持有效。

minYValue : real [since 6.3]

生成的曲面点的最小 Y 值。默认值为0.0 。设置此属性时,如果需要,相应的最大值会进行调整,以确保范围保持有效。

该属性自 Qt 6.3 起引入。

minZValue : real

生成的曲面点的最小Z值。默认值为0.0 。设置此属性时,系统会在必要时调整相应的最大值,以确保该范围保持有效。

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