Palette

app.addColorCycle(fromIndex, toIndex, opts?) — modifica, annullabile

Aggiunge un intervallo di ciclo colori (sprite indicizzati): durante la riproduzione i colori di quell'intervallo di palette ruotano. I pixel non cambiano; usa app.bakeColorCycles per trasformare il ciclo in palette per fotogramma.

• fromIndex (number) — Primo indice di palette dell'intervallo ciclato.
• toIndex (number) — Ultimo indice di palette dell'intervallo (incluso).
• opts (table, facoltativo)
  • direction (string; predefinito "forward") — "forward" sposta ogni colore all'indice successivo più alto, "reverse" a quello più basso.
  • framesPerStep (integer 1–1000; predefinito 1) — Fotogrammi di riproduzione per una rotazione di un passo.

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

app.bakeColorCycles(frames?) — modifica, annullabile

Converte i cicli colori in palette per fotogramma (aggiungendo fotogrammi se serve) in modo che esportazioni come GIF riproducano il ciclo, poi rimuove i cicli. Solo sprite indicizzati.

• frames (number, facoltativo) — Fotogrammi totali dell'animazione risultante (almeno il numero attuale); predefinito: un giro completo dei cicli. I fotogrammi vengono aggiunti dopo l'ultimo.

Non restituisce nulla.

app.cleanPalette(opts?) — modifica, annullabile

Pulisce la palette: unisce i colori duplicati e simili nella loro prima occorrenza e rimuove le voci inutilizzate. Negli sprite indicizzati i pixel seguono i loro colori.

• opts (table, facoltativo) — { removeDuplicates = bool, removeUnused = bool, mergeDistance = 0-100 (delta E; ~2 è appena visibile, 10 chiaramente diverso), frameId = palette in vigore in quel fotogramma }. Ogni opzione è disattivata per impostazione predefinita.

Non restituisce nulla.

app.createPaletteChange(frameId, colors?) — modifica, annullabile

Inizia una nuova palette in un fotogramma: quel fotogramma e quelli successivi (fino al cambio seguente) risolvono i pixel indicizzati attraverso di essa. Gli indici dei pixel non cambiano.

• frameId (string) — Fotogramma da cui inizia la nuova palette (non il primo fotogramma).
• colors (table, facoltativo) — La palette da quel fotogramma in poi, un array di colori esadecimali; predefinito: una copia della palette in vigore in quel punto.

Non restituisce nulla.

app.createPaletteRamp(from, to, count?, space?, mode?, frameId?) — modifica, annullabile

Genera una rampa di colori tra due voci di palette (il Gradiente della palette di Aseprite): per impostazione predefinita sovrascrive le voci tra di esse, oppure con mode "insert" inserisce nuovi colori prima della voce successiva. Negli sprite indicizzati un inserimento sposta gli indici dei pixel in modo che l'immagine resti invariata. Un unico passo annullabile.

• from (number) — Indice di palette di un estremo della rampa (da 0).
• to (number) — Indice di palette dell'altro estremo (da 0).
• count (number, facoltativo) — Quanti colori inserire tra di essi (da 1 a 256). Obbligatorio per mode "insert"; "replace" riempie ogni voce tra gli estremi e lo ignora.
• space (string, facoltativo) — Spazio di interpolazione: "oklab" (predefinito, percettivamente uniforme), "oklch", "rgb" o "hsl".
• mode (string, facoltativo) — "replace" sovrascrive con la rampa le voci tra i due estremi (il Gradiente della palette di Aseprite; i pixel restano intatti); "insert" aggiunge count nuovi colori prima dell'estremo successivo. Predefinito: "replace" quando ci sono voci tra gli estremi, altrimenti "insert".
• frameId (string, facoltativo) — Modifica la palette in vigore in questo fotogramma (le palette possono cambiare per fotogramma); predefinito: la palette del primo fotogramma. Negli sprite indicizzati "insert" sposta solo i pixel dei fotogrammi che condividono quella palette.

Non restituisce nulla.

app.getColorCycles() — legge

Gli intervalli di ciclo colori di uno sprite indicizzato: { id, fromIndex, toIndex, direction, framesPerStep } ciascuno.

Restituisce (table): Array di tabelle di cicli colori.

app.getPalette(frameId?) — legge

