Surface3DSeries QML Type
在三维曲面图中表示数据序列。更多
| Import Statement: | import QtGraphs |
| In C++: | QSurface3DSeries |
| Inherits: |
- 所有成员（包括继承成员）列表
- Surface3DSeries 是Qt Graphs QML Types for 3D 的一部分。
属性
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- dataArray : SurfaceDataArray
- dataProxy : SurfaceDataProxy
- drawMode : DrawFlag
- flatShadingSupported : bool
- invalidSelectionPosition : point
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- mesh : Abstract3DSeries.Mesh
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- selectedPoint : point
- shading : Shading
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- textureFile : string
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
- wireframeColor : color
信号
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- dataArrayChanged(SurfaceDataArray array)
- dataProxyChanged(SurfaceDataProxy proxy)
- drawModeChanged(DrawFlag mode)
- flatShadingSupportedChanged(bool enable)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- selectedPointChanged(point position)
- shadingChanged(const Shading shading)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- textureFileChanged(string filename)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
- wireframeColorChanged(color color)
方法
- void setMeshAxisAndAngle(vector3d axis, real angle)
详细说明
该类型管理系列特定的可视化元素以及系列数据（通过数据代理）。
Surface3DSeries 支持以下 itemLabelFormat 格式标签：
| @xTitle | 来自 x 轴的标题 |
| @yTitle | 来自 y 轴的标题 |
| @zTitle | 来自 Z 轴的标题 |
| @xLabel | 使用 x 轴格式的项目值。更多信息，请参阅labelFormat 。 |
| @yLabel | 使用 Y 轴格式的项目值。更多信息，请参阅labelFormat 。 |
| @zLabel | 使用 Z 轴格式的项目值。更多信息，请参阅labelFormat 。 |
| @seriesName | 系列名称 |
有关更完整的说明，请参阅QSurface3DSeries 。
另请参阅 Qt Graphs 3D 数据处理。
属性文档
baseColor : color |
设置系列的基色。
另请参阅 colorStyle 和GraphsTheme.seriesColors 。
baseGradient : Gradient |
设置序列的基本梯度。
另请参阅 colorStyle 和 GraphsTheme.seriesGradients。
colorStyle : GraphsTheme.ColorStyle |
设置系列的颜色样式。
另请参阅 GraphsTheme.ColorStyle 。
dataArray : SurfaceDataArray |
保存数据数组的引用。
dataArrayChanged 设置数据数组时会发出信号，除非 与前一个相同。newDataArray
注意： 在对 dataArray 做任何操作之前，必须为相关代理创建一个系列。
dataProxy : SurfaceDataProxy |
活动数据代理。该系列拥有任何设置给它的代理的所有权，并在添加新代理时删除任何先前设置的代理。代理不能为空或设置为其他系列。
drawMode : DrawFlag |
将绘图模式设置为Surface3DSeries.DrawFlag 之一。不允许清除所有标记。
flatShadingSupported : bool |
表示当前系统是否支持曲面的平面着色。它至少需要 GLSL 1.2 版本和 GL_EXT_gpu_shader4 扩展。
注意： 此只读属性会在第一次渲染后设置为正确值。在此之前，它始终是true 。
invalidSelectionPosition : point |
提供无效选择位置的常量属性。该位置将分配给selectedPoint 属性，以便从该系列中清除选区。
另请参阅 GraphsItem3D::clearSelection() 。
itemLabel : string |
格式化的项目标签。如果没有选中项或选中项不可见，则返回空字符串。
另请参阅 itemLabelFormat 。
itemLabelFormat : string |
该系列中数据项的标签格式。该格式用于单个项目标签，例如，当一个项目被选中时。如何解释格式取决于系列类型。
另请参阅 Bar3DSeries,Scatter3DSeries, 和Surface3DSeries 。
itemLabelVisible : bool |
如果true ，项目标签在图表中将绘制为浮动标签。否则不绘制项目标签。要在外部控件中显示项目标签，应将此属性设置为false 。默认值为true 。
另请参阅 itemLabelFormat 和itemLabel 。
mesh : Abstract3DSeries.Mesh |
设置系列中项目的网格，如果是Surface3DSeries ，则设置选择指针。如果网格是Abstract3DSeries.Mesh.UserDefined ，则必须同时设置userDefinedMesh 属性，项目才能正确呈现。默认值取决于图形类型。
另请参阅 QAbstract3DSeries::Mesh 。
meshRotation : quaternion |
设置应用于系列中所有项目的网格旋转。旋转应为归一化四元数。Bar3DSeries 会忽略任何非绕 Y 轴的旋转。Surface3DSeries 只对选择指针应用旋转。默认为不旋转。
meshSmooth : bool |
如果true ，则会使用通过mesh 属性设置的预定义网格的平滑版本。当网格设置为Abstract3DSeries.Mesh.UserDefined 时，此属性不会影响使用的自定义网格。默认为false 。
multiHighlightColor : color |
设置系列的多项目高亮颜色。
multiHighlightGradient : Gradient |
设置系列的多条目高亮渐变色。
name : string |
系列名称。可通过标签@seriesName 以项目标签格式使用。
另请参阅 itemLabelFormat 。
selectedPoint : point |
将曲面网格点设置在所选系列数据数组中某一行和某一列指定的位置。每次只能选择一个点。
要清除此系列的选择，请将invalidSelectionPosition 指定为位置。如果将此序列添加到图表中，图表会根据用户交互或当选择无效时调整选择。
在所选点的行之前从系列中移除行或插入行都会调整选区，使同一点保持在选区中。
另请参阅 GraphsItem3D::clearSelection()。
shading : Shading |
将曲面平面阴影设置为可见。默认设置为Surface3DSeries.Shading.Flat 。禁用时，曲面上的法线将被内插，使边缘看起来更圆。可见时，三角形上的法线保持不变，三角形的颜色为纯色。这将使数据更容易从模型中读取。
注意： 平着色曲面至少需要 GLSL 1.2 版本和 GL_EXT_gpu_shader4 扩展。flatShadingSupported 属性的值表示运行时是否支持平面着色。
singleHighlightColor : color |
设置系列的单项高亮颜色。
singleHighlightGradient : Gradient |
设置系列的单项高亮渐变色。
textureFile : string |
曲面纹理的纹理文件名。若要清除纹理，则文件名为空。
type : Abstract3DSeries.SeriesType |
系列的类型。QAbstract3DSeries::SeriesType 值之一。
userDefinedMesh : string |
为用户定义的自定义网格设置文件名，当mesh 为Abstract3DSeries.Mesh.UserDefined 时使用。
注： 文件必须是QtQuick3D 网格格式。使用balsam 转换工具从其他 3D 模型格式创建网格。
visible : bool |
设置系列的可见性。如果false ，则不会渲染序列。
wireframeColor : color |
用于绘制曲面线框网格线的颜色。
信号文档
baseGradientChanged(Gradient gradient) |
当baseGradient 更改为gradient 时，将发出此信号。
注： 相应的处理程序是onBaseGradientChanged 。
colorStyleChanged(GraphsTheme.ColorStyle style) |
当colorStyle 变更为style 时，发出该信号。
注： 相应的处理程序是onColorStyleChanged 。
dataArrayChanged(SurfaceDataArray array) |
当dataArray 变更为array 时，发出此信号。
注： 相应的处理程序是onDataArrayChanged 。
dataProxyChanged(SurfaceDataProxy proxy) |
当dataProxy 变更为proxy 时，发出此信号。
注： 相应的处理程序是onDataProxyChanged 。
drawModeChanged(DrawFlag mode) |
当drawMode 变更为mode 时，发出此信号。
注： 相应的处理程序是onDrawModeChanged 。
flatShadingSupportedChanged(bool enable) |
当flatShadingSupported 变更为enable 时，发出此信号。
注： 相应的处理程序是onFlatShadingSupportedChanged 。
itemLabelFormatChanged(string format) |
当itemLabelFormat 变更为format 时，发出此信号。
注： 相应的处理程序是onItemLabelFormatChanged 。
itemLabelVisibilityChanged(bool visible) |
当 itemLabelVisibility 变更为visible 时，发出此信号。
注： 相应的处理程序是onItemLabelVisibilityChanged 。
meshChanged(Abstract3DSeries.Mesh mesh) |
当mesh 变更为mesh 时，发出此信号。
注： 相应的处理程序是onMeshChanged 。
meshRotationChanged(quaternion rotation) |
当meshRotation 变更为rotation 时，发出该信号。
注： 相应的处理程序是onMeshRotationChanged 。
meshSmoothChanged(bool enabled) |
当meshSmooth 变更为enabled 时，发出此信号。
注： 相应的处理程序是onMeshSmoothChanged 。
multiHighlightColorChanged(colorcolor) |
当multiHighlightColor 更改为color 时会发出该信号。
注： 相应的处理程序是onMultiHighlightColorChanged 。
multiHighlightGradientChanged(Gradient gradient) |
当multiHighlightGradient 变更为gradient 时发出此信号。
注： 相应的处理程序是onMultiHighlightGradientChanged 。
selectedPointChanged(point position) |
当selectedPoint 变更为position 时，发出该信号。
注： 相应的处理程序是onSelectedPointChanged 。
shadingChanged(const Shading shading) |
当shading 变更为shading 时，发出该信号。
注： 相应的处理程序是onShadingChanged 。
singleHighlightColorChanged(color color) |
当singleHighlightColor 变更为color 时，发出该信号。
注： 相应的处理程序是onSingleHighlightColorChanged 。
singleHighlightGradientChanged(Gradient gradient) |
当singleHighlightGradient 变更为gradient 时，发出此信号。
注： 相应的处理程序是onSingleHighlightGradientChanged 。
textureFileChanged(string filename) |
当textureFile 变更为filename 时，发出该信号。
注： 相应的处理程序是onTextureFileChanged 。
userDefinedMeshChanged(string fileName) |
当userDefinedMesh 变更为fileName 时，发出该信号。
注： 相应的处理程序是onUserDefinedMeshChanged 。
visibilityChanged(bool visible) |
当系列可见性更改为visible 时，发出此信号。
注： 相应的处理程序是onVisibilityChanged 。
wireframeColorChanged(color color) |
当wireframeColor 变更为color 时，发出该信号。
注： 相应的处理程序是onWireframeColorChanged 。
方法文档
方便函数，用于从axis 和angle 构建网格旋转四元数。
另请参见 meshRotation 。
© 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.
