HeightMapSurfaceDataProxy QML Type

Surface3D 的基本代理类型。更多

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

SurfaceDataProxy

属性

信号

详细说明

QHeightMapSurfaceDataProxy 负责处理与曲面相关的高度图数据。它可将高度地图可视化为曲面图。

更完整的描述请参见QHeightMapSurfaceDataProxy

另请参阅 Qt Graphs 3D 数据处理

属性文档

autoScaleY : real

将高度值缩放至 Y 轴。默认值为false 。当此属性设置为true 时,高度值将按比例缩放到minYValuemaxYValue 之间的 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


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