Desenho

app.blur(layerId, frameId, points, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desfoca os pixels sob o pincel ao longo dos pontos, exatamente como a ferramenta de desfoque da interface.

• layerId (string)
• frameId (string)
• points (table) — Lista de pontos { x = n, y = n } (ou { n, n }); as lacunas entre pontos consecutivos são interpoladas como em um arrasto real.
• opts (table, opcional) Também aceita Opções de pintura e Opções de pincel (veja "Grupos de opções"), e ainda:
  • strength (integer 0–8; padrão context.blurStrength) — Raio do desfoque em pixels.

Não retorna nada.

app.dodgeBurn(layerId, frameId, points, opts?) — altera, desfazível, recusada em uma camada bloqueada

Clareia (dodge) ou escurece (burn) os pixels sob o pincel ao longo dos pontos, na luminosidade OKLCH, exatamente como a ferramenta subexpor/superexpor da interface. Matiz e croma são mantidos, a menos que hueShift seja definido. Cada pixel muda uma vez por chamada; pixels transparentes não são tocados.

• layerId (string)
• frameId (string)
• points (table) — Lista de pontos { x = n, y = n } (ou { n, n }); as lacunas entre pontos consecutivos são interpoladas como em um arrasto real.
• opts (table, opcional) Também aceita Opções de pintura e Opções de pincel (veja "Grupos de opções"), e ainda:
  • strength (integer 1–100; padrão context.dodgeBurnStrength) — Quanto a luminosidade OKLCH de cada pixel tocado se move: 100 = metade do caminho de preto a branco, 25 = 0.125.
  • hueShift (integer 0–60; padrão context.dodgeBurnHueShift) — Graus que o matiz OKLCH de cada pixel tocado gira em direção ao amarelo quente (dodge) ou ao azul frio (burn), sem nunca passar dele, com o croma reduzido (dodge) ou aprofundado (burn) em 0,5% por grau. 0 mantém matiz e croma.
  • burn (boolean; padrão false) — Escurece (burn) em vez de clarear (dodge).

Não retorna nada.

app.drawContour(layerId, frameId, points, opts?) — altera, desfazível, recusada em uma camada bloqueada

Preenche o caminho fechado que passa pelos pontos, incluindo os pixels do caminho (o contorno do Aseprite), exatamente como a ferramenta de contorno da interface.

• layerId (string)
• frameId (string)
• points (table) — O caminho à mão livre como uma lista de pontos { x = n, y = n }; é fechado e preenchido automaticamente.
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.

Não retorna nada.

app.drawCurve(layerId, frameId, anchors, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desenha um caminho de curvas de Bezier cúbicas pelas âncoras, exatamente como a ferramenta de curva da interface. Passe closed = true para uma forma fechada (e fill = "filled" para preenchê-la).

• layerId (string)
• frameId (string)
• anchors (table) — As âncoras do caminho em ordem: { x = n, y = n } (ou { n, n }), cada uma opcionalmente com alças de Bezier inX/inY (o ponto de controle do segmento que chega) e outX/outY (do segmento que sai). Uma âncora sem alças é um canto vivo; duas seguidas são unidas por uma linha reta.
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • closed (boolean; padrão false) — Une a última âncora de volta à primeira.
  • fill (FillMode: "outline" | "filled"; padrão context.shapeFillMode) — Caminhos fechados: desenha o contorno, ou preenche também o interior.
  • width (integer 1–64; padrão context.lineWidth) — Espessura do traço em pixels (1 = uma curva dura de 1px); traços mais largos têm pontas arredondadas.
  • pixelPerfect (boolean; padrão context.curvePixelPerfect) — Remove os cantos em L que uma curva de 1px acumula, para linhas de pixel art limpas (ignorado em traços mais largos).

Não retorna nada.

app.drawEllipse(layerId, frameId, x0, y0, x1, y1, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desenha uma elipse inscrita na caixa definida pelos dois cantos, exatamente como a ferramenta de elipse da interface.

• layerId (string)
• frameId (string)
• x0 (number) — Primeiro canto.
• y0 (number)
• x1 (number) — Canto oposto (inclusivo).
• y1 (number)
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • fill (FillMode: "outline" | "filled"; padrão context.shapeFillMode) — Somente contorno, ou preenchido.

Não retorna nada.

app.drawGradient(layerId, frameId, x0, y0, x1, y1, opts?) — altera, desfazível, recusada em uma camada bloqueada

Preenche a região que o balde preencheria a partir de (x0, y0), a área conectada da sua cor (ou todo pixel correspondente quando não contíguo), dentro da seleção, com um gradiente de startColor em (x0, y0) a endColor em (x1, y1), ou ao longo de stops, exatamente como a ferramenta de gradiente da interface. Com simetria, as regiões espelhadas recebem o mesmo gradiente. Um arrasto de comprimento zero, ou um início fora da tela ou da seleção, não faz nada.

• layerId (string)
• frameId (string)
• x0 (number) — Início do gradiente (onde fica startColor).
• y0 (number)
• x1 (number) — Fim do gradiente (onde fica endColor).
• y1 (number)
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • startColor (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor no primeiro ponto.
  • endColor (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.backgroundColor) — A cor no segundo ponto.
  • stops ({ color, color, ... } or { { color = c, position = 0-1 }, ... }; padrão When gradientColors is "stops" and neither startColor nor endColor is given, the gradientStops list.) — Uma rampa de várias paradas, de 2 a 32 cores, do primeiro ao segundo ponto, em vez de startColor e endColor. Cores simples são distribuídas uniformemente; as posições vão de 0 a 1 em ordem, e duas paradas na mesma posição criam uma borda dura.
  • gradientType (GradientType: "linear" | "radial"; padrão context.gradientType) — Uma rampa reta entre os pontos, ou irradiando a partir do primeiro.
  • dithering (GradientDithering: "none" | "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise"; padrão context.gradientDithering) — Dithering ordenado aplicado à rampa (none = suave).
  • snap (GradientSnap: "free" | "palette"; padrão context.gradientSnap) — Mesclas livres, ou apenas cores da paleta (o dithering então alterna entre cores vizinhas da paleta).
  • contiguous (boolean; padrão context.bucketFillMode (true para o modo contíguo do contexto, false para global)) — Somente a região conectada (true), ou todo pixel correspondente na tela (false).
  • tolerance (integer 0–255; padrão context.bucketTolerance) — A maior diferença de cor por canal que ainda conta como correspondência.
  • diagonal (boolean; padrão context.bucketDiagonal) — Somente contíguo: também se espalha para vizinhos diagonais (8 conectados), então a região vaza por linhas diagonais de 1px.
  • stopAtGrid (boolean; padrão context.bucketStopAtGrid) — Limita a região à célula da grade em que o clique cai (a célula de uma grade isométrica é o losango que ela desenha, com os pixels de linha das suas duas bordas superiores).
  • closeGap (integer 0–5; padrão context.bucketCloseGap) — Preenchimentos contíguos: trata como fechadas as lacunas no contorno de até esta largura em pixels, para que o preenchimento pare nelas em vez de vazar. 0 = desativado.

Não retorna nada.

app.drawHexagon(layerId, frameId, x0, y0, x1, y1, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desenha um hexágono de topo plano que preenche a caixa definida pelos dois cantos, exatamente como a ferramenta de hexágono da interface.

• layerId (string)
• frameId (string)
• x0 (number) — Primeiro canto.
• y0 (number)
• x1 (number) — Canto oposto (inclusivo).
• y1 (number)
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • fill (FillMode: "outline" | "filled"; padrão context.shapeFillMode) — Somente contorno, ou preenchido.

Não retorna nada.

app.drawIsoShape(layerId, frameId, x, y, width?, depth?, height?, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desenha um sólido isométrico (caixa, rampa, escada, pirâmide, prisma, cilindro, cone, esfera ou domo) em projeção de pixel art, exatamente como a ferramenta Forma isométrica da interface. As bordas são escadas limpas (2 px na horizontal para 1 px na vertical em 2:1), as faces são preenchidas com as cores de topo / esquerda / direita, as bordas internas as separam e a silhueta é contornada. O canto de trás da base fica em (x, y); x corre para baixo e à direita e y para baixo e à esquerda na tela, e height ergue o topo. Os sólidos redondos (cilindro, cone, esfera, domo) usam width como diâmetro e ignoram depth; a esfera também ignora height.

• layerId (string)
• frameId (string)
• x (number) — Âncora: o pixel mais à esquerda da tampa no canto de trás (superior) da base, no chão.
• y (number)
• width (number, opcional) — Base ao longo de x (para baixo e à direita), em unidades iso: cada unidade é uma linha da escada da borda 2:1. nil = o isoWidth do contexto.
• depth (number, opcional) — Base ao longo de y (para baixo e à esquerda), em unidades iso. nil = o isoDepth do contexto.
• height (number, opcional) — Altura em pixels (0 = um losango plano). nil = o isoHeight do contexto.
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor base: a face de topo no sombreamento automático.
  • shape (IsoShape: "box" | "ramp" | "stairs" | "pyramid" | "prism" | "cylinder" | "cone" | "sphere" | "dome"; padrão context.isoShape) — Qual sólido desenhar.
  • cap (integer 2–4; padrão context.isoCap) — O trecho plano de pixels nos vértices superior e inferior: 2 (larguras pares), 3 (ímpares) ou 4 (múltiplos de quatro). Proporções acima de 2 têm uma tampa natural mais larga.
  • bevel (integer 0–1024; padrão context.isoBevel) — Somente caixa: chanfra as quatro bordas superiores por este número de pixels, uma inclinação de 45 graus entre o topo e as laterais (0 = bordas retas). Limitado à altura e à metade da base.
  • style (IsoShapeStyle: "filled" | "outline" | "filled-outline"; padrão context.isoStyle) — Faces, contorno, ou ambos.
  • hiddenEdges (boolean; padrão context.isoHiddenEdges) — Desenha também as bordas atrás do sólido, na cor da borda interna (um wireframe transparente com style outline).
  • direction (IsoDirection: "+x" | "-x" | "+y" | "-y"; padrão context.isoDirection) — Rampa e escada: o sentido em que descem. Prisma: o sentido para o qual uma inclinação aponta (+x e -x dão o mesmo telhado). Ignorado pelas outras formas.
  • ratio (integer 1–8; padrão the sprite's isometric grid ratio (run / rise, rounded), else 2) — Pixels na horizontal por pixel na vertical ao longo dos eixos iso.
  • colors ({ outline =, innerEdge =, top =, left =, right = } colors; padrão auto-shaded from color, or the context's isoColors when isoAutoShade is off) — Todas as cinco cores de uma vez (left é a face voltada para +y, para baixo e à esquerda; right a face voltada para +x). Substitui o sombreamento automático.
  • autoShade (boolean; padrão context.isoAutoShade) — Deriva as cores de color: topo = color, as laterais um e dois passos mais escuras ao longo de ramp (ou calculadas), as bordas internas ainda mais escuras, o contorno o mais escuro. false usa o isoColors do contexto. Ignorado quando colors é informado.
  • ramp (a list of colors ("#rrggbb[aa]" or { r, g, b, a }); padrão context.shades) — A rampa ao longo da qual o sombreamento automático avança quando ela contém color (a extremidade mais escura é achada pelo brilho). Caso contrário, os tons são calculados e ajustados à paleta em um sprite indexado.

Não retorna nada.

app.drawLine(layerId, frameId, x0, y0, x1, y1, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desenha uma linha reta entre os dois pontos, exatamente como a ferramenta de linha da interface (width a engrossa, com pontas arredondadas).

• layerId (string)
• frameId (string)
• x0 (number)
• y0 (number)
• x1 (number)
• y1 (number)
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • width (integer 1–64; padrão context.lineWidth) — Espessura da linha em pixels (1 = uma linha dura de 1px); linhas mais largas têm pontas arredondadas.

Não retorna nada.

app.drawPolygon(layerId, frameId, vertices, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desenha um polígono fechado pelos vértices, exatamente como a ferramenta de polígono da interface.

• layerId (string)
• frameId (string)
• vertices (table) — Lista de vértices { x = n, y = n } (ou { n, n }), pelo menos 2; o polígono se fecha de volta ao primeiro automaticamente.
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • fill (FillMode: "outline" | "filled"; padrão context.shapeFillMode) — Somente contorno, ou preenchido.

Não retorna nada.

app.drawRectangle(layerId, frameId, x0, y0, x1, y1, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desenha um retângulo alinhado aos eixos definido pelos dois cantos, exatamente como a ferramenta de retângulo da interface (radius arredonda os cantos, juntos ou um a um). Ignora a seleção, a menos que respectSelection = true.

• layerId (string)
• frameId (string)
• x0 (number) — Primeiro canto.
• y0 (number)
• x1 (number) — Canto oposto (inclusivo).
• y1 (number)
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • fill (FillMode: "outline" | "filled"; padrão context.shapeFillMode) — Somente contorno, ou preenchido.
  • radius (an integer 0–1024 for every corner, or a list of four { topLeft, topRight, bottomRight, bottomLeft }; padrão context.cornerRadius) — Arredonda os cantos, em pixels (0 = retos): um raio para os quatro, ou um por canto no sentido horário a partir do canto superior esquerdo. Cada um é limitado à metade do lado menor.

Não retorna nada.

app.drawStar(layerId, frameId, x0, y0, x1, y1, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desenha uma estrela de 5 pontas (com uma ponta para cima) cujas pontas externas tocam todos os lados da caixa definida pelos dois cantos, exatamente como a ferramenta de estrela da interface.

• layerId (string)
• frameId (string)
• x0 (number) — Primeiro canto.
• y0 (number)
• x1 (number) — Canto oposto (inclusivo).
• y1 (number)
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • fill (FillMode: "outline" | "filled"; padrão context.shapeFillMode) — Somente contorno, ou preenchido.

Não retorna nada.

app.drawStroke(layerId, frameId, points, opts?) — altera, desfazível, recusada em uma camada bloqueada

Traço de pincel à mão livre pelos pontos, exatamente como o lápis da interface (ou, com erase = true, a borracha; com dither, o pincel de dithering).

• layerId (string)
• frameId (string)
• points (table) — Lista de pontos { x = n, y = n } (ou { n, n }); as lacunas entre pontos consecutivos são interpoladas como em um arrasto real.
• opts (table, opcional) Também aceita Opções de pintura, Opções de pincel e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • erase (boolean; padrão false) — Apaga para transparente em vez de pintar (a borracha); color é ignorado.
  • pixelPerfect (boolean; padrão context.pixelPerfect) — Remove os degraus duplicados dos cantos do caminho do traço (qualquer tamanho de pincel).
  • matchColor (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão nil (every pixel)) — Só pinta (ou apaga) pixels que sejam exatamente esta cor; os outros não são tocados. Com color = a cor de fundo e matchColor = a cor de primeiro plano, é a borracha de botão direito do Aseprite.
  • dither ({ pattern = "bayer2" | "bayer4" | "bayer8" | "dots" | "lines-h" | "lines-v" | "diagonal" | "noise", density = 0-100 }; padrão nil (every pixel)) — Só pinta (ou apaga) os pixels de um padrão ordenado em uma densidade em porcentagem, deixando o resto intocado: o pincel de dithering (50 com bayer2 é um tabuleiro de xadrez). O padrão se repete a partir do canto superior esquerdo do sprite, então traços sobrepostos continuam alinhados.
  • dynamics ({ stabilizer = 0-64, pressure = { size, angle, gradient (booleans), min, max (0-100) }, velocity = { same }, minSize, minAngle, maxAngle, dither, curve = 25-400 }; padrão built from the context's stabilizer, pressure*/velocity* and dynamics* fields; pass {} for a plain stroke) — Dinâmica do pincel: um estabilizador (média móvel dos pontos) e sensores de pressão / velocidade que controlam o tamanho do carimbo (de minSize até o tamanho do pincel), o ângulo (minAngle a maxAngle) e um gradiente de cor de color a endColor (dither = true escolhe um ou outro por pixel; sprites indexados se ajustam à cor da paleta mais próxima). min/max são o intervalo do sensor em porcentagem (min > max inverte); curve é a sensibilidade em porcentagem (100 = linear). Com pixelPerfect e um tamanho variável, os cotovelos ainda são removidos ao longo do caminho central. Pincéis personalizados só recebem o estabilizador e o gradiente.
  • pressures (list of numbers 0-1, one per point; padrão 1 (full pressure) for every point) — Pressão da caneta por ponto, lida pelo sensor de pressão. Um mouse não tem, então conta como total.
  • velocities (list of numbers >= 0, one per point; padrão 0 for every point) — Velocidade do ponteiro por ponto em pixels do sprite por milissegundo (0.5 = o máximo do sensor), lida pelo sensor de velocidade.
  • endColor (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.backgroundColor) — A cor final do gradiente quando um sensor controla o gradiente; color é o início.

Não retorna nada.

app.drawTriangle(layerId, frameId, x0, y0, x1, y1, opts?) — altera, desfazível, recusada em uma camada bloqueada

Desenha um triângulo isósceles (vértice no centro do topo, base ao longo da parte inferior) que preenche a caixa definida pelos dois cantos, exatamente como a ferramenta de triângulo da interface.

• layerId (string)
• frameId (string)
• x0 (number) — Primeiro canto.
• y0 (number)
• x1 (number) — Canto oposto (inclusivo).
• y1 (number)
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • fill (FillMode: "outline" | "filled"; padrão context.shapeFillMode) — Somente contorno, ou preenchido.

Não retorna nada.

app.floodFill(layerId, frameId, x, y, opts?) — altera, desfazível, recusada em uma camada bloqueada

Preenchimento com balde de tinta a partir de (x, y), exatamente como a ferramenta de balde da interface.

• layerId (string)
• frameId (string)
• x (number)
• y (number)
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • contiguous (boolean; padrão context.bucketFillMode (true para o modo contíguo do contexto, false para global)) — Somente a região conectada (true), ou todo pixel correspondente na tela (false).
  • tolerance (integer 0–255; padrão context.bucketTolerance) — A maior diferença de cor por canal que ainda conta como correspondência.
  • diagonal (boolean; padrão context.bucketDiagonal) — Somente contíguo: também se espalha para vizinhos diagonais (8 conectados), então a região vaza por linhas diagonais de 1px.
  • stopAtGrid (boolean; padrão context.bucketStopAtGrid) — Limita a região à célula da grade em que o clique cai (a célula de uma grade isométrica é o losango que ela desenha, com os pixels de linha das suas duas bordas superiores).
  • closeGap (integer 0–5; padrão context.bucketCloseGap) — Preenchimentos contíguos: trata como fechadas as lacunas no contorno de até esta largura em pixels, para que o preenchimento pare nelas em vez de vazar. 0 = desativado.
  • pattern (FillPattern: "solid" | "checker" | "dither25" | "dither75" | "hstripes" | "vstripes" | "diagonal" | "grid" | "dots" | "bricks"; padrão context.bucketPattern) — Preenche com um padrão repetido de color e patternColor, repetido a partir do canto superior esquerdo da tela. "solid" = apenas color.
  • patternColor (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.backgroundColor) — A segunda cor do padrão (ignorada quando pattern é "solid").

Não retorna nada.

app.isoProject(layerId, frameId, projection, opts?) — altera, desfazível, recusada em uma camada bloqueada

Projeta os pixels selecionados (a área de seleção acompanha), ou o cel inteiro quando nada está selecionado, em uma face de um cubo isométrico: "left" e "right" inclinam as colunas ao longo da inclinação, "floor" transforma a região na face de topo (um quadrado vira um losango). Exato ao pixel: toda borda sai como uma escada limpa (2 na horizontal para 1 na vertical em 2:1) e nenhuma cor é mesclada. O conteúdo que cai fora da tela e dos limites do cel é cortado (a camada Background é cortada à tela).

• layerId (string)
• frameId (string)
• projection (IsoProjection: "left" | "right" | "floor")
• opts (table, opcional)
  • run (integer 1–16; padrão The sprite's isometric grid ratio, or 2 (2:1) when the grid is rectangular.) — Pixels na horizontal por rise pixels na vertical (a inclinação, na forma irredutível). Informe rise também.
  • rise (integer 1–16; padrão The sprite's isometric grid ratio, or 1 (2:1) when the grid is rectangular.) — Pixels na vertical por run pixels na horizontal. Informe run também.

Não retorna nada.

app.jumble(layerId, frameId, points, opts?) — altera, desfazível, recusada em uma camada bloqueada

Borrão aleatório: embaralha os pixels sob o pincel com vizinhos aleatórios ao longo dos pontos, exatamente como a ferramenta de embaralhar da interface.

• layerId (string)
• frameId (string)
• points (table) — Lista de pontos { x = n, y = n } (ou { n, n }); as lacunas entre pontos consecutivos são interpoladas como em um arrasto real.
• opts (table, opcional) Também aceita Opções de pintura e Opções de pincel (veja "Grupos de opções"), e ainda:
  • strength (integer 0–100; padrão context.jumbleStrength) — Chance em porcentagem de cada pixel tocado ser embaralhado. Um pincel de 1px não tem vizinhos com quem embaralhar, então use brushSize 2 ou mais.
  • seed (integer 0–4294967295; padrão random) — Seed aleatória: a mesma seed e os mesmos pontos dão o mesmo resultado.

Não retorna nada.

app.movePixels(layerId, frameId, dx, dy) — altera, desfazível, recusada em uma camada bloqueada

Move os pixels selecionados (conforme a seleção atual; a área de seleção acompanha), ou o cel inteiro quando nada está selecionado, por (dx, dy). Exatamente como a ferramenta de mover da interface. Sem seleção, o cel inteiro se move e mantém tudo, inclusive além da borda da tela; os pixels da seleção movidos são mantidos dentro da tela e dos limites do cel, e cortados além deles. A camada Background é cortada à tela.

• layerId (string)
• frameId (string)
• dx (number) — Pixels a mover para a direita (negativo = esquerda).
• dy (number) — Pixels a mover para baixo (negativo = para cima).

Não retorna nada.

app.outline(layerId, frameIds, opts?) — altera, desfazível, recusada em uma camada bloqueada

Filtro > Contorno, como no Aseprite: desenha um contorno ao redor (ou logo dentro) das formas nos cels de uma camada, como uma única etapa de desfazer. Um pixel faz parte de uma forma, a menos que seja transparente (ou corresponda a bgColor). Contornos externos expandem o cel, recortados pela tela. Somente camadas de imagem.

• layerId (string)
• frameIds (table) — Array de ids de quadros cujos cels nesta camada recebem o contorno (um quadro para o cel ativo, todos os quadros para todos eles).
• opts (table, opcional)
  • cels (Array of { layerId = ..., frameId = ... }) — Contorna estes cels, entre camadas e quadros, em vez de layerId/frameIds (passe nil para ambos).
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor do contorno. Em um sprite indexado, ela se ajusta à entrada da paleta mais próxima, a menos que colorIndex seja informado.
  • colorIndex (integer 0–255; padrão Taken from color.) — Sprites indexados: o índice da paleta a pintar, usado como está. Não o índice transparente.
  • place (OutlinePlace: "outside" | "inside"; padrão "outside") — Contorna por fora da forma (ela cresce) ou por dentro (seus pixels de borda são repintados).
  • shape (OutlineShape: "circle" | "square"; padrão "circle") — Predefinição da matriz de vizinhos. Ignorada quando matrix é informada.
  • matrix (9 booleans, row-major 3x3 (top-left first): which neighbors count as touching. The center entry is ignored.) — Uma matriz de vizinhos personalizada, como a grade 3x3 de alternadores do Aseprite.
  • bgColor (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão Only transparent pixels are background.) — Uma cor opaca que também conta como fundo, além dos pixels totalmente transparentes.
  • bgIndex (integer 0–255) — Sprites indexados: um índice da paleta que também conta como fundo.
  • respectSelection (boolean; padrão false) — Passe true para contornar apenas dentro da seleção atual. Por padrão, a seleção é ignorada.

Não retorna nada.

app.pastePixels(layerId, frameId, image, opts?) — altera, desfazível, recusada em uma camada bloqueada

Cola uma imagem no cel de uma camada/quadro como a colagem flutuante da interface: pixels transparentes deixam o cel como está, os parcialmente transparentes se mesclam sobre ele, e os pixels colados viram a seleção. O transform opcional distorce a imagem (corners), depois a escala, gira e/ou inclina em torno do seu centro (a menos que pivotX/pivotY sejam informados), e então a desloca por dx/dy. Exige uma camada de imagem editável (desbloqueada); um bloqueio de movimento não se aplica. O que cai fora da tela e dos limites do cel é cortado (a camada Background é cortada à tela).

• layerId (string)
• frameId (string)
• image (table) — { x, y, width, height, pixels }: pixels é uma lista de width*height cores ("#rrggbb[aa]" ou { r, g, b, a }), linha por linha; x, y é onde cai o canto superior esquerdo.
• opts (table, opcional)
  • scaleX (number -256–256; padrão 1) — Escala horizontal em torno do pivô; negativo inverte. Não pode ser 0.
  • scaleY (number -256–256; padrão 1) — Escala vertical em torno do pivô; negativo inverte. Não pode ser 0.
  • rotation (number; padrão 0) — Graus no sentido horário em torno do pivô.
  • skewX (number -80–80; padrão 0) — Graus de cisalhamento horizontal (o topo se inclina para um lado, a base para o outro, em torno do pivô).
  • skewY (number -80–80; padrão 0) — Graus de cisalhamento vertical.
  • dx (number; padrão 0) — Pixels a deslocar para a direita após a transformação.
  • dy (number; padrão 0) — Pixels a deslocar para baixo após a transformação.
  • pivotX (number; padrão The center of the selection (or of the cel when nothing is selected).) — X do ponto fixo para rotação/escala/cisalhamento, em pixels da tela.
  • pivotY (number; padrão The center of the selection (or of the cel when nothing is selected).) — Y do ponto fixo para rotação/escala/cisalhamento, em pixels da tela.
  • interpolation (TransformInterpolation: "nearest" | "rotsprite" | "bilinear"; padrão "nearest") — Como os pixels são reamostrados. Use rotsprite para rotações limpas de pixel art, bilinear para resultados suaves (mesclados).
  • corners ({ {x=,y=}, {x=,y=}, {x=,y=}, {x=,y=} }; padrão The region's own corners (no distortion).) — Distorção livre / perspectiva: onde caem os cantos superior esquerdo, superior direito, inferior direito e inferior esquerdo da região, em pixels da tela (frações permitidas), antes da escala/cisalhamento/rotação/deslocamento acima. Deve formar uma forma convexa. Fixar os dois cantos superiores mais próximos entre si que os inferiores dá uma perspectiva de piso.

Não retorna nada.

app.scatter(layerId, frameId, points, opts?) — altera, desfazível, recusada em uma camada bloqueada

Pincel de dispersão: carimba o pincel ao longo dos pontos, um passo por largura de pincel, cada carimbo deslocado por um desvio aleatório, exatamente como a ferramenta de dispersão da interface.

• layerId (string)
• frameId (string)
• points (table) — Lista de pontos { x = n, y = n } (ou { n, n }); as lacunas entre pontos consecutivos são interpoladas como em um arrasto real.
• opts (table, opcional) Também aceita Opções de pintura, Opções de pincel e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • offsetX (integer 0–64; padrão context.scatterX) — Até onde cada carimbo pode cair à esquerda ou à direita do caminho, em pixels.
  • offsetY (integer 0–64; padrão context.scatterY) — Até onde cada carimbo pode cair acima ou abaixo do caminho, em pixels.
  • count (integer 1–16; padrão context.scatterCount) — Carimbos colocados a cada passo ao longo do caminho.
  • seed (integer 0–4294967295; padrão random) — Seed aleatória: a mesma seed e os mesmos pontos dão o mesmo resultado.

Não retorna nada.

app.spray(layerId, frameId, points, opts?) — altera, desfazível, recusada em uma camada bloqueada

Aerógrafo: espalha pontos aleatórios ao redor de cada ponto, exatamente como a ferramenta de spray da interface. Cada ponto é um tique, então repita um ponto para continuar pulverizando no mesmo lugar.

• layerId (string)
• frameId (string)
• points (table) — Lista de pontos { x = n, y = n } (ou { n, n }); as lacunas entre pontos consecutivos são interpoladas como em um arrasto real.
• opts (table, opcional) Também aceita Opções de pintura e Opções de tinta (veja "Grupos de opções"), e ainda:
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor da tinta.
  • radius (integer 1–128; padrão twice the context's brushSize, at least 2) — A que distância de cada ponto os pontos se espalham, em pixels.
  • rate (integer 1–64; padrão context.sprayRate) — Pontos espalhados por ponto.
  • seed (integer 0–4294967295; padrão random) — Seed aleatória: a mesma seed e os mesmos pontos dão o mesmo resultado.

Não retorna nada.

app.strokeSelection(layerId, frameId, width, opts?) — altera, desfazível, recusada em uma camada bloqueada

Editar > Traçar seleção: pinta uma linha da largura indicada ao longo da borda da seleção atual (por dentro, centralizada ou por fora) em um cel, como uma única etapa de desfazer. Não faz nada quando nada está selecionado. Somente camadas de imagem.

• layerId (string)
• frameId (string)
• width (number) — Pixels, de 1 a 256.
• opts (table, opcional)
  • position (StrokePosition: "inside" | "center" | "outside"; padrão "center") — Onde o traço fica em relação à borda da seleção.
  • color (color ("#rgb", "#rrggbb[aa]" or { r, g, b, a }); padrão context.foregroundColor) — A cor do traço. Em um sprite indexado, ela se ajusta à entrada da paleta mais próxima, a menos que colorIndex seja informado.
  • colorIndex (integer 0–255; padrão Taken from color.) — Sprites indexados: o índice da paleta a pintar, usado como está. Não o índice transparente.
  • shape (SelectionModifyShape: "circle" | "square"; padrão "circle") — Como a distância até a borda é medida (cantos redondos ou quadrados).

Não retorna nada.

app.transformPixels(layerId, frameId, opts?) — altera, desfazível, recusada em uma camada bloqueada

Escala, gira, inclina e/ou distorce (perspectiva, via corners) os pixels selecionados (a área de seleção acompanha), ou o cel inteiro quando nada está selecionado, em torno de um pivô, exatamente como as alças de transformação da ferramenta de mover da interface. Ordem: escala, cisalhamento, rotação e depois deslocamento por dx/dy. Em um sprite com pixels não quadrados (Sprite.pixelRatio), os ângulos e as escalas valem para o que você vê na tela, então uma rotação de 90 graus parece uma. Sem seleção, o cel inteiro mantém o que cai dentro da caixa formada pela tela e pelos limites do cel, tanto onde está quanto deslocado por dx/dy (então um deslocamento simples não perde nada, inclusive além da borda da tela); os pixels da seleção transformados são mantidos dentro da tela e dos limites do cel e cortados além deles. A camada Background é cortada à tela. Uma transformação nula não altera nada.

• layerId (string)
• frameId (string)
• opts (table, opcional)
  • scaleX (number -256–256; padrão 1) — Escala horizontal em torno do pivô; negativo inverte. Não pode ser 0.
  • scaleY (number -256–256; padrão 1) — Escala vertical em torno do pivô; negativo inverte. Não pode ser 0.
  • rotation (number; padrão 0) — Graus no sentido horário em torno do pivô.
  • skewX (number -80–80; padrão 0) — Graus de cisalhamento horizontal (o topo se inclina para um lado, a base para o outro, em torno do pivô).
  • skewY (number -80–80; padrão 0) — Graus de cisalhamento vertical.
  • dx (number; padrão 0) — Pixels a deslocar para a direita após a transformação.
  • dy (number; padrão 0) — Pixels a deslocar para baixo após a transformação.
  • pivotX (number; padrão The center of the selection (or of the cel when nothing is selected).) — X do ponto fixo para rotação/escala/cisalhamento, em pixels da tela.
  • pivotY (number; padrão The center of the selection (or of the cel when nothing is selected).) — Y do ponto fixo para rotação/escala/cisalhamento, em pixels da tela.
  • interpolation (TransformInterpolation: "nearest" | "rotsprite" | "bilinear"; padrão "nearest") — Como os pixels são reamostrados. Use rotsprite para rotações limpas de pixel art, bilinear para resultados suaves (mesclados).
  • corners ({ {x=,y=}, {x=,y=}, {x=,y=}, {x=,y=} }; padrão The region's own corners (no distortion).) — Distorção livre / perspectiva: onde caem os cantos superior esquerdo, superior direito, inferior direito e inferior esquerdo da região, em pixels da tela (frações permitidas), antes da escala/cisalhamento/rotação/deslocamento acima. Deve formar uma forma convexa. Fixar os dois cantos superiores mais próximos entre si que os inferiores dá uma perspectiva de piso.

Não retorna nada.

Em Markdown: drawing.md.