QAbstractSeries Class

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

name : QString

このプロパティには、系列の名前が格納されます。

この名前は、その系列の凡例に表示され、HTML 書式設定に対応しています。

アクセス関数：

通知シグナル：

opacity : qreal

このプロパティは、シリーズの不透明度を指定します。

デフォルトでは、不透明度は 1.0 です。有効な値の範囲は 0.0（透明）から 1.0（不透明）までです。

アクセス関数：

通知シグナル：

[read-only] type : SeriesType

このプロパティは、系列の型を保持します。

アクセス関数：

useOpenGL : bool

OpenGL を使用してシリーズの描画を高速化するかどうかを指定します。

OpenGL によるアクセラレーションは、QLineSeries および QScatterSeries でのみサポートされています。 QAreaSeries のエッジ・シリーズとして使用される線形シリーズは、OpenGL によるアクセラレーションを使用できません。チャートに OpenGL を使用して描画されるシリーズが含まれている場合、チャートのプロット領域の上に透明な QOpenGLWidget が作成されます。アクセラレーションが適用されたシリーズは、基になるQGraphicsView 上に描画されるのではなく、作成された QOpenGLWidget 上に描画されます。

OpenGL を使用してシリーズの描画を高速化することで得られるパフォーマンス向上は、基盤となるハードウェアに依存しますが、ほとんどの場合、その効果は顕著です。たとえば、標準的なデスクトップコンピュータでは、シリーズの OpenGL アクセラレーションを有効にすることで、通常、フレームレートを低下させることなく、少なくとも 100 倍多くの点をレンダリングできるようになります。また、チャートのサイズがフレームレートに与える影響も小さくなります。

系列の描画における OpenGL アクセラレーションは、大量の点を高速に描画する必要があるユースケースを対象としています。これは効率性を重視して最適化されているため、これを使用する系列では、アクセラレーションを使用しない系列で利用可能な多くの機能がサポートされません：

• アクセラレーションが有効なシリーズでは、シリーズのアニメーションはサポートされません。
• アクセラレーションが有効なシリーズでは、ポイントラベルはサポートされません。
• アクセラレーションが有効なシリーズでは、ペンスタイル、マーカー形状、およびライトマーカーは無視されます。実線とプレーンな散布点のみがサポートされます。散布点は、基盤となるグラフィックスハードウェアおよびドライバに応じて、円形または長方形になる場合があります。
• 極座標グラフでは、アクセラレーション対応の系列はサポートされていません。
• アクセラレーション対応の系列を使用する場合、チャートのドロップシャドウを有効にしたり、チャートの背景色を透明に設定したりすることは、フレームレートが大幅に低下する可能性があるため推奨されません。

これらの追加の制限は、アクセラレーション対応の系列がグラフの上にある別のウィジェット上に描画されるという事実によるものです。

• アクセラレーテッド・シリーズを含むグラフの上にグラフィック要素を描画すると、アクセラレーテッド・シリーズがそれらの要素の上に描画されます。
• QOpenGLWidgetを部分的に透明にするには、他のすべてのウィジェットの上に重ねる必要があります。つまり、アクセラレーテッド・シリーズを使用する際、他のウィジェットがチャートを部分的に覆うような配置はできません。
• グラフィックシーンに複数のグラフィックビューがアタッチされているユースケースでは、アクセラレーテッド・シリーズはサポートされていません。
• チャートがデフォルト以外のジオメトリを持つユースケースでは、アクセラレーテッド・シリーズはサポートされません。たとえば、グラフィックス・ビューに変換（トランスフォーム）を追加すると、アクセラレーテッド・シリーズがチャートに対して不適切な位置に描画されてしまいます。

デフォルト値は `false` です。

アクセス関数：

通知シグナル:

visible : bool

このプロパティは、シリーズが表示されているかどうかを指定します。

デフォルトでは、true です。

アクセス関数：

通知シグナル：