QAbstract3DGraph Class
QAbstract3DGraph クラスは、グラフ用のウィンドウとレンダリングループを提供します。詳細...
| ヘッダー: | #include <QAbstract3DGraph> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| バージョン: | QtDataVisualization 1.0 |
| 継承元： | QWindow およびQOpenGLFunctions （protected） |
| 継承元: | |
| ステータス: | 非推奨 |
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
パブリック型
(since QtDataVisualization 1.1) enum | ElementType { ElementNone, ElementSeries, ElementAxisXLabel, ElementAxisYLabel, ElementAxisZLabel, ElementCustomItem } |
(since Qt Data Visualization 1.1) enum | OptimizationHint { OptimizationDefault, OptimizationStatic } |
| flags | OptimizationHints |
| enum | SelectionFlag { SelectionNone, SelectionItem, SelectionRow, SelectionItemAndRow, SelectionColumn, …, SelectionMultiSeries } |
| flags | SelectionFlags |
| enum | ShadowQuality { ShadowQualityNone, ShadowQualityLow, ShadowQualityMedium, ShadowQualityHigh, ShadowQualitySoftLow, …, ShadowQualitySoftHigh } |
プロパティ
|
|
パブリック関数
| virtual | ~QAbstract3DGraph() |
| QAbstract3DInputHandler * | activeInputHandler() const |
| Q3DTheme * | activeTheme() const |
(since QtDataVisualization 1.1) int | addCustomItem(QCustom3DItem *item) |
| void | addInputHandler(QAbstract3DInputHandler *inputHandler) |
| void | addTheme(Q3DTheme *theme) |
| qreal | aspectRatio() const |
| void | clearSelection() |
| qreal | currentFps() const |
(since QtDataVisualization 1.2) QList<QCustom3DItem *> | customItems() const |
| bool | hasContext() const |
(since 6.3) bool | hasSeries(QAbstract3DSeries *series) const |
| qreal | horizontalAspectRatio() const |
| QList<QAbstract3DInputHandler *> | inputHandlers() const |
| bool | isOrthoProjection() const |
| bool | isPolar() const |
| bool | isReflection() const |
| QLocale | locale() const |
| qreal | margin() const |
| bool | measureFps() const |
| QAbstract3DGraph::OptimizationHints | optimizationHints() const |
| QVector3D | queriedGraphPosition() const |
| float | radialLabelOffset() const |
| qreal | reflectivity() const |
(since QtDataVisualization 1.1) void | releaseCustomItem(QCustom3DItem *item) |
| void | releaseInputHandler(QAbstract3DInputHandler *inputHandler) |
| void | releaseTheme(Q3DTheme *theme) |
(since QtDataVisualization 1.1) void | removeCustomItem(QCustom3DItem *item) |
(since QtDataVisualization 1.1) void | removeCustomItemAt(const QVector3D &position) |
(since QtDataVisualization 1.1) void | removeCustomItems() |
(since QtDataVisualization 1.1) QImage | renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize()) |
| Q3DScene * | scene() const |
(since QtDataVisualization 1.1) QAbstract3DAxis * | selectedAxis() const |
(since QtDataVisualization 1.1) QCustom3DItem * | selectedCustomItem() const |
(since QtDataVisualization 1.1) int | selectedCustomItemIndex() const |
| QAbstract3DGraph::ElementType | selectedElement() const |
(since QtDataVisualization 1.1) int | selectedLabelIndex() const |
| QAbstract3DGraph::SelectionFlags | selectionMode() const |
| void | setActiveInputHandler(QAbstract3DInputHandler *inputHandler) |
| void | setActiveTheme(Q3DTheme *theme) |
| void | setAspectRatio(qreal ratio) |
| void | setHorizontalAspectRatio(qreal ratio) |
| void | setLocale(const QLocale &locale) |
| void | setMargin(qreal margin) |
| void | setMeasureFps(bool enable) |
| void | setOptimizationHints(QAbstract3DGraph::OptimizationHints hints) |
| void | setOrthoProjection(bool enable) |
| void | setPolar(bool enable) |
| void | setRadialLabelOffset(float offset) |
| void | setReflection(bool enable) |
| void | setReflectivity(qreal reflectivity) |
| void | setSelectionMode(QAbstract3DGraph::SelectionFlags mode) |
| void | setShadowQuality(QAbstract3DGraph::ShadowQuality quality) |
| QAbstract3DGraph::ShadowQuality | shadowQuality() const |
| virtual bool | shadowsSupported() const |
| QList<Q3DTheme *> | themes() const |
シグナル
| void | activeInputHandlerChanged(QAbstract3DInputHandler *inputHandler) |
| void | activeThemeChanged(Q3DTheme *theme) |
| void | aspectRatioChanged(qreal ratio) |
| void | currentFpsChanged(qreal fps) |
| void | horizontalAspectRatioChanged(qreal ratio) |
| void | localeChanged(const QLocale &locale) |
| void | marginChanged(qreal margin) |
| void | measureFpsChanged(bool enabled) |
| void | optimizationHintsChanged(QAbstract3DGraph::OptimizationHints hints) |
| void | orthoProjectionChanged(bool enabled) |
| void | polarChanged(bool enabled) |
| void | queriedGraphPositionChanged(const QVector3D &data) |
| void | radialLabelOffsetChanged(float offset) |
| void | reflectionChanged(bool enabled) |
| void | reflectivityChanged(qreal reflectivity) |
| void | selectedElementChanged(QAbstract3DGraph::ElementType type) |
| void | selectionModeChanged(QAbstract3DGraph::SelectionFlags mode) |
| void | shadowQualityChanged(QAbstract3DGraph::ShadowQuality quality) |
関連する非メンバー関数
| QSurfaceFormat | qDefaultSurfaceFormat(bool antialias) |
詳細な説明
このクラスはQWindow を継承しており、これを継承するグラフに対してレンダリングループを提供します。
このクラスを直接使用する必要はなく、そのサブクラスのいずれかを使用してください。
C++ では、デフォルトでアンチエイリアシングが有効になっていますが、OpenGL ES2 環境では、Qt Data Visualization がアンチエイリアシングをサポートしていないため、この限りではありません。グラフに対してデフォルト以外のアンチエイリアシングを指定するには、コンストラクタのパラメータとしてカスタムサーフェスフォーマットを指定してください。サーフェスフォーマットオブジェクトの作成には、便利関数 `qDefaultSurfaceFormat() ` を使用できます。
注: QAbstract3DGraph は 、デフォルトでウィンドウフラグQt::FramelessWindowHint をオンに設定します。グラフウィンドウを通常のウィンドウフレームを持つ独立したウィンドウとして表示したい場合は、グラフの構築後にこのフラグをクリアしてください。例:
関連項目: Q3DBars 、Q3DScatter 、Q3DSurface 、および Qt Data Visualization C++ Classes。
メンバ型のドキュメント
[since QtDataVisualization 1.1] enum QAbstract3DGraph::ElementType
グラフ内の要素の種類。
| 定数 | 値 | 説明 |
|---|---|---|
QAbstract3DGraph::ElementNone | 0 | 定義されていない要素。 |
QAbstract3DGraph::ElementSeries | 1 | 系列（つまり、系列内の項目）。 |
QAbstract3DGraph::ElementAxisXLabel | 2 | x 軸のラベル。 |
QAbstract3DGraph::ElementAxisYLabel | 3 | y 軸のラベル。 |
QAbstract3DGraph::ElementAxisZLabel | 4 | z軸のラベル。 |
QAbstract3DGraph::ElementCustomItem | 5 | カスタム項目。 |
この列挙型は、QtDataVisualization 1.1で導入されました。
[since Qt Data Visualization 1.1] enum QAbstract3DGraph::OptimizationHint
flags QAbstract3DGraph::OptimizationHints
レンダリングに関する最適化のヒント。
| 定数 | 値 | 説明 |
|---|---|---|
QAbstract3DGraph::OptimizationDefault | 0 | 妥当なパフォーマンスで全機能セットを提供します。 |
QAbstract3DGraph::OptimizationStatic | 1 | 一部の機能を犠牲にして、静的なデータセットのレンダリングを最適化します。 |
この列挙型は、Qt Data Visualization 1.1 で導入されました。
OptimizationHints 型は、QFlags<OptimizationHint> の typedef です。OptimizationHint 値の論理和（OR）を格納します。
enum QAbstract3DGraph::SelectionFlag
flags QAbstract3DGraph::SelectionFlags
項目の選択モード。この列挙型の値は、OR演算子で組み合わせることができます。
| 定数 | 値 | 説明 |
|---|---|---|
QAbstract3DGraph::SelectionNone | 0 | 選択モードが無効です。 |
QAbstract3DGraph::SelectionItem | 1 | 選択により、1 つの項目が強調表示されます。 |
QAbstract3DGraph::SelectionRow | 2 | 選択時に 1 つの行が強調表示されます。 |
QAbstract3DGraph::SelectionItemAndRow | SelectionItem | SelectionRow | 項目と行の両方を異なる色で強調表示するための組み合わせフラグ。 |
QAbstract3DGraph::SelectionColumn | 4 | 選択により、1つの列がハイライトされます。 |
QAbstract3DGraph::SelectionItemAndColumn | SelectionItem | SelectionColumn | 項目と列の両方を異なる色でハイライト表示するための組み合わせフラグ。 |
QAbstract3DGraph::SelectionRowAndColumn | SelectionRow | SelectionColumn | 行と列の両方を異なる色で強調表示するための組み合わせフラグ。 |
QAbstract3DGraph::SelectionItemRowAndColumn | SelectionItem | SelectionRow | SelectionColumn | 項目、行、列をすべて強調表示するための組み合わせフラグ。 |
QAbstract3DGraph::SelectionSlice | 8 | このモードフラグを設定すると、グラフがスライスビューの処理を自動的に行うようになります。 Q3DScene を使用してスライスビューを自分で制御したい場合は、このフラグを設定しないでください。このモードフラグを設定する場合、SelectionRow またはSelectionColumn のいずれかを設定する必要がありますが、両方を設定してはいけません。スライス機能は、Q3DBars および Q3DSurface でのみサポートされています。このフラグが設定されている場合、以下の状況でスライスモードに入ります：
|
QAbstract3DGraph::SelectionMultiSeries | 16 | このモードを設定すると、選択された項目のみではなく、同じ位置にあるすべてのシリーズの項目がハイライト表示されます。他のシリーズにおける実際の選択状態は変更されません。このモードフラグを設定する際は、基本選択フラグ（SelectionItem 、SelectionRow 、またはSelectionColumn ）のうち1つ以上も設定する必要があります。Q3DScatterでは、複数シリーズの選択はサポートされていません。 |
SelectionFlags 型は、QFlags<SelectionFlag> の typedef です。これは、SelectionFlag 値の論理和（OR）の組み合わせを格納します。
enum QAbstract3DGraph::ShadowQuality
影の質。
| 定数 | 値 | 説明 |
|---|---|---|
QAbstract3DGraph::ShadowQualityNone | 0 | 影が無効になります。 |
QAbstract3DGraph::ShadowQualityLow | 1 | 影は低品質でレンダリングされます。 |
QAbstract3DGraph::ShadowQualityMedium | 2 | 影は中程度の品質でレンダリングされます。 |
QAbstract3DGraph::ShadowQualityHigh | 3 | 影が高品質でレンダリングされます。 |
QAbstract3DGraph::ShadowQualitySoftLow | 4 | 影は低品質で、エッジがぼかされてレンダリングされます。 |
QAbstract3DGraph::ShadowQualitySoftMedium | 5 | 影は、エッジを滑らかにした中品質でレンダリングされます。 |
QAbstract3DGraph::ShadowQualitySoftHigh | 6 | 影は、エッジを滑らかにした高画質でレンダリングされます。 |
プロパティのドキュメント
activeInputHandler : QAbstract3DInputHandler*
このプロパティには、グラフで使用されているアクティブな入力ハンドラが格納されます。
アクセス関数：
| QAbstract3DInputHandler * | activeInputHandler() const |
| void | setActiveInputHandler(QAbstract3DInputHandler *inputHandler) |
通知シグナル:
| void | activeInputHandlerChanged(QAbstract3DInputHandler *inputHandler) |
activeTheme : Q3DTheme*
このプロパティは、グラフのアクティブなテーマを保持します。
アクセス関数：
| Q3DTheme * | activeTheme() const |
| void | setActiveTheme(Q3DTheme *theme) |
通知シグナル:
| void | activeThemeChanged(Q3DTheme *theme) |
[since QtDataVisualization 1.1] aspectRatio : qreal
このプロパティは、水平面上の最長軸とy軸との間のグラフのスケーリング比率を保持します。
デフォルト値は2.0 です。
注： Q3DBars には影響しません 。
この列挙型は、QtDataVisualization 1.1で導入されました。
アクセス関数：
| qreal | aspectRatio() const |
| void | setAspectRatio(qreal ratio) |
通知シグナル:
| void | aspectRatioChanged(qreal ratio) |
horizontalAspectRatioも参照してください 。
[read-only, since QtDataVisualization 1.1] currentFps : qreal
このプロパティには、過去1秒間のレンダリング結果が格納されます。
FPS測定が有効になっている場合、結果はこの読み取り専用プロパティに格納されます。測定が有効になってから、この値が更新されるまでには少なくとも1秒かかります。
この列挙型は、QtDataVisualization 1.1 で導入されました。
アクセス関数：
| qreal | currentFps() const |
Notifierシグナル:
| void | currentFpsChanged(qreal fps) |
関連項目: measureFps 。
[since QtDataVisualization 1.2] horizontalAspectRatio : qreal
このプロパティは、x軸とz軸間のグラフのスケーリング比率を指定します。
0.0 の値は、軸の範囲に応じて自動的にスケーリングが行われることを示します。デフォルトは0.0 です。
Q3DBars には影響しません。Q3DBars では、barThickness およびbarSpacing プロパティを使用して水平方向のスケーリングを処理します。極座標グラフもこのプロパティを無視します。
この列挙型は、QtDataVisualization 1.2で導入されました。
アクセス関数:
| qreal | horizontalAspectRatio() const |
| void | setHorizontalAspectRatio(qreal ratio) |
Notifierシグナル:
| void | horizontalAspectRatioChanged(qreal ratio) |
関連項目： aspectRatio 、polar 、Q3DBars::barThickness 、およびQ3DBars::barSpacingを参照してください 。
[since QtDataVisualization 1.2] locale : QLocale
このプロパティは、さまざまな数値ラベルの書式設定に使用されるロケールを保持します。
デフォルトは「"C" 」ロケールです。
この列挙型は、QtDataVisualization 1.2で導入されました。
アクセス関数:
| QLocale | locale() const |
| void | setLocale(const QLocale &locale) |
通知シグナル:
| void | localeChanged(const QLocale &locale) |
「QValue3DAxis::labelFormat」も参照してください 。
[since QtDataVisualization 1.2] margin : qreal
このプロパティは、プロット可能なグラフ領域の端とグラフの背景の端との間に残す余白の絶対値を保持します。
マージンの値が負の場合、マージンは自動的に決定され、系列内の項目のサイズやグラフの種類に応じて変化することがあります。グラフのアスペクト比がデフォルト値から変更されていない場合、この値は Y 軸範囲に対する割合として解釈されます。デフォルト値は `-1.0` です。
注： 散布図の余白を、自動的に決定される余白よりも小さく設定すると 、グラフの端にある散布点がグラフの背景と重なってしまうことがあります。
注： 散布図 およびサーフェスグラフにおいて 、マージンが軸ラベルのサイズに比べて小さい場合、隣接する軸の端のラベルとの重なりを避けるために、軸の端のラベルの位置が調整されます。
この列挙型は、QtDataVisualization 1.2 で導入されました。
アクセス関数：
| qreal | margin() const |
| void | setMargin(qreal margin) |
Notifier シグナル：
| void | marginChanged(qreal margin) |
[since QtDataVisualization 1.1] measureFps : bool
このプロパティは、レンダリングがオンデマンドではなく継続的に行われるかどうかを指定します。
true の場合、レンダリングは連続的に行われ、currentFps プロパティの値が更新されます。デフォルトはfalse です。
この列挙型は、QtDataVisualization 1.1で導入されました。
アクセス関数：
| bool | measureFps() const |
| void | setMeasureFps(bool enable) |
Notifierシグナル:
| void | measureFpsChanged(bool enabled) |
currentFpsも参照してください 。
optimizationHints : OptimizationHints
このプロパティは、レンダリングの最適化にデフォルトモードとスタティックモードのどちらが使用されるかに関係なく有効です。
デフォルトモードでは、妥当なパフォーマンスレベルで全機能を利用できます。静的モードはグラフのレンダリングを最適化するため、変更のない大規模なデータセットに最適です。ただし、動的なデータ変更や項目の回転を行う場合は処理速度が低下します。選択操作は最適化されていないため、大規模なデータセットで静的モードを使用することは推奨されません。 静的最適化は散布図でのみ機能します。デフォルトはOptimizationDefault です。
注：一部の環境では 、静的最適化を使用した大規模なグラフがレンダリングされない場合があります。これは、すべてのアイテムが単一のドローコールでレンダリングされるためであり、グラフィックドライバによって1回の呼び出しあたりの最大頂点数が異なるためです。この問題は主に32ビットおよびOpenGL ES2プラットフォームで発生します。 この問題を回避するには、頂点数の少ないアイテムメッシュを選択するか、ポイントメッシュを使用してください。
アクセス関数：
| QAbstract3DGraph::OptimizationHints | optimizationHints() const |
| void | setOptimizationHints(QAbstract3DGraph::OptimizationHints hints) |
通知シグナル：
| void | optimizationHintsChanged(QAbstract3DGraph::OptimizationHints hints) |
関連項目： QAbstract3DSeries::mesh 。
[since QtDataVisualization 1.1] orthoProjection : bool
このプロパティは、グラフの表示に正投影が使用されるかどうかを指定します。
デフォルトはfalse です。
注： true に設定すると、影 は無効になります。
この列挙型は、QtDataVisualization 1.1で導入されました。
アクセス関数:
| bool | isOrthoProjection() const |
| void | setOrthoProjection(bool enable) |
通知シグナル:
| void | orthoProjectionChanged(bool enabled) |
QAbstract3DAxis::labelAutoRotation およびQ3DCamera::cameraPresetも参照してください 。
[since QtDataVisualization 1.2] polar : bool
この特性は、横軸が極座標軸に変更された場合でも維持されます。
true の場合、x軸は角度軸となり、z軸は半径軸となります。棒グラフでは極座標モードは使用できません。
デフォルトはfalse です。
この列挙型は、QtDataVisualization 1.2で導入されました。
アクセス関数:
| bool | isPolar() const |
| void | setPolar(bool enable) |
通知シグナル:
| void | polarChanged(bool enabled) |
orthoProjection およびradialLabelOffsetも参照してください 。
[read-only, since QtDataVisualization 1.2] queriedGraphPosition : QVector3D
このプロパティには、各軸に沿った最新のグラフ位置のクエリ結果が格納されます。
この読み取り専用プロパティには、Q3DScene::graphPositionQuery の結果が含まれます。値は[-1, 1] の範囲に正規化されます。クエリされた位置がグラフの境界外にある場合、値は実際の位置を反映せず、代わりに[-1, 1] の範囲外の未定義の位置を示します。クエリが行われるまで、値は未定義のままとなります。
特定の画面位置に対応する唯一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む見えないボックスの内側を基準に行われます。
注：棒グラフでは 、グラフの底面レベルでのみ位置の照会が可能であるため、棒グラフの y 値は常に 0 となり、有効な照会はグラフの底面を含む画面位置でのみ行うことができます。
この列挙型は、QtDataVisualization 1.2 で導入されました。
アクセス関数：
| QVector3D | queriedGraphPosition() const |
Notifier シグナル：
| void | queriedGraphPositionChanged(const QVector3D &data) |
Q3DScene::graphPositionQueryも参照してください 。
[since QtDataVisualization 1.2] radialLabelOffset : float
このプロパティは、放射状極座標軸の軸ラベルの正規化された水平オフセットを保持します。
値「0.0 」は、ラベルを角度軸の 0 度のグリッド線の隣に描画することを示します。値「1.0 」は、ラベルをグラフ背景の端にある通常の位置に描画することを示します。デフォルトは「1.0 」です。
polar プロパティの値がfalse の場合、このプロパティは無視されます。
この列挙型は、QtDataVisualization 1.2 で導入されました。
アクセス関数：
| float | radialLabelOffset() const |
| void | setRadialLabelOffset(float offset) |
通知シグナル：
| void | radialLabelOffsetChanged(float offset) |
「polar」も参照してください 。
[since QtDataVisualization 1.2] reflection : bool
このプロパティは、床面反射を有効にするか無効にするかを指定します。
デフォルトはfalse です。
Q3DBarsにのみ影響します。ただし、正負両方の値を含むQ3DBarsグラフにおいて、床面と交差するカスタムアイテムの反射はサポートされていません。その場合は、誤ったレンダリングを防ぐために、反射を無効にする必要があります。
カスタムサーフェス形式を使用する場合、反射を機能させるには、ステンシルバッファを定義する必要があります (QSurfaceFormat::setStencilBufferSize())。
この列挙型は、QtDataVisualization 1.2で導入されました。
アクセス関数：
| bool | isReflection() const |
| void | setReflection(bool enable) |
通知シグナル:
| void | reflectionChanged(bool enabled) |
reflectivityも参照してください 。
[since QtDataVisualization 1.2] reflectivity : qreal
床の反射率。
数値が大きいほど、床の反射率が高くなります。有効範囲は[0...1] です。デフォルト値は0.5 です。
注： Q3DBarsにのみ影響します 。
この列挙型は、QtDataVisualization 1.2で導入されました。
アクセス関数：
| qreal | reflectivity() const |
| void | setReflectivity(qreal reflectivity) |
通知シグナル:
| void | reflectivityChanged(qreal reflectivity) |
関連項目： reflection 。
[read-only] scene : Q3DScene*
このプロパティには、シーンの操作や、アクティブなカメラなどのシーン要素へのアクセスに使用できる Q3DScene ポインタが格納されています。
このプロパティは読み取り専用です。
アクセス関数：
| Q3DScene * | scene() const |
[read-only, since QtDataVisualization 1.1] selectedElement : ElementType
このプロパティには、グラフで選択されている要素が格納されます。
このプロパティを使用すると、選択された要素のタイプを照会できます。このタイプは、グラフ内で新たな選択が行われ、「selectedElementChanged 」シグナルが発信されるまで有効です。
このシグナルは、たとえば「Scatter Graph 」タブにある「Graph Gallery」のサンプルで示されているように、カスタム入力ハンドラを実装するために使用できます。
この列挙型は、QtDataVisualization 1.1 で導入されました。
アクセス関数:
| QAbstract3DGraph::ElementType | selectedElement() const |
Notifier シグナル:
| void | selectedElementChanged(QAbstract3DGraph::ElementType type) |
関連項目: selectedLabelIndex()、selectedAxis()、selectedCustomItemIndex()、selectedCustomItem()、Q3DBars::selectedSeries()、Q3DScatter::selectedSeries()、Q3DSurface::selectedSeries()、およびQ3DScene::setSelectionQueryPosition()。
selectionMode : SelectionFlags
項目の選択モード。
SelectionFlags の組み合わせです。デフォルトでは、SelectionItem です。グラフの種類によって、サポートされる選択モードが異なります。
アクセス関数：
| QAbstract3DGraph::SelectionFlags | selectionMode() const |
| void | setSelectionMode(QAbstract3DGraph::SelectionFlags mode) |
通知シグナル：
| void | selectionModeChanged(QAbstract3DGraph::SelectionFlags mode) |
SelectionFlagsも参照してください 。
shadowQuality : ShadowQuality
このプロパティは、影の品質を指定します。
ShadowQuality 列挙型の値の1つです。デフォルトはShadowQualityMedium です。
注： シャドウの品質を特定のレベルに設定しようとして失敗した場合 、設定が成功するまでレベルが段階的に引き下げられます。変更が行われるたびに、shadowQualityChanged シグナルが発信されます。
アクセス関数：
| QAbstract3DGraph::ShadowQuality | shadowQuality() const |
| void | setShadowQuality(QAbstract3DGraph::ShadowQuality quality) |
通知シグナル:
| void | shadowQualityChanged(QAbstract3DGraph::ShadowQuality quality) |
「ShadowQuality」も参照してください 。
メンバ関数のドキュメント
[virtual noexcept] QAbstract3DGraph::~QAbstract3DGraph()
QAbstract3DGraph を削除します。
[since QtDataVisualization 1.1] int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)
item 型の QCustom3DItem をグラフに追加します。追加された項目の所有権はグラフが引き継ぎます。
追加操作が成功した場合は追加された項目のインデックスを返し、null の項目を追加しようとした場合は -1 を返し、すでに追加されている項目を追加しようとした場合はその項目のインデックスを返します。
アイテムは挿入された順序でレンダリングされます。不透明なアイテムと透明なアイテムを併用する場合は、このレンダリング順序を考慮する必要があります。
この関数は QtDataVisualization 1.1 で導入されました。
関連項目： removeCustomItems()、removeCustomItem()、removeCustomItemAt()、およびcustomItems()。
void QAbstract3DGraph::addInputHandler(QAbstract3DInputHandler *inputHandler)
指定されたinputHandler をグラフに追加します。addInputHandlerを介して追加された入力ハンドラは、直接使用されることはありません。inputHandler の所有権のみがグラフに引き継がれます。inputHandler はnullであってはならず、また他のグラフにすでに追加されていてもいけません。
releaseInputHandler() およびsetActiveInputHandler()も参照してください 。
void QAbstract3DGraph::addTheme(Q3DTheme *theme)
指定されたtheme をグラフに追加します。addThemeを介して追加されたテーマは、直接使用されるわけではありません。グラフにはテーマの所有権のみが渡されます。theme はnullであってはならず、また他のグラフにすでに追加されていてもいけません。
releaseTheme() およびsetActiveTheme()も参照してください 。
void QAbstract3DGraph::clearSelection()
すべての関連シリーズから選択内容を解除します。
[since QtDataVisualization 1.2] QList<QCustom3DItem *> QAbstract3DGraph::customItems() const
追加されたすべてのカスタム項目のリストを返します。
この関数は、QtDataVisualization 1.2 で導入されました。
addCustomItem()も参照してください 。
bool QAbstract3DGraph::hasContext() const
グラフの OpenGL コンテキストの初期化が正常に完了した場合、true を返します。コンテキストの初期化に失敗した状態でグラフを使用しようとすると、通常はクラッシュが発生します。コンテキストの初期化が失敗する一般的な原因として、プラットフォームによる OpenGL のサポートが不十分であることが挙げられます。
[since 6.3] bool QAbstract3DGraph::hasSeries(QAbstract3DSeries *series) const
series がすでにグラフに追加されているかどうかを返します。
この関数は Qt 6.3 で導入されました。
QList<QAbstract3DInputHandler *> QAbstract3DGraph::inputHandlers() const
追加されたすべての入力ハンドラのリストを返します。
addInputHandler()も参照してください 。
[since QtDataVisualization 1.1] void QAbstract3DGraph::releaseCustomItem(QCustom3DItem *item)
指定されたitem の所有権を取り戻し、グラフからitem を削除します。
注： 同じアイテムをグラフに再度追加する場合 、テクスチャまたはテクスチャファイルを再設定する必要があります。
この関数は QtDataVisualization 1.1 で導入されました。
QCustom3DItem::setTextureImage() およびQCustom3DItem::setTextureFile()も参照してください 。
void QAbstract3DGraph::releaseInputHandler(QAbstract3DInputHandler *inputHandler)
inputHandler が本グラフに追加されていた場合、その所有権を呼び出し元に返します。解放されたinputHandler が使用中の場合、この呼び出し後はアクティブな入力ハンドラは存在しなくなります。
デフォルトの入力ハンドラが解放され、後で再度追加された場合、その挙動は他の入力ハンドラと同様に動作します。
addInputHandler() およびsetActiveInputHandler()も参照してください 。
void QAbstract3DGraph::releaseTheme(Q3DTheme *theme)
theme が本グラフに追加されていた場合、その所有権を呼び出し元に返します。解放されたtheme が使用中の場合、新しいデフォルトテーマが作成され、アクティブに設定されます。
デフォルトテーマが解放され、後で再度追加された場合、そのテーマは他のテーマと同様に動作します。
addTheme() およびsetActiveTheme()も参照してください 。
[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItem(QCustom3DItem *item)
カスタムitem を削除します。それに割り当てられたリソースを解放します。
この関数は、QtDataVisualization 1.1 で導入されました。
[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItemAt(const QVector3D &position)
position にあるすべてのカスタム項目を削除します。それらに割り当てられたリソースも削除します。
この関数は、QtDataVisualization 1.1 で導入されました。
[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItems()
すべてのカスタム項目を削除します。それらに割り当てられていたリソースも削除します。
この関数は、QtDataVisualization 1.1で導入されました。
[since QtDataVisualization 1.1] QImage QAbstract3DGraph::renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize())
現在のフレームをimageSize の画像としてレンダリングします。デフォルトのサイズはウィンドウサイズです。画像は、msaaSamples で指定されたアンチエイリアシングレベルでレンダリングされます。デフォルトのレベルは0 です。
レンダリングされた画像を返します。
注：OpenGL ES2はアンチエイリアシングをサポートしていないため、msaaSamples は常に0 に強制されます。
この関数は、QtDataVisualization 1.1 で導入されました。
[since QtDataVisualization 1.1] QAbstract3DAxis *QAbstract3DGraph::selectedAxis() const
任意のラベルタイプでselectedElementChanged シグナルを受信した後、選択された軸を取得するために使用できます。選択は、次のselectedElementChanged シグナルが送信されるまで有効です。
選択された軸へのポインタ、またはnullを返します。
この関数は、QtDataVisualization 1.1 で導入されました。
selectedElementも参照してください 。
[since QtDataVisualization 1.1] QCustom3DItem *QAbstract3DGraph::selectedCustomItem() const
QAbstract3DGraph::ElementCustomItem 型のselectedElementChanged シグナルを受信した後、選択されたカスタムアイテムを取得するために使用できます。アイテムの所有権はグラフに残ります。選択は、次のselectedElementChanged シグナルが送信されるまで有効です。
選択されたカスタムアイテムへのポインタ、またはnullを返します。
この関数は、QtDataVisualization 1.1で導入されました。
selectedElementも参照してください 。
[since QtDataVisualization 1.1] int QAbstract3DGraph::selectedCustomItemIndex() const
QAbstract3DGraph::ElementCustomItem 型のselectedElementChanged 信号を受信した後、選択されたカスタム項目のインデックスを照会するために使用できます。選択は、次のselectedElementChanged 信号が送信されるまで有効です。
選択されたカスタム項目のインデックス、または -1 を返します。
この関数は、QtDataVisualization 1.1 で導入されました。
selectedElementも参照してください 。
[since QtDataVisualization 1.1] int QAbstract3DGraph::selectedLabelIndex() const
任意のラベルタイプで「selectedElementChanged 」信号を受信した後、選択されたラベルのインデックスを照会するために使用できます。選択は、次の「selectedElementChanged 」信号が送信されるまで有効です。
選択されたラベルのインデックス、または -1 を返します。
この関数は、QtDataVisualization 1.1で導入されました。
selectedElementも参照してください 。
void QAbstract3DGraph::setActiveInputHandler(QAbstract3DInputHandler *inputHandler)
inputHandler を、グラフで使用されるアクティブな入力ハンドラとして設定します。暗黙的にaddInputHandler() を呼び出し、inputHandler の所有権をこのグラフに移譲します。
inputHandler が null の場合、この呼び出しの後、アクティブな入力ハンドラは存在しなくなります。
注： プロパティactiveInputHandler のセッター 関数。
関連項目： activeInputHandler()、addInputHandler()、およびreleaseInputHandler()。
void QAbstract3DGraph::setActiveTheme(Q3DTheme *theme)
theme を、グラフで使用するアクティブなテーマとして設定します。暗黙的にaddTheme() を呼び出し、テーマの所有権をこのグラフに移します。
theme が null の場合、一時的なデフォルトのテーマが作成されます。この一時的なテーマは、後で何らかのテーマが明示的に設定されると破棄されます。テーマのプロパティは設定後でも変更可能であり、変更は即座に反映されます。
注： プロパティactiveTheme のセッター 関数。
関連項目:activeTheme()も参照してください 。
[virtual] bool QAbstract3DGraph::shadowsSupported() const
現在の設定でシャドウがサポートされている場合、true を返します。OpenGL ES2 の設定ではシャドウはサポートされていません。
QList<Q3DTheme *> QAbstract3DGraph::themes() const
追加されたすべてのテーマのリストを返します。
addTheme()も参照してください 。
関連する非メンバー
QSurfaceFormat qDefaultSurfaceFormat(bool antialias)
この便利関数を使用すると、Qt Data Visualization のグラフで使用するのに適したカスタムサーフェスフォーマットを作成できます。
antialias パラメータは、アンチエイリアシングを有効にするかどうかを指定します。
この関数が返すサーフェスフォーマットを、グラフコンストラクタ（C++）に渡すか、またはshow() を呼び出す前に、QQuickView のウィンドウフォーマットとして設定してください（QML）。
たとえば、C++ アプリケーションでアンチエイリアシングを無効にするには：
#include <QtDataVisualization/qutils.h>
// ...
Q3DBars *graph = new Q3DBars(qDefaultSurfaceFormat(false));例：QMLアプリケーションでダイレクトレンダリングモードのアンチエイリアシングを有効にするには：
#include <QtDataVisualization/qutils.h>
// ...
QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));注： OpenGL ES2 環境ではアンチエイリアシングは サポートされていません。
© 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.
