PySide6.QtGraphs.QSurface3DSeries¶
- class QSurface3DSeries¶
QSurface3DSeries
类表示3D表面图中的数据系列。更多…概要¶
属性¶
dataArrayᅟ
- 系列的数据数组dataProxyᅟ
- 活跃的数据代理flatShadingSupportedᅟ
- 当前系统是否支持表面平面着色selectedPointᅟ
- 在系列中选择的表面网格点shadingᅟ
- 是否启用表面平面着色textureᅟ
- 用于表面作为QImagetextureFileᅟ
- 表面纹理文件wireframeColorᅟ
- 表面线框的颜色
方法¶
def
__init__()
def
clearArray()
def
clearRow()
def
dataArray()
def
dataProxy()
def
drawMode()
def
selectedPoint()
def
setDataArray()
def
setDataProxy()
def
setDrawMode()
def
setShading()
def
setTexture()
def
setTextureFile()
def
shading()
def
texture()
def
textureFile()
def
wireframeColor()
信号¶
静态函数¶
注意
本文档可能包含从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
与之前的相同。- 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:
此属性保存系列中选中的表面网格点。
在由行和列指定的系列的数据数组中的位置
position
处选择一个表面网格点。一次只能选择一个点。
要清除此系列中的选择,
invalidSelectionPosition()
被设置为position
。如果此系列被添加到图表中,图表可以根据用户交互或选择无效时调整选择。在选定点的行之前从系列中删除行或插入行将调整选择,以便保持选择相同的点。
另请参阅
- Access functions:
- property shadingᅟ: QSurface3DSeries.Shading¶
此属性表示是否启用了表面平面着色。
默认预设为
QSurface3DSeries::Shading::Flat
。当禁用时,表面上的法线会被插值,使边缘看起来圆滑。当可见时,法线在三角形上保持不变,使三角形的颜色保持单一。这使得从模型中读取数据更加清晰。
注意
平面着色表面至少需要GLSL版本1.2并带有GL_EXT_gpu_shader4扩展。
flatShadingSupported
属性的值表示在运行时是否支持平面着色。- Access functions:
此属性保存表面的纹理作为QImage。
设置一个空的QImage会清除纹理。
- Access functions:
- property textureFileᅟ: str¶
此属性保存作为文件的表面纹理。
设置一个空文件名会清除纹理。
- Access functions:
此属性保存表面线框的颜色。
- Access functions:
使用父级
parent
构建一个表面 3D 系列。- __init__(dataProxy[, parent=None])
- Parameters:
dataProxy –
QSurfaceDataProxy
parent –
QObject
使用数据代理
dataProxy
和父级parent
构建一个表面 3D 系列。- clearArray()¶
清除现有数组。
- clearRow(rowIndex)¶
- Parameters:
rowIndex – int
根据给定的
rowIndex
清除数组中的现有行。- dataArray()¶
- Return type:
QSurfaceDataItem 的列表的列表
属性
dataArrayᅟ
的获取器。- dataArrayChanged(array)¶
- Parameters:
array – QSurfaceDataItem 的列表的列表
属性
dataArrayᅟ
的通知信号。- dataProxy()¶
- Return type:
另请参阅
属性
dataProxyᅟ
的获取器。- dataProxyChanged(proxy)¶
- Parameters:
proxy –
QSurfaceDataProxy
属性
dataProxyᅟ
的通知信号。属性
drawModeᅟ
的获取器。属性
drawModeᅟ
的通知信号。- flatShadingSupportedChanged(enabled)¶
- Parameters:
enabled – 布尔值
属性
flatShadingSupportedᅟ
的通知信号。返回表示无效选择位置的QPoint。这被设置为
selectedPoint
属性以清除此系列中的选择。另请参阅
- isFlatShadingSupported()¶
- Return type:
布尔
属性
flatShadingSupportedᅟ
的获取器。- selectedPoint()¶
- Return type:
另请参阅
属性
selectedPointᅟ
的获取器。属性
selectedPointᅟ
的通知信号。- setDataArray(newDataArray)¶
- Parameters:
newDataArray – QSurfaceDataItem 的列表的列表
另请参阅
属性
dataArrayᅟ
的设置器。- setDataProxy(proxy)¶
- Parameters:
proxy –
QSurfaceDataProxy
另请参阅
属性
dataProxyᅟ
的设置器。属性
drawModeᅟ
的设置器。属性
selectedPointᅟ
的设置器。属性
shadingᅟ
的设置器。属性
textureᅟ
的设置器。- setTextureFile(filename)¶
- Parameters:
文件名 – str
另请参阅
属性
textureFileᅟ
的设置器。属性
wireframeColorᅟ
的设置器。- shading()¶
- Return type:
另请参阅
属性
shadingᅟ
的获取器。属性
shadingᅟ
的通知信号。- texture()¶
- Return type:
另请参阅
属性
textureᅟ
的获取器。属性
textureᅟ
的通知信号。- textureFile()¶
- Return type:
字符串
另请参阅
属性
textureFileᅟ
的获取器。- textureFileChanged(filename)¶
- Parameters:
文件名 – str
属性
textureFileᅟ
的通知信号。- wireframeColor()¶
- Return type:
另请参阅
属性
wireframeColorᅟ
的获取器。属性
wireframeColorᅟ
的通知信号。