QCanvasPath Class

Documentation des fonctions membres

QCanvasPath::QCanvasPath()

Construit un chemin vide.

[explicit] QCanvasPath::QCanvasPath(qsizetype commandsSize, qsizetype commandsDataSize = -1)

Construit un chemin vide, en allouant de l'espace pour commandsSize quantité de commandes et optionnellement commandsDataSize quantité de données. Si le paramètre commandsDataSize n'est pas fourni, l'espace est automatiquement réservé pour la quantité de données 2 * commandsSize, qui est la quantité optimale lorsque les commandes du chemin sont des lignes droites (moveTo(), lineTo(), rect()).

La réservation d'un espace correct permet d'optimiser la création des chemins et l'utilisation de la mémoire. Elle n'est pas obligatoire car un espace suffisant est automatiquement garanti lors de l'ajout de commandes au chemin.

Voir également reserve().

QCanvasPath::QCanvasPath(const QCanvasPath &path)

Construit un chemin qui est une copie du chemin donné path.

QCanvasPath::QCanvasPath(QCanvasPath &&other)

Move-construit un nouveau QCanvasPath à partir de other.

[noexcept] QCanvasPath::~QCanvasPath()

Détruit le chemin.

void QCanvasPath::addPath(const QCanvasPath &path, const QTransform &transform = QTransform())

Ajoute path à ce chemin, en utilisant éventuellement transform pour modifier les points du chemin. Lorsque transform n'est pas fourni (ou qu'il s'agit d'une matrice d'identité), cette opération est très rapide car elle réutilise les données du chemin.

void QCanvasPath::addPath(const QCanvasPath &path, qsizetype start, qsizetype count, const QTransform &transform = QTransform())

Ajoute path au chemin actuel, en commençant par la commande start et en incluant le nombre de commandes count. Il est possible d'utiliser transform pour modifier les points du chemin. La plage de start et count est vérifiée, de sorte que les commandes ne sont pas accédées plus que QCanvasPath::commandsSize(). Au cas où le chemin ne devrait pas continuer à partir de la position actuelle du chemin, appeler d'abord moveTo() avec path.positionAt(start - 1).

void QCanvasPath::arc(float centerX, float centerY, float radius, float a0, float a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

Crée un arc centré sur QPointF(centerX, centerY) avec radius, commençant à un angle de a0 radians et se terminant à a1 radians. L'arc s'étend sur direction. Lorsque connection est NotConnected, le chemin précédent est fermé et un nouveau chemin secondaire est créé.

void QCanvasPath::arc(QPointF centerPoint, float radius, float a0, float a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

Crée un arc centré sur centerPoint avec radius, commençant à un angle de a0 radians et se terminant à a1 radians. L'arc s'étend sur direction. Lorsque connection est NotConnected, le chemin précédent est fermé et un nouveau chemin secondaire est créé.

void QCanvasPath::arcTo(float x1, float y1, float x2, float y2, float radius)

Crée un arc à partir des points QPointF(x1, y1) et QPointF(x2, y2) avec le point donné radius.

void QCanvasPath::arcTo(QPointF point1, QPointF point2, float radius)

Crée un arc à partir des points point1 et point2 avec le point donné radius.

void QCanvasPath::beginHoleSubPath()

Commencer un sous-chemin de trou. Ceci est équivalent à setPathWinding(QCanvasPainter::PathWinding::ClockWise))

Voir aussi beginSolidSubPath().

void QCanvasPath::beginSolidSubPath()

Commencer un sous-chemin solide. Ceci est équivalent à setPathWinding(QCanvasPainter::PathWinding::CounterClockWise))

Voir aussi beginHoleSubPath().

void QCanvasPath::bezierCurveTo(float cp1X, float cp1Y, float cp2X, float cp2Y, float x, float y)

Ajoute une courbe de Bézier cubique entre la position actuelle et le point final spécifié par x et y, en utilisant les points de contrôle spécifiés par cp1X, cp1Y, cp2X et cp2Y.

Après l'ajout de la courbe, la position actuelle est mise à jour pour se situer au point final de la courbe.

void QCanvasPath::bezierCurveTo(QPointF controlPoint1, QPointF controlPoint2, QPointF endPoint)

Ajoute une courbe de Bézier cubique entre la position actuelle et l'adresse endPoint à l'aide des points de contrôle spécifiés par controlPoint1, et controlPoint2.

Après l'ajout de la courbe, la position actuelle est mise à jour pour se trouver au point final de la courbe.

void QCanvasPath::circle(float x, float y, float radius)

Ajoute au chemin un cercle dont le centre se trouve à QPointF(x, y) et le point donné radius.

void QCanvasPath::circle(QPointF centerPoint, float radius)

Ajoute à la trajectoire un cercle dont le centre se trouve à centerPoint et dont l'adresse est radius.

void QCanvasPath::clear()

Efface les commandes et les données du chemin.

Appelez cette commande lorsque les commandes du chemin changent afin de recréer le chemin. Cela n'affecte pas l'utilisation de la mémoire, utilisez reserve() et squeeze() pour cela.

Voir aussi reserve() et squeeze().

void QCanvasPath::closePath()

Ferme le sous-chemin actuel en traçant une ligne jusqu'au début du sous-chemin, démarrant ainsi automatiquement un nouveau chemin.

qsizetype QCanvasPath::commandsCapacity() const

Renvoie la capacité des commandes dans le chemin.

Voir aussi commandsDataCapacity() et reserve().

qsizetype QCanvasPath::commandsDataCapacity() const

Renvoie la capacité des données de commandes dans le chemin.

Voir aussi commandsCapacity() et reserve().

qsizetype QCanvasPath::commandsDataSize() const

Renvoie la quantité de données de commande dans le chemin.

Par données de commande, on entend les points requis par les commandes.

qsizetype QCanvasPath::commandsSize() const

Renvoie le nombre de commandes dans le chemin.

QPointF QCanvasPath::currentPosition() const

Renvoie la position actuelle du chemin. Il s'agit de la position où la commande de chemin précédente (moveTo, lineTo, bezierCurveTo etc.) s'est terminée. Si le chemin est vide, la valeur retournée est (0.0, 0.0).

void QCanvasPath::ellipse(float x, float y, float radiusX, float radiusY)

Crée une ellipse centrée sur (x, y), avec des rayons définis par radiusX, radiusY et l'ajoute au chemin en tant que sous-chemin fermé.

void QCanvasPath::ellipse(const QRectF &rect)

Crée une ellipse dans le rectangle rect et l'ajoute au chemin en tant que sous-chemin fermé.

bool QCanvasPath::isEmpty() const

Retourne vrai si le chemin est vide.

Voir aussi clear.

void QCanvasPath::lineTo(QPointF point)

Ajoute une ligne droite entre la position actuelle et la position donnée point. Une fois la ligne tracée, la position actuelle est mise à jour pour correspondre au point final de la ligne.

void QCanvasPath::lineTo(float x, float y)

Dessine une ligne depuis la position actuelle jusqu'au point (x, y).

void QCanvasPath::moveTo(QPointF point)

Déplace le point actuel sur le site point, en commençant implicitement un nouveau sous-chemin et en fermant le précédent.

void QCanvasPath::moveTo(float x, float y)

Déplace la position actuelle à (x, y) et démarre un nouveau sous-chemin, fermant implicitement le chemin précédent.

QPointF QCanvasPath::positionAt(qsizetype index) const

Renvoie la position du chemin à index. Cela signifie que la position où la commande du chemin (moveTo, lineTo, bezierCurveTo etc.) se trouve à index. L'index doit être compris entre 0 et commandsSize() - 1. Si le chemin est vide, le résultat est (0.0, 0.0).

void QCanvasPath::quadraticCurveTo(float cpX, float cpY, float x, float y)

Ajoute une courbe de Bézier quadratique entre le point actuel et le point final (x, y) avec le point de contrôle spécifié par (cpX, cpY).

void QCanvasPath::quadraticCurveTo(QPointF controlPoint, QPointF endPoint)

Ajoute une courbe de Bézier quadratique entre la position actuelle et l'adresse endPoint avec le point de contrôle spécifié par controlPoint.

void QCanvasPath::rect(float x, float y, float width, float height)

Crée un rectangle positionné à QPointF(x, y) avec les données width et height.

void QCanvasPath::rect(const QRectF &rect)

Crée un rectangle spécifié par rect

void QCanvasPath::reserve(qsizetype commandsSize, qsizetype commandsDataSize)

Réserve une quantité donnée d'espace dans la mémoire interne de QCanvasPath.

Tente d'allouer de la mémoire pour au moins les commandes commandsSize et les points de données commandsDataSize. Certains éléments du chemin nécessitent plusieurs commandes, voir commandsSize() et commandsDataSize().

La réservation d'un espace correct permet d'optimiser la création des chemins et l'utilisation de la mémoire. Elle n'est pas obligatoire, car un espace suffisant est automatiquement garanti lors de l'ajout de commandes dans le chemin.

Voir également squeeze(), commandsCapacity() et commandsDataCapacity().

void QCanvasPath::reserve(qsizetype commandsSize)

Réserve une quantité donnée d'espace dans la mémoire interne de QCanvasPath.

Tente d'allouer de la mémoire pour au moins commandsSize commandes. Certains éléments du chemin nécessitent plusieurs commandes, voir commandsSize() et commandsDataSize().

L'espace est automatiquement réservé pour la quantité de données 2 * commandsSize, qui est la quantité optimale lorsque les commandes du chemin sont des lignes droites (moveTo(), lineTo(), rect()).

La réservation d'un espace correct permet d'optimiser la création des chemins et l'utilisation de la mémoire. Elle n'est pas obligatoire car l'espace suffisant est automatiquement assuré lors de l'ajout de commandes dans le chemin.

Voir aussi squeeze(), commandsCapacity(), et commandsDataCapacity().

void QCanvasPath::roundRect(float x, float y, float width, float height, float radius)

Ajoute au chemin le rectangle donné x, y, width, height avec des coins arrondis. Les coins sont des quarts de cercle avec la valeur radius.

void QCanvasPath::roundRect(float x, float y, float width, float height, float radiusTopLeft, float radiusTopRight, float radiusBottomRight, float radiusBottomLeft)

Ajoute au chemin le rectangle x, y, width, height avec des coins arrondis. Les coins sont des quarts de cercle de rayon radiusTopLeft, radiusTopRight radiusBottomRight et radiusBottomLeft, respectivement.

void QCanvasPath::roundRect(const QRectF &rect, float radius)

Ajoute au chemin le rectangle donné rect avec des coins arrondis. Les coins sont des quarts de cercle avec la valeur donnée radius.

void QCanvasPath::roundRect(const QRectF &rect, float radiusTopLeft, float radiusTopRight, float radiusBottomRight, float radiusBottomLeft)

Ajoute le rectangle rect aux coins arrondis à la trajectoire. Les coins sont des quarts de cercle de rayon radiusTopLeft, radiusTopRight radiusBottomRight et radiusBottomLeft, respectivement.

void QCanvasPath::setPathWinding(QCanvasPainter::PathWinding winding)

Définit le sous-chemin actuel winding en QCanvasPainter::CounterClockWise (par défaut) ou QCanvasPainter::ClockWise. CounterClockWise dessine des sous-chemins pleins tandis que ClockWise dessine des trous.

QCanvasPath QCanvasPath::sliced(qsizetype start, qsizetype count, const QTransform &transform = QTransform()) const

Renvoie un nouveau chemin contenant les commandes de ce chemin, en commençant par la commande à start et en incluant la quantité de commandes à count, en utilisant éventuellement transform pour modifier les points du chemin.

L'intervalle entre start et count est vérifié, afin que les commandes ne soient pas accédées plus loin que commandsSize(). Si la commande à start n'est pas MoveTo, la première commande sera remplacée par MoveTo afin que cette tranche soit un chemin individuel.

void QCanvasPath::squeeze()

Libère la mémoire qui n'est pas nécessaire pour stocker les commandes et les données du chemin. Ceci peut être utilisé pour réduire l'utilisation de la mémoire après l'appel à reserve().

Normalement, cette fonction n'est pas nécessaire, mais elle peut être utile lorsque la taille du chemin a été importante en raison de la réservation ou de l'ajout de nombreux éléments (lineTo, bezierCurveTo etc.) et que l'on s'attend à ce que cette taille soit beaucoup plus petite à l'avenir. L'appel de reserve() puis de squeeze(), libère alors de la mémoire.

Voir aussi reserve().

[noexcept] void QCanvasPath::swap(QCanvasPath &other)

Remplace ce chemin par other. Cette opération est très rapide et n'échoue jamais.

QCanvasPath::operator QVariant() const

Retourne le chemin sous forme de QVariant.

[noexcept] QCanvasPath &QCanvasPath::operator=(QCanvasPath &&other)

Move-assigne other à cette instance QCanvasPath.

QCanvasPath &QCanvasPath::operator=(const QCanvasPath &path)

Affecte le site path à ce chemin et renvoie une référence à ce chemin.