QAbstractSeries Class

Documentation sur les propriétés

name : QString

Cette propriété contient le nom de la série.

Le nom est affiché dans la légende de la série et prend en charge le formatage HTML.

Fonctions d'accès :

Signal de notification :

opacity : qreal

Cette propriété définit l'opacité de la série.

Par défaut, l'opacité est de 1,0. Les valeurs valides sont comprises entre 0,0 (transparent) et 1,0 (opaque).

Fonctions d'accès :

Signal de notification :

[read-only] type : SeriesType

Cette propriété contient le type de la série.

Fonctions d'accès :

useOpenGL : bool

Spécifie si le dessin de la série est accéléré par l'utilisation d'OpenGL.

L'accélération à l'aide d'OpenGL n'est prise en charge que pour QLineSeries et QScatterSeries. Une série de lignes utilisée comme série de bord pour QAreaSeries ne peut pas utiliser l'accélération OpenGL. Lorsqu'un graphique contient des séries dessinées avec OpenGL, un QOpenGLWidget transparent est créé au-dessus de la zone de tracé du graphique. Les séries accélérées ne sont pas dessinées sur le site QGraphicsView, mais sur le QOpenGLWidget créé.

Les performances obtenues grâce à l'utilisation d'OpenGL pour accélérer le dessin des séries dépendent du matériel sous-jacent, mais dans la plupart des cas, elles sont significatives. Par exemple, sur un ordinateur de bureau standard, l'activation de l'accélération OpenGL pour une série permet généralement de rendre au moins cent fois plus de points sans réduction du taux de rafraîchissement. La taille des graphiques a également moins d'effet sur la fréquence d'images.

L'accélération OpenGL du dessin des séries est destinée aux cas d'utilisation qui nécessitent le dessin rapide d'un grand nombre de points. Elle est optimisée pour l'efficacité et, par conséquent, les séries qui l'utilisent ne prennent pas en charge de nombreuses fonctionnalités disponibles pour les séries non accélérées :

• Les animations de séries ne sont pas prises en charge pour les séries accélérées.
• Les étiquettes de points ne sont pas prises en charge pour les séries accélérées.
• Les styles de stylo, les formes de marqueur et les marqueurs lumineux sont ignorés pour les séries accélérées. Seules les lignes pleines et les points de dispersion simples sont pris en charge. Les points de dispersion peuvent être circulaires ou rectangulaires, en fonction du matériel graphique et des pilotes sous-jacents.
• Les graphiques polaires ne prennent pas en charge les séries accélérées.
• Il n'est pas recommandé d'activer l'ombre portée des graphiques ou d'utiliser une couleur d'arrière-plan transparente lors de l'utilisation de séries accélérées, car cela peut ralentir considérablement le taux de rafraîchissement.

Ces restrictions supplémentaires sont dues au fait que les séries accélérées sont dessinées dans un widget séparé au-dessus du graphique :

• Si vous dessinez des éléments graphiques au-dessus d'un graphique contenant une série accélérée, la série accélérée est dessinée au-dessus de ces éléments.
• Pour permettre à QOpenGLWidget d'être partiellement transparent, il doit être empilé au-dessus de tous les autres widgets. Cela signifie que vous ne pouvez pas avoir d'autres widgets couvrant partiellement le graphique lorsque vous utilisez des séries accélérées.
• Les séries accélérées ne sont pas prises en charge dans les cas où la scène graphique comporte plus d'une vue graphique.
• Les séries accélérées ne sont pas prises en charge dans les cas où la géométrie du graphique n'est pas celle par défaut. Par exemple, l'ajout de transformations à la vue graphique entraîne le dessin de la série accélérée dans une position incorrecte par rapport au graphique.

La valeur par défaut est false.

Fonctions d'accès :

Signal de notification :

visible : bool

Cette propriété indique si la série est visible ou non.

Par défaut, true.

Fonctions d'accès :

Signal du notificateur :