Documentation de Gambas - /comp/gb.cairo/cairo

/comp/gb.cairo/cairo

# 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.

Cette classe est statique.

Propriétés statiques | Méthodes statiques | Constantes
--- | --- | ---

Retourne ou définit le mode antialiasing du 'rasterizer' (convertisseur en image matricielle) utilisé pour tracer les formes.
AntiAlias
Calcule une boîte de découpage, en coordonnées utilisateur, couvrant la surface dans le clip courant.
ClipExtents
Retourne ou définit le motif de pointillé utilisé par Cairo.Stroke.
Dash
Retourne ou définit le décalage utilisé pour le tracé des tirets.
DashOffset
Retourne le périphérique sur lequel vous dessinez avec la classe Cairo.
Device
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.
FillExtents
Retourne ou définit la règle de remplissage courante pour le tracé en cours.
FillRule
Retourne la police utilisée pour dessiner du texte.
Font
Retourne ou définit le style de terminaison de la ligne en cours dans le contexte cairo.
LineCap
Retourne ou définit le style de raccordement de la ligne en cours dans le contexte cairo.
LineJoin
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).
LineWidth
Retourne ou définit la matrice de transformation courante.
Matrix
Retourne ou fixe l'angle limite des extrémités.
MiterLimit
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é.
Operator
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.
PathExtents
Retourne ou définit le motif source pour un tracé.
Source
Teste si une erreur est apparue antérieurement, en retournant l'état du dessin en cours.
Status
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.
StrokeExtents
Retourne ou définit la tolérance employée lors de la conversion du tracé en trapezoides.
Tolerance

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.
Arc
ArcNegative
Démarre le tracé sur le périphérique spécifié.
Begin
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).
Clip
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.
ClosePath
Crée un nouveau motif Cairo correspondant à une couleur opaque ou translucide.
ColorPattern
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.
CopyPage
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).
CurveTo
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.
DrawText
Termine un tracé.
End
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).
Fill
Crée un nouveau motif Cairo à partir d’une image.
ImagePattern
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.
InFill
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.
InStroke
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).
LineTo
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 .
LinearGradient
Un opérateur de dessin qui peint la source courante en utilisant le canal alpha de motif comme masque.
Mask
Débute un nouveau tracé secondaire. Après cet appel, le point en cours sera (X, Y).
MoveTo
Efface le tracé courant. Après cet appel il n'y a plus de tracé ni de point en cours.
NewPath
Commence un tracé secondaire.
NewSubPath
Un opérateur de dessin qui peint la source courante dans toute la région sélectionnée.
Paint
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 .
RadialGradient
Ajoute un sous tracé rectangle fermé de la taille donnée au tracé courant, à la position (X, Y) en coordonnées espace utilisateur.
Rectangle
Version en coordonnées relatives de Cairo.CurveTo.
RelCurveTo
Version en coordonnées relatives de Cairo.LineTo().
RelLineTo
Débute un nouveau tracé secondaire. Après cet appel, le point en cours sera décalé par (DX, DY).
RelMoveTo
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.
ResetClip
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.
Restore
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.
Rotate
Fait une copie de l’état du dessin en cours et la sauvegarde sur une pile interne d’états sauvegardés.
Save
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.
Scale
Emet et efface la page en cours pour les terminaux (backends) qui gèrent les pages multiple .
ShowPage
Crée un nouveau motif Cairo correspondant à une couleur opaque translucide.
SolidPattern
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.
Stroke
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`.
Text
Renvoie l’étendue d’une chaîne textuelle.
TextExtents
Modifie la matrice de transformation courante (MTC) en translatant les origines de l'espace utilisateur par (TX, TY).
Translate

Utilise l'anticrénelage (antialiasing) par défaut pour le sous système et le périphérique cible.
AntiAliasDefault
Effectue un anticrénelage (antialiasing) monochrome (utilisation de dégradé de gris pour le texte noir sur fond blanc , par exemple).
AntiAliasGray
Utilise un masque alpha à 2 niveaux.
AntiAliasNone
Effectue un anticrénelage (antialiasing) en s'appuyant sur l'ordre des élements sous-pixels sur des périphérique comme les afficheurs LCD.
AntiAliasSubPixel
Les pixels en dehors du motif source sont entièrement transparents.
ExtendNone
Pixels extérieurs à la copie de model (pattern) les plus près de la source.
ExtendPad
Le motif est pavé par réflexion sur les bords.
ExtendReflect
Le motif est pavé par répétition.
ExtendRepeat
Constante utilisée pour sélectionner comment les trajets sont remplis.
FillRuleEvenOdd
Constante utilisée pour sélectionner comment les trajets sont remplis.
FillRuleWinding
La meilleure qualité disponible, les performances risquent d'être inadaptées pour un usage inter actif.
FilterBest
Interpolation linéaire en deux dimensions.
FilterBilinear
Filtre de haute performance, avec une qualité similaire à FilterNearest.
FilterFast
Cette valeur de filtre n'est pas implémentée pour le moment, et ne doit pas être utilisée dans le code courant.
FilterGaussian
Filtre aux performances raisonnables, avec une qualité comparable à FilterBilinear.
FilterGood
Filtrage selon le plus proche voisin.
FilterNearest
Style de police Italique.
FontSlantItalic
Style de police droite.
FontSlantNormal
Style de police oblique.
FontSlantOblique
Graisse de police : gras.
FontWeightBold
Graisse de police normale.
FontWeightNormal
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) .
LineCapButt
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.
LineCapRound
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.
LineCapSquare
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.
LineJoinBevel
Séecifie le rendu de la jonction de deux lignes utilisant un coin droit (anguleux).
LineJoinMiter
Spécifie le rendu de la jonction de deux lignes utilisant un coin arrondi, le centre du cercle étant le point de jonction.
LineJoinRound
Opérateur de composition qui trace la source par dessus le contenu dans la couche destination et uniquement là.
OperatorATop
Opérateur de composition qui additionne les couches source et destination.
OperatorAdd
Opérateur de composition qui efface la couche destination (borné).
OperatorClear
Opérateur de composition qui ignore la source.
OperatorDest
Opérateur de composition qui dépose l'image destination par dessus le contenu de la source et uniquement là (non borné).
OperatorDestATop
Opérateur de composition qui dépose l'image destination uniquement là ou il y avait du contenu (non borné).
OperatorDestIn
Opérateur de composition qui dépose l'image destination uniquement là ou il n'y avait pas de contenu.
OperatorDestOut
Opérateur de composition qui trace l'image destination par dessus la source.
OperatorDestOver
Opérateur de composition qui trace la source où il y avait un contenu dans la couche destination (non borné).
OperatorIn
Opérateur de composition qui trace la source où il n'y avait pas de contenu dans la couche destination (non borné).
OperatorOut
Opérateur de composition qui trace la couche source par dessus la couche destination (borné).
OperatorOver
Opérateur de composition qui se comporte comme OperatorOver, mais en supposant que source et destination sont de géométries disjointes.
OperatorSaturate
Operateur de composition qui remplace la couche destination (borné).
OperatorSource
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.
OperatorXor
Cette constante est utilisée par la propriété Status pour représenter l'erreur suivante :
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 : Valeur d'interval invalide.
StatusInvalidStride
Constante utilisée par la propriété Status pour représenter l'erreur suivante :
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 quand aucune erreur n'est apparue.
StatusSuccess
Constante utilisée par la propriété Status pour représenter l'erreur suivante :
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