# API de scripts Lua do pxstud.io — Comandos internos

> Parte da referência de scripts Lua do pxstud.io, cuja visão geral (https://pxstud.io/pt-br/docs/scripting.md) explica as convenções. Os grupos de opções e os tipos a que ela remete estão em https://pxstud.io/pt-br/docs/scripting/option-groups.md e https://pxstud.io/pt-br/docs/scripting/types.md. Tudo em um único arquivo (em inglês): https://pxstud.io/llms-full.txt. O índice de todo o site (em inglês): https://pxstud.io/llms.txt.

## Comandos internos
O motor tem 173 comandos. Estes 25 não podem ser chamados por scripts, cada um pelo motivo indicado; todos os outros fazem parte da API acima.

- `addReferenceLayer` — o payload carrega um ReferenceSource bruto (pixels de imagem em resolução total decodificados de um arquivo importado) — não é algo que um script possa construir
- `autoSlice` — um comando do editor (Sprite > Auto-slice); os scripts encontram suas próprias regiões e chamam app.addSlice
- `insertFrame` — infraestrutura de desfazer/refazer — o payload carrega um Frame bruto mais um snapshot Map<CelKey, Cel>, não é algo que um script possa construir
- `insertLayer` — infraestrutura de desfazer/refazer — o payload carrega objetos Layer brutos mais snapshots Map<CelKey, Cel>/Map<CelKey, ReferenceTransform>, não é algo que um script possa construir
- `insertSlice` — infraestrutura de desfazer/refazer — restaura um slice removido à posição original; os scripts usam app.addSlice
- `insertTag` — infraestrutura de desfazer/refazer — o payload carrega um snapshot Tag bruto, não é algo que um script possa construir
- `insertTilemapTile` — o payload carrega buffers de pixels capturados e listas de instâncias para desfazer — infraestrutura interna, o inverso de removeTilemapTile
- `pasteCels` — o payload é um snapshot da área de transferência produzido por extractCels (arrays RGBA tipados por cel), não algo que um script construa; os scripts copiam com app.moveCels / app.linkCels ou setPixel
- `replaceDocument` — infraestrutura de desfazer/refazer — o payload carrega um snapshot de um Sprite inteiro, não é algo que um script possa construir
- `replaceLayerContent` — infraestrutura de desfazer/refazer para convertToTilemap / convertToNormalLayer — o payload carrega um snapshot dos cels e das posições de uma camada
- `restoreCel` — infraestrutura de desfazer/refazer — o payload carrega um snapshot Cel bruto (ou null), não é algo que um script possa construir
- `restoreCelRegion` — infraestrutura de desfazer — a parte de um cel que uma escrita de pixels substituiu, capturada pelo motor
- `restoreCels` — infraestrutura de desfazer/refazer — o payload carrega snapshots Cel brutos (ou exclusões), não é algo que um script possa construir
- `restoreDocumentParts` — infraestrutura de desfazer/refazer para mesclagens, flatten, conversão de fundo, geometria da tela e remapeamentos de paleta — o payload carrega camadas, cels e posições brutos
- `restoreFrameDurations` — infraestrutura de desfazer/refazer para setAllFrameDurations — app.setAllFrameDurations / app.setFrameDuration já cobrem os usos reais em scripts
- `restoreLayerTree` — infraestrutura de desfazer/refazer para groupLayers / ungroupLayer — o payload é a ordem completa das camadas mais objetos Layer de grupo brutos; os scripts usam app.groupLayers, app.ungroupLayer e app.moveLayer
- `restoreMoveState` — infraestrutura de desfazer para movePixels — o payload carrega um snapshot exato de Cel + Selection que um script não tem por que construir
- `restorePalette` — infraestrutura de desfazer/refazer para ajustes de cor em uma paleta: define a paleta literalmente, sem remapear os pixels (app.setPalette remapeia)
- `restoreTilemapState` — infraestrutura de desfazer/refazer para paintTilemapPixels — o payload carrega buffers de tiles capturados e uma lista de instâncias
- `setCelText` — o editor desenha o texto com suas próprias fontes e envia os pixels junto; um script não tem fontes, então desenha o texto como pixels (app.pastePixels)
- `setColorCycles` — infraestrutura de desfazer/refazer — restaura a lista de ciclos de cor; os scripts usam app.addColorCycle e afins
- `setGrid` — configuração de exibição do editor (a caixa de diálogo Configurações da grade) — posiciona uma sobreposição e o alinhamento, não altera a arte que um script produz
- `setGuides` — configuração de exibição do editor (Exibir > Guias) — as guias posicionam uma sobreposição e o alinhamento, não alteram a arte que um script produz
- `setPerspective` — configuração de exibição do editor (Exibir > Grade de perspectiva) — posiciona uma sobreposição, não altera a arte que um script produz
- `setSlices` — infraestrutura de desfazer/refazer — restaura a lista de slices que autoSlice substituiu
