Q3DGraphsWidgetItem Class

プロパティ・ドキュメント

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

(2)回転角度 カメラの回転角度を度単位で示す。

アクセス関数

通知シグナル

cameraZoomLevel : float

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

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

アクセス関数：

通知シグナル：

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

[read-only] currentFps : const int

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

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

アクセス関数

通知シグナル：

measureFpsも参照してください 。

gridLineType : QtGraphs3D::GridLineType

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

この値はすべてのグリッド線に影響します。

アクセス関数：

通知シグナル：

QtGraphs3D::GridLineTypeも参照してください 。

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" ロケールです。

アクセス関数：

Notifier シグナル：

QValue3DAxis::labelFormatも参照のこと 。

margin : qreal

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

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

アクセス機能

通知シグナル

maxCameraXRotation : float

本プロパティは、カメラの目標点周りの最大 X 回転角度を度単位で保持する。

アクセス関数

通知シグナル

maxCameraYRotation : float

このプロパティは、カメラの目標点周りの最大 Y 回転角度を度単位で保持する。

アクセス関数

通知シグナル

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 列挙型の値の 1 つです。デフォルトでは、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 シグナル：

QQuickWidget quickwidget;
Q3DBarsWidgetItem graph;
graph.setWidget(&quickwidget);