Réglages du contexte

Les réglages que les commandes de dessin utilisent pour chaque option qu'on ne leur donne pas : ce sont les mêmes valeurs que montre la barre d'outils de l'éditeur. Lis-les avec app.getContext(), modifie-les avec app.setContext({ ... }). Ils ne font pas partie du document et ne peuvent pas être annulés.

• foregroundColor (color — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; par défaut { r = 0, g = 0, b = 0, a = 255 }) — La couleur de peinture : le color de chaque commande de dessin, et la couleur de départ du dégradé.
• backgroundColor (color — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; par défaut { r = 255, g = 255, b = 255, a = 255 }) — La couleur secondaire : la couleur d'arrivée du dégradé, et ce qu'échange swapColors.
• brushSize (integer 1–64; par défaut 1) — Taille du pinceau en pixels pour les formes intégrées (ignorée par un pinceau personnalisé). Définit aussi le rayon de l'aérosol (2 fois la taille).
• brushShape (BrushShape: "circle" | "square" | "line" | "diamond" | "cross" | "x" | "star" | "horizontal" | "custom"; par défaut "circle") — "line" est une ligne de 1 px inclinée selon brushAngle ; "square" est pivoté par celui-ci ; "circle", "diamond", "cross", "x" et "star" l'ignorent ; "horizontal" est une ligne à l'angle 0 qui l'ignore ; "custom" peint customBrush.
• brushAngle (integer 0–180; par défaut 0) — Angle du pinceau en degrés (0-180) : incline le pinceau "line" et fait pivoter le pinceau "square". Ignoré par les autres formes.
• customBrush ({ width, height, mask } or false; par défaut nil) — Le masque que peint un pinceau personnalisé : { rows = { ".#.", "###", ".#." } } ou { width, height, mask } avec mask une liste à plat de 0/1. Normalement défini avec app.useBrush(name) à partir d'un pinceau défini avec app.defineBrush. Sans masque, un pinceau personnalisé peint un point de 1 px.
• pixelPerfect (boolean; par défaut false) — Retire les marches de coin doublées des traits à main levée (quelle que soit la taille du pinceau) ; le pinceau est tamponné le long du trajet corrigé.
• eraserRightClick (EraserRightClick: "background" | "replace"; par défaut "background") — Bouton droit de la gomme : "background" peint la couleur d'arrière-plan partout où elle passe, "replace" ne transforme en couleur d'arrière-plan que les pixels de la couleur de premier plan (Aseprite).
• ink (Ink: "copy" | "simple" | "lock-alpha" | "shading"; par défaut "copy") — La façon dont la peinture (traits, aérosol, formes, lignes, polygone, contour, pot de peinture, dégradé, fillSelection) se combine avec les pixels existants : "copy" les remplace (par défaut), "simple" composite en alpha, "lock-alpha" ne recolore que les pixels visibles, "shading" fait avancer les pixels le long de shades.
• shades (list of colors — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; par défaut {}) — Le dégradé de nuances que l'encre shading parcourt, dans l'ordre : la boîte Nuances de l'éditeur (ou la plage de palette sélectionnée). Les commandes de dessin l'utilisent quand ink vaut shading.
• stabilizer (integer 0–64; par défaut 0) — Force du stabilisateur pour les traits à main levée : chaque point est moyenné avec les N points précédents, ce qui lisse les tremblements (le trait traîne derrière le curseur). 0 = désactivé.
• pressureSize (boolean; par défaut true) — Laisse la pression du stylet (une souris compte comme une pression maximale) piloter la taille du pinceau, de dynamicsMinSize jusqu'à brushSize.
• pressureAngle (boolean; par défaut false) — Laisse la pression du stylet (une souris compte comme une pression maximale) piloter l'angle du pinceau, de dynamicsMinAngle à dynamicsMaxAngle.
• pressureGradient (boolean; par défaut false) — Laisse la pression du stylet (une souris compte comme une pression maximale) fondre la couleur de foregroundColor vers backgroundColor le long du trait.
• pressureMin (integer 0–100; par défaut 0) — Valeur lue (en pourcentage) du capteur de pression qui correspond à l'extrémité basse. Si elle est supérieure à pressureMax, la correspondance est inversée.
• pressureMax (integer 0–100; par défaut 100) — Valeur lue (en pourcentage) du capteur de pression qui correspond à l'extrémité haute.
• velocitySize (boolean; par défaut false) — Laisse la vitesse du pointeur piloter la taille du pinceau, de dynamicsMinSize jusqu'à brushSize.
• velocityAngle (boolean; par défaut false) — Laisse la vitesse du pointeur piloter l'angle du pinceau, de dynamicsMinAngle à dynamicsMaxAngle.
• velocityGradient (boolean; par défaut false) — Laisse la vitesse du pointeur fondre la couleur de foregroundColor vers backgroundColor le long du trait.
• velocityMin (integer 0–100; par défaut 0) — Valeur lue (en pourcentage) du capteur de vitesse qui correspond à l'extrémité basse. Si elle est supérieure à velocityMax, la correspondance est inversée.
• velocityMax (integer 0–100; par défaut 100) — Valeur lue (en pourcentage) du capteur de vitesse qui correspond à l'extrémité haute.
• dynamicsMinSize (integer 1–64; par défaut 1) — Taille du pinceau à l'extrémité basse d'un capteur associé à la taille (l'extrémité haute est brushSize).
• dynamicsMinAngle (integer 0–180; par défaut 0) — Angle du pinceau à l'extrémité basse d'un capteur associé à l'angle.
• dynamicsMaxAngle (integer 0–180; par défaut 180) — Angle du pinceau à l'extrémité haute d'un capteur associé à l'angle.
• dynamicsDither (boolean; par défaut false) — La dynamique de dégradé choisit foregroundColor ou backgroundColor par pixel (tramage ordonné) au lieu de les fondre. Les sprites indexés alignent les mélanges sur la couleur de palette la plus proche.
• dynamicsCurve (integer 25–400; par défaut 100) — Courbe de sensibilité en pourcentage : la valeur du capteur est élevée à la puissance curve/100 (100 = linéaire ; au-dessus de 100, il faut plus de pression/vitesse pour qu'elle agisse).
• symmetry (list of SymmetryAxis: "horizontal" | "vertical" | "diagonal" | "antidiagonal"; par défaut {}) — Le réglage de symétrie du sprite actif (chaque sprite garde le sien, comme la position de son axe) : des axes de miroir passant par le centre de symétrie. Information en lecture seule : les commandes de dessin ne l'appliquent pas, sauf si tu passes symmetry = app.getContext().symmetry. Vide = désactivée ; plusieurs axes se combinent (horizontal + vertical = 4 directions).
• symmetryX (number (multiple of 0.5) or false; par défaut nil) — Où se trouve l'axe de symétrie vertical (et le point où se croisent les deux diagonales) : en pixels depuis le bord gauche du canevas, un multiple de 0.5 (entier = entre deux pixels, x.5 = au milieu d'un pixel). nil = centré. Comme symmetry, information en lecture seule : passe symmetryX = app.getContext().symmetryX à une commande de dessin pour la suivre. Mets false pour recentrer.
• symmetryY (number (multiple of 0.5) or false; par défaut nil) — Où se trouve l'axe de symétrie horizontal (et le croisement des diagonales) : en pixels depuis le bord supérieur du canevas, un multiple de 0.5. nil = centré. Mets false pour recentrer.
• tilemapMode (TilemapEditMode: "tiles" | "pixels-edit" | "pixels-auto"; par défaut "pixels-auto") — La façon dont la peinture de pixels traite un calque tilemap : "pixels-auto" donne à chaque cellule peinte sa propre tuile, "pixels-edit" modifie sur place la tuile partagée (tous les placements sont mis à jour), "tiles" n'autorise que le tamponnage de tuiles entières.
• shapeFillMode (FillMode: "outline" | "filled"; par défaut "outline") — Rectangles, ellipses, polygones et courbes fermées : contour ou plein.
• cornerRadius (integer 0–1024 (every corner), or a list of four, clockwise from the top-left; par défaut { 0, 0, 0, 0 }) — Rectangle : rayons des coins en pixels, dans le sens horaire à partir du coin supérieur gauche (0 = coin droit), chacun limité à la moitié du plus petit côté.
• selectionCornerRadius (integer 0–1024 (every corner), or a list of four, clockwise from the top-left; par défaut { 0, 0, 0, 0 }) — Sélection rectangulaire : rayons des coins en pixels, dans le sens horaire à partir du coin supérieur gauche (0 = coin droit).
• cornerRadiusLinked (boolean; par défaut true) — La barre d'options de l'outil modifie les quatre rayons de coin ensemble (un seul champ Rayon) au lieu d'un champ par coin.
• lineWidth (integer 1–64; par défaut 1) — Outils Ligne et Courbe : épaisseur en pixels (1 = une ligne nette de 1 px) ; les lignes plus larges ont des extrémités rondes.
• curvePixelPerfect (boolean; par défaut true) — Outil Courbe : retire les coins en L qu'une courbe de 1 px accumule, pour des lignes de pixel art propres.
• bucketFillMode (BucketFillMode: "contiguous" | "global"; par défaut "contiguous") — Pot de peinture : seulement la région connectée, ou tous les pixels correspondants.
• bucketTolerance (integer 0–255; par défaut 0) — Pot de peinture : la plus grande différence par canal qui compte encore comme la même couleur.
• bucketCloseGap (integer 0–5; par défaut 0) — Pot de peinture (contigu) : considère comme fermées les brèches du contour jusqu'à cette largeur en pixels, pour que le remplissage ne fuie pas à travers. 0 = désactivé.
• bucketDiagonal (boolean; par défaut false) — Pot de peinture (contigu) : se propage aussi aux voisins en diagonale (8-connexe), si bien que la région fuit à travers les lignes diagonales de 1 px.
• bucketStopAtGrid (boolean; par défaut false) — Pot de peinture : confine la région à la cellule de la grille où tombe le clic.
• bucketPattern (FillPattern: "solid" | "checker" | "dither25" | "dither75" | "hstripes" | "vstripes" | "diagonal" | "grid" | "dots" | "bricks"; par défaut "solid") — Pot de peinture : peint un motif répétitif à deux couleurs (la couleur de remplissage et l'autre entre premier plan/arrière-plan) au lieu d'une couleur unie. "solid" = pas de motif.
• wandFillMode (BucketFillMode: "contiguous" | "global"; par défaut "contiguous") — Baguette magique : seulement la région connectée, ou tous les pixels correspondants. Distinct de bucketFillMode du pot de peinture.
• wandTolerance (integer 0–255; par défaut 0) — Baguette magique : la plus grande différence par canal qui compte encore comme la même couleur. Distincte de bucketTolerance du pot de peinture.
• wandDiagonal (boolean; par défaut false) — Baguette magique (contigu) : se propage aussi aux voisins en diagonale (8-connexe), si bien que la région fuit à travers les lignes diagonales de 1 px.
• wandStopAtGrid (boolean; par défaut false) — Baguette magique : confine la région à la cellule de la grille où tombe le clic.
• sprayRate (integer 1–64; par défaut 8) — Aérosol : points par position.
• scatterX (integer 0–64; par défaut 8) — Dispersion : jusqu'où chaque tampon peut atterrir à gauche ou à droite du trajet, en pixels.
• scatterY (integer 0–64; par défaut 8) — Dispersion : jusqu'où chaque tampon peut atterrir au-dessus ou au-dessous du trajet, en pixels.
• scatterCount (integer 1–16; par défaut 2) — Dispersion : tampons placés à chaque pas le long du trajet.
• blurStrength (integer 1–4; par défaut 1) — Flou : rayon du voisinage en pixels.
• jumbleStrength (integer 0–100; par défaut 100) — Brouillage : pourcentage de chances que chaque pixel touché soit brouillé.
• dodgeBurnStrength (integer 1–100; par défaut 25) — Éclaircir/Assombrir : de combien la luminosité OKLCH de chaque pixel touché se déplace (100 = la moitié du noir au blanc).
• dodgeBurnHueShift (integer 0–60; par défaut 0) — Éclaircir/Assombrir : de combien de degrés la teinte OKLCH de chaque pixel touché tourne vers le jaune chaud (éclaircir) ou le bleu froid (assombrir), sans jamais le dépasser ; 0 garde la teinte.
• ditherPattern (DitherPattern: "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise"; par défaut "bayer2") — Pinceau de tramage : le motif ordonné à travers lequel il peint. Les motifs se répètent depuis le coin supérieur gauche du sprite, pour que les traits s'alignent.
• ditherDensity (integer 0–100; par défaut 50) — Pinceau de tramage : la part des pixels du motif qu'il peint, en pourcentage (50 avec bayer2 donne un damier).
• gradientType (GradientType: "linear" | "radial"; par défaut "linear") — Dégradé : un dégradé droit entre les points, ou rayonnant depuis le point de départ.
• gradientDithering (GradientDithering: "none" | "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise"; par défaut "bayer4") — Dégradé : le motif de tramage ordonné (none = un dégradé lisse).
• gradientSnap (GradientSnap: "free" | "palette"; par défaut "free") — Dégradé : mélanges libres, ou uniquement des couleurs de la palette (chaque pixel prend la couleur de palette la plus proche ; le tramage alterne entre des couleurs de palette voisines).
• gradientColors (GradientColors: "fg-bg" | "stops"; par défaut "fg-bg") — Dégradé : va de la couleur de premier plan à la couleur d'arrière-plan, ou le long de gradientStops ("stops" ; avec moins de deux points, on revient au premier plan vers l'arrière-plan).
• gradientStops (list of up to 32 { color, position } (position 0–1, in order), or of colors spread evenly; par défaut {}) — Dégradé : le dégradé à plusieurs points depuis le point de départ, sous forme d'entrées { color, position } (position 0-1, dans l'ordre ; deux à la même position font un bord net). Une simple liste de couleurs est répartie régulièrement. Utilisé quand gradientColors vaut "stops" ; la barre Points de l'éditeur le modifie.
• eyedropperSource (EyedropperSource: "composite" | "layer"; par défaut "composite") — Pipette : échantillonne ce que montre le canevas, ou seulement le calque actif.
• tileIndex (integer ≥ 0; par défaut 1) — Tampon de tuile : la tuile à placer, en commençant à 1 (0 = la tuile vide).
• tileFlipH (boolean; par défaut false) — Tampon de tuile : retourne horizontalement les tuiles placées.
• tileFlipV (boolean; par défaut false) — Tampon de tuile : retourne verticalement les tuiles placées.
• tileRotate90 (boolean; par défaut false) — Tampon de tuile : fait pivoter les tuiles placées de 90° dans le sens horaire.
• tilePlace (boolean; par défaut false) — Placer des tuiles : sur un calque tilemap, le crayon, la gomme, la ligne, les outils de forme et le pot de peinture placent la tuile du tampon de tuile (l'effacent, pour la gomme) sur les cellules qu'ils couvrent au lieu de peindre des pixels.
• isoShape (IsoShape: "box" | "ramp" | "stairs" | "pyramid" | "prism" | "cylinder" | "cone" | "sphere" | "dome"; par défaut "box") — Outil Forme isométrique : le solide qu'il dessine.
• isoWidth (integer 1–1024; par défaut 8) — Outil Forme isométrique : emprise le long de x (en bas à droite), en unités iso (une ligne de l'escalier du bord chacune).
• isoDepth (integer 1–1024; par défaut 8) — Outil Forme isométrique : emprise le long de y (en bas à gauche), en unités iso.
• isoHeight (integer 0–1024; par défaut 8) — Outil Forme isométrique : hauteur en pixels (0 = plat).
• isoBevel (integer 0–1024; par défaut 0) — Outil Forme isométrique : pour les boîtes uniquement, de combien de pixels les arêtes du dessus sont chanfreinées (0 = à angle droit).
• isoCap (integer 2–4; par défaut 3) — Outil Forme isométrique : le segment plat aux sommets du haut et du bas, 2 (pair), 3 (impair) ou 4 (multiples de quatre). C'est aussi le pas de glissement de W / D (2 unités avec cap 4).
• isoStyle (IsoShapeStyle: "filled" | "outline" | "filled-outline"; par défaut "filled-outline") — Outil Forme isométrique : faces, contour, ou les deux.
• isoHiddenEdges (boolean; par défaut false) — Outil Forme isométrique : dessine aussi les arêtes derrière le solide.
• isoDirection (IsoDirection: "+x" | "-x" | "+y" | "-y"; par défaut "+x") — Outil Forme isométrique : dans quel sens descend une rampe ou un escalier, ou vers où font face les pentes d'un prisme.
• isoAutoShade (boolean; par défaut true) — Outil Forme isométrique : dérive les cinq couleurs de la couleur de premier plan le long de shades (true), ou utilise isoColors (false).
• isoColors (list of colors — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; par défaut { { r = 34, g = 32, b = 52, a = 255 }, { r = 69, g = 68, b = 79, a = 255 }, { r = 203, g = 219, b = 252, a = 255 }, { r = 139, g = 155, b = 180, a = 255 }, { r = 90, g = 105, b = 136, a = 255 } }) — Outil Forme isométrique : les couleurs utilisées quand isoAutoShade est désactivé, dans l'ordre contour, arête intérieure, dessus, gauche, droite.

En Markdown : context-settings.md.