Q3DGraphsWidgetItem Class

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

プロパティ ドキュメント

activeTheme : QGraphsTheme*

このプロパティは、グラフのアクティブなテーマを保持します。

グラフに使用するアクティブテーマとしてactiveTheme を設定します。暗黙的にaddTheme() を呼び出し、テーマの所有権をこのグラフに移します。

activeTheme が NULL の場合、一時的なデフォルトテーマが作成されます。この一時的テーマは、後で何らかのテーマが明示的に設定されると破棄されます。テーマのプロパティは設定後でも変更可能で、変更は即座に反映されます。

アクセス関数：

通知シグナル：

ambientLightStrength : float

このプロパティは、グラフ全体の環境光の強さを保持する。

この値は、光の位置に関係なく、グラフ全体がどの程度均等に明るく表示されるかを決定する。

値は0.0f から1.0f の間でなければならない。

アクセス関数：

通知シグナル：

aspectRatio : qreal

このプロパティは、水平面上の最長軸とY軸の間のグラフのスケーリングの比率を保持する。

デフォルトは2.0 。

アクセス関数：

ノーティファイアシグナル：

horizontalAspectRatioも参照。

cameraTargetPosition : QVector3D

こ のプ ロパテ ィ は、 カ メ ラ の タ ーゲ ッ ト 位置を、 3D 空間のベ ク ト ルま たは頂点 と し て保持 し ます。

デフォルトはQVector3D(0.0, 0.0, 0.0) です。

有効な座標値は-1.0...1.0 の間です。 こ こ で辺値は、 対応する軸範囲の辺を表 し ます。こ の範囲外の値は、 その辺に ク ラ ンプ さ れます。

アクセス関数：

通知シグナル：

cameraXRotation : float

このプロパティは、ターゲット点周りのカメラの X 回転角度を度単位で保持する。

アクセス関数：

ノーティファイアシグナル：

cameraYRotation : float

プロパティ値：ターゲットポイント周りのカメラの Y 回転角度を度単位で保持する。

アクセス関数

通知シグナル： カメラのズームレベルを度単位で保持する：

cameraZoomLevel : float

このプロパティは、カメラのズームレベルをパーセンテージで保持する。

デフォルト値の100.0f は、カメラにズームインまたはズームアウトが設定されていないことを意味します。この値はminCameraZoomLevel およびmaxCameraZoomLevel プロパティによって制限されます。

アクセス関数：

通知シグナル：

minCameraZoomLevel およびmaxCameraZoomLevelも参照してください 。

[read-only] currentFps : const int

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

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

アクセス関数

通知シグナル：

measureFpsも参照 。

gridLineType : QtGraphs3D::GridLineType

このプロパティはグリッド線のタイプがQ3DGraphsWidgetItem::GridLineType::ShaderかQ3DGraphsWidgetItem::GridLineType::Geometryかを保持します。

この値は全てのグリッドラインに影響する。

アクセス関数

通知シグナル：

horizontalAspectRatio : qreal

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

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

barThickness とbarSpacing プロパティによって水平面のスケーリングを扱うQ3DBarsWidgetItem には影響しません。極座標グラフもこのプロパティを無視します。

アクセス関数：

ノーティファイアシグナル：

aspectRatio,polar,Q3DBarsWidgetItem::barThickness,Q3DBarsWidgetItem::barSpacingも参照 。

labelMargin : float

このプロパティは、軸ラベルの配置のマージンを指定します。

負の値はラベルをプロット領域内に配置し、正の値はラベルをプロット領域外に配置する。値が負の場合、ラベルの自動回転は無効になる。デフォルトは0.1

アクセス関数：

通知シグナル：

QAbstract3DAxis::labelAutoAngleも参照 。

lightColor : QColor

このプロパティは環境光と鏡面光の色を保持します。

この値はQ3DScene で指定された光に影響します。

アクセス関数：

ノーティファイアシグナル：

lightStrength : float

このプロパティは、グラフ全体の鏡面光の強さを保持します。

値は0.0f と10.0f の間でなければなりません。

この値はQ3DScene で指定されたライトに影響します。

アクセス関数：

ノーティファイアシグナル：

locale : QLocale

このプロパティは、様々な数値ラベルのフォーマットに使用されるロケールを保持します。

デフォルトは"C" ロケール。

アクセス関数：

ノーティファイアシグナル：

QValue3DAxis::labelFormatも参照 。

