Kontexteinstellungen

Die Einstellungen, die Zeichenbefehle für jede Option verwenden, die ihnen nicht übergeben wird – dieselben Werte, die die Werkzeugleiste des Editors zeigt. Lies sie mit app.getContext(), ändere sie mit app.setContext({ ... }). Sie sind kein Teil des Dokuments und lassen sich nicht rückgängig machen.

• foregroundColor (color — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; Standard { r = 0, g = 0, b = 0, a = 255 }) — Die Malfarbe: die color jedes Zeichenbefehls und die Startfarbe des Verlaufs.
• backgroundColor (color — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; Standard { r = 255, g = 255, b = 255, a = 255 }) — Die Zweitfarbe: die Endfarbe des Verlaufs und das, was swapColors vertauscht.
• brushSize (integer 1–64; Standard 1) — Pinselgröße in Pixeln für die eingebauten Formen (ein eigener Pinsel ignoriert sie). Legt auch den Sprühradius fest (2x die Größe).
• brushShape (BrushShape: "circle" | "square" | "line" | "diamond" | "cross" | "x" | "star" | "horizontal" | "custom"; Standard "circle") — "line" ist eine 1px-Linie, die um brushAngle gekippt wird; "square" wird um ihn gedreht; "circle", "diamond", "cross", "x" und "star" ignorieren ihn; "horizontal" ist eine Linie bei Winkel 0, die ihn ignoriert; "custom" malt customBrush.
• brushAngle (integer 0–180; Standard 0) — Pinselwinkel in Grad (0-180): kippt den "line"-Pinsel und dreht den "square"-Pinsel. Andere Formen ignorieren ihn.
• customBrush ({ width, height, mask } or false; Standard nil) — Die Maske, die ein eigener Pinsel malt: { rows = { ".#.", "###", ".#." } } oder { width, height, mask } mit mask als flacher 0/1-Liste. Wird normalerweise mit app.useBrush(name) für einen mit app.defineBrush definierten Pinsel gesetzt. Ohne Maske malt ein eigener Pinsel einen 1px-Punkt.
• pixelPerfect (boolean; Standard false) — Entfernt doppelte Eckschritte aus Freihandstrichen (bei jeder Pinselgröße); der Pinsel wird entlang des korrigierten Pfads gestempelt.
• eraserRightClick (EraserRightClick: "background" | "replace"; Standard "background") — Rechte Taste des Radierers: "background" malt überall dort, wo er hinkommt, die Hintergrundfarbe, "replace" macht nur Pixel in der Vordergrundfarbe zur Hintergrundfarbe (Aseprite).
• ink (Ink: "copy" | "simple" | "lock-alpha" | "shading"; Standard "copy") — Wie Farbe (Striche, Sprühen, Formen, Linien, Polygon, Kontur, Farbeimer, Verlauf, fillSelection) sich mit vorhandenen Pixeln verbindet: "copy" ersetzt sie (Standard), "simple" komponiert per Alpha, "lock-alpha" färbt nur sichtbare Pixel um, "shading" schaltet Pixel entlang von shades weiter.
• shades (list of colors — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; Standard {}) — Die Farbreihe, entlang der die Tinte Schattierung schaltet, der Reihe nach: das Abstufungen-Feld des Editors (oder der ausgewählte Palettenbereich). Zeichenbefehle nutzen sie, wenn die Tinte Schattierung ist.
• stabilizer (integer 0–64; Standard 0) — Stärke des Stabilisators für Freihandstriche: Jeder Punkt wird mit den vorherigen N Punkten gemittelt, was Wackeln glättet (der Strich hinkt dem Cursor hinterher). 0 = aus.
• pressureSize (boolean; Standard true) — Lässt den Stiftdruck (eine Maus zählt als voller Druck) die Pinselgröße steuern, von dynamicsMinSize bis brushSize.
• pressureAngle (boolean; Standard false) — Lässt den Stiftdruck (eine Maus zählt als voller Druck) den Pinselwinkel steuern, von dynamicsMinAngle bis dynamicsMaxAngle.
• pressureGradient (boolean; Standard false) — Lässt den Stiftdruck (eine Maus zählt als voller Druck) die Farbe entlang des Strichs von foregroundColor zu backgroundColor überblenden.
• pressureMin (integer 0–100; Standard 0) — Messwert (in Prozent) des Drucksensors, der dem unteren Ende zugeordnet wird. Ein Wert über pressureMax kehrt die Zuordnung um.
• pressureMax (integer 0–100; Standard 100) — Messwert (in Prozent) des Drucksensors, der dem oberen Ende zugeordnet wird.
• velocitySize (boolean; Standard false) — Lässt die Zeigergeschwindigkeit die Pinselgröße steuern, von dynamicsMinSize bis brushSize.
• velocityAngle (boolean; Standard false) — Lässt die Zeigergeschwindigkeit den Pinselwinkel steuern, von dynamicsMinAngle bis dynamicsMaxAngle.
• velocityGradient (boolean; Standard false) — Lässt die Zeigergeschwindigkeit die Farbe entlang des Strichs von foregroundColor zu backgroundColor überblenden.
• velocityMin (integer 0–100; Standard 0) — Messwert (in Prozent) des Geschwindigkeitssensors, der dem unteren Ende zugeordnet wird. Ein Wert über velocityMax kehrt die Zuordnung um.
• velocityMax (integer 0–100; Standard 100) — Messwert (in Prozent) des Geschwindigkeitssensors, der dem oberen Ende zugeordnet wird.
• dynamicsMinSize (integer 1–64; Standard 1) — Pinselgröße am unteren Ende eines Sensors, der der Größe zugeordnet ist (das obere Ende ist brushSize).
• dynamicsMinAngle (integer 0–180; Standard 0) — Pinselwinkel am unteren Ende eines Sensors, der dem Winkel zugeordnet ist.
• dynamicsMaxAngle (integer 0–180; Standard 180) — Pinselwinkel am oberen Ende eines Sensors, der dem Winkel zugeordnet ist.
• dynamicsDither (boolean; Standard false) — Die Verlaufsdynamik wählt pro Pixel foregroundColor oder backgroundColor (geordnetes Dithering), statt zu überblenden. Bei indizierten Sprites rasten Überblendungen auf die nächste Palettenfarbe ein.
• dynamicsCurve (integer 25–400; Standard 100) — Empfindlichkeitskurve in Prozent: Der Sensorwert wird mit curve/100 potenziert (100 = linear; über 100 braucht es mehr Druck/Geschwindigkeit, bis es wirkt).
• symmetry (list of SymmetryAxis: "horizontal" | "vertical" | "diagonal" | "antidiagonal"; Standard {}) — Die Symmetrieeinstellung des aktiven Sprites (jeder Sprite behält seine eigene, wie die Lage seiner Achse): Spiegelachsen durch das Symmetriezentrum. Nur lesbare Information – Zeichenbefehle wenden sie nicht an, außer du übergibst symmetry = app.getContext().symmetry. Leer = aus; mehrere Achsen kombinieren sich (horizontal + vertikal = 4-fach).
• symmetryX (number (multiple of 0.5) or false; Standard nil) — Wo die vertikale Symmetrieachse (und der Punkt, an dem sich beide Diagonalen kreuzen) liegt: Pixel vom linken Rand der Leinwand, ein Vielfaches von 0.5 (ganzzahlig = zwischen Pixeln, x.5 = durch die Mitte eines Pixels). nil = zentriert. Wie symmetry nur lesbare Information: Übergib symmetryX = app.getContext().symmetryX an einen Zeichenbefehl, damit er ihr folgt. Mit false wird neu zentriert.
• symmetryY (number (multiple of 0.5) or false; Standard nil) — Wo die horizontale Symmetrieachse (und der Kreuzungspunkt der Diagonalen) liegt: Pixel vom oberen Rand der Leinwand, ein Vielfaches von 0.5. nil = zentriert. Mit false wird neu zentriert.
• tilemapMode (TilemapEditMode: "tiles" | "pixels-edit" | "pixels-auto"; Standard "pixels-auto") — Wie Pixelfarbe eine Tilemap-Ebene behandelt: "pixels-auto" gibt jeder bemalten Zelle ein eigenes Tile, "pixels-edit" bearbeitet das gemeinsame Tile an Ort und Stelle (jede Platzierung wird aktualisiert), "tiles" erlaubt nur das Stempeln ganzer Tiles.
• shapeFillMode (FillMode: "outline" | "filled"; Standard "outline") — Rechtecke, Ellipsen, Polygone und geschlossene Kurven: Umriss oder gefüllt.
• cornerRadius (integer 0–1024 (every corner), or a list of four, clockwise from the top-left; Standard { 0, 0, 0, 0 }) — Rechteck: Eckenradien in Pixeln, im Uhrzeigersinn ab oben links (0 = eckige Ecke), jeweils auf die Hälfte der kürzeren Seite begrenzt.
• selectionCornerRadius (integer 0–1024 (every corner), or a list of four, clockwise from the top-left; Standard { 0, 0, 0, 0 }) — Rechteckauswahl: Eckenradien in Pixeln, im Uhrzeigersinn ab oben links (0 = eckige Ecke).
• cornerRadiusLinked (boolean; Standard true) — Die Optionsleiste des Werkzeugs bearbeitet alle vier Eckenradien gemeinsam (ein Feld Radius) statt eines Felds pro Ecke.
• lineWidth (integer 1–64; Standard 1) — Werkzeuge Linie und Kurve: Stärke in Pixeln (1 = harte 1px-Linie); breitere Linien bekommen runde Enden.
• curvePixelPerfect (boolean; Standard true) — Werkzeug Kurve: Entfernt die L-förmigen Ecken, die eine 1px-Kurve bekommt, für saubere Pixel-Art-Linien.
• bucketFillMode (BucketFillMode: "contiguous" | "global"; Standard "contiguous") — Füllen: nur der zusammenhängende Bereich oder jedes passende Pixel.
• bucketTolerance (integer 0–255; Standard 0) — Füllen: der größte Unterschied pro Kanal, der noch als dieselbe Farbe gilt.
• bucketCloseGap (integer 0–5; Standard 0) — Füllen (zusammenhängend): Lücken im Umriss bis zu dieser Breite in Pixeln gelten als geschlossen, sodass die Füllung nicht hindurchläuft. 0 = aus.
• bucketDiagonal (boolean; Standard false) — Füllen (zusammenhängend): breitet sich auch auf diagonale Nachbarn aus (8er-Nachbarschaft), sodass der Bereich durch 1px-Diagonallinien durchläuft.
• bucketStopAtGrid (boolean; Standard false) — Füllen: begrenzt den Bereich auf die Rasterzelle, in die der Klick fällt.
• bucketPattern (FillPattern: "solid" | "checker" | "dither25" | "dither75" | "hstripes" | "vstripes" | "diagonal" | "grid" | "dots" | "bricks"; Standard "solid") — Füllen: malt ein sich wiederholendes Zweifarbmuster (die Füllfarbe und die jeweils andere von Vorder-/Hintergrundfarbe) statt einer einfarbigen Fläche. "solid" = kein Muster.
• wandFillMode (BucketFillMode: "contiguous" | "global"; Standard "contiguous") — Zauberstab: nur der zusammenhängende Bereich oder jedes passende Pixel. Getrennt von bucketFillMode des Füllens.
• wandTolerance (integer 0–255; Standard 0) — Zauberstab: der größte Unterschied pro Kanal, der noch als dieselbe Farbe gilt. Getrennt von bucketTolerance des Füllens.
• wandDiagonal (boolean; Standard false) — Zauberstab (zusammenhängend): breitet sich auch auf diagonale Nachbarn aus (8er-Nachbarschaft), sodass der Bereich durch 1px-Diagonallinien durchläuft.
• wandStopAtGrid (boolean; Standard false) — Zauberstab: begrenzt den Bereich auf die Rasterzelle, in die der Klick fällt.
• sprayRate (integer 1–64; Standard 8) — Sprühen: Punkte pro Stelle.
• scatterX (integer 0–64; Standard 8) — Streuen: wie weit jeder Stempel links oder rechts vom Pfad landen kann, in Pixeln.
• scatterY (integer 0–64; Standard 8) — Streuen: wie weit jeder Stempel oberhalb oder unterhalb des Pfads landen kann, in Pixeln.
• scatterCount (integer 1–16; Standard 2) — Streuen: Stempel, die bei jedem Schritt entlang des Pfads gesetzt werden.
• blurStrength (integer 1–4; Standard 1) — Weichzeichnen: Radius der Umgebung in Pixeln.
• jumbleStrength (integer 0–100; Standard 100) — Durchmischen: Wahrscheinlichkeit in Prozent, dass jedes berührte Pixel verwürfelt wird.
• dodgeBurnStrength (integer 1–100; Standard 25) — Abwedeln/Nachbelichten: wie weit sich die OKLCH-Helligkeit jedes berührten Pixels verschiebt (100 = die Hälfte von Schwarz zu Weiß).
• dodgeBurnHueShift (integer 0–60; Standard 0) — Abwedeln/Nachbelichten: Grad, um die sich der OKLCH-Farbton jedes berührten Pixels zu warmem Gelb (Abwedeln) oder kühlem Blau (Nachbelichten) dreht, nie darüber hinaus; 0 behält den Farbton.
• ditherPattern (DitherPattern: "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise"; Standard "bayer2") — Dithering-Pinsel: das geordnete Muster, durch das er malt. Muster kacheln von der oberen linken Ecke des Sprites aus, sodass Striche zueinander passen.
• ditherDensity (integer 0–100; Standard 50) — Dithering-Pinsel: der Anteil der Musterpixel, die er malt, in Prozent (50 mit bayer2 ist ein Schachbrett).
• gradientType (GradientType: "linear" | "radial"; Standard "linear") — Verlauf: eine gerade Farbreihe zwischen den Punkten oder strahlenförmig vom Startpunkt aus.
• gradientDithering (GradientDithering: "none" | "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise"; Standard "bayer4") — Verlauf: das geordnete Dithering-Muster (none = ein glatter Verlauf).
• gradientSnap (GradientSnap: "free" | "palette"; Standard "free") — Verlauf: freie Überblendungen oder nur Palettenfarben (jedes Pixel die nächste Palettenfarbe; das Dithering schaltet zwischen benachbarten Palettenfarben).
• gradientColors (GradientColors: "fg-bg" | "stops"; Standard "fg-bg") — Verlauf: läuft von der Vorder- zur Hintergrundfarbe oder entlang von gradientStops ("stops"; bei weniger als zwei Stopps gilt Vorder- zu Hintergrundfarbe).
• gradientStops (list of up to 32 { color, position } (position 0–1, in order), or of colors spread evenly; Standard {}) — Verlauf: die Farbreihe mit mehreren Stopps ab dem Startpunkt, als { color, position }-Einträge (position 0-1, der Reihe nach; zwei an derselben Position ergeben eine harte Kante). Eine einfache Farbliste wird gleichmäßig verteilt. Wird verwendet, wenn gradientColors "stops" ist; die Stopps-Leiste des Editors bearbeitet sie.
• eyedropperSource (EyedropperSource: "composite" | "layer"; Standard "composite") — Pipette: nimmt auf, was die Leinwand zeigt, oder nur die aktive Ebene.
• tileIndex (integer ≥ 0; Standard 1) — Tile-Stempel: das 1-basierte Tile, das platziert wird (0 = das leere Tile).
• tileFlipH (boolean; Standard false) — Tile-Stempel: spiegelt platzierte Tiles horizontal.
• tileFlipV (boolean; Standard false) — Tile-Stempel: spiegelt platzierte Tiles vertikal.
• tileRotate90 (boolean; Standard false) — Tile-Stempel: dreht platzierte Tiles um 90° im Uhrzeigersinn.
• tilePlace (boolean; Standard false) — Tiles platzieren: Auf einer Tilemap-Ebene setzen Stift, Radierer, Linie, Formwerkzeuge und Farbeimer das Tile des Tile-Stempels (beim Radierer: löschen es) auf die Zellen, die sie abdecken, statt Pixel zu malen.
• isoShape (IsoShape: "box" | "ramp" | "stairs" | "pyramid" | "prism" | "cylinder" | "cone" | "sphere" | "dome"; Standard "box") — Werkzeug Iso-Form: der Körper, den es zeichnet.
• isoWidth (integer 1–1024; Standard 8) — Werkzeug Iso-Form: Grundfläche entlang x (nach rechts unten), in Iso-Einheiten (je eine Zeile der Kantentreppe).
• isoDepth (integer 1–1024; Standard 8) — Werkzeug Iso-Form: Grundfläche entlang y (nach links unten), in Iso-Einheiten.
• isoHeight (integer 0–1024; Standard 8) — Werkzeug Iso-Form: Höhe in Pixeln (0 = flach).
• isoBevel (integer 0–1024; Standard 0) — Werkzeug Iso-Form: nur bei Quadern, um wie viele Pixel die oberen Kanten abgeschrägt werden (0 = eckig).
• isoCap (integer 2–4; Standard 3) — Werkzeug Iso-Form: das flache Stück an den oberen und unteren Eckpunkten, 2 (gerade), 3 (ungerade) oder 4 (Vielfache von vier). Auch der Ziehschritt für W / D (2 Einheiten bei Cap 4).
• isoStyle (IsoShapeStyle: "filled" | "outline" | "filled-outline"; Standard "filled-outline") — Werkzeug Iso-Form: Flächen, Umriss oder beides.
• isoHiddenEdges (boolean; Standard false) — Werkzeug Iso-Form: zeichnet auch die Kanten hinter dem Körper.
• isoDirection (IsoDirection: "+x" | "-x" | "+y" | "-y"; Standard "+x") — Werkzeug Iso-Form: in welche Richtung eine Rampe oder Treppe abfällt oder die Schrägen eines Prismas zeigen.
• isoAutoShade (boolean; Standard true) — Werkzeug Iso-Form: leitet die fünf Farben aus der Vordergrundfarbe entlang von shades ab (true) oder verwendet isoColors (false).
• isoColors (list of colors — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; Standard { { 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 } }) — Werkzeug Iso-Form: die Farben, die bei ausgeschaltetem isoAutoShade verwendet werden, in der Reihenfolge Umriss, Innenkante, Oberseite, links, rechts.

Als Markdown: context-settings.md.