PySide6.QtGraphs.QSurface3DSeries

class QSurface3DSeries

QSurface3DSeries 类表示3D表面图中的数据系列。更多…

PySide6.QtGraphs.QSurface3DSeries 的继承图

概要

属性

方法

信号

静态函数

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

该类管理系列特定的视觉元素，以及系列数据（通过数据代理）。

关于代理系列关系，强调几个关键点至关重要。在这种情况下，数据存储在系列中，用户可以通过系列访问数据集。这个系列由代理对象控制或表示。因此，代理可以用来管理数据的各种操作并更新实际数据集。然而，有必要创建一个与此代理关联的系列来编辑数据集。

如果没有为系列显式设置数据代理，系列将创建一个默认代理。设置另一个代理将销毁现有的代理以及添加到系列中的所有数据。

通过mesh属性设置的对象网格定义了表面系列中的选择指针形状。

QSurface3DSeries 支持以下格式标签用于 setItemLabelFormat() ：

@xTitle

X轴标题

@yTitle

Y轴标题

@zTitle

来自z轴的标题

@xLabel

使用x轴格式格式化的项目值。有关更多信息，请参见labelFormat。

@yLabel

使用y轴格式格式化的项目值。有关更多信息，请参见labelFormat。

@zLabel

使用z轴格式格式化的项目值。有关更多信息，请参阅labelFormat。

@seriesName

系列名称

例如：

proxy.setItemLabelFormat("@valueTitle for (@rowLabel, @colLabel): %.1f")

另请参阅

使用3D处理Qt图形数据

class DrawFlag

(继承自 enum.Flag) 表面的绘制模式。此枚举的值可以使用 OR 运算符进行组合。

常量

描述

QSurface3DSeries.DrawWireframe

仅绘制网格。

QSurface3DSeries.DrawSurface

仅绘制表面。

QSurface3DSeries.DrawSurfaceAndWireframe

表面和网格都被绘制。
class Shading

在版本6.8中添加。

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property dataArrayᅟ: list of list of QSurfaceDataItem

此属性保存系列的数据数组。

保存数据数组的引用。

当数据数组被设置时，会发出dataArrayChanged信号，除非newDataArray与之前的相同。

注意

在对dataArray进行任何操作之前，必须为相关代理创建一个系列。

另请参阅

clearRow(qsizetype rowIndex) clearArray()

Access functions:
property dataProxyᅟ: QSurfaceDataProxy

此属性保存活动数据代理。

该系列假定拥有任何设置给它的代理，并在添加新代理时删除任何先前设置的代理。代理不能为空或设置为另一个系列。

Access functions:
property drawModeᅟ: Combination of QSurface3DSeries.DrawFlag

绘图模式。

可能的值为 DrawFlag 的值。不允许清除所有标志。

Access functions:
property flatShadingSupportedᅟ: bool

此属性表示当前系统是否支持表面平面着色。

表面的平面着色至少需要GLSL版本1.2并带有GL_EXT_gpu_shader4扩展。如果true，则支持表面的平面着色。

注意

这个只读属性在第一次渲染通过后会被设置为其正确的值。在此之前，它始终是true。

Access functions:
property selectedPointᅟ: QPoint

此属性保存系列中选中的表面网格点。

在由行和列指定的系列的数据数组中的位置 position 处选择一个表面网格点。

一次只能选择一个点。

要清除此系列中的选择，invalidSelectionPosition() 被设置为 position。如果此系列被添加到图表中，图表可以根据用户交互或选择无效时调整选择。

在选定点的行之前从系列中删除行或插入行将调整选择，以便保持选择相同的点。

另请参阅

clearSelection()

Access functions:
property shadingᅟ: QSurface3DSeries.Shading

此属性表示是否启用了表面平面着色。

默认预设为 QSurface3DSeries::Shading::Flat。

当禁用时，表面上的法线会被插值，使边缘看起来圆滑。当可见时，法线在三角形上保持不变，使三角形的颜色保持单一。这使得从模型中读取数据更加清晰。

注意

平面着色表面至少需要GLSL版本1.2并带有GL_EXT_gpu_shader4扩展。flatShadingSupported属性的值表示在运行时是否支持平面着色。

Access functions:
property textureᅟ: QImage

此属性保存表面的纹理作为QImage。

