Back to Qt.io
Contact Us Blog Download Qt

QAbstract3DGraph Class

QAbstract3DGraphクラスは、グラフのウィンドウとレンダリングループを提供します。詳細...

Header: #include <QAbstract3DGraph>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Since: QtDataVisualization 1.0
Inherits: QWindow and QOpenGLFunctions (protected)
Inherited By:

Q3DBars, Q3DScatter, and Q3DSurface

パブリックタイプ

(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 をサブクラス化し、それを継承したグラフのレンダリングループを提供する。

このクラスを直接使用する必要はなく、サブクラスのいずれかを使用してください。

アンチエイリアスは、OpenGL ES2 環境を除き、C++ ではデフォルトでオンになっています。グラフにデフォルト以外のアンチエイリアスを指定するには、コンストラクタのパラメータにカスタムサーフェスフォーマットを指定します。サーフェスフォーマットオブジェクトを作成するには、便利な関数qDefaultSurfaceFormat() を使用します。

注： QAbstract3DGraphは、デフォルトでウィンドウフラグQt::FramelessWindowHint をオンに設定します。グラフ・ウィンドウを通常のウィンドウ・フレームを持つスタンドアロン・ウィンドウとして表示したい場合は、グラフの作成後にこのフラグをクリアしてください。例えば

Q3DBars *graphWindow = new Q3DBars;
graphWindow->setFlags(graphWindow->flags() ^ Qt::FramelessWindowHint);

Q3DBars,Q3DScatter,Q3DSurface,Qt Data Visualization C++ Classesも参照してください 。

メンバ型 ドキュメント

[since QtDataVisualization 1.1] enum QAbstract3DGraph::ElementType

グラフの要素の型。

定数値説明
QAbstract3DGraph::ElementNone0定義されていない要素。
QAbstract3DGraph::ElementSeries1系列（つまり、系列内の項目）。
QAbstract3DGraph::ElementAxisXLabel2X軸ラベル。
QAbstract3DGraph::ElementAxisYLabel3Y軸ラベル
QAbstract3DGraph::ElementAxisZLabel4z軸ラベル
QAbstract3DGraph::ElementCustomItem5カスタム項目。

この enum は QtDataVisualization 1.1 で導入されました。

[since Qt Data Visualization 1.1] enum QAbstract3DGraph::OptimizationHint
flags QAbstract3DGraph::OptimizationHints.

レンダリングの最適化のヒント。

定数値説明
QAbstract3DGraph::OptimizationDefault0妥当なパフォーマンスで全機能を提供します。
QAbstract3DGraph::OptimizationStatic1一部の機能を犠牲にして、静的データセットのレンダリングを最適化します。

この列挙型は Qt Data Visualization 1.1 で導入されました。

OptimizationHints 型はQFlags<OptimizationHint> の typedef です。これは、OptimizationHint 値の OR の組み合わせを格納します。

enum QAbstract3DGraph::SelectionFlag
flags QAbstract3DGraph::SelectionFlags

項目の選択モード。この列挙の値は OR 演算子で組み合わせることができます。

定数値説明
QAbstract3DGraph::SelectionNone0選択モード無効。
QAbstract3DGraph::SelectionItem1選択は1つの項目をハイライトする。
QAbstract3DGraph::SelectionRow2選択は、単一の行を強調表示します。
QAbstract3DGraph::SelectionItemAndRowSelectionItem | SelectionRow異なる色で項目と行の両方を強調表示するための組み合わせフラグ。
QAbstract3DGraph::SelectionColumn4選択すると1つの列がハイライトされる。
QAbstract3DGraph::SelectionItemAndColumnSelectionItem | SelectionColumn項目と列の両方を異なる色でハイライトするための組み合わせフラグ。
QAbstract3DGraph::SelectionRowAndColumnSelectionRow | SelectionColumn行と列の両方をハイライトするための組み合わせフラグ。
QAbstract3DGraph::SelectionItemRowAndColumnSelectionItem | SelectionRow | SelectionColumn項目、行、列のハイライトの組み合わせフラグ。
QAbstract3DGraph::SelectionSlice8このモード・フラグを設定すると、スライス表示の処理をグラフが自動的に行うようになります。Q3DScene を使ってスライス表示を自分で制御したい場合は、このフラグを設定しないでください。このモード・フラグを設定する場合、SelectionRow またはSelectionColumn のどちらかを設定しなければならないが、両方を設定することはできない。スライスはQ3DBars とQ3DSurface でのみサポートされる。このフラグが設定されている場合、以下の状況でスライスモードになる：
  • シリーズAPIを使って明示的に可視アイテムに選択を変更した場合。
  • グラフをクリックすることによって選択が変更されたとき。
  • 選択モードが変更され、選択された項目が可視になったとき。
QAbstract3DGraph::SelectionMultiSeries16このモードを設定すると、選択された項目だけでなく、同じ位置にあるすべての系列の項目がハイライトされます。他の系列での実際の選択は変更されません。このモードフラグを設定する場合、1つ以上の基本選択フラグ（SelectionItem 、SelectionRow 、SelectionColumn ）も設定しなければならない。Q3DScatter では多系列選択はサポートされない。

SelectionFlags型はQFlags<SelectionFlag>のtypedefです。SelectionFlag 値の OR の組み合わせを格納する。

enum QAbstract3DGraph::ShadowQuality

影の質。

定数値説明
QAbstract3DGraph::ShadowQualityNone0影は無効です。
QAbstract3DGraph::ShadowQualityLow1影は低画質でレンダリングされます。
QAbstract3DGraph::ShadowQualityMedium2影は中画質でレンダリングされます。
QAbstract3DGraph::ShadowQualityHigh3影は高品質でレンダリングされます。
QAbstract3DGraph::ShadowQualitySoftLow4影は、エッジをソフト化した低画質でレンダリングされます。
QAbstract3DGraph::ShadowQualitySoftMedium5影は、エッジがソフト化された中品質でレンダリングされます。
QAbstract3DGraph::ShadowQualitySoftHigh6影は、エッジが柔らかくされた高品質でレンダリングされます。

プロパティの説明

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 : const qreal

このプロパティは、最後の1秒間のレンダリング結果を保持します。

FPS 測定が有効な場合、結果はこの読み取り専用プロパティに保存されます。測定が有効になってからこの値が更新されるまで、少なくとも 1 秒かかります。

このプロパティは、QtDataVisualization 1.1 で導入されました。

アクセス関数

qreal currentFps() const

通知シグナル：

void currentFpsChanged(qreal fps)

measureFpsも参照してください 。

[since QtDataVisualization 1.2] horizontalAspectRatio : qreal

このプロパティは、X軸とZ軸の間のグラフのスケーリングの比率を保持します。

値0.0 は、 軸範囲に従っ た自動ス ケー リ ン グ を示す。デフォルトは0.0 。

barThickness およびbarSpacing プロパティによって水平面上のスケーリングを処理するQ3DBars には影響しません。極座標グラフもこのプロパティを無視します。

このプロパティは 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)

