Spline3DSeries QML Type

在三维样条曲线图中表示数据序列。更多

• 所有成员（包括继承成员）的列表
• Spline3DSeries 是Qt Graphs QML Types for 3D 的一部分。

属性

• baseColor : color
• baseGradient : Gradient
• colorStyle : GraphsTheme.ColorStyle
• itemLabel : string
• itemLabelFormat : string
• itemLabelVisible : bool
• lightingMode : Abstract3DSeries.LightingMode (since 6.10)
• mesh : Abstract3DSeries.Mesh
• meshRotation : quaternion
• meshSmooth : bool
• multiHighlightColor : color
• multiHighlightGradient : Gradient
• name : string
• singleHighlightColor : color
• singleHighlightGradient : Gradient
• splineColor : color
• splineKnotting : real
• splineLooping : bool
• splineResolution : int
• splineTension : real
• splineVisible : bool
• type : Abstract3DSeries.SeriesType
• userDefinedMesh : string
• visible : bool

信号

• baseColorChanged(color color)
• baseGradientChanged(Gradient gradient)
• colorStyleChanged(GraphsTheme.ColorStyle style)
• itemLabelChanged(string label)
• itemLabelFormatChanged(string format)
• itemLabelVisibilityChanged(bool visible)
• lightingModeChanged(Abstract3DSeries.LightingMode lightingMode) (since 6.10)
• meshChanged(Abstract3DSeries.Mesh mesh)
• meshRotationChanged(quaternion rotation)
• meshSmoothChanged(bool enabled)
• multiHighlightColorChanged(color color)
• multiHighlightGradientChanged(Gradient gradient)
• nameChanged(string name)
• singleHighlightColorChanged(color color)
• singleHighlightGradientChanged(Gradient gradient)
• userDefinedMeshChanged(string fileName)
• visibilityChanged(bool visible)

方法

• void setMeshAxisAndAngle(vector3d axis, real angle)

详细说明

样条曲线图用于将信息显示为由弯曲或笔直的 Catmull-Rom 样条曲线连接的一系列数据点。

该类型管理特定于样条线的可视化元素。

属性文档

baseColor : color

该系列的基色。

另请参阅 colorStyle 和GraphsTheme.seriesColors 。

baseGradient : Gradient

系列的基准梯度。

另请参见 colorStyle 。

colorStyle : GraphsTheme.ColorStyle

该系列的色彩风格。

另请参见 GraphsTheme.ColorStyle 。

itemLabel : string [read-only]

格式化的项目标签。如果没有选中项目或选中项目不可见，则返回空字符串。

另请参阅 itemLabelFormat 。

itemLabelFormat : string

本系列数据项的标签格式。该格式用于单个项目标签，例如，当选择一个项目时。如何解释格式取决于系列类型。

另请参阅 Bar3DSeries,Scatter3DSeries, 和Surface3DSeries 。

itemLabelVisible : bool

如果true ，项目标签将在图形中绘制为浮动标签。否则，不绘制项目标签。若要在外部控件中显示项目标签，则将此属性设置为false 。默认值为true 。

另请参阅 itemLabelFormat 和itemLabel 。

lightingMode : Abstract3DSeries.LightingMode [since 6.10]

系列中项目的照明模式。默认值为QAbstract3DSeries::LightingMode::Shaded

此属性在 Qt 6.10 中引入。

另请参阅 QAbstract3DSeries::LightingMode 。

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

系列中多个项目的高亮颜色。

另请参阅 colorStyle 和GraphsTheme.multiHighlightColor 。

multiHighlightGradient : Gradient

系列中多个项目的高亮渐变。

另请参阅 colorStyle 和GraphsTheme.multiHighlightGradient 。

name : string

系列名称。可与标签@seriesName 一起用于项目标签格式。

另请参阅 itemLabelFormat 。

singleHighlightColor : color

系列中单个项目的高亮颜色。

另请参阅 colorStyle 和GraphsTheme.singleHighlightColor 。

singleHighlightGradient : Gradient

系列的单项高亮渐变。

另请参阅 colorStyle 和GraphsTheme.singleHighlightGradient 。

splineColor : color

花键的颜色。

splineKnotting : real

样条曲线的节点参数。

该参数可改变曲线的轮廓。当值为0.0 时，样条曲线被划分为均匀 Catmull-Rom 样条曲线；当值为0.5 时，样条曲线被划分为向心 Catmull-Rom 样条曲线；当值为1.0 时，样条曲线被划分为弦向 Catmull-Rom 样条曲线。

该值必须介于0.0 和1.0 之间。默认值为0.5 。

splineLooping : bool

确定样条曲线是否循环。

这将在连接该样条线的系列的第一个点和最后一个点之间添加一个样条线段，使其成为一个循环。

默认值为false

splineResolution : int

样条线段的分辨率。

每条样条线段的顶点数，定义为两点之间的部分。

必须大于2 。默认值为10 。

splineTension : real

花键的张力。

在0.0 的值时，样条曲线会使用最大曲率；在1.0 的值时，样条曲线会完全变直；必须介于0.0 和1.0 之间。默认值为0.0

splineVisible : bool

样条曲线的可见性。默认值为true 。

type : Abstract3DSeries.SeriesType [read-only]

系列类型。QAbstract3DSeries::SeriesType 值之一。

userDefinedMesh : string

mesh 时使用的用户自定义对象网格的文件名是Abstract3DSeries.Mesh.UserDefined 。

visible : bool

系列的可见性。如果false ，则不渲染系列。

信号文档

baseColorChanged(color color)

当baseColor 更改为color 时会发出该信号。

baseGradientChanged(Gradient gradient)

当baseGradient 更改为gradient 时会发出该信号。

colorStyleChanged(GraphsTheme.ColorStyle style)

当colorStyle 更改为style 时会发出该信号。

itemLabelChanged(string label)

当itemLabel 更改为label 时会发出该信号。

itemLabelFormatChanged(string format)

当itemLabelFormat 更改为format 时会发出该信号。

itemLabelVisibilityChanged(bool visible)

当 itemLabelVisibility 变更为visible 时发出此信号。

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

当lightingMode 更改为lightingMode 时会发出该信号。

此信号在 Qt 6.10 中引入。

meshChanged(Abstract3DSeries.Mesh mesh)

当mesh 更改为mesh 时会发出该信号。

meshRotationChanged(quaternion rotation)

当meshRotation 更改为rotation 时会发出该信号。

meshSmoothChanged(bool enabled)

当meshSmooth 更改为enabled 时会发出该信号。

multiHighlightColorChanged(color color)

当multiHighlightColor 更改为color 时会发出该信号。

multiHighlightGradientChanged(Gradient gradient)

当multiHighlightGradient 更改为gradient 时会发出该信号。

nameChanged(string name)

当name 更改为name 时会发出该信号。

singleHighlightColorChanged(color color)

当singleHighlightColor 更改为color 时会发出该信号。

singleHighlightGradientChanged(Gradient gradient)

当singleHighlightGradient 更改为gradient 时会发出该信号。

userDefinedMeshChanged(string fileName)

当userDefinedMesh 更改为fileName 时会发出该信号。

visibilityChanged(bool visible)

当系列可见性更改为visible 时，将发出此信号。

方法文档

void setMeshAxisAndAngle(vector3d axis, real angle)

从axis 和angle 构建网格旋转四元数的便捷函数。

另请参见 meshRotation 。