QtGraphs3D Namespace

QtGraphs3D モジュールはQtGraphs' 3D API で使用される列挙型を提供します。詳細...

ヘッダ	`#include <QtGraphs3D>`
CMake：	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake：	`QT += graphs`

QtGraphs3D はQt Graphs C++ Classes for 3D の一部です。

型

enum class	CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
enum class	ElementType { None, Series, AxisXLabel, AxisYLabel, AxisZLabel, CustomItem }
enum class	GridLineType { Shader, Geometry }
enum class	OptimizationHint { Default, Legacy }
enum class	RenderingMode { DirectToBackground, Indirect }
enum class	SelectionFlag { None, Item, Row, ItemAndRow, Column, …, MultiSeries }
flags	SelectionFlags
enum class	ShadowQuality { None, Low, Medium, High, SoftLow, …, SoftHigh }

関数

(until 6.9) QSurfaceFormat qDefaultSurfaceFormat(bool antialias)

詳細説明

型の説明

enum class QtGraphs3D::CameraPreset

あらかじめ定義されたカメラの位置。

定数	値	説明
`QtGraphs3D::CameraPreset::NoPreset`	`0`	プリセットが設定されていないか、シーンが自由に回転していることを示すために使用される。
`QtGraphs3D::CameraPreset::FrontLow`	`1`	カメラのX回転とY回転の両方が0。
`QtGraphs3D::CameraPreset::Front`	`2`	X回転が0、Y回転が22.5度。
`QtGraphs3D::CameraPreset::FrontHigh`	`3`	X回転が0、Y回転が45度。
`QtGraphs3D::CameraPreset::LeftLow`	`4`	X回転が90度、Y回転が0度。
`QtGraphs3D::CameraPreset::Left`	`5`	X回転は90度、Y回転は22.5度。
`QtGraphs3D::CameraPreset::LeftHigh`	`6`	X回転は90度、Y回転は45度。
`QtGraphs3D::CameraPreset::RightLow`	`7`	X回転は-90度、Y回転は0度。
`QtGraphs3D::CameraPreset::Right`	`8`	X回転は-90度、Y回転は22.5度。
`QtGraphs3D::CameraPreset::RightHigh`	`9`	X回転は-90度、Y回転は45度。
`QtGraphs3D::CameraPreset::BehindLow`	`10`	X回転は180度、Y回転は0度。
`QtGraphs3D::CameraPreset::Behind`	`11`	X回転は180度、Y回転は22.5度。
`QtGraphs3D::CameraPreset::BehindHigh`	`12`	X回転は180度、Y回転は45度。
`QtGraphs3D::CameraPreset::IsometricLeft`	`13`	X回転が45度、Y回転が22.5度。
`QtGraphs3D::CameraPreset::IsometricLeftHigh`	`14`	X回転は45度、Y回転は45度。
`QtGraphs3D::CameraPreset::IsometricRight`	`15`	X回転は-45度、y回転は22.5度。
`QtGraphs3D::CameraPreset::IsometricRightHigh`	`16`	X回転は-45度、Y回転は45度。
`QtGraphs3D::CameraPreset::DirectlyAbove`	`17`	X回転は0度、Y回転は90度。
`QtGraphs3D::CameraPreset::DirectlyAboveCW45`	`18`	X回転は-45度、y回転は90度。
`QtGraphs3D::CameraPreset::DirectlyAboveCCW45`	`19`	X回転は45度、Y回転は90度。
`QtGraphs3D::CameraPreset::FrontBelow`	`20`	X回転は0度、Y回転は-45度。FrontBelow 以降のQ3DBarsWidgetItem では、これらは負の値を含むグラフに対してのみ機能する。正の値のみの場合は CameraPreset...Low として動作します。
`QtGraphs3D::CameraPreset::LeftBelow`	`21`	X回転は90度、Y回転は-45度。
`QtGraphs3D::CameraPreset::RightBelow`	`22`	X回転が-90度、Y回転が-45度。
`QtGraphs3D::CameraPreset::BehindBelow`	`23`	X回転は180度、Y回転は-45度。
`QtGraphs3D::CameraPreset::DirectlyBelow`	`24`	X回転が0で、Y回転が-90度。正方向のみの小節に対してFrontLowとして動作する。

enum class QtGraphs3D::ElementType

グラフの要素のタイプ。

定数	値	説明
`QtGraphs3D::ElementType::None`	`0`	定義されていない要素。
`QtGraphs3D::ElementType::Series`	`1`	系列内の項目。
`QtGraphs3D::ElementType::AxisXLabel`	`2`	X軸ラベル。
`QtGraphs3D::ElementType::AxisYLabel`	`3`	Y軸ラベル。
`QtGraphs3D::ElementType::AxisZLabel`	`4`	z 軸ラベル。
`QtGraphs3D::ElementType::CustomItem`	`5`	カスタム項目

enum class QtGraphs3D::GridLineType

定数	値	説明
`QtGraphs3D::GridLineType::Shader`	`0`	グリッドラインは、シェーダ内のGPUでレンダリングされます。
`QtGraphs3D::GridLineType::Geometry`	`1`	グリッドラインは3Dモデルでレンダリングされます。

enum class QtGraphs3D::OptimizationHint

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

定数	値	説明
`QtGraphs3D::OptimizationHint::Default`	`0`	良好なパフォーマンスでインスタンス化された全機能セットを提供します。
`QtGraphs3D::OptimizationHint::Legacy`	`1`	妥当なパフォーマンスで全機能セットを提供します。OptimizationHint.Defaultのパフォーマンスが低いか、動作しない場合に使用します。