Notifier シグナル：

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)

Notifier シグナル：

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)

Notifier シグナル：

void polarChanged(bool enabled)

orthoProjection およびradialLabelOffsetも参照してください 。

[read-only, since QtDataVisualization 1.2] queriedGraphPosition : const 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)

Notifier シグナル：

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)

Notifier シグナル：

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)

Notifier シグナル：

void reflectivityChanged(qreal reflectivity)

reflectionも参照してください 。

[read-only] scene : Q3DScene* const

このプロパティは、Q3DScene ポインタを保持します。このポインタを使用して、シーンを操作したり、アクティブなカメラなどのシーン要素にアクセスしたりすることができます。

このプロパティは読み取り専用です。

アクセス関数：

Q3DScene *scene() const

[read-only, since QtDataVisualization 1.1] selectedElement : const ElementType

このプロパティは、グラフ内で選択されているエレメントを保持します。

このプロパティは、選択された要素のタイプを問い合わせるために使用することができる。このタイプは、グラフ内で新しい選択が行われ、selectedElementChanged シグナルが発せられるまで有効です。

このシグナルは、Scatter Graph タブのグラフギャラリーの例で示したように、カスタム入力ハンドラの実装などに使用できます。

このプロパティは 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 enum 値のいずれか。デフォルトはShadowQualityMedium 。

注意: 影の品質をあるレベルに設定することに失敗した場合、設定に成功するまでレベルが下げられます。shadowQualityChanged シグナルは、変更が行われるたびに発せられます。

アクセス関数：

QAbstract3DGraph::ShadowQuality shadowQuality() const
void setShadowQuality(QAbstract3DGraph::ShadowQuality quality)

Notifier シグナル：

void shadowQualityChanged(QAbstract3DGraph::ShadowQuality quality)

ShadowQualityも参照 。

メンバ関数ドキュメント

[virtual noexcept] QAbstract3DGraph::~QAbstract3DGraph()

QAbstract3DGraph を破棄する。

[since QtDataVisualization 1.1] int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)

QCustom3DItem item をグラフに追加する。グラフは追加された項目の所有権を持つ。

追加操作が成功した場合は追加されたアイテムのインデックスを返し、 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 環境ではサポートされていません。

本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。