QSurface3DSeries Class
QSurface3DSeries クラスは、3D サーフェスグラフ上のデータ系列を表します。詳細...
| ヘッダー: | #include <QSurface3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| バージョン: | QtDataVisualization 1.0 |
| QMLでの使用開始: | Surface3DSeries |
| 継承元: | QAbstract3DSeries |
| ステータス: | 非推奨 |
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
パブリック型
プロパティ
|
|
パブリック関数
| QSurface3DSeries(QObject *parent = nullptr) | |
| QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QSurface3DSeries() |
| QSurfaceDataProxy * | dataProxy() const |
| QSurface3DSeries::DrawFlags | drawMode() const |
| bool | isFlatShadingEnabled() const |
| bool | isFlatShadingSupported() const |
| QPoint | selectedPoint() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
| void | setFlatShadingEnabled(bool enabled) |
| void | setSelectedPoint(const QPoint &position) |
| void | setTexture(const QImage &texture) |
| void | setTextureFile(const QString &filename) |
| void | setWireframeColor(const QColor &color) |
| QImage | texture() const |
| QString | textureFile() const |
| QColor | wireframeColor() const |
シグナル
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
| void | flatShadingEnabledChanged(bool enable) |
| void | flatShadingSupportedChanged(bool enable) |
| void | selectedPointChanged(const QPoint &position) |
| void | textureChanged(const QImage &image) |
| void | textureFileChanged(const QString &filename) |
| void | wireframeColorChanged(const QColor &color) |
静的パブリックメンバー
| QPoint | invalidSelectionPosition() |
詳細な説明
このクラスは、シリーズ固有の視覚的要素に加え、シリーズデータ（データプロキシを介して）も管理します。
シリーズに対してデータプロキシが明示的に設定されていない場合、シリーズはデフォルトのプロキシを作成します。別のプロキシを設定すると、既存のプロキシおよびそこに追加されたすべてのデータが破棄されます。
QAbstract3DSeries::mesh プロパティで設定されたオブジェクトメッシュは、サーフェス・シリーズにおける選択ポインタの形状を定義します。
QSurface3DSeries は、QAbstract3DSeries::setItemLabelFormat() に対して以下のフォーマットタグをサポートしています。
| @xTitle | x軸からのタイトル |
| @yTitle | y軸からのタイトル |
| @zTitle | z軸のタイトル |
| @xLabel | x軸の書式を使用して書式設定された項目の値。詳細については、QValue3DAxis::setLabelFormat() を参照してください。 |
| @yLabel | y軸の書式を使用して書式設定された項目の値。詳細については、QValue3DAxis::setLabelFormat() を参照してください。 |
| @zLabel | z軸の書式を使用して書式設定された項目の値。詳細については、QValue3DAxis::setLabelFormat() を参照してください。 |
| @seriesName | 系列名 |
例:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));「Qt Data Visualization データ処理」も参照してください 。
メンバタイプのドキュメント
enum QSurface3DSeries::DrawFlag
flags QSurface3DSeries::DrawFlags
サーフェスの描画モード。この列挙型の値は、OR演算子を用いて組み合わせることができます。
| 定数 | 値 | 説明 |
|---|---|---|
QSurface3DSeries::DrawWireframe | 1 | グリッドのみが描画されます。 |
QSurface3DSeries::DrawSurface | 2 | サーフェスのみが描画されます。 |
QSurface3DSeries::DrawSurfaceAndWireframe | DrawWireframe | DrawSurface | サーフェスとグリッドの両方が描画されます。 |
DrawFlags 型は、QFlags<DrawFlag> の typedef です。DrawFlag 値の OR 組み合わせを格納します。
プロパティのドキュメント
dataProxy : QSurfaceDataProxy*
このプロパティには、アクティブなデータプロキシが格納されます。
このシリーズは、自身に設定されたプロキシの所有権を取得し、新しいプロキシが追加されると、以前に設定されていたプロキシを削除します。プロキシは null または別のシリーズに設定することはできません。
アクセス関数：
| QSurfaceDataProxy * | dataProxy() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
通知シグナル：
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
drawMode : DrawFlags
描画モード。
有効な値は、DrawFlag の各値です。すべてのフラグをクリアすることはできません。
アクセス関数：
| QSurface3DSeries::DrawFlags | drawMode() const |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
通知シグナル：
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
flatShadingEnabled : bool
このプロパティは、サーフェス・フラットシェーディングが有効かどうかを指定します。
デフォルトでは「true 」に設定されています。
無効にすると、サーフェスの法線が補間され、エッジが丸く見えます。有効にすると、1つの三角形内の法線は一定に保たれ、三角形の色が一様になります。これにより、モデルからのデータがより読みやすくなります。
注：フラットシェーディングされた サーフェスには、GL_EXT_gpu_shader4 拡張機能を備えた GLSL バージョン 1.2 以上が必要です。flatShadingSupported プロパティの値は、実行時にフラットシェーディングがサポートされているかどうかを示します。
アクセス関数：
| bool | isFlatShadingEnabled() const |
| void | setFlatShadingEnabled(bool enabled) |
通知シグナル：
| void | flatShadingEnabledChanged(bool enable) |
[read-only] flatShadingSupported : bool
このプロパティは、現在のシステムがサーフェス・フラットシェーディングをサポートしているかどうかを示します。
サーフェスのフラットシェーディングには、GL_EXT_gpu_shader4 拡張機能を備えた GLSL バージョン 1.2 以上が必要です。true の場合、サーフェスのフラットシェーディングがサポートされています。
注：この 読み取り専用プロパティは、最初のレンダリングパス終了後に正しい値に設定されます。それまでは常にtrue となります。
アクセス関数：
| bool | isFlatShadingSupported() const |
通知シグナル：
| void | flatShadingSupportedChanged(bool enable) |
selectedPoint : QPoint
このプロパティには、シリーズ内で選択されている表面グリッド点が格納されます。
アクセス関数：
| QPoint | selectedPoint() const |
| void | setSelectedPoint(const QPoint &position) |
通知信号:
| void | selectedPointChanged(const QPoint &position) |
texture : QImage
このプロパティは、サーフェスのテクスチャをQImage として保持します。
QImage を空に設定すると、テクスチャがクリアされます。
アクセス関数：
| QImage | texture() const |
| void | setTexture(const QImage &texture) |
通知シグナル:
| void | textureChanged(const QImage &image) |
textureFile : QString
このプロパティは、サーフェスのテクスチャをファイルとして保持します。
ファイル名を空に設定すると、テクスチャがクリアされます。
アクセス関数：
| QString | textureFile() const |
| void | setTextureFile(const QString &filename) |
通知シグナル：
| void | textureFileChanged(const QString &filename) |
[since 6.3] wireframeColor : QColor
このプロパティは、サーフェスのワイヤーフレームの色を指定します。
この列挙型は Qt 6.3 で導入されました。
アクセス関数：
| QColor | wireframeColor() const |
| void | setWireframeColor(const QColor &color) |
Notifierシグナル:
| void | wireframeColorChanged(const QColor &color) |
メンバ関数のドキュメント
[explicit] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
親オブジェクトparent を使用して、サーフェスの3Dシリーズを構築します。
[explicit] QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
データプロキシ `dataProxy ` および親 `parent` を使用して、サーフェスの 3D シリーズを構築します。
[virtual noexcept] QSurface3DSeries::~QSurface3DSeries()
サーフェスの3Dシリーズを削除します。
[static] QPoint QSurface3DSeries::invalidSelectionPosition()
無効な選択位置を示すQPoint を返します。この値はselectedPoint プロパティに設定することで、このシリーズから選択を解除します。
QAbstract3DGraph::clearSelection()も参照してください 。
void QSurface3DSeries::setSelectedPoint(const QPoint &position)
行と列で指定された系列のデータ配列内の、位置position にある表面グリッド点を選択します。
一度に選択できる点は1つだけです。
この系列から選択を解除するには、invalidSelectionPosition() をposition に設定します。この系列がグラフに追加されている場合、グラフはユーザーの操作に応じて、または選択が無効になった場合に、選択内容を調整することができます。
選択されたポイントの行の前後から行を削除したり、行を挿入したりすると、選択範囲が調整され、同じポイントが選択されたままになります。
注： プロパティ `selectedPoint`のセッター 関数です。
関連項目: selectedPoint() およびQAbstract3DGraph::clearSelection()。
© 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.
