Impostazioni del contesto

Le impostazioni che i comandi di disegno usano per ogni opzione non specificata: gli stessi valori mostrati dalla barra degli strumenti dell'editor. Leggile con app.getContext(), modificale con app.setContext({ ... }). Non fanno parte del documento e non si possono annullare.

• foregroundColor (color — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; predefinito { r = 0, g = 0, b = 0, a = 255 }) — Il colore di pittura: il color di ogni comando di disegno e il colore iniziale del gradiente.
• backgroundColor (color — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; predefinito { r = 255, g = 255, b = 255, a = 255 }) — Il colore secondario: il colore finale del gradiente e ciò che scambia swapColors.
• brushSize (integer 1–64; predefinito 1) — Dimensione del pennello in pixel per le forme integrate (ignorata da un pennello personalizzato). Imposta anche il raggio dello spray (2x la dimensione).
• brushShape (BrushShape: "circle" | "square" | "line" | "diamond" | "cross" | "x" | "star" | "horizontal" | "custom"; predefinito "circle") — "line" è una linea di 1px inclinata da brushAngle; "square" viene ruotato da esso; "circle", "diamond", "cross", "x" e "star" lo ignorano; "horizontal" è una linea ad angolo 0 che lo ignora; "custom" dipinge customBrush.
• brushAngle (integer 0–180; predefinito 0) — Angolo del pennello in gradi (0-180): inclina il pennello "line" e ruota il pennello "square". Ignorato dalle altre forme.
• customBrush ({ width, height, mask } or false; predefinito nil) — La maschera che dipinge un pennello personalizzato: { rows = { ".#.", "###", ".#." } } oppure { width, height, mask } con mask una lista piatta di 0/1. Di norma si imposta con app.useBrush(name) da un pennello definito con app.defineBrush. Senza maschera, un pennello personalizzato dipinge un punto di 1px.
• pixelPerfect (boolean; predefinito false) — Rimuove i gradini d'angolo doppi dai tratti a mano libera (con qualsiasi dimensione del pennello); il pennello viene timbrato lungo il percorso corretto.
• eraserRightClick (EraserRightClick: "background" | "replace"; predefinito "background") — Pulsante destro della gomma: "background" dipinge il colore di sfondo ovunque tocchi, "replace" trasforma in colore di sfondo solo i pixel del colore di primo piano (Aseprite).
• ink (Ink: "copy" | "simple" | "lock-alpha" | "shading"; predefinito "copy") — Come la pittura (tratti, spray, forme, linee, poligono, contorno, secchiello, gradiente, fillSelection) si combina con i pixel esistenti: "copy" li sostituisce (il predefinito), "simple" compone con alfa, "lock-alpha" ricolora solo i pixel visibili, "shading" fa avanzare i pixel lungo shades.
• shades (list of colors — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; predefinito {}) — La rampa lungo cui avanza l'inchiostro shading, in ordine: la casella Sfumature dell'editor (o l'intervallo di palette selezionato). I comandi di disegno la usano quando ink è shading.
• stabilizer (integer 0–64; predefinito 0) — Intensità dello stabilizzatore per i tratti a mano libera: ogni punto viene mediato con gli N punti precedenti, attenuando le oscillazioni (il tratto è in ritardo rispetto al cursore). 0 = disattivato.
• pressureSize (boolean; predefinito true) — Fa governare la dimensione del pennello alla pressione della penna (un mouse conta come pressione piena), da dynamicsMinSize fino a brushSize.
• pressureAngle (boolean; predefinito false) — Fa governare l'angolo del pennello alla pressione della penna (un mouse conta come pressione piena), da dynamicsMinAngle a dynamicsMaxAngle.
• pressureGradient (boolean; predefinito false) — Fa sì che la pressione della penna (un mouse conta come pressione piena) fonda il colore da foregroundColor a backgroundColor lungo il tratto.
• pressureMin (integer 0–100; predefinito 0) — Lettura (in percentuale) del sensore di pressione che corrisponde all'estremo basso. Se è maggiore di pressureMax inverte la corrispondenza.
• pressureMax (integer 0–100; predefinito 100) — Lettura (in percentuale) del sensore di pressione che corrisponde all'estremo alto.
• velocitySize (boolean; predefinito false) — Fa governare la dimensione del pennello alla velocità del puntatore, da dynamicsMinSize fino a brushSize.
• velocityAngle (boolean; predefinito false) — Fa governare l'angolo del pennello alla velocità del puntatore, da dynamicsMinAngle a dynamicsMaxAngle.
• velocityGradient (boolean; predefinito false) — Fa sì che la velocità del puntatore fonda il colore da foregroundColor a backgroundColor lungo il tratto.
• velocityMin (integer 0–100; predefinito 0) — Lettura (in percentuale) del sensore di velocità che corrisponde all'estremo basso. Se è maggiore di velocityMax inverte la corrispondenza.
• velocityMax (integer 0–100; predefinito 100) — Lettura (in percentuale) del sensore di velocità che corrisponde all'estremo alto.
• dynamicsMinSize (integer 1–64; predefinito 1) — Dimensione del pennello all'estremo basso di un sensore associato alla dimensione (l'estremo alto è brushSize).
• dynamicsMinAngle (integer 0–180; predefinito 0) — Angolo del pennello all'estremo basso di un sensore associato all'angolo.
• dynamicsMaxAngle (integer 0–180; predefinito 180) — Angolo del pennello all'estremo alto di un sensore associato all'angolo.
• dynamicsDither (boolean; predefinito false) — Le dinamiche del gradiente scelgono foregroundColor o backgroundColor per ogni pixel (dithering ordinato) invece di fonderli. Gli sprite indicizzati agganciano le miscele al colore di palette più vicino.
• dynamicsCurve (integer 25–400; predefinito 100) — Curva di sensibilità in percentuale: il valore del sensore viene elevato a curve/100 (100 = lineare, oltre 100 serve più pressione/velocità perché abbia effetto).
• symmetry (list of SymmetryAxis: "horizontal" | "vertical" | "diagonal" | "antidiagonal"; predefinito {}) — L'impostazione di simmetria dello sprite attivo (ogni sprite ha la propria, come la posizione dell'asse): assi speculari che passano per il centro di simmetria. Solo informazione di lettura: i comandi di disegno non la applicano a meno che tu non passi symmetry = app.getContext().symmetry. Vuoto = disattivata; più assi si combinano (orizzontale + verticale = a 4 vie).
• symmetryX (number (multiple of 0.5) or false; predefinito nil) — Dove si trova l'asse di simmetria verticale (e il punto in cui si incrociano entrambe le diagonali): pixel dal bordo sinistro della tela, multiplo di 0.5 (intero = tra i pixel, x.5 = al centro di un pixel). nil = centrato. Come symmetry, solo informazione di lettura: passa symmetryX = app.getContext().symmetryX a un comando di disegno perché lo segua. Imposta false per ricentrare.
• symmetryY (number (multiple of 0.5) or false; predefinito nil) — Dove si trova l'asse di simmetria orizzontale (e l'incrocio delle diagonali): pixel dal bordo superiore della tela, multiplo di 0.5. nil = centrato. Imposta false per ricentrare.
• tilemapMode (TilemapEditMode: "tiles" | "pixels-edit" | "pixels-auto"; predefinito "pixels-auto") — Come la pittura di pixel tratta un livello tilemap: "pixels-auto" dà a ogni cella dipinta il proprio tile, "pixels-edit" modifica sul posto il tile condiviso (ogni posizionamento si aggiorna), "tiles" consente solo la timbratura di tile interi.
• shapeFillMode (FillMode: "outline" | "filled"; predefinito "outline") — Rettangoli, ellissi, poligoni e curve chiuse: contorno o pieno.
• cornerRadius (integer 0–1024 (every corner), or a list of four, clockwise from the top-left; predefinito { 0, 0, 0, 0 }) — Rettangolo: raggi degli angoli in pixel, in senso orario dall'alto a sinistra (0 = angolo vivo), ciascuno limitato alla metà del lato più corto.
• selectionCornerRadius (integer 0–1024 (every corner), or a list of four, clockwise from the top-left; predefinito { 0, 0, 0, 0 }) — Selezione a riquadro rettangolare: raggi degli angoli in pixel, in senso orario dall'alto a sinistra (0 = angolo vivo).
• cornerRadiusLinked (boolean; predefinito true) — La barra delle opzioni dello strumento modifica insieme tutti e quattro i raggi degli angoli (un solo campo Raggio) invece di un campo per angolo.
• lineWidth (integer 1–64; predefinito 1) — Strumenti Linea e Curva: spessore in pixel (1 = una linea netta di 1px); le linee più larghe hanno estremità arrotondate.
• curvePixelPerfect (boolean; predefinito true) — Strumento Curva: rimuove gli angoli a L che una curva di 1px si porta dietro, per linee di pixel art pulite.
• bucketFillMode (BucketFillMode: "contiguous" | "global"; predefinito "contiguous") — Riempimento: solo la regione connessa, o ogni pixel corrispondente.
• bucketTolerance (integer 0–255; predefinito 0) — Riempimento: la massima differenza per canale che conta ancora come lo stesso colore.
• bucketCloseGap (integer 0–5; predefinito 0) — Riempimento (contiguo): considera chiuse le lacune nel contorno larghe fino a questo numero di pixel, così il riempimento non trabocca. 0 = disattivato.
• bucketDiagonal (boolean; predefinito false) — Riempimento (contiguo): si estende anche ai vicini diagonali (8-connessi), così la regione trabocca attraverso le linee diagonali di 1px.
• bucketStopAtGrid (boolean; predefinito false) — Riempimento: limita la regione alla cella della griglia in cui cade il clic.
• bucketPattern (FillPattern: "solid" | "checker" | "dither25" | "dither75" | "hstripes" | "vstripes" | "diagonal" | "grid" | "dots" | "bricks"; predefinito "solid") — Riempimento: dipinge un motivo ripetuto a due colori (il colore di riempimento e l'altro tra primo piano/sfondo) invece di un colore pieno. "solid" = nessun motivo.
• wandFillMode (BucketFillMode: "contiguous" | "global"; predefinito "contiguous") — Bacchetta magica: solo la regione connessa, o ogni pixel corrispondente. Distinta da bucketFillMode del riempimento.
• wandTolerance (integer 0–255; predefinito 0) — Bacchetta magica: la massima differenza per canale che conta ancora come lo stesso colore. Distinta da bucketTolerance del riempimento.
• wandDiagonal (boolean; predefinito false) — Bacchetta magica (contigua): si estende anche ai vicini diagonali (8-connessi), così la regione trabocca attraverso le linee diagonali di 1px.
• wandStopAtGrid (boolean; predefinito false) — Bacchetta magica: limita la regione alla cella della griglia in cui cade il clic.
• sprayRate (integer 1–64; predefinito 8) — Spray: punti per ogni punto.
• scatterX (integer 0–64; predefinito 8) — Dispersione: quanto lontano a sinistra o a destra del percorso può cadere ogni timbro, in pixel.
• scatterY (integer 0–64; predefinito 8) — Dispersione: quanto lontano sopra o sotto il percorso può cadere ogni timbro, in pixel.
• scatterCount (integer 1–16; predefinito 2) — Dispersione: timbri posizionati a ogni passo lungo il percorso.
• blurStrength (integer 1–4; predefinito 1) — Sfocatura: raggio dell'intorno in pixel.
• jumbleStrength (integer 0–100; predefinito 100) — Mescola: probabilità percentuale che ogni pixel toccato venga rimescolato.
• dodgeBurnStrength (integer 1–100; predefinito 25) — Scherma/Brucia: di quanto si sposta la luminosità OKLCH di ogni pixel toccato (100 = metà da nero a bianco).
• dodgeBurnHueShift (integer 0–60; predefinito 0) — Scherma/Brucia: gradi di cui la tonalità OKLCH di ogni pixel toccato ruota verso il giallo caldo (scherma) o il blu freddo (brucia), senza mai superarlo; 0 mantiene la tonalità.
• ditherPattern (DitherPattern: "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise"; predefinito "bayer2") — Pennello dithering: il motivo ordinato attraverso cui dipinge. I motivi si ripetono a partire dall'angolo in alto a sinistra dello sprite, così i tratti si allineano.
• ditherDensity (integer 0–100; predefinito 50) — Pennello dithering: la quota di pixel del motivo che dipinge, in percentuale (50 con bayer2 è una scacchiera).
• gradientType (GradientType: "linear" | "radial"; predefinito "linear") — Gradiente: una rampa dritta tra i punti, oppure che si irradia dal punto iniziale.
• gradientDithering (GradientDithering: "none" | "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise"; predefinito "bayer4") — Gradiente: il motivo di dithering ordinato (none = una rampa continua).
• gradientSnap (GradientSnap: "free" | "palette"; predefinito "free") — Gradiente: miscele libere, oppure solo colori della palette (ogni pixel il colore di palette più vicino; il dithering procede a gradini tra colori adiacenti della palette).
• gradientColors (GradientColors: "fg-bg" | "stops"; predefinito "fg-bg") — Gradiente: va dal colore di primo piano a quello di sfondo, oppure lungo gradientStops ("stops"; con meno di due punti si torna da primo piano a sfondo).
• gradientStops (list of up to 32 { color, position } (position 0–1, in order), or of colors spread evenly; predefinito {}) — Gradiente: la rampa a più punti dal punto iniziale, come voci { color, position } (position 0-1, in ordine; due nella stessa posizione creano un bordo netto). Una semplice lista di colori viene distribuita in modo uniforme. Usata quando gradientColors è "stops"; la barra Punti dell'editor la modifica.
• eyedropperSource (EyedropperSource: "composite" | "layer"; predefinito "composite") — Contagocce: campiona ciò che mostra la tela, oppure solo il livello attivo.
• tileIndex (integer ≥ 0; predefinito 1) — Timbro di tile: il tile da posizionare, a partire da 1 (0 = il tile vuoto).
• tileFlipH (boolean; predefinito false) — Timbro di tile: capovolge orizzontalmente i tile posizionati.
• tileFlipV (boolean; predefinito false) — Timbro di tile: capovolge verticalmente i tile posizionati.
• tileRotate90 (boolean; predefinito false) — Timbro di tile: ruota i tile posizionati di 90° in senso orario.
• tilePlace (boolean; predefinito false) — Posiziona tile: su un livello tilemap la matita, la gomma, la linea, gli strumenti per le forme e il secchiello posizionano il tile del timbro di tile (lo cancellano, per la gomma) sulle celle che coprono invece di dipingere pixel.
• isoShape (IsoShape: "box" | "ramp" | "stairs" | "pyramid" | "prism" | "cylinder" | "cone" | "sphere" | "dome"; predefinito "box") — Strumento Forma isometrica: il solido che disegna.
• isoWidth (integer 1–1024; predefinito 8) — Strumento Forma isometrica: impronta lungo x (in basso a destra), in unità isometriche (una riga della scalinatura del bordo ciascuna).
• isoDepth (integer 1–1024; predefinito 8) — Strumento Forma isometrica: impronta lungo y (in basso a sinistra), in unità isometriche.
• isoHeight (integer 0–1024; predefinito 8) — Strumento Forma isometrica: altezza in pixel (0 = piatta).
• isoBevel (integer 0–1024; predefinito 0) — Strumento Forma isometrica: solo per i parallelepipedi, di quanti pixel vengono smussati i bordi superiori (0 = vivi).
• isoCap (integer 2–4; predefinito 3) — Strumento Forma isometrica: il tratto piatto ai vertici superiore e inferiore, 2 (pari), 3 (dispari) o 4 (multipli di quattro). È anche il passo di trascinamento W / D (2 unità con cap 4).
• isoStyle (IsoShapeStyle: "filled" | "outline" | "filled-outline"; predefinito "filled-outline") — Strumento Forma isometrica: facce, contorno, o entrambi.
• isoHiddenEdges (boolean; predefinito false) — Strumento Forma isometrica: disegna anche gli spigoli dietro il solido.
• isoDirection (IsoDirection: "+x" | "-x" | "+y" | "-y"; predefinito "+x") — Strumento Forma isometrica: in che direzione scende una rampa o una scala, o verso dove sono rivolte le falde di un prisma.
• isoAutoShade (boolean; predefinito true) — Strumento Forma isometrica: ricava i cinque colori dal colore di primo piano lungo shades (true), oppure usa isoColors (false).
• isoColors (list of colors — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; predefinito { { 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 } }) — Strumento Forma isometrica: i colori usati quando isoAutoShade è disattivato, in ordine contorno, spigolo interno, alto, sinistra, destra.

In Markdown: context-settings.md.