Ajustes del contexto

Los colores, el pincel y las opciones de herramienta que usan por defecto los comandos de dibujo, más el interruptor de simetría de la interfaz (solo informativo).

Los ajustes que usan los comandos de dibujo para cada opción que no se les da: los mismos valores que muestra la barra de herramientas del editor. Léelos con app.getContext() y cambia cualquiera con app.setContext({ ... }). No forman parte del documento y no se pueden deshacer.

  • foregroundColor (color — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; predeterminado { r = 0, g = 0, b = 0, a = 255 }) — El color de pintura: el color de cada comando de dibujo y el color inicial del degradado.
  • backgroundColor (color — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; predeterminado { r = 255, g = 255, b = 255, a = 255 }) — El color secundario: el color final del degradado y lo que intercambia swapColors.
  • brushSize (integer 1–64; predeterminado 1) — Tamaño del pincel en píxeles para las formas integradas (lo ignora un pincel personalizado). También fija el radio del aerógrafo (2x el tamaño).
  • brushShape (BrushShape: "circle" | "square" | "line" | "diamond" | "cross" | "x" | "star" | "horizontal" | "custom"; predeterminado "circle") — "line" es una línea de 1px inclinada por brushAngle; "square" se gira con él; "circle", "diamond", "cross", "x" y "star" lo ignoran; "horizontal" es una línea en ángulo 0 que lo ignora; "custom" pinta customBrush.
  • brushAngle (integer 0–180; predeterminado 0) — Ángulo del pincel en grados (0-180): inclina el pincel "line" y gira el pincel "square". Las demás formas lo ignoran.
  • customBrush ({ width, height, mask } or false; predeterminado nil) — La máscara que pinta un pincel personalizado: { rows = { ".#.", "###", ".#." } } o { width, height, mask } con mask una lista plana de 0/1. Normalmente se establece con app.useBrush(name) a partir de un pincel definido con app.defineBrush. Sin máscara, un pincel personalizado pinta un punto de 1px.
  • pixelPerfect (boolean; predeterminado false) — Quita los escalones dobles en las esquinas de los trazos a mano alzada (con cualquier tamaño de pincel); el pincel se estampa a lo largo del camino corregido.
  • eraserRightClick (EraserRightClick: "background" | "replace"; predeterminado "background") — Botón derecho del borrador: "background" pinta el color de fondo en todo lo que toca, "replace" convierte en color de fondo solo los píxeles del color de primer plano (Aseprite).
  • ink (Ink: "copy" | "simple" | "lock-alpha" | "shading"; predeterminado "copy") — Cómo se combina la pintura (trazos, aerógrafo, formas, líneas, polígono, contorno, bote de pintura, degradado, fillSelection) con los píxeles existentes: "copy" los reemplaza (el valor predeterminado), "simple" compone con alfa, "lock-alpha" recolorea solo los píxeles visibles, "shading" avanza los píxeles a lo largo de shades.
  • shades (list of colors — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; predeterminado {}) — La rampa a lo largo de la cual avanza la tinta de sombreado, en orden: el cuadro Tonos del editor (o el rango de paleta seleccionado). Los comandos de dibujo la usan cuando la tinta es shading.
  • stabilizer (integer 0–64; predeterminado 0) — Intensidad del estabilizador en los trazos a mano alzada: cada punto se promedia con los N puntos anteriores, lo que suaviza el temblor (el trazo se queda atrás del cursor). 0 = desactivado.
  • pressureSize (boolean; predeterminado true) — Deja que la presión del lápiz (un mouse cuenta como presión máxima) controle el tamaño del pincel, desde dynamicsMinSize hasta brushSize.
  • pressureAngle (boolean; predeterminado false) — Deja que la presión del lápiz (un mouse cuenta como presión máxima) controle el ángulo del pincel, desde dynamicsMinAngle hasta dynamicsMaxAngle.
  • pressureGradient (boolean; predeterminado false) — Deja que la presión del lápiz (un mouse cuenta como presión máxima) mezcle el color de foregroundColor a backgroundColor a lo largo del trazo.
  • pressureMin (integer 0–100; predeterminado 0) — Lectura (porcentaje) del sensor de presión que corresponde al extremo bajo. Si es mayor que pressureMax, invierte la correspondencia.
  • pressureMax (integer 0–100; predeterminado 100) — Lectura (porcentaje) del sensor de presión que corresponde al extremo alto.
  • velocitySize (boolean; predeterminado false) — Deja que la velocidad del puntero controle el tamaño del pincel, desde dynamicsMinSize hasta brushSize.
  • velocityAngle (boolean; predeterminado false) — Deja que la velocidad del puntero controle el ángulo del pincel, desde dynamicsMinAngle hasta dynamicsMaxAngle.
  • velocityGradient (boolean; predeterminado false) — Deja que la velocidad del puntero mezcle el color de foregroundColor a backgroundColor a lo largo del trazo.
  • velocityMin (integer 0–100; predeterminado 0) — Lectura (porcentaje) del sensor de velocidad que corresponde al extremo bajo. Si es mayor que velocityMax, invierte la correspondencia.
  • velocityMax (integer 0–100; predeterminado 100) — Lectura (porcentaje) del sensor de velocidad que corresponde al extremo alto.
  • dynamicsMinSize (integer 1–64; predeterminado 1) — Tamaño del pincel en el extremo bajo de un sensor asignado al tamaño (el extremo alto es brushSize).
  • dynamicsMinAngle (integer 0–180; predeterminado 0) — Ángulo del pincel en el extremo bajo de un sensor asignado al ángulo.
  • dynamicsMaxAngle (integer 0–180; predeterminado 180) — Ángulo del pincel en el extremo alto de un sensor asignado al ángulo.
  • dynamicsDither (boolean; predeterminado false) — La dinámica de degradado elige foregroundColor o backgroundColor por píxel (tramado ordenado) en lugar de mezclar. En los sprites indexados, las mezclas se ajustan al color de paleta más cercano.
  • dynamicsCurve (integer 25–400; predeterminado 100) — Curva de sensibilidad en porcentaje: el valor del sensor se eleva a curve/100 (100 = lineal; por encima de 100 hace falta más presión o velocidad para que surta efecto).
  • symmetry (list of SymmetryAxis: "horizontal" | "vertical" | "diagonal" | "antidiagonal"; predeterminado {}) — El ajuste de simetría del sprite activo (cada sprite conserva el suyo, igual que la posición de su eje): ejes de espejo que pasan por el centro de simetría. Es solo información de lectura: los comandos de dibujo no la aplican a menos que pases symmetry = app.getContext().symmetry. Vacío = desactivada; varios ejes se combinan (horizontal + vertical = 4 direcciones).
  • symmetryX (number (multiple of 0.5) or false; predeterminado nil) — Dónde está el eje de simetría vertical (y el punto donde se cruzan ambas diagonales): píxeles desde el borde izquierdo del lienzo, un múltiplo de 0.5 (entero = entre píxeles, x.5 = por el centro de un píxel). nil = centrado. Igual que symmetry, es solo información de lectura: pasa symmetryX = app.getContext().symmetryX a un comando de dibujo para seguirlo. Establécelo en false para recentrar.
  • symmetryY (number (multiple of 0.5) or false; predeterminado nil) — Dónde está el eje de simetría horizontal (y el cruce de las diagonales): píxeles desde el borde superior del lienzo, un múltiplo de 0.5. nil = centrado. Establécelo en false para recentrar.
  • tilemapMode (TilemapEditMode: "tiles" | "pixels-edit" | "pixels-auto"; predeterminado "pixels-auto") — Cómo trata la pintura de píxeles una capa de tilemap: "pixels-auto" da a cada celda pintada su propio tile, "pixels-edit" edita el tile compartido en su sitio (se actualizan todas las colocaciones), "tiles" solo permite estampar tiles completos.
  • shapeFillMode (FillMode: "outline" | "filled"; predeterminado "outline") — Rectángulos, elipses, polígonos y curvas cerradas: contorno o relleno.
  • cornerRadius (integer 0–1024 (every corner), or a list of four, clockwise from the top-left; predeterminado { 0, 0, 0, 0 }) — Rectángulo: radios de las esquinas en píxeles, en sentido horario desde la esquina superior izquierda (0 = esquina recta), cada uno limitado a la mitad del lado menor.
  • selectionCornerRadius (integer 0–1024 (every corner), or a list of four, clockwise from the top-left; predeterminado { 0, 0, 0, 0 }) — Marco rectangular: radios de las esquinas en píxeles, en sentido horario desde la esquina superior izquierda (0 = esquina recta).
  • cornerRadiusLinked (boolean; predeterminado true) — La barra de opciones de la herramienta edita juntos los cuatro radios de las esquinas (un solo campo Radio) en lugar de un campo por esquina.
  • lineWidth (integer 1–64; predeterminado 1) — Herramientas Línea y Curva: grosor en píxeles (1 = una línea nítida de 1px); las líneas más anchas tienen extremos redondeados.
  • curvePixelPerfect (boolean; predeterminado true) — Herramienta Curva: quita las esquinas en L que adquiere una curva de 1px, para líneas de pixel art limpias.
  • bucketFillMode (BucketFillMode: "contiguous" | "global"; predeterminado "contiguous") — Bote de pintura: solo la región conectada, o todos los píxeles que coinciden.
  • bucketTolerance (integer 0–255; predeterminado 0) — Bote de pintura: la mayor diferencia por canal que todavía cuenta como el mismo color.
  • bucketCloseGap (integer 0–5; predeterminado 0) — Bote de pintura (contiguo): trata como cerrados los huecos del contorno de hasta este número de píxeles de ancho, para que el relleno no se filtre por ellos. 0 = desactivado.
  • bucketDiagonal (boolean; predeterminado false) — Bote de pintura (contiguo): se extiende también a los vecinos diagonales (8 conexiones), así que la región se filtra por las líneas diagonales de 1px.
  • bucketStopAtGrid (boolean; predeterminado false) — Bote de pintura: limita la región a la celda de la cuadrícula donde cae el clic.
  • bucketPattern (FillPattern: "solid" | "checker" | "dither25" | "dither75" | "hstripes" | "vstripes" | "diagonal" | "grid" | "dots" | "bricks"; predeterminado "solid") — Bote de pintura: pinta un patrón repetido de dos colores (el color de relleno y el otro entre primer plano y fondo) en lugar de un color sólido. "solid" = sin patrón.
  • wandFillMode (BucketFillMode: "contiguous" | "global"; predeterminado "contiguous") — Varita mágica: solo la región conectada, o todos los píxeles que coinciden. Independiente de bucketFillMode del bote de pintura.
  • wandTolerance (integer 0–255; predeterminado 0) — Varita mágica: la mayor diferencia por canal que todavía cuenta como el mismo color. Independiente de bucketTolerance del bote de pintura.
  • wandDiagonal (boolean; predeterminado false) — Varita mágica (contiguo): se extiende también a los vecinos diagonales (8 conexiones), así que la región se filtra por las líneas diagonales de 1px.
  • wandStopAtGrid (boolean; predeterminado false) — Varita mágica: limita la región a la celda de la cuadrícula donde cae el clic.
  • sprayRate (integer 1–64; predeterminado 8) — Aerógrafo: puntos por posición.
  • scatterX (integer 0–64; predeterminado 8) — Dispersión: hasta dónde puede caer cada estampa a la izquierda o a la derecha del camino, en píxeles.
  • scatterY (integer 0–64; predeterminado 8) — Dispersión: hasta dónde puede caer cada estampa por encima o por debajo del camino, en píxeles.
  • scatterCount (integer 1–16; predeterminado 2) — Dispersión: estampas colocadas en cada paso a lo largo del camino.
  • blurStrength (integer 1–4; predeterminado 1) — Desenfoque: radio de la vecindad en píxeles.
  • jumbleStrength (integer 0–100; predeterminado 100) — Mezcla: probabilidad en porcentaje de que se desordene cada píxel tocado.
  • dodgeBurnStrength (integer 1–100; predeterminado 25) — Aclarar/Oscurecer: cuánto se mueve la luminosidad OKLCH de cada píxel tocado (100 = la mitad de negro a blanco).
  • dodgeBurnHueShift (integer 0–60; predeterminado 0) — Aclarar/Oscurecer: grados que gira el tono OKLCH de cada píxel tocado hacia el amarillo cálido (aclarar) o el azul frío (oscurecer), sin pasarse de ahí; 0 conserva el tono.
  • ditherPattern (DitherPattern: "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise"; predeterminado "bayer2") — Pincel de tramado: el patrón ordenado con el que pinta. Los patrones se repiten desde la esquina superior izquierda del sprite, así que los trazos encajan.
  • ditherDensity (integer 0–100; predeterminado 50) — Pincel de tramado: la proporción de píxeles del patrón que pinta, en porcentaje (50 con bayer2 es un tablero de ajedrez).
  • gradientType (GradientType: "linear" | "radial"; predeterminado "linear") — Degradado: una rampa recta entre los puntos, o que se irradia desde el punto inicial.
  • gradientDithering (GradientDithering: "none" | "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise"; predeterminado "bayer4") — Degradado: el patrón de tramado ordenado (none = una rampa suave).
  • gradientSnap (GradientSnap: "free" | "palette"; predeterminado "free") — Degradado: mezclas libres, o solo colores de la paleta (cada píxel toma el color de paleta más cercano; el tramado alterna entre colores de paleta vecinos).
  • gradientColors (GradientColors: "fg-bg" | "stops"; predeterminado "fg-bg") — Degradado: va del color de primer plano al de fondo, o a lo largo de gradientStops ("stops"; con menos de dos puntos vuelve a ir de primer plano a fondo).
  • gradientStops (list of up to 32 { color, position } (position 0–1, in order), or of colors spread evenly; predeterminado {}) — Degradado: la rampa de varios puntos desde el punto inicial, como entradas { color, position } (position 0-1, en orden; dos en la misma posición forman un borde duro). Una lista simple de colores se reparte por igual. Se usa cuando gradientColors es "stops"; la barra Puntos del editor la edita.
  • eyedropperSource (EyedropperSource: "composite" | "layer"; predeterminado "composite") — Cuentagotas: toma lo que muestra el lienzo, o solo la capa activa.
  • tileIndex (integer ≥ 0; predeterminado 1) — Sello de tile: el tile a colocar, empezando en 1 (0 = el tile vacío).
  • tileFlipH (boolean; predeterminado false) — Sello de tile: voltea horizontalmente los tiles colocados.
  • tileFlipV (boolean; predeterminado false) — Sello de tile: voltea verticalmente los tiles colocados.
  • tileRotate90 (boolean; predeterminado false) — Sello de tile: gira los tiles colocados 90° en sentido horario.
  • tilePlace (boolean; predeterminado false) — Colocar tiles: en una capa de tilemap, el lápiz, el borrador, la línea, las herramientas de formas y el bote de pintura colocan el tile de la sello de tile (lo borran, en el caso del borrador) en las celdas que cubren, en lugar de pintar píxeles.
  • isoShape (IsoShape: "box" | "ramp" | "stairs" | "pyramid" | "prism" | "cylinder" | "cone" | "sphere" | "dome"; predeterminado "box") — Herramienta Forma isométrica: el sólido que dibuja.
  • isoWidth (integer 1–1024; predeterminado 8) — Herramienta Forma isométrica: huella a lo largo de x (abajo a la derecha), en unidades isométricas (una fila de la escalera del borde cada una).
  • isoDepth (integer 1–1024; predeterminado 8) — Herramienta Forma isométrica: huella a lo largo de y (abajo a la izquierda), en unidades isométricas.
  • isoHeight (integer 0–1024; predeterminado 8) — Herramienta Forma isométrica: altura en píxeles (0 = plana).
  • isoBevel (integer 0–1024; predeterminado 0) — Herramienta Forma isométrica: solo cajas, cuántos píxeles se achaflanan los bordes superiores (0 = recto).
  • isoCap (integer 2–4; predeterminado 3) — Herramienta Forma isométrica: el tramo plano en los vértices superior e inferior, 2 (par), 3 (impar) o 4 (múltiplos de cuatro). También es el paso de arrastre de W / D (2 unidades con cap 4).
  • isoStyle (IsoShapeStyle: "filled" | "outline" | "filled-outline"; predeterminado "filled-outline") — Herramienta Forma isométrica: caras, contorno, o ambos.
  • isoHiddenEdges (boolean; predeterminado false) — Herramienta Forma isométrica: dibuja también los bordes que quedan detrás del sólido.
  • isoDirection (IsoDirection: "+x" | "-x" | "+y" | "-y"; predeterminado "+x") — Herramienta Forma isométrica: hacia dónde desciende una rampa o unas escaleras, o hacia dónde miran las pendientes de un prisma.
  • isoAutoShade (boolean; predeterminado true) — Herramienta Forma isométrica: deriva los cinco colores del color de primer plano a lo largo de shades (true), o usa isoColors (false).
  • isoColors (list of colors — "#rgb", "#rrggbb[aa]" or { r, g, b, a }; predeterminado { { 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 } }) — Herramienta Forma isométrica: los colores que se usan cuando isoAutoShade está desactivado, en orden: contorno, borde interior, superior, izquierda, derecha.

En Markdown: context-settings.md.