QAbstractSeries Class

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

name : QString

このプロパティはシリーズの名前を保持する。

この名前はシリーズの凡例に表示され、HTML書式をサポートする。

アクセス関数：

通知シグナル

opacity : qreal

このプロパティはシリーズの不透明度を保持する。

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

アクセス関数：

通知シグナル：

[read-only] type : const SeriesType

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

アクセス関数：

useOpenGL : bool

OpenGLを使用して系列の描画を高速化するかどうかを指定する。

OpenGLによる高速化は、QLineSeries とQScatterSeries でのみサポートされています。QAreaSeries のエッジ系列として使用される線系列は、OpenGL アクセラレーションを使用できない。チャートに OpenGL で描画される系列が含まれる場合、チャートのプロット領域の上に透明な QOpenGLWidget が作成されます。アクセラレーションされた系列は、その下にあるQGraphicsView には描画されず、代わりに作成された QOpenGLWidget に描画されます。

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

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

• 加速されたシリーズでは、シリーズのアニメーションはサポートされていません。
• 加速度付きシリーズでは、ポイントラベルはサポートされていません。
• 加速シリーズでは、ペンのスタイル、マーカーの形状、およびライトマーカーは無視されます。実線とプレーンなスキャッタードットのみがサポートされます。スキャッタードットは、基礎となるグラフィックスハードウェアとドライバによって、円形または長方形になります。
• 極座標チャートは加速系列をサポートしません。
• 加速系列を使用する場合、チャートのドロップシャドウを有効にしたり、透明なチャート背景色を使用することは推奨されません。

これらの追加制限は、accelerated seriesがチャートの上にある別のウィジェットに描画されることに起因しています：

• 加速級数を含むチャートの上にグラフィック・アイテムを描画すると、加速級数はそれらのアイテムの上に描画されます。
• QOpenGLWidget を部分的に透明にするには、他のすべてのウィジェットの上に重ねる必要があります。つまり、加速度系列を使用しているときに、他のウィジェットがチャートを部分的に覆うことはできません。
• 加速系列は、グラフィックス・シーンに複数のグラフィックス・ビューがアタッチされているような使用例ではサポートされていません。
• 加速系列は、チャートがデフォルト以外のジオメトリを持つ使用例には対応していません。例えば、グラフィックスビューにトランスフォームを追加すると、加速系列がチャートに関連する正しくない位置に描画されます。

デフォルト値はfalse です。

アクセス関数：

通知シグナル：

visible : bool

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

デフォルトでは、true 。

アクセス関数：

通知シグナル：