设置一个空的QImage会清除纹理。

Access functions:
property textureFileᅟ: str

此属性保存作为文件的表面纹理。

设置一个空文件名会清除纹理。

Access functions:
property wireframeColorᅟ: QColor

此属性保存表面线框的颜色。

Access functions:
__init__([parent=None])
Parameters:

父对象 – QObject

使用父级 parent 构建一个表面 3D 系列。

__init__(dataProxy[, parent=None])
Parameters:

使用数据代理 dataProxy 和父级 parent 构建一个表面 3D 系列。

clearArray()

清除现有数组。

clearRow(rowIndex)
Parameters:

rowIndex – int

根据给定的rowIndex清除数组中的现有行。

dataArray()
Return type:

QSurfaceDataItem 的列表的列表

属性 dataArrayᅟ 的获取器。

dataArrayChanged(array)
Parameters:

array – QSurfaceDataItem 的列表的列表

属性 dataArrayᅟ 的通知信号。

dataProxy()
Return type:

QSurfaceDataProxy

另请参阅

setDataProxy()

属性 dataProxyᅟ 的获取器。

dataProxyChanged(proxy)
Parameters:

proxy – QSurfaceDataProxy

属性 dataProxyᅟ 的通知信号。

drawMode()
Return type:

DrawFlag 的组合

另请参阅

setDrawMode()

属性 drawModeᅟ 的获取器。

drawModeChanged(mode)
Parameters:

mode – DrawFlag 的组合

属性 drawModeᅟ 的通知信号。

flatShadingSupportedChanged(enabled)
Parameters:

enabled – 布尔值

属性 flatShadingSupportedᅟ 的通知信号。

static invalidSelectionPosition()
Return type:

QPoint

返回表示无效选择位置的QPoint。这被设置为selectedPoint属性以清除此系列中的选择。

另请参阅

clearSelection()

isFlatShadingSupported()
Return type:

布尔

属性 flatShadingSupportedᅟ 的获取器。

selectedPoint()
Return type:

QPoint

另请参阅

setSelectedPoint()

属性 selectedPointᅟ 的获取器。

selectedPointChanged(position)
Parameters:

位置 – QPoint

属性 selectedPointᅟ 的通知信号。

setDataArray(newDataArray)
Parameters:

newDataArray – QSurfaceDataItem 的列表的列表

另请参阅

dataArray()

属性 dataArrayᅟ 的设置器。

setDataProxy(proxy)
Parameters:

proxy – QSurfaceDataProxy

另请参阅

dataProxy()

属性 dataProxyᅟ 的设置器。

setDrawMode(mode)
Parameters:

mode – DrawFlag 的组合

另请参阅

drawMode()

属性 drawModeᅟ 的设置器。

setSelectedPoint(position)
Parameters:

位置 – QPoint

另请参阅

selectedPoint()

属性 selectedPointᅟ 的设置器。

setShading(shading)
Parameters:

阴影 – Shading

另请参阅

shading()

属性 shadingᅟ 的设置器。

setTexture(texture)
Parameters:

纹理 – QImage

另请参阅

texture()

属性 textureᅟ 的设置器。

setTextureFile(filename)
Parameters:

文件名 – str

另请参阅

textureFile()

属性 textureFileᅟ 的设置器。

setWireframeColor(color)
Parameters:

颜色 – QColor

另请参阅

wireframeColor()

属性 wireframeColorᅟ 的设置器。

shading()
Return type:

Shading

另请参阅

setShading()

属性 shadingᅟ 的获取器。

shadingChanged(shading)
Parameters:

阴影 – Shading

属性 shadingᅟ 的通知信号。

texture()
Return type:

QImage

另请参阅

setTexture()

属性 textureᅟ 的获取器。

textureChanged(image)
Parameters:

图像 – QImage

属性 textureᅟ 的通知信号。

textureFile()
Return type:

字符串

另请参阅

setTextureFile()

属性 textureFileᅟ 的获取器。

textureFileChanged(filename)
Parameters:

文件名 – str

属性 textureFileᅟ 的通知信号。

wireframeColor()
Return type:

QColor

另请参阅

setWireframeColor()

属性 wireframeColorᅟ 的获取器。

wireframeColorChanged(color)
Parameters:

颜色 – QColor

属性 wireframeColorᅟ 的通知信号。