QtGraphs3D Namespace

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

Header:	`#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 }

関数

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 アイテムを使用すると、グラフは非表示になります。グラフを描画する前にウィンドウ全体をクリアする。ウィンドウのサーフェスフォーマットがアンチエイリアスをサポートしている場合、アンチエイリアスが使用されます（`qDefaultSurfaceFormat()` を参照）。このレンダリングモードは最高のパフォーマンスを提供しますが、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`	影は、エッジが柔らかくされた高品質でレンダリングされる。

関数の説明

QSurfaceFormat qDefaultSurfaceFormat(bool antialias)

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

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

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

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

#include <QtGraphs/qutils.h>

// ...

Q3DBars *graph = new Q3DBars(qDefaultSurfaceFormat(false));

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

#include <QtGraphs/qutils.h>

// ...

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

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