Cel

app.clearCels(cels) — modifica, annullabile, rifiutata su un livello bloccato

Elimina più cel in una volta, come un unico passo di annullamento: immagini nei livelli immagine, posizionamenti di tile nei livelli tilemap, posizionamenti nei livelli di riferimento. I cel che non esistono vengono ignorati.

• cels (table) — Array di tabelle { layerId = ..., frameId = ... } che indicano i cel da eliminare.

Non restituisce nulla.

app.getCel(layerId, frameId) — legge

Il cel in layerId/frameId nella forma di app.getCels, oppure nil se quel livello non ha un'immagine (o posizionamenti di tile) in quel fotogramma.

• layerId (string)
• frameId (string)

Restituisce (table): Tabella del cel o nil.

app.getCelLink(layerId, frameId) — legge

Se il cel in layerId/frameId è collegato, l'id del fotogramma del cel sorgente di cui condivide l'immagine; altrimenti nil.

• layerId (string)
• frameId (string)

Restituisce (string): Id del fotogramma sorgente o nil.

app.getCels() — legge

Ogni cel (l'immagine di un livello in un fotogramma) come { layerId, frameId, x, y, width, height, opacity, zIndex (spostamento dell'ordine di disegno, solo se diverso da 0), linkedTo (id del fotogramma dell'immagine condivisa, solo cel collegati) }, livello per livello dal basso verso l'alto, poi in ordine di fotogramma. Anche un fotogramma tilemap con posizionamenti (o un collegamento) è un cel: x/y/width/height sono i limiti in pixel dei suoi posizionamenti. I dati dei pixel si leggono con app.getImage, i posizionamenti con app.getTilemap.

Restituisce (table): Array di tabelle di cel.

app.getLinkedFrames() — legge

Ogni fotogramma collegato nei livelli tilemap e di riferimento come { layerId, frameId, linkedTo (il fotogramma di cui condivide i posizionamenti di tile o il posizionamento) }, livello per livello dal basso verso l'alto, poi in ordine di fotogramma. I livelli immagine riportano i propri collegamenti tramite linkedTo di app.getCels.

Restituisce (table): Array di tabelle di collegamento.

app.linkCels(layerId, frameIds) — modifica, annullabile, rifiutata su un livello bloccato

Collega i cel di un livello nei fotogrammi indicati in modo che condividano un'unica immagine (modificarne uno li modifica tutti); in un livello tilemap condividono i posizionamenti di tile, in un livello di riferimento il posizionamento. Genera un errore se il primo fotogramma non ha un cel.

• layerId (string)
• frameIds (table) — Array di id di fotogramma. L'immagine del cel del primo fotogramma è condivisa da tutti; i loro cel vengono sostituiti da collegamenti.

Non restituisce nulla.

app.moveCels(cels, dLayer, dFrame) — modifica, annullabile, rifiutata su un livello bloccato

Sposta un blocco di cel di (dLayer, dFrame), sovrascrivendo le celle di destinazione, come un unico passo di annullamento. I cel immagine si spostano tra livelli immagine, i posizionamenti di tile tra livelli tilemap che condividono un tileset, i posizionamenti di riferimento solo lungo il proprio livello. Genera un errore se lo spostamento esce dalla griglia o viola questa regola.

• cels (table) — Array di tabelle { layerId = ..., frameId = ... } che indicano il blocco di cel da spostare.
• dLayer (number) — Variazione dell'indice del livello; un valore positivo sale nella pila.
• dFrame (number) — Variazione dell'ordine dei fotogrammi; un valore positivo va verso i fotogrammi successivi.

Non restituisce nulla.

app.setCelProps(layerId, frameId, props) — modifica, annullabile, rifiutata su un livello bloccato

Aggiorna le proprietà del cel in un livello e un fotogramma (un cel immagine o un fotogramma tilemap): la sua opacità e il suo z-index.

• layerId (string)
• frameId (string)
• props (table) — Le chiavi omesse restano invariate.
  • opacity (number 0–1) — Opacità del cel, combinata con quella del livello. Un cel collegato condivide quella della sorgente (impostarla su un cel qualsiasi del collegamento la imposta per tutti). I cel del livello Sfondo restano a 1.
  • zIndex (integer -32767–32767) — Lo z-index del cel di Aseprite: sposta l'ordine di disegno di questo cel tra i livelli del suo gruppo in questo fotogramma (ordine di disegno = posizione del livello + zIndex). 0 = la posizione propria del livello.

Non restituisce nulla.

app.unlinkCels(layerId, frameIds) — modifica, annullabile, rifiutata su un livello bloccato

Trasforma i cel collegati di nuovo in copie indipendenti dell'immagine condivisa (posizionamenti di tile, posizionamento di riferimento). Elencare il fotogramma a cui gli altri sono collegati lo scollega a sua volta; gli altri restano collegati tra loro. I cel non collegati vengono lasciati stare.

• layerId (string)
• frameIds (table) — Array di id di fotogramma i cui cel collegati diventano copie indipendenti.

Non restituisce nulla.

In Markdown: cels.md.