QSurface3DSeries Class
QSurface3DSeries クラスは、3D サーフェスグラフのデータ系列を表します。詳細...
| ヘッダー | #include <QSurface3DSeries> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake | QT += graphs |
| QML で | Surface3DSeries |
| 継承： | QAbstract3DSeries |
- 継承メンバを含む全メンバのリスト
- QSurface3DSeries はQt Graphs C++ Classes for 3D に含まれます。
パブリックタイプ
プロパティ
|
|
パブリック機能
| QSurface3DSeries(QObject *parent = nullptr) | |
| QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QSurface3DSeries() override |
| void | clearArray() |
| void | clearRow(qsizetype rowIndex) |
| QSurfaceDataArray | dataArray() && |
| const QSurfaceDataArray & | dataArray() const & |
| QSurfaceDataProxy * | dataProxy() const |
| QSurface3DSeries::DrawFlags | drawMode() const |
| bool | isFlatShadingSupported() const |
| QPoint | selectedPoint() const |
| void | setDataArray(const QSurfaceDataArray &newDataArray) |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
| void | setSelectedPoint(QPoint position) |
| void | setShading(const QSurface3DSeries::Shading shading) |
| void | setTexture(const QImage &texture) |
| void | setTextureFile(const QString &filename) |
| void | setWireframeColor(QColor color) |
| QSurface3DSeries::Shading | shading() const |
| QImage | texture() const |
| QString | textureFile() const |
| QColor | wireframeColor() const |
シグナル
| void | dataArrayChanged(const QSurfaceDataArray &array) |
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
| void | flatShadingSupportedChanged(bool enabled) |
| void | selectedPointChanged(QPoint position) |
| void | shadingChanged(const QSurface3DSeries::Shading shading) |
| void | textureChanged(const QImage &image) |
| void | textureFileChanged(const QString &filename) |
| void | wireframeColorChanged(QColor color) |
静的パブリックメンバ
| QPoint | invalidSelectionPosition() |
詳細説明
このクラスは、シリーズ固有のビジュアル要素と、（データプロキシを介した）シリーズデータを管理します。
プロキシとシリーズの関係については、いくつかの重要なポイントを強調することが重要です。このコンテキストでは、データは系列に格納され、ユーザは系列を通してデータセットにアクセスできる。この系列はプロキシオブジェクトによって制御または表現される。したがって、このプロキシを使って、データに対する様々な操作を管理し、実際のデータセットを更新することができる。ただし、データセットを編集するには、このプロキシに関連付けられた系列を作成する必要がある。
シリーズに明示的にデータプロキシが設定されていない場合、シリーズはデフォルトのプロキシを作成する。別のプロキシを設定すると、既存のプロキシとシリーズに追加されたすべてのデータが破壊される。
QAbstract3DSeries::mesh プロパティで設定されたオブジェクトメッシュは、サーフェスシリーズの選択ポインタ形状を定義します。
QSurface3DSeriesは、QAbstract3DSeries::setItemLabelFormat()で以下のフォーマットタグをサポートしています：
| xTitle | x 軸からのタイトル |
| yTitle | y 軸からのタイトル |
| zTitle | z軸からのタイトル |
| xLabel | x軸のフォーマットでフォーマットされた項目値。詳細については、QValue3DAxis::labelFormat を参照。 |
| yLabel | y 軸のフォーマットを使用してフォーマットされた項目値。詳細はQValue3DAxis::labelFormat を参照。 |
| zLabel | z 軸のフォーマットでフォーマットされた項目値。詳細はQValue3DAxis::labelFormat を参照。 |
| シリーズ名 | シリーズの名前。 |
例えば：
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Qt Graphs 3Dによるデータ処理も参照のこと 。
メンバ型ドキュメント
enum QSurface3DSeries::DrawFlag
flags QSurface3DSeries::DrawFlags
サーフェスの描画モード。この列挙の値は OR 演算子と組み合わせることができます。
| 定数 | 値 | 説明 |
|---|---|---|
QSurface3DSeries::DrawWireframe | 1 | グリッドのみが描画されます。 |
QSurface3DSeries::DrawSurface | 2 | サーフェスのみが描画される。 |
QSurface3DSeries::DrawSurfaceAndWireframe | DrawWireframe | DrawSurface | サーフェスとグリッドの両方が描画される。 |
DrawFlags型はQFlags<DrawFlag>のtypedefである。DrawFlagの値のORの組み合わせを格納する。
プロパティ・ドキュメント
dataArray : QSurfaceDataArray
シリーズのデータ配列。
データ配列の参照を保持する。
dataArrayChanged シグナルは、データ配列が設定されたときに発行される。ただし、newDataArray が前のものと同一である場合を除く。
注： dataArrayに関して何かを行う前に、関連するプロキシに対してシリーズを作成する必要があります。
アクセス関数：
| const QSurfaceDataArray & | dataArray() const & |
| QSurfaceDataArray | dataArray() && |
| void | setDataArray(const QSurfaceDataArray &newDataArray) |
通知シグナル：
| void | dataArrayChanged(const QSurfaceDataArray &array) |
clearRow(qsizetype rowIndex) およびclearArray()も参照のこと 。
dataProxy : QSurfaceDataProxy*
このプロパティは、アクティブなデータプロキシを保持する。
この系列は、その系列に設定されているプロキシの所有権を引き受け、新しいプロキシが追加されると、以前に設定されていたプロキシは削除される。プロキシをNULLにしたり、他の系列に設定したりすることはできません。
アクセス関数：
| QSurfaceDataProxy * | dataProxy() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
通知シグナル：
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
drawMode : QSurface3DSeries::DrawFlags
描画モード。
設定可能な値は、DrawFlag の値である。 すべてのフラグをクリアすることはできない。
アクセス関数：
| QSurface3DSeries::DrawFlags | drawMode() const |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
通知シグナル：
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
[read-only] flatShadingSupported : const bool
このプロパティは、サーフェスのフラットシェーディングが現在のシステムでサポートされているかどうかを保持します。
サーフェスのフラットシェーディングには、少なくともGL_EXT_gpu_shader4エクステンションを持つGLSLバージョン1.2が必要です。true の場合、サーフェスのフラットシェーディングがサポートされます。
注意： この読み取り専用プロパティは、最初のレンダーパスの後に正しい値に設定されます。それまでは常にtrue です。
アクセス関数：
| bool | isFlatShadingSupported() const |
通知シグナル：
| void | flatShadingSupportedChanged(bool enabled) |
selectedPoint : QPoint
このプロパティは、シリーズで選択されているサーフェスグリッドポイントを保持する。
行と列で指定されたシリーズのデータ配列の位置position にある面格子点を選択する。
一度に選択できる点は1点のみです。
この系列から選択を解除するには、invalidSelectionPosition() をposition とする。この系列がグラフに追加された場合、グラフはユーザーの操作に応じて、あるいは無効となった場合に選択を調整することができる。
選択されたポイントの行の前に系列から行を削除したり、系列に行を挿入したりすると、同じポイントが選択されたままになるように選択が調整される。
アクセス機能
| QPoint | selectedPoint() const |
| void | setSelectedPoint(QPoint position) |
通知シグナル：
| void | selectedPointChanged(QPoint position) |
Q3DGraphsWidgetItem::clearSelection()も参照のこと 。
shading : QSurface3DSeries::Shading
このプロパティは、サーフェスフラットシェーディングが有効かどうかを保持する。
デフォルトではQSurface3DSeries::Shading::Flat に設定されています。
無効の場合、サーフェスの法線は補間され、エッジが丸く見えます。可視の場合、法線は三角形上で同じまま保たれ、三角形の色はベタになります。これにより、モデルからデータがより読みやすくなります。
注意： フラットシェーディングサーフェスには、少なくともGL_EXT_gpu_shader4エクステンションを持つGLSLバージョン1.2が必要です。flatShadingSupported プロパティの値は、実行時にフラットシェーディングがサポートされているかどうかを示します。
アクセス関数
| QSurface3DSeries::Shading | shading() const |
| void | setShading(const QSurface3DSeries::Shading shading) |
通知シグナル：
| void | shadingChanged(const QSurface3DSeries::Shading shading) |
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) |
wireframeColor : QColor
このプロパティは、サーフェスワイヤーフレームの色を保持する。
アクセス関数
| QColor | wireframeColor() const |
| void | setWireframeColor(QColor color) |
通知シグナル
| void | wireframeColorChanged(QColor color) |
メンバ関数ドキュメント
[explicit] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
サーフェス 3D 系列を親parent で構築する。
[explicit] QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
データプロキシdataProxy と親parent でサーフェス 3D 系列を構築する。
[override virtual noexcept] QSurface3DSeries::~QSurface3DSeries()
サーフェス3Dシリーズを削除する。
void QSurface3DSeries::clearArray()
既存の配列をクリアする。
void QSurface3DSeries::clearRow(qsizetype rowIndex)
与えられたrowIndex に従って、配列の既存の行をクリアします。
[static] QPoint QSurface3DSeries::invalidSelectionPosition()
無効な選択位置を示すQPoint を返す。これをselectedPoint プロパティに設定すると、このシリーズからの選択が解除されます。
Q3DGraphsWidgetItem::clearSelection()も参照してください 。
© 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.
