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 をサブクラス化し、それを継承したグラフのレンダリングループを提供する。
このクラスを直接使用する必要はなく、サブクラスのいずれかを使用してください。
アンチエイリアスは、Qt Data Visualization でサポートされていない OpenGL ES2 環境を除き、C++ ではデフォルトでオンになっています。グラフにデフォルト以外のアンチエイリアスを指定するには、コンストラクタのパラメータにカスタムサーフェス形式を指定します。サーフェスフォーマットオブジェクトを作成するには、便利な関数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 | カスタム項目。 |
この enum は 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 | 選択は単一の項目をハイライトする。 |
QAbstract3DGraph::SelectionRow | 2 | 選択は、単一の行を強調表示します。 |
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 | このモードを設定すると、選択された項目だけでなく、同じ位置にあるすべての系列の項目がハイライトされます。他の系列での実際の選択は変更されません。このモードフラグを設定する場合、1つ以上の基本選択フラグ（SelectionItem 、SelectionRow 、SelectionColumn ）も設定しなければならない。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 : 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) |
通知シグナル：
| 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回の描画呼び出しで描画されるためで、グラフィックドライバによって、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値の1つです。デフォルトでは、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環境ではサポートされていません。
© 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.