La palette come array di stringhe di colori esadecimali, "#rrggbb" oppure, per le voci con alfa inferiore a 255, "#rrggbbaa", ad es. { "#ff0000", "#00ff0080", ... }. Passa un id di fotogramma per la palette di quel fotogramma.

• frameId (string, facoltativo) — Fotogramma di cui leggere la palette (le palette possono cambiare per fotogramma); se omesso, la palette del primo fotogramma.

Restituisce (table): Array di stringhe di colori esadecimali.

app.insertPaletteEntries(index, colors, frameId?) — modifica, annullabile

Inserisce voci di palette a un indice. Negli sprite indicizzati ogni pixel (e l'indice trasparente) segue la sua voce, quindi l'immagine resta invariata.

• index (number) — Dove va la prima nuova voce (da 0; la lunghezza della palette aggiunge in coda).
• colors (table) — Array di stringhe di colori esadecimali, "#rrggbb" o "#rrggbbaa", ad es. { "#ff0000", "#00ff0080" }.
• frameId (string, facoltativo) — Modifica la palette in vigore in questo fotogramma (le palette possono cambiare per fotogramma); predefinito: la palette del primo fotogramma.

Non restituisce nulla.

app.movePaletteEntry(fromIndex, toIndex, frameId?) — modifica, annullabile

Sposta una voce di palette in una nuova posizione. Negli sprite indicizzati ogni pixel segue il suo colore, quindi l'immagine resta invariata.

• fromIndex (number) — Indice di palette attuale (da 0).
• toIndex (number) — Indice in cui la voce deve finire (da 0).
• frameId (string, facoltativo) — Modifica la palette in vigore in questo fotogramma (le palette possono cambiare per fotogramma); predefinito: la palette del primo fotogramma.

Non restituisce nulla.

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

Sostituisce colori esatti con altri colori in un insieme di cel: la rimappatura dell'Audit della palette. Sprite RGBA e in scala di grigi.

• mappings (table) — Array di { from = "#rrggbb", to = "#rrggbb" } (entrambi possono avere l'alfa, "#rrggbbaa"); tutte le mappature si applicano insieme.
• cels (table) — Array di { layerId = ..., frameId = ... }: i cel da ricolorare (livelli immagine).

Non restituisce nulla.

app.removeColorCycle(cycleId) — modifica, annullabile

Rimuove un ciclo colori.

• cycleId (string)

Non restituisce nulla.

app.removePaletteChange(frameId) — modifica, annullabile

Rimuove il cambio di palette in un fotogramma, che torna a usare la palette precedente. Gli indici dei pixel non cambiano.

• frameId (string) — Fotogramma di cui rimuovere il cambio di palette.

Non restituisce nulla.

app.removePaletteEntries(indices, frameId?) — modifica, annullabile

Rimuove voci di palette per indice. Negli sprite indicizzati i pixel delle voci rimosse diventano trasparenti e ogni altro pixel (e l'indice trasparente) segue la sua voce.

• indices (table) — Array degli indici di palette da rimuovere (da 0), ad es. { 3 } o { 4, 5, 6 }.
• frameId (string, facoltativo) — Modifica la palette in vigore in questo fotogramma (le palette possono cambiare per fotogramma); predefinito: la palette del primo fotogramma.

Non restituisce nulla.

app.setColorDepth(depth?) — modifica, annullabile

Vincola lo sprite a una profondità di colore, come una console che può mostrare solo certi valori: pixel, tile e palette vi si adattano subito (un solo passo di annullamento) e tutto ciò che viene disegnato dopo ci resta. nil la rimuove (la precisione persa non torna). Rileggila con app.getSprite().colorDepth.

• depth (table, facoltativo) — La profondità di colore in livelli per canale, o nil per rimuoverla. n bit sono 2^n livelli (3 bit = 8).
  • red (integer 2–256) — Livelli di rosso (con green e blue).
  • green (integer 2–256) — Livelli di verde.
  • blue (integer 2–256) — Livelli di blu.
  • gray (integer 2–256) — Livelli di grigio, al posto di rosso, verde e blu: ogni colore diventa un grigio.
  • profile (string) — L'id del profilo hardware che rappresenta (ad es. "mega-drive"), mostrato nell'editor.

Non restituisce nulla.

app.setPalette(colors, frameId?) — modifica, annullabile

Sostituisce l'intera palette dello sprite posizione per posizione. Negli sprite indicizzati ogni pixel mantiene il proprio indice e mostra il nuovo colore in quella posizione (una palette più corta viene completata con i vecchi colori delle posizioni ancora in uso). Per aggiungere o rimuovere colori con i pixel che li seguono, usa app.insertPaletteEntries / app.removePaletteEntries.

• colors (table) — Array di stringhe di colori esadecimali, "#rrggbb" o "#rrggbbaa" (alfa), ad es. { "#ff0000", "#00ff0080" }.
• frameId (string, facoltativo) — Modifica la palette in vigore in questo fotogramma (le palette possono cambiare per fotogramma); predefinito: la palette del primo fotogramma.

Non restituisce nulla.

app.setPaletteEntry(index, color, frameId?) — modifica, annullabile

Ricolora una voce di palette sul posto. Negli sprite indicizzati ogni pixel che usa quella voce mostra il nuovo colore.

• index (number) — Voce di palette da ricolorare (da 0).
• color (string) — Colore esadecimale, "#rrggbb" (opaco) o "#rrggbbaa" (con alfa), ad es. "#ff0000" o "#ff000080".
• frameId (string, facoltativo) — Modifica la palette in vigore in questo fotogramma (le palette possono cambiare per fotogramma); predefinito: la palette del primo fotogramma.

Non restituisce nulla.

app.setPaletteGroups(groups) — modifica, annullabile

Sostituisce i gruppi di palette: etichette con nome su intervalli di indici di palette. Etichettano le posizioni, quindi spostare od ordinare i colori non sposta un gruppo.

• groups (table) — Array di { name = "Skin", from = 0, to = 3 } (indici di palette da 0, inclusi), ordinati per from e senza sovrapposizioni. {} rimuove ogni gruppo.

Non restituisce nulla.

app.setPaletteLock(locked) — modifica, annullabile

Attiva o disattiva il Blocco palette. Solo sprite RGBA (gli sprite indicizzati dipingono sempre con i colori della palette); salvato nel file.

• locked (boolean) — true: ogni comando di disegno su uno sprite RGBA aggancia i pixel che dipinge al colore della palette più vicino.

Non restituisce nulla.

app.setTransparentIndex(index) — modifica, annullabile

Imposta l'indice del colore trasparente dello sprite indicizzato (Proprietà dello sprite > Colore trasparente di Aseprite). Cambia solo la proprietà, non i byte dei pixel.

• index (number) — Indice di palette (0-255) i cui pixel sono trasparenti negli sprite indicizzati (predefinito 0).

Non restituisce nulla.

app.sortPalette(by, descending?, from?, to?, frameId?) — modifica, annullabile

Ordina la palette (o l'intervallo from..to) in base a una proprietà del colore, ordinata come l'ordinamento della palette di Aseprite: le voci completamente trasparenti vanno prima in entrambe le direzioni; hue mette i grigi per primi (per valore) in ordine crescente, per ultimi in ordine decrescente; hue, saturation e brightness confrontano gradi e percentuali interi (a parità la saturazione si ordina per luminosità e viceversa); luminance pesa i canali elevati al quadrato. Le parità restanti mantengono il loro ordine. Negli sprite indicizzati ogni pixel segue il suo colore, quindi l'immagine resta invariata.

• by (string) — Chiave di ordinamento: "hue", "saturation", "brightness", "luminance", "red", "green", "blue" o "alpha".
• descending (boolean, facoltativo) — Ordina dall'alto al basso (predefinito false).
• from (number, facoltativo) — Primo indice di palette da ordinare (da 0, predefinito 0).
• to (number, facoltativo) — Ultimo indice di palette da ordinare (incluso, predefinito: l'ultimo).
• frameId (string, facoltativo) — Modifica la palette in vigore in questo fotogramma (le palette possono cambiare per fotogramma); predefinito: la palette del primo fotogramma.

Non restituisce nulla.

app.updateColorCycle(cycleId, props?) — modifica, annullabile

Cambia l'intervallo, la direzione o la velocità di un ciclo colori.

• cycleId (string)
• props (table, facoltativo)
  • fromIndex (integer 0–255) — Primo indice di palette dell'intervallo.
  • toIndex (integer 0–255) — Ultimo indice di palette dell'intervallo (incluso).
  • direction (string) — "forward" o "reverse".
  • framesPerStep (integer 1–1000) — Fotogrammi di riproduzione per una rotazione di un passo.

Non restituisce nulla.

In Markdown: palette.md.