QtGraphs3D Namespace

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

ヘッダー:	`#include <qgraphs3dnamespace.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake:	`QT += graphs`

非推奨のメンバ
QtGraphs3Dは、Qt Graphs の3D用C++クラスの一部です。

型

enum class	CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
`(since 6.12)` enum class	DragMode { Rotate, Pan }
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 }
`(since 6.10)` enum class	SliceCaptureType { NoImage, RowImage, ColumnImage }
`(since 6.9)` enum class	TransparencyTechnique { Default, Approximate, Accurate }

詳細な説明

型のドキュメント

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度です。Q3DBarsWidgetItem の「FrontBelow」以降では、これらは負の値を含むグラフでのみ機能します。正の値のみの場合、これらは「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として機能します。

`[since 6.12]` enum class QtGraphs3D::DragMode

グラフ上のマウスまたはタッチによるドラッグイベントがどのように解釈されるかを決定します。

定数	値	説明
`QtGraphs3D::DragMode::Rotate`	`0`	ドラッグするとグラフが回転します。
`QtGraphs3D::DragMode::Pan`	`1`	ドラッグするとグラフがパンされます。

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

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`	選択により、1 つの項目が強調表示されます。
`QtGraphs3D::SelectionFlag::Row`	`0x02`	選択すると、1つの行が強調表示されます。
`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`	このモードを設定すると、選択された項目のみではなく、同じ位置にあるすべてのシリーズの項目がハイライト表示されます。他のシリーズにおける実際の選択状態は変更されません。このモードフラグを設定する際は、基本選択フラグ（`Item` 、`Row` 、または`Column` ）のうち1つ以上も設定する必要があります。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`	影は、エッジを滑らかにした高画質でレンダリングされます。

`[since 6.10]` enum class QtGraphs3D::SliceCaptureType

画像に読み込むスライスの種類。

定数	値	説明
`QtGraphs3D::SliceCaptureType::NoImage`	`0`	キャプチャするスライスのタイプが定義されていません。
`QtGraphs3D::SliceCaptureType::RowImage`	`1`	行のスライスをキャプチャします。
`QtGraphs3D::SliceCaptureType::ColumnImage`	`2`	列のキャプチャスライス。

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

`[since 6.9]` enum class QtGraphs3D::TransparencyTechnique

使用する透過処理の手法を指定します。デフォルト値は `Default` です。透過表面グラフをレンダリングする場合は、`Approximate ` または `Accurate` を使用してください。その他のグラフタイプには `Default ` を使用してください。

定数	値	説明
`QtGraphs3D::TransparencyTechnique::Default`	`0`	順序非依存の透過処理技術を使用しないことを示します。最高のパフォーマンスが得られます。グラフに透過が含まれていない場合、または棒グラフや散布図でインスタンス化も使用されている場合（つまり、optimizationHint が{QtGraphs3D::OptimizationHint::Default} である場合）に使用します。
`QtGraphs3D::TransparencyTechnique::Approximate`	`1`	順序に依存しない透過処理の近似を行うことを示します。この方法は ``Accurate` ` よりも高速で、古いハードウェアでも動作しますが、結果が不正確になる可能性があります。順序に依存しない透過処理が必要であるが、正確な順序に依存しない透過処理を使用する場合よりもパフォーマンスのオーバーヘッドを低く抑える必要がある場合に使用してください。
`QtGraphs3D::TransparencyTechnique::Accurate`	`2`	正確な順序非依存の透明度が使用されることを示します。完全な透明度レンダリングが必要な場合に使用します。

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

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