Celdas
Una celda es la imagen de una capa en un fotograma. Muévelas, bórralas y vincúlalas en bloques. (9 funciones)
app.clearCels(cels) — modifica, deshacible, se rechaza en una capa bloqueada
Elimina varias celdas a la vez como un único paso de deshacer: imágenes en capas de imagen, colocaciones de tiles en capas de tilemap, colocaciones en capas de referencia. Las celdas que no existen se ignoran.
cels(table) — Array de tablas { layerId = ..., frameId = ... } que indican las celdas que se eliminarán.
No devuelve nada.
app.getCel(layerId, frameId) — lee
La celda en layerId/frameId con la forma de app.getCels, o nil si esa capa no tiene imagen (ni colocaciones de tiles) en ese fotograma.
layerId(string)frameId(string)
Devuelve (table): Tabla de celda o nil.
app.getCelLink(layerId, frameId) — lee
Si la celda en layerId/frameId está vinculada, el id del fotograma de la celda de origen cuya imagen comparte; de lo contrario, nil.
layerId(string)frameId(string)
Devuelve (string): Id del fotograma de origen o nil.
app.getCels() — lee
Todas las celdas (la imagen de una capa en un fotograma) como { layerId, frameId, x, y, width, height, opacity, zIndex (desplazamiento del orden de dibujo, solo si no es 0), linkedTo (id del fotograma de la imagen compartida, solo celdas vinculadas) }, capa por capa de abajo hacia arriba y luego por orden de fotogramas. Un fotograma de tilemap con colocaciones (o un vínculo) también es una celda: x/y/width/height son los límites en píxeles de sus colocaciones. Los datos de píxeles se leen con app.getImage, las colocaciones con app.getTilemap.
Devuelve (table): Array de tablas de celda.
app.getLinkedFrames() — lee
Todos los fotogramas vinculados en capas de tilemap y de referencia como { layerId, frameId, linkedTo (el fotograma cuyas colocaciones de tiles o colocación comparte) }, capa por capa de abajo hacia arriba y luego por orden de fotogramas. Las capas de imagen informan de sus vínculos mediante linkedTo de app.getCels.
Devuelve (table): Array de tablas de vínculo.
app.linkCels(layerId, frameIds) — modifica, deshacible, se rechaza en una capa bloqueada
Vincula las celdas de una capa en los fotogramas indicados para que compartan una imagen (editar una edita todas); en una capa de tilemap comparten las colocaciones de tiles, en una capa de referencia la colocación. Lanza un error si el primer fotograma no tiene celda.
layerId(string)frameIds(table) — Array de ids de fotograma. La imagen de la celda del primer fotograma la comparten todos; sus propias celdas se reemplazan por vínculos.
No devuelve nada.
app.moveCels(cels, dLayer, dFrame) — modifica, deshacible, se rechaza en una capa bloqueada
Mueve un bloque de celdas (dLayer, dFrame), sobrescribiendo las celdas de destino, como un único paso de deshacer. Las celdas de imagen se mueven entre capas de imagen, las colocaciones de tiles entre capas de tilemap que comparten un tileset, y las colocaciones de referencia solo a lo largo de su propia capa. Lanza un error si el movimiento sale de la cuadrícula o incumple esa regla.
cels(table) — Array de tablas { layerId = ..., frameId = ... } que indican el bloque de celdas que se moverá.dLayer(number) — Desplazamiento de índice de capa; un valor positivo sube en la pila.dFrame(number) — Desplazamiento en el orden de fotogramas; un valor positivo avanza a fotogramas posteriores.
No devuelve nada.
app.setCelProps(layerId, frameId, props) — modifica, deshacible, se rechaza en una capa bloqueada
Actualiza las propiedades de la celda en una capa y un fotograma (una celda de imagen o un fotograma de tilemap): su opacidad y su z-index.
layerId(string)frameId(string)props(table) — Las claves omitidas no se modifican.opacity(number 0–1) — Opacidad de la celda, combinada con la de la capa. Una celda vinculada comparte la de su origen (establecerla en cualquier celda del vínculo la establece en todas). Las celdas de la capa Background se quedan en 1.zIndex(integer -32767–32767) — El z-index de celda de Aseprite: desplaza el orden de dibujo de esta celda entre las capas de su grupo en este fotograma (orden de dibujo = posición de la capa + zIndex). 0 = la posición propia de la capa.
No devuelve nada.
app.unlinkCels(layerId, frameIds) — modifica, deshacible, se rechaza en una capa bloqueada
Convierte las celdas vinculadas de nuevo en copias independientes de la imagen compartida (colocaciones de tiles, colocación de referencia). Indicar el fotograma al que se vinculan las demás también lo desvincula; el resto sigue vinculado entre sí. Las celdas no vinculadas se dejan como están.
layerId(string)frameIds(table) — Array de ids de fotograma cuyas celdas vinculadas pasan a ser copias independientes.
No devuelve nada.
En Markdown: cels.md.