enum class QtGraphs3D::RenderingMode

定数	値	説明
`QtGraphs3D::RenderingMode::DirectToBackground`	`0`	グラフがウィンドウの背景に直接描画され、その上にQMLアイテムが描画されることを示す。背景として透明でない QML アイテムを使用すると、グラフは非表示になります。グラフを描画する前にウィンドウ全体をクリアする。ウィンドウのサーフェスフォーマットがアンチエイリアスをサポートしている場合、アンチエイリアスが使用されます（QQuick3D::idealSurfaceFormat() を参照）。このレンダリングモードは、QMLの非標準的な動作を犠牲にして、最高のパフォーマンスを提供します。例えば、グラフはQMLアイテムのZ順序に従わず、不透明度の値は影響を与えません。
`QtGraphs3D::RenderingMode::Indirect`	`1`	通常の QML アイテムのレンダリング中に描画されるオフスクリーンサーフェスにグラフがレンダリングされることを示します。現在の環境でマルチサンプリングがサポートされており、msaaSamples プロパティの値が 0 より大きい場合、レンダリング画像はマルチサンプリング方式でアンチエイリアス処理されます。このレンダリングモードでは、パフォーマンスが犠牲になりますが、品質が良く、通常の QML アイテムの動作が得られます。

enum class QtGraphs3D::SelectionFlag
flags QtGraphs3D::SelectionFlags

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

定数	値	説明
`QtGraphs3D::SelectionFlag::None`	`0x00`	選択モード無効。
`QtGraphs3D::SelectionFlag::Item`	`0x01`	選択は単一の項目をハイライトする。
`QtGraphs3D::SelectionFlag::Row`	`0x02`	選択は、単一の行を強調表示します。
`QtGraphs3D::SelectionFlag::ItemAndRow`	`Item \| Row`	異なる色で項目と行の両方を強調表示するための組み合わせフラグ。
`QtGraphs3D::SelectionFlag::Column`	`0x04`	選択すると1つの列がハイライトされる。
`QtGraphs3D::SelectionFlag::ItemAndColumn`	`Item \| Column`	項目と列の両方を異なる色でハイライトするための組み合わせフラグ。
`QtGraphs3D::SelectionFlag::RowAndColumn`	`Row \| Column`	行と列の両方をハイライトするための組み合わせフラグ。
`QtGraphs3D::SelectionFlag::ItemRowAndColumn`	`Item \| Row \| Column`	項目、行、列のハイライトの組み合わせフラグ。
`QtGraphs3D::SelectionFlag::Slice`	`0x08`	このモード・フラグを設定すると、スライス表示の処理をグラフが自動的に行うようになります。Q3DScene を使ってスライス表示を自分で制御したい場合は、このフラグを設定しないでください。このモード・フラグを設定する場合、`Row` または`Column` のどちらかを設定する必要があるが、両方を設定することはできない。スライスはQ3DBarsWidgetItem とQ3DSurfaceWidgetItem でのみサポートされる。このフラグが設定されている場合、以下の状況でスライスモードになる：シリーズAPIを使って明示的に可視アイテムに選択を変更した場合。グラフをクリックすることによって選択が変更されたとき。選択モードが変更され、選択された項目が可視になったとき。
`QtGraphs3D::SelectionFlag::MultiSeries`	`0x10`	このモードを設定すると、選択された項目だけでなく、同じ位置にあるすべての系列の項目がハイライトされます。他の系列での実際の選択は変更されません。このモードフラグを設定する場合、1つ以上の基本選択フラグ（`Item` 、`Row` 、`Column` ）も設定しなければならない。Q3DScatterWidgetItem では多系列選択はサポートされない。

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

enum class QtGraphs3D::ShadowQuality

影の質。

一定	値	説明
`QtGraphs3D::ShadowQuality::None`	`0`	影は無効です。
`QtGraphs3D::ShadowQuality::Low`	`1`	影は低画質でレンダリングされます。
`QtGraphs3D::ShadowQuality::Medium`	`2`	影は中画質でレンダリングされます。
`QtGraphs3D::ShadowQuality::High`	`3`	影は高品質でレンダリングされます。
`QtGraphs3D::ShadowQuality::SoftLow`	`4`	影は、エッジをソフトにした低画質でレンダリングされます。
`QtGraphs3D::ShadowQuality::SoftMedium`	`5`	影は、エッジがソフト化された中品質でレンダリングされます。
`QtGraphs3D::ShadowQuality::SoftHigh`	`6`	影は、エッジがソフト化された高品質でレンダリングされる。

機能説明

`[until 6.9]` QSurfaceFormat qDefaultSurfaceFormat(bool antialias)

この関数はバージョン6.9で非推奨となる予定です。

QQuick3D::idealSurfaceFormat() を使用する。

この便利な関数は、Qt Graphs グラフで使用するのに適したカスタムサーフェスフォーマットを作成するために使用できます。

antialias パラメータは、アンチエイリアスを有効にするかどうかを指定します。

この関数が返すサーフェスフォーマットをグラフのコンストラクタ（C++）に与えるか、show() を呼び出す前にQQuickView のウィンドウフォーマット（QML）として設定してください。

例えば、C++アプリケーションでアンチエイリアスを無効にします：

#include <QtGraphs/qutils.h>

// ...

QSurfaceFormat::setDefaultFormat(qDefaultSurfaceFormat(true));

例えば、QMLアプリケーションのダイレクトレンダリングモードでアンチエイリアスを有効にします：

#include <QtGraphs/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));

© 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.