Slice

Rettangoli con nome, ad esempio per le regioni di esportazione o gli hitbox. Uno slice può anche essere un 9-slice (un rettangolo centrale) e avere un punto di perno; entrambi sono relativi all'angolo in alto a sinistra dello slice, come in Aseprite, e si spostano con esso quando la tela viene ridimensionata, ritagliata o ruotata. (5 funzioni)

app.addSlice(name, x, y, width, height, opts?) — modifica, annullabile

Aggiunge un nuovo slice rettangolare con nome, facoltativamente un 9-slice (center) e/o con un perno.

  • name (string)
  • x (number)
  • y (number)
  • width (number)
  • height (number)
  • opts (table, facoltativo)
    • center ({ x, y, width, height }) — Il centro del 9-slice { x, y, width, height }, relativo all'origine dello slice: dentro lo slice, con dimensioni positive.
    • pivot ({ x, y }) — Il punto di perno { x, y }, relativo all'origine dello slice (può trovarsi fuori dallo slice).

Restituisce (string): L'id del nuovo slice.

app.getSlices(frameId?) — legge

Ogni slice come { id, name, x, y, width, height, center = { x, y, width, height } (slice a 9 parti), pivot = { x, y } (slice con un pivot), keyFrameIds (fotogrammi in cui lo slice ha una propria chiave, solo slice con chiavi per fotogramma) }. center e pivot sono relativi all'origine dello slice. Passa un id di fotogramma per la geometria in vigore in quel fotogramma.

  • frameId (string, facoltativo) — Il fotogramma in cui leggere gli slice (uno slice può cambiare limiti, centro e perno per fotogramma); omettilo per quelli del primo fotogramma.

Restituisce (table): Array di tabelle slice.

app.removeSlice(sliceId) — modifica, annullabile

Rimuove uno slice.

  • sliceId (string)

Non restituisce nulla.

app.removeSliceKey(sliceId, frameId) — modifica, annullabile

Rimuove la chiave di uno slice in un fotogramma (non il primo, che contiene la geometria propria dello slice): da quel fotogramma in poi torna ad applicarsi la geometria della chiave precedente. Genera un errore se lo slice non ha una chiave in quel fotogramma.

  • sliceId (string)
  • frameId (string)

Non restituisce nulla.

app.updateSlice(sliceId, props, frameId?) — modifica, annullabile

Aggiorna una o più proprietà di uno slice. Ridimensionare un 9-slice ne mantiene il centro solo se ci sta ancora; altrimenti passa anche un nuovo center (o false). Con un frameId successivo al primo fotogramma, x, y, width, height, center e pivot modificano la chiave dello slice in quel fotogramma (creandola: la nuova geometria vale da quel fotogramma fino alla chiave successiva); name vale sempre per l'intero slice.

  • sliceId (string)
  • props (table) — Le chiavi omesse restano invariate.
    • name (string) — Il nome dello slice.
    • x (integer) — Bordo sinistro, in pixel dello sprite.
    • y (integer) — Bordo superiore, in pixel dello sprite.
    • width (integer ≥ 1) — Larghezza in pixel.
    • height (integer ≥ 1) — Altezza in pixel.
    • center ({ x, y, width, height } or false) — Il centro del 9-slice { x, y, width, height }, relativo all'origine dello slice: dentro lo slice, con dimensioni positive. false lo rimuove.
    • pivot ({ x, y } or false) — Il punto di perno { x, y }, relativo all'origine dello slice (può trovarsi fuori dallo slice). false lo rimuove.
  • frameId (string, facoltativo) — Il fotogramma in cui si applica la geometria; se omesso o se è il primo fotogramma, modifica la geometria propria dello slice.

Non restituisce nulla.

In Markdown: slices.md.