このページでは

Spline3DSeries QML Type (Uncreatable)

3Dスプライングラフ上のデータ系列を表します。詳細...

Import Statement: import QtGraphs
Since: Qt 6.9
In C++: QSpline3DSeries
Inherits:

Scatter3DSeries

注:これは作成不可能な型です。QML ではインスタンス化できません。

プロパティ

信号

方法

詳細な説明

スプライングラフは、曲線または直線の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 の場合は均一なキャットマル・ロム・スプライン、0.5 の場合は求心性キャットマル・ロム・スプライン、1.0 の場合は弦形キャットマル・ロム・スプラインとして分類されます。

この値は、0.0 から1.0 の範囲内である必要があります。デフォルト値は0.5 です。

splineLooping : bool

スプラインをループさせるかどうかを指定します。

これにより、スプラインをループ状に接続するために、系列の最初の点と最後の点の間にスプラインセグメントが追加されます。

デフォルト値はfalse

splineResolution : int

スプラインのセグメントの解像度。

スプラインセグメント(2つの点間の区間)あたりの頂点数。

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 です。

注:ファイルは QtQuick3D のメッシュ形式である必要があります。他の3Dモデル形式からメッシュを作成するには、balsam の変換ツールを使用してください。

visible : bool

シリーズの表示可否。false の場合、そのシリーズは表示されません。

Signal ドキュメント

baseColorChanged(color color)

このシグナルは、baseColor がcolor に変更されたときに発生します。

注: 対応するハンドラは onBaseColorChanged です。

baseGradientChanged(Gradient gradient)

このシグナルは、baseGradient がgradient に変更されたときに発生します。

注: 対応するハンドラは onBaseGradientChanged です。

colorStyleChanged(GraphsTheme.ColorStyle style)

このシグナルは、colorStyle がstyle に変更されたときに発生します。

注: 対応するハンドラは onColorStyleChanged です。

itemLabelChanged(string label)

このシグナルは、itemLabel がlabel に変化したときに発生します。

注: 対応するハンドラは onItemLabelChanged です。

itemLabelFormatChanged(string format)

このシグナルは、itemLabelFormat がformat に変更されたときに発せられます。

注: 対応するハンドラは onItemLabelFormatChanged です。

itemLabelVisibilityChanged(bool visible)

このシグナルは、itemLabelVisibility が `visible` に変更されたときに発火します。

注: 対応するハンドラは `onItemLabelVisibilityChanged` です。

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

このシグナルは、lightingMode がlightingMode に変更されたときに発せられます。

注: 対応するハンドラは onLightingModeChanged です。

このシグナルは Qt 6.10 で導入されました。

meshChanged(Abstract3DSeries.Mesh mesh)

このシグナルは、mesh がmesh に変更されたときに発生します。

注: 対応するハンドラは onMeshChanged です。

meshRotationChanged(quaternion rotation)

このシグナルは、meshRotation がrotation に変更されたときに発生します。

注: 対応するハンドラは onMeshRotationChanged です。

meshSmoothChanged(bool enabled)

このシグナルは、meshSmooth がenabled に変更されたときに発せられます。

注: 対応するハンドラは onMeshSmoothChanged です。

multiHighlightColorChanged(color color)

このシグナルは、multiHighlightColor がcolor に変更されたときに発生します。

注: 対応するハンドラは onMultiHighlightColorChanged です。

multiHighlightGradientChanged(Gradient gradient)

このシグナルは、multiHighlightGradient がgradient に変更されたときに発生します。

注: 対応するハンドラは onMultiHighlightGradientChanged です。

nameChanged(string name)

このシグナルは、name がname に変更されたときに発信されます。

注: 対応するハンドラは onNameChanged です。

singleHighlightColorChanged(color color)

このシグナルは、singleHighlightColor がcolor に変わったときに発せられます。

注: 対応するハンドラは onSingleHighlightColorChanged です。

singleHighlightGradientChanged(Gradient gradient)

このシグナルは、singleHighlightGradient がgradient に変更されたときに発生します。

注: 対応するハンドラは onSingleHighlightGradientChanged です。

userDefinedMeshChanged(string fileName)

このシグナルは、userDefinedMesh がfileName に変更されたときに発生します。

注: 対応するハンドラは onUserDefinedMeshChanged です。

visibilityChanged(bool visible)

このシグナルは、シリーズの見え方が「visible 」に変わったときに発せられます。

注: 対応するハンドラは onVisibilityChanged です。

メソッドのドキュメント

void setMeshAxisAndAngle(vector3d axis, real angle)

axis およびangle からメッシュ回転クォータニオンを生成するための便利な関数です。

meshRotationも参照してください 。

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