margin : qreal

このプロパティは、プロット可能なグラフ領域の端とグラフの背景の端の間に残されたスペースに使用される絶対値を保持する。

マージン値が負の場合、マージンは自動的に決定され、シリーズ内のアイテムのサイズやグラフのタイプによって変化する。グラフのアスペクト比がデフォルト値から変更されていない場合、値はY軸範囲の分数として解釈される。デフォルトは-1.0 。

アクセス機能

通知信号：

maxCameraXRotation : float

プロパティの値域 目標点周りのカメラの最大 X 回転角度を度単位で示す。

アクセス関数

通知信号：

maxCameraYRotation : float

プロパティの値域：0～9999(0～9999) プロパティの値域は、0～9999(0～9999)とする。

アクセス関数

カメラの最大ズーム角度を度単位で保持する：

maxCameraZoomLevel : float

このプロパティは、カメラのズームレベルの最大値を保持する。

最大レベルが既存の最小レベルより低い新しい値に設定された場合、最小レベルも新しい最大レベルに調整される。現在のcameraZoomLevel が新しい境界の外にある場合、それも調整されます。デフォルトは500.0f 。

アクセス関数：

通知シグナル：

cameraZoomLevel およびminCameraZoomLevelも参照 。

measureFps : bool

このプロパティは、レンダリングがオンデマンドではなく連続的に行われるかどうかを保持する。

true の場合、レンダリングは継続的に行われ、currentFps プロパティの値が更新されます。デフォルトはfalse です。

アクセス関数：

Notifier シグナル：

currentFpsも参照。

minCameraXRotation : float

このプロパティは、ターゲット点周りのカメラの最小 X 回転角度を度単位で保持します。

アクセス関数：

ノーティファイアシグナル：

minCameraYRotation : float

このプロパティは、ターゲットポイント周りのカメラの最小 Y 回転角度を度単位で保持する。

アクセス関数

ノーティファイアシグナル

minCameraZoomLevel : float

このプロパティは、許可されるカメラのズーム・レベルの最小値を保持する。

最小レベルが既存の最大レベルより高い新しい値に設定された場合、最大レベルも新しい最小レベルに調整されます。現在のzoomLevelが新しい範囲外の場合、同様に調整されます。minCameraZoomLevel を1.0f 以下に設定することはできません。デフォルトは10.0f 。

アクセス関数：

通知シグナル：

cameraZoomLevel およびmaxCameraZoomLevelも参照 。

msaaSamples : int

このプロパティは、MSAA の使用サンプル数を保持します。

MSAA の使用サンプル数をsamples に設定します。 サンプル数は 0、2、4、8 のいずれかを指定します。

アクセス関数

ノーティファイアシグナル：

optimizationHint : QtGraphs3D::OptimizationHint

このプロパティは、レンダリングの最適化にデフォルトモード、スタティックモード、またはレガシーモードのいずれを使用するかを保持します。

デフォルトモードはインスタンス化されたレンダリングを使用し、ほとんどのシステムで最高レベルのパフォーマンスで全機能セットを提供します。静的モードはグラフ描画を最適化し、変化のない大きなデータセットに最適です。動的なデータの変化やアイテムの回転があると遅くなります。選択は最適化されないので、大量のデータセットで静的モードを使用することはお勧めできません。静的最適化は散布図でのみ機能します。レガシーモードは、インスタンス化せずにグラフ内のすべての項目を個別にレンダリングします。デフォルトモードが機能しない場合、つまりターゲットシステムがインスタンス化をサポートしていない場合にのみ使用する必要があります。デフォルトはQtGraphs3D::OptimizationHint::Default です。

アクセス関数：

通知シグナル：

QAbstract3DSeries::meshも参照してください 。

orthoProjection : bool

このプロパティは、グラフの表示に正射投影を使用するかどうかを保持します。

デフォルトはfalse 。

アクセス関数：

Notifier シグナル：

QAbstract3DAxis::labelAutoAngleも参照。

polar : bool

このプロパティは、水平軸を極軸に変更するかどうかを保持します。

true の場合、x 軸は角度軸になり、z 軸は半径軸になります。棒グラフでは極軸モードは使用できません。

デフォルトはfalse 。

アクセス関数：

通知シグナル：

orthoProjection およびradialLabelOffsetも参照 。

[read-only] queriedGraphPosition : const QVector3D

