Back to Qt.io
Contact Us Blog Download Qt
このページでは

Surface3DSeries QML Type

データ系列を3D曲面グラフで表現します。詳細...

Import Statement: import QtGraphs
In C++: QSurface3DSeries
Inherits:

Abstract3DSeries

プロパティ

信号

方法

詳細説明

この型は、シリーズ固有のビジュアルエレメントと（データプロキシを介した）シリーズデータを管理する。

Surface3DSeriesはitemLabelFormatに以下のフォーマットタグをサポートする：

xTitlex軸のタイトル
yTitley 軸からのタイトル
zTitlez軸からのタイトル
xLabelx軸のフォーマットでフォーマットされた項目値。詳細については、labelFormat を参照。
yLabely 軸のフォーマットを使用してフォーマットされた項目値。詳細はlabelFormat を参照。
zLabelz 軸のフォーマットでフォーマットされた項目値。詳細はlabelFormat を参照。
シリーズ名シリーズ名。

より詳細な説明は、QSurface3DSeries を参照。

Qt Graphs 3Dによるデータ処理も参照のこと 。

プロパティ・ドキュメント

baseColor : color

シリーズのベースカラー。

colorStyle およびGraphsTheme.seriesColorsも参照の こと。

baseGradient : Gradient

シリーズのベース勾配。

colorStyleも参照のこと 。

colorStyle : GraphsTheme.ColorStyle

シリーズのカラースタイル。

GraphsTheme.ColorStyleも参照 。

dataArray : SurfaceDataArray

データ配列の参照を保持する。

dataArrayChanged newDataArray が前のものと同じでない限り、データ配列が設定されるとシグナルが発せられる。

注意： dataArrayに関して何かをする前に、関連するプロキシに対してシリーズを作成する必要があります。

dataProxy : SurfaceDataProxy

アクティブなデータプロキシ。この系列は、その系列に設定されているプロキシの所有権を引き受け、新しいプロキシが追加されると、以前に設定されていたプロキシは削除される。プロキシをNULLにしたり、別の系列に設定したりすることはできない。

drawMode : DrawFlag

描画モードをSurface3DSeries.DrawFlag{QSurface3DSeries.DrawFilledSurface} のいずれかに設定します。DrawWireframe または DrawSurface のいずれかを設定する必要があります。

flatShadingSupported : bool [read-only]

サーフェスのフラットシェーディングが現在のシステムでサポートされているかどうかを示します。少なくともGLSLバージョン1.2とGL_EXT_gpu_shader4エクステンションが必要です。

注意： この読み取り専用プロパティは、最初のレンダーパスの後に正しい値に設定されます。それまでは常にtrue です。

invalidSelectionPosition : point [read-only]

無効な選択位置を提供する定数プロパティ。この位置はselectedPoint プロパティに代入され、このシリーズからの選択をクリアする。

GraphsItem3D::clearSelection()も参照 。

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も参照のこと 。

selectedPoint : point

選択されているシリーズのデータ配列の行と列で指定された位置にサーフェスグリッドポイントを設定します。一度に選択できる点は1つだけです。

この系列から選択を解除するには、invalidSelectionPosition を位置として指定します。この系列がグラフに追加された場合、グラフはユーザーの操作に応じて、あるいは無効となった場合に選択を調整することができる。

選択されたポイントの行の前に系列から行を削除したり、系列に行を挿入したりすると、同じポイントが選択されたままになるように選択が調整されます。

GraphsItem3D::clearSelection()も参照 。

shading : Shading

サーフェスのフラットシェーディングを可視に設定します。デフォルトではSurface3DSeries.Shading.Flat に設定されています。無効にすると、サーフェスの法線が補間され、エッジが丸く見えます。visibleの場合、法線は三角形上で同じに保たれ、三角形の色はソリッドになります。これにより、モデルからデータがより読みやすくなります。

注意： フラットシェーディングサーフェスには、少なくともGL_EXT_gpu_shader4エクステンションを持つGLSLバージョン1.2が必要です。flatShadingSupported プロパティの値は、実行時にフラットシェーディングがサポートされているかどうかを示します。

singleHighlightColor : color

シリーズの単一アイテムのハイライト色。

colorStyle およびGraphsTheme.singleHighlightColorも参照のこと 。

singleHighlightGradient : Gradient

シリーズの単一アイテムのハイライトグラデーション。

colorStyle およびGraphsTheme.singleHighlightGradientも参照のこと 。

textureFile : string

表面テクスチャのテクスチャファイル名。テクスチャをクリアするには、空のファイル名が設定されます。

type : Abstract3DSeries.SeriesType [read-only]

シリーズのタイプ。QAbstract3DSeries::SeriesType 。

userDefinedMesh : string

mesh のときに使用されるオブジェクト用のユーザー定義カスタムメッシュのファイル名はAbstract3DSeries.Mesh.UserDefined です。

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

visible : bool

シリーズの可視性。false の場合、シリーズはレンダリングされない。

wireframeColor : color

サーフェスワイヤーフレームのグリッドラインの描画に使用される色。

信号のドキュメント

baseColorChanged(color color)

このシグナルは、baseColor がcolor に変更されたときに発せられる。

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

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 。

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 。

rowsSanitizedChanged(bool enabled)

このシグナルは、rowsSanitized がenabled に変更されたときに発行される。

注： 対応するハンドラはonRowsSanitizedChanged です。

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

メソッド・ドキュメント

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.