Surface3DSeries QML Type (Uncreatable)

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

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

• 継承されたメンバーを含むすべてのメンバーの一覧
• Surface3DSeriesは、Qt Graphs の3D用QML型の一部です。

プロパティ

• baseColor : color
• baseGradient : Gradient
• colorStyle : GraphsTheme.ColorStyle
• dataArray : SurfaceDataArray
• dataProxy : SurfaceDataProxy
• drawMode : DrawFlag
• flatShadingSupported : bool
• invalidSelectionPosition : point
• 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
• 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)
• 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)
• rowsSanitizedChanged(bool enabled)
• 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に対して以下のフォーマットタグをサポートしています：

より詳しい説明については、QSurface3DSeries を参照してください。

Qt Graphs 「3D データ処理」も参照してください 。

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

baseColor : color

このシリーズのベースカラーです。

「 colorStyle 」および「GraphsTheme.seriesColors 」も参照してください 。

baseGradient : Gradient

この数列の基本勾配。

colorStyleも参照してください 。

colorStyle : GraphsTheme.ColorStyle

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

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

dataArray : SurfaceDataArray

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

dataArrayChanged データ配列が設定されると、newDataArray が前回のものと同一でない限り、signalが発信されます。

dataProxy : SurfaceDataProxy

アクティブなデータプロキシ。このシリーズは、自身に設定されたプロキシの所有権を取得し、新しいプロキシが追加されると、以前に設定されていたプロキシを削除します。プロキシはnullにしたり、別のシリーズに設定したりすることはできません。

drawMode : DrawFlag

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

flatShadingSupported : bool [read-only]

現在のシステムがサーフェスのフラットシェーディングをサポートしているかどうかを示します。これには、GL_EXT_gpu_shader4 拡張機能を備えた GLSL バージョン 1.2 以上が必要です。

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 」に設定されています。無効にすると、サーフェスの法線が補間され、エッジが丸く見えます。有効にすると、三角形内の法線が一定に保たれ、三角形の色が一様になります。これにより、モデルからデータをより読み取りやすくなります。

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

visible : bool

系列の表示設定。false の場合、その系列は表示されません。

wireframeColor : color

サーフェスのワイヤーフレームのグリッド線を描画する際に使用する色。

Signal ドキュメント

baseColorChanged(color color)

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

baseGradientChanged(Gradient gradient)

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

colorStyleChanged(GraphsTheme.ColorStyle style)

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

dataArrayChanged(SurfaceDataArray array)

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

dataProxyChanged(SurfaceDataProxy proxy)

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

drawModeChanged(DrawFlag mode)

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

flatShadingSupportedChanged(bool enable)

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

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 に変更されたときに発生します。

rowsSanitizedChanged(bool enabled)

このシグナルは、`rowsSanitized`がenabled に変化したときに発火します。

selectedPointChanged(point position)

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

shadingChanged(const Shading shading)

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

singleHighlightColorChanged(color color)

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

singleHighlightGradientChanged(Gradient gradient)

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

textureFileChanged(string filename)

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

userDefinedMeshChanged(string fileName)

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

visibilityChanged(bool visible)

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

wireframeColorChanged(color color)

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

メソッドのドキュメント

void setMeshAxisAndAngle(vector3d axis, real angle)

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

meshRotationも参照してください 。