こ のプ ロパテ ィ は、 各軸に沿っ て ク エ リ さ れた最新のグ ラ フ位置値を保持 し ます。

この読み取り専用プロパティには、Q3DScene::graphPositionQuery の結果が含まれます。 値は、範囲[-1, 1] に正規化されます。クエリされた位置がグラフ境界の外側にあった場合、値は実際の位置を反映せず、代わりに範囲外の未定義の位置[-1, 1] を示します。この値は、問い合わせが行われるまで未定義となる。

特定の画面位置に一致する唯一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む不可視のボックスの内側に対して行われます。

アクセス関数

通知シグナル：

Q3DScene::graphPositionQueryも参照 。

radialLabelOffset : float

このプロパティは、半径極軸の軸ラベルの正規化された水平オフセットを保持する。

値0.0 は、ラベルが0角度の角度軸グリッド線の隣に描画されるべきであることを示します。値1.0 は、ラベルがグラフ背景の端の通常の場所に描画されることを示します。デフォルトは1.0 。

このプロパティは、polar プロパティ値がfalse の場合は無視されます。

アクセス関数：

Notifier シグナル：

polarも参照。

rotationEnabled : bool

このプロパティは、この入力ハンドラがグラフ回転を許すかどうかを保持します。

デフォルトはtrue です。

アクセス関数：

ノーティファイアシグナル：

[read-only] scene : Q3DScene* const

このプロパティは、シーンの操作とシーン要素へのアクセスに使用できるQ3DScene ポインタを保持する。

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

アクセス関数：

[read-only] selectedElement : const QtGraphs3D::ElementType

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

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

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

アクセス関数

Notifierシグナル：

selectedLabelIndex(),selectedAxis(),selectedCustomItemIndex(),selectedCustomItem(),Q3DBarsWidgetItem::selectedSeries(),Q3DScatterWidgetItem::selectedSeries(),Q3DSurfaceWidgetItem::selectedSeries(),Q3DScene::setSelectionQueryPosition()も参照 。

selectionEnabled : bool

このプロパティは、この入力ハンドラがグラフからの選択を許可するかどうかを保持する。

デフォルトはtrue 。

アクセス関数：

通知シグナル：

selectionMode : QtGraphs3D::SelectionFlags

項目選択モード。

SelectionFlags の組み合わせ。デフォルトはItem 。グラフの種類によって、サポートする選択モードが異なります。

アクセス関数：

通知シグナル：

QtGraphs3D::SelectionFlagsも参照 。

shadowQuality : QtGraphs3D::ShadowQuality

このプロパティは影の品質を保持します。

ShadowQuality 列挙型の値のいずれか。デフォルトでは、Medium 。

アクセス関数：

Notifier シグナル：

QtGraphs3D::ShadowQualityも参照 。

shadowStrength : float

このプロパティは、グラフ全体の影の強さを保持する。

数値が大きいほど影が濃くなります。値は0.0 と100.0 の間でなければなりません。

この値はQ3DScene で指定した光に影響します。

アクセス関数：

通知シグナル：

wrapCameraXRotation : bool

こ のプ ロパテ ィ は、 X 回転の最小限度と最大限度の動作を保持する。

true に設定すると、カメラの X 回転は最小から最大へ、最大から最小へと折り返されます。false に設定すると、カメラの X 回転は最小値と最大値によって決定されるセクタに制限されます。デフォルトではtrue に設定されています。

アクセス関数：

通知シグナル：

wrapCameraYRotation : bool

このプロパティは、Y 回転の最小値と最大値の制限の動作を保持する。

true の場合、カメラの Y 回転は最小から最大、最大から最小に折り返されます。false の場合、カメラの Y 回転は、最小値と最大値によって決定されるセクタに制限されます。デフォルトではtrue に設定されています。

アクセス関数：

通知シグナル：

zoomAtTargetEnabled : bool

このプロパティは、ズームが、グラフのズームされた点がズーム後も同じ位置に留まるように、カメラのターゲットを変更すべきかどうかを保持する。

デフォルトはtrue 。

アクセス関数：

ノーティファイアシグナル：

zoomEnabled : bool

このプロパティーは、この入力ハンドラーがグラフのズームを許可するかどうかを保持します。

デフォルトはtrue 。

アクセス関数：

アクセス関数：Notifier signal: このプロパティは、この入力ハンドラがグラフのズームを許可するかどうかを保持します：