Cels

app.clearCels(cels) — altera, desfazível, recusada em uma camada bloqueada

Exclui vários cels de uma vez como uma única etapa de desfazer: imagens em camadas de imagem, posicionamentos de tiles em camadas de tilemap, posicionamentos em camadas de referência. Cels que não existem são ignorados.

• cels (table) — Array de tabelas { layerId = ..., frameId = ... } que indicam os cels a excluir.

Não retorna nada.

app.getCel(layerId, frameId) — lê

O cel em layerId/frameId no formato de app.getCels, ou nil se essa camada não tiver imagem (nem posicionamentos de tiles) nesse quadro.

• layerId (string)
• frameId (string)

Retorna (table): Tabela de cel ou nil.

app.getCelLink(layerId, frameId) — lê

Se o cel em layerId/frameId estiver vinculado, o id do quadro do cel de origem cuja imagem ele compartilha; caso contrário, nil.

• layerId (string)
• frameId (string)

Retorna (string): Id do quadro de origem ou nil.

app.getCels() — lê

Todo cel (a imagem de uma camada em um quadro) como { layerId, frameId, x, y, width, height, opacity, zIndex (deslocamento da ordem de desenho, somente se não for 0), linkedTo (id do quadro da imagem compartilhada, somente cels vinculados) }, camada por camada de baixo para cima e depois na ordem dos quadros. Um quadro de tilemap com posicionamentos (ou um vínculo) também é um cel: x/y/width/height são os limites em pixels dos seus posicionamentos. Os dados de pixels são lidos com app.getImage e os posicionamentos com app.getTilemap.

Retorna (table): Array de tabelas de cel.

app.getLinkedFrames() — lê

Todo quadro vinculado em camadas de tilemap e de referência como { layerId, frameId, linkedTo (o quadro cujos posicionamentos de tiles ou posicionamento ele compartilha) }, camada por camada de baixo para cima e depois na ordem dos quadros. As camadas de imagem informam seus vínculos pelo linkedTo de app.getCels.

Retorna (table): Array de tabelas de vínculo.

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

Vincula os cels de uma camada nos quadros indicados para que compartilhem uma imagem (editar um edita todos); em uma camada de tilemap eles compartilham posicionamentos de tiles, e em uma camada de referência, o posicionamento. Lança um erro se o primeiro quadro não tiver cel.

• layerId (string)
• frameIds (table) — Array de ids de quadros. A imagem do cel do primeiro quadro é compartilhada por todos; os cels dos demais são substituídos por vínculos.

Não retorna nada.

app.moveCels(cels, dLayer, dFrame) — altera, desfazível, recusada em uma camada bloqueada

Move um bloco de cels por (dLayer, dFrame), sobrescrevendo as células de destino, como uma única etapa de desfazer. Cels de imagem se movem entre camadas de imagem, posicionamentos de tiles entre camadas de tilemap que compartilham um tileset, e posicionamentos de referência apenas ao longo da própria camada. Lança um erro se o movimento sair da grade ou violar essa regra.

• cels (table) — Array de tabelas { layerId = ..., frameId = ... } que indicam o bloco de cels a mover.
• dLayer (number) — Deslocamento do índice de camada; valores positivos sobem na pilha.
• dFrame (number) — Deslocamento da ordem dos quadros; valores positivos vão para quadros posteriores.

Não retorna nada.

app.setCelProps(layerId, frameId, props) — altera, desfazível, recusada em uma camada bloqueada

Atualiza propriedades do cel em uma camada e um quadro (um cel de imagem ou um quadro de tilemap): sua opacidade e seu z-index.

• layerId (string)
• frameId (string)
• props (table) — Chaves omitidas permanecem inalteradas.
  • opacity (number 0–1) — Opacidade do cel, combinada com a da camada. Um cel vinculado compartilha a da sua origem (definir em qualquer cel do vínculo define para todos). Os cels da camada Background permanecem em 1.
  • zIndex (integer -32767–32767) — O z-index de cel do Aseprite: desloca a ordem de desenho deste cel entre as camadas do seu grupo neste quadro (ordem de desenho = posição da camada + zIndex). 0 = a posição da própria camada.

Não retorna nada.

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

Transforma cels vinculados de volta em cópias independentes da imagem compartilhada (posicionamentos de tiles, posicionamento de referência). Listar o quadro ao qual os outros se vinculam também o desvincula; os demais continuam vinculados entre si. Cels não vinculados são deixados como estão.

• layerId (string)
• frameIds (table) — Array de ids de quadros cujos cels vinculados se tornam cópias independentes.

Não retorna nada.

Em Markdown: cels.md.