QSurface3DSeries Class
QSurface3DSeries クラスは、3D サーフェスグラフのデータ系列を表します。詳細...
| Header: | #include <QSurface3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.0 |
| In QML: | Surface3DSeries |
| Inherits: | 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() を参照。 |
| シリーズ名 | 系列の名前。 |
例えば：
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 に設定されています。
無効にすると、サーフェスの法線が補間され、エッジが丸く見えます。有効にすると、法線は三角形上で同じまま保たれ、三角形の色はベタになります。これにより、モデルからデータがより読みやすくなります。
注意： フラットシェーディングサーフェスには、少なくともGLSLバージョン1.2とGL_EXT_gpu_shader4エクステンションが必要です。flatShadingSupported プロパティの値は、実行時にフラットシェーディングがサポートされているかどうかを示します。
アクセス関数
| bool | isFlatShadingEnabled() const |
| void | setFlatShadingEnabled(bool enabled) |
Notifier シグナル：
| void | flatShadingEnabledChanged(bool enable) |
[read-only] flatShadingSupported : const 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) |
通知シグナル
| void | wireframeColorChanged(const QColor &color) |
メンバ関数ドキュメント
[explicit] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
サーフェス 3D シリーズを親parent と共に構築します。
[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()も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
