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 および GraphsTheme.seriesGradients も参照して ください。


colorStyle : GraphsTheme.ColorStyle

シリーズのカラースタイルを設定します。

GraphsTheme.ColorStyleも参照して ください。


dataArray : SurfaceDataArray

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

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

注意: dataArrayに関して何かを行う前に、関連するプロキシに対して系列を作成する必要があります。


dataProxy : SurfaceDataProxy

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


drawMode : DrawFlag

描画モードをSurface3DSeries.DrawFlag のいずれかに設定する。 すべてのフラグをクリアすることはできない。


flatShadingSupported : bool [read-only]

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

注意： この読み取り専用プロパティは、最初のレンダーパスの後に正しい値に設定されます。それまでは常に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も参照してください 。


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の場合、三角形の法線は同じに保たれ、三角形の色はベタになります。これにより、モデルからデータがより読みやすくなります。

注意： フラットシェーディングサーフェスには、少なくともGLSLバージョン1.2とGL_EXT_gpu_shader4エクステンションが必要です。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 です。


meshChanged(Abstract3DSeries.Mesh mesh)

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

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


meshRotationChanged(quaternion rotation)

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

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


meshSmoothChanged(bool enabled)

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

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


multiHighlightColorChanged(color色)

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

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


multiHighlightGradientChanged(Gradient gradient)

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

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


nameChanged(string name)

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

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


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も参照してください ．


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