Cairo (gb.cairo)

Cete classe est utilisée pour dessiner sur un objet Image avec la bibliothèque Cairo.

Avant de commencer à tracer quoique ce soit, vous devez appeler la Méthode Begin en lui passant l'image sur laquelle vous voulez dessiner.

Ensuite, vous pouvez appeler n'importe quelle méthode de dessin pour définir des trajets, les tracer, les remplir, etc ...

Quand votre dessin est fini, vous devez appeler la méthode End.

Constantes

AntiAliasDefault	Utilise l'anticrénelage (antialiasing) par défaut pour le sous système et le périphérique cible.
AntiAliasGray	Effectue un anticrénelage (antialiasing) monochrome (utilisation de dégradé de gris pour le texte noir sur fond blanc , par exemple).
AntiAliasNone	Utilise un masque alpha à 2 niveaux.
AntiAliasSubPixel	Effectue un anticrénelage (antialiasing) en s'appuyant sur l'ordre des élements sous-pixels sur des périphérique comme les afficheurs LCD.
ExtendNone	Les pixels en dehors du motif source sont entièrement transparents.
ExtendPad	Pixels extérieurs à la copie de model (pattern) les plus près de la source.
ExtendReflect	Le motif est pavé par réflexion sur les bords.
ExtendRepeat	Le motif est pavé par répétition.
FillRuleEvenOdd	Constante utilisée pour sélectionner comment les trajets sont remplis.
FillRuleWinding	Constante utilisée pour sélectionner comment les trajets sont remplis.
FilterBest	La meilleure qualité disponible, les performances risquent d'être inadaptées pour un usage inter actif.
FilterBilinear	Interpolation linéaire en deux dimensions.
FilterFast	Filtre de haute performance, avec une qualité similaire à FilterNearest.
FilterGaussian	Cette valeur de filtre n'est pas implémentée pour le moment, et ne doit pas être utilisée dans le code courant.
FilterGood	Filtre aux performances raisonnables, avec une qualité comparable à FilterBilinear.
FilterNearest	Filtrage selon le plus proche voisin.
FontSlantItalic	Style de police Italique.
FontSlantNormal	Style de police droite.
FontSlantOblique	Style de police oblique.
FontWeightBold	Graisse de police : gras.
FontWeightNormal	Graisse de police normale.
LineCapButt	Spécifie le rendu des points terminaux du trajet lors du tracé d’un contour débutant (ou finissant) exactement la ligne au point initial (ou final) .
LineCapRound	Spécifie le rendu des points terminaux du trajet lors du tracé d’un contour avec extrémités arrondies, le centre du cercle étant le point final.
LineCapSquare	Spécifie le rendu des points terminaux du trajet lors du tracé d’un contour avec extrémités carrées, le milieu du carré étant le point final.
LineJoinBevel	Spécifie le rendu de la jonction de deux lignes utilisant un coin biaisé, la jonction étant arrêtée au milieux de la largeur de ligne à partir du point de jonction.
LineJoinMiter	Séecifie le rendu de la jonction de deux lignes utilisant un coin droit (anguleux).
LineJoinRound	Spécifie le rendu de la jonction de deux lignes utilisant un coin arrondi, le centre du cercle étant le point de jonction.
OperatorATop	Opérateur de composition qui trace la source par dessus le contenu dans la couche destination et uniquement là.
OperatorAdd	Opérateur de composition qui additionne les couches source et destination.
OperatorClear	Opérateur de composition qui efface la couche destination (borné).
OperatorDest	Opérateur de composition qui ignore la source.
OperatorDestATop	Opérateur de composition qui dépose l'image destination par dessus le contenu de la source et uniquement là (non borné).
OperatorDestIn	Opérateur de composition qui dépose l'image destination uniquement là ou il y avait du contenu (non borné).
OperatorDestOut	Opérateur de composition qui dépose l'image destination uniquement là ou il n'y avait pas de contenu.
OperatorDestOver	Opérateur de composition qui trace l'image destination par dessus la source.
OperatorIn	Opérateur de composition qui trace la source où il y avait un contenu dans la couche destination (non borné).
OperatorOut	Opérateur de composition qui trace la source où il n'y avait pas de contenu dans la couche destination (non borné).
OperatorOver	Opérateur de composition qui trace la couche source par dessus la couche destination (borné).
OperatorSaturate	Opérateur de composition qui se comporte comme OperatorOver, mais en supposant que source et destination sont de géométries disjointes.
OperatorSource	Operateur de composition qui remplace la couche destination (borné).
OperatorXor	Opérateur de composition qui conserve les images source et destination là où il n'y a de contenu que pour qu'une seule des deux.
StatusClipNotRepresentable	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusFileNotFound	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusFontTypeMismatch	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidClusters	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidContent	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidDash	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidDscComment	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidFormat	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidIndex	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidMatrix	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidPathData	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidPopGroup	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidRestore	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidSlant	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidStatus	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidStride	Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante : Valeur d'interval invalide.
StatusInvalidString	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidVisual	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusInvalidWeight	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusNegativeCount	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusNoCurrentPoint	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusNoMemory	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusNullPointer	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusPatternTypeMismatch	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusReadError	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusSuccess	Constante utilisée par la propriété Status quand aucune erreur n'est apparue.
StatusSurfaceFinished	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusSurfaceTypeMismatch	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusTempFileError	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusUserFontError	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusUserFontImmutable	Constante utilisée par la propriété Status pour représenter l'erreur suivante :
StatusWriteError	Constante utilisée par la propriété Status pour représenter l'erreur suivante :

Propriétés statiques

AntiAlias	Retourne ou définit le mode antialiasing du 'rasterizer' (convertisseur en image matricielle) utilisé pour tracer les formes.
ClipExtents	Calcule une boîte de découpage, en coordonnées utilisateur, couvrant la surface dans le clip courant.
Dash	Retourne ou définit le motif de pointillé utilisé par Cairo.Stroke.
DashOffset	Retourne ou définit le décalage utilisé pour le tracé des tirets.
Device	Retourne le périphérique sur lequel vous dessinez avec la classe Cairo.
FillExtents	Calcule une boîte de détourage en coordonnées utilisateur couvrant la surface qui sera affectée , (la surface "encrée" ), par une opération Fill selon le chemin courant et les paramètres de remplissage. Si le chemin courant est vide, retourne un rectangle vide ((0,0), (0,0)). Les dimensions de surface et le découpage ne sont pas pris en compte.
FillRule	Retourne ou définit la règle de remplissage courante pour le tracé en cours.
Font	Retourne la police utilisée pour dessiner du texte.
LineCap	Retourne ou définit le style de terminaison de la ligne en cours dans le contexte cairo.
LineJoin	Retourne ou définit le style de raccordement de la ligne en cours dans le contexte cairo.
LineWidth	Retourne ou définit la largeur de la ligne en cours. La valeur de largeur de ligne spécifie le diamètre d’un stylo qui est circulaire en espace utilisateur, même si l’espace dispositif-stylo est en général une ellipse à cause de la mise à l’échelle/rotation/déformation de la matrice courante de transformation (MCT).
Matrix	Retourne ou définit la matrice de transformation courante.
MiterLimit	Retourne ou fixe l'angle limite des extrémités.
Operator	Retourne ou définit l’opérateur de composition à employer pour toutes les opérations de tracé. Voyez chacun des constantes ci-dessous pour des détails de sémantique concernant chaque opérateur de composition accepté.
PathExtents	Calcule une boîte circonscrite, en coordonnées utilisateur, qui couvre les points du tracé en cours. Si le tracé courant est vide, retourne un rectangle vide. Les paramètres de tracé, les règles de remplissage, les dimensios de la surface et de la sélection sont ignorés.
Source	Retourne ou définit le motif source pour un tracé.
Status	Teste si une erreur est apparue antérieurement, en retournant l'état du dessin en cours.
StrokeExtents	Calcule une boîte de détourage en coordonnées utilisateur couvrant la surface qui serait affectée (la surface encrée) par une opération Cairo.Stroke , relativement au trait en cours et aux paramètres de tracé. Si le trait en cours est vide, retourne un rectangle vide. Les dimensions de la Surface et de sélection ne sont pas pris en compte.
Tolerance	Retourne ou définit la tolérance employée lors de la conversion du tracé en trapezoides.

Méthodes statiques

Arc	Ajoute un arc de cercle de rayon Radius au tracé courant. L'arc est centré à (XC, YC), commence à Angle1 et s'étend dans la direction des angles croissants jusqu'à Angle2. Si Angle2 est plus petit que Angle1 il sera progressivement incrémenté de 2 * π jusqu'à être supérieur à Angle1.
ArcNegative
Begin	Démarre le tracé sur le périphérique spécifié.
Clip	Etablit une nouvelle région de sélection par intersection de la sélection courante avec le tracé courant comme s’il devait être rempli par Cairo.Fill et en accord avec les règes de remplissage courantes (voir Cairo.FillRule).
ClosePath	Ajoute un segment de droite au tracé à partir du point en cours jusqu’au tracé secondaire courant, (le point le plus récent passé à Cairo.MoveTo), et ferme ce tracé secondaire. Après cet appel, le point courant sera au point de concours avec le tracé secondaire.
ColorPattern	Crée un nouveau motif Cairo correspondant à une couleur opaque ou translucide.
CopyPage	Emet la page en cours pour le termibal qui gère les pages multiples , mais ne l'efface pas; ainsi, le contenu de la page courante sera également retenu pour la page suivante.
CurveTo	Ajoute une courbe de Bézier cubique au tracé à partir du point courant jusqu’à la position (X3, Y3) en coordonnées utilisateur, en prenant (X1, Y1) and (X2, Y2) comme points de contrôle . Après cet appel, le point courant sera (X3, Y3).
DrawText	Un opérateur de tracé qui génère des formes à partir d'une chaîne de caractères UTF-8, avec un rendu dépendant de la Font courante.
End	Termine un tracé.
Fill	Un opérateur de dessin qui remplit le tracé en cours selon la règle de remplissage courante, (Chaque sous tracé est implicitement fermé avant d’être rempli).
ImagePattern	Crée un nouveau motif Cairo à partir d’une image.
InFill	Teste si le point désigné est dans ou hors la surface qui sera affectée par une opération Cairo.Fill en fonction du tracé courant et des paramètres de remplissage. Les dimensions de la surface et de la sélection ne sont pas pris en compte.
InStroke	Teste si le point désigné est dans ou hors la surface qui sera affectée par une opération Cairo.Stroke en fonction du tracé courant et des paramètres de l’outil de tracé. Les dimensions de la surface et de la sélection ne sont pas pris en compte.
LineTo	Ajoute une ligne au tracé depuis le point courant jusqu'a la position (X, Y) en coordonnées espace utilistaur. Après cet appel le point courant deviendra (X, Y).
LinearGradient	Crée un nouveau model (pattern) de gradient linéaire Cairo le long de la ligne définie par (X0, Y0) et(X1, Y1), et utilisant les bornes de couleur definies par l'argument Colors .
Mask	Un opérateur de dessin qui peint la source courante en utilisant le canal alpha de motif comme masque.
MoveTo	Débute un nouveau tracé secondaire. Après cet appel, le point en cours sera (X, Y).
NewPath	Efface le tracé courant. Après cet appel il n'y a plus de tracé ni de point en cours.
NewSubPath	Commence un tracé secondaire.
Paint	Un opérateur de dessin qui peint la source courante dans toute la région sélectionnée.
RadialGradient	Crée un nouveau model (pattern) de gradient radial Cairo entre les deux cercles définis par (CX0, CY0, Radius0) et (CX1, CY1, Radius1), et utilisant les color stops definis par l'argument Colors .
Rectangle	Ajoute un sous tracé rectangle fermé de la taille donnée au tracé courant, à la position (X, Y) en coordonnées espace utilisateur.
RelCurveTo	Version en coordonnées relatives de Cairo.CurveTo.
RelLineTo	Version en coordonnées relatives de Cairo.LineTo().
RelMoveTo	Débute un nouveau tracé secondaire. Après cet appel, le point en cours sera décalé par (DX, DY).
ResetClip	Réinitialise la région de sélection actuelle à son état d’origine, sans restriction. C'est-à-dire, définit la région de sélection comme une forme infiniment grande contenant la surface cible. De manière équivalente, si l’infinité est trop grande pour être atteinte, on peut imaginer la région de sélection comme étant réinitialisée aux limites de la surface cible.
Restore	Restaure l'état d'un tracé avec celui sauvegardé par un précédent appel à Save et retire cet état de la pile des états sauvegardés.
Rotate	Modifie la matrice de transformation courante (CTM) par rotation des axes de l’espace utilisateur d’un angle en radians. La rotation des axes a lieu après toute transformation existante de l’espace utilisateur. La direction de la rotation pour les angles positifs est de l’axe des X positifs vers l’axe des Y positifs.
Save	Fait une copie de l’état du dessin en cours et la sauvegarde sur une pile interne d’états sauvegardés.
Scale	Modifie la matrice de transformation courante (CTM) en redimensionnant les axes X et Y de l’espace utilisateur respectivement par sx et sy. Le redimensionnant des axes s’effectue après toute transformation existante de l’espace utilisateur.
ShowPage	Emet et efface la page en cours pour les terminaux (backends) qui gèrent les pages multiple .
SolidPattern	Crée un nouveau motif Cairo correspondant à une couleur opaque translucide.
Stroke	Un opérateur de dessin qui applique au tracé courant la largeur de ligne courante, la jointure de ligne, , la forme de terminaison, et les pointillés.
Text	Ajoute au chemin en cours, des chemins fermés pour le texte. Le chemin généré est rempli, produisant un effet similaire à celui de Cairo.DrawText.
TextExtents	Renvoie l’étendue d’une chaîne textuelle.
Translate	Modifie la matrice de transformation courante (MTC) en translatant les origines de l'espace utilisateur par (TX, TY).