# Lua-Skript-API von pxstud.io — Interne Befehle

> Teil der Lua-Skript-Referenz von pxstud.io, deren Übersicht (https://pxstud.io/de/docs/scripting.md) die Konventionen erklärt. Die Optionsgruppen und Typen, auf die sie verweist, stehen in https://pxstud.io/de/docs/scripting/option-groups.md und https://pxstud.io/de/docs/scripting/types.md. Alles in einer Datei (auf Englisch): https://pxstud.io/llms-full.txt. Das Verzeichnis der ganzen Website (auf Englisch): https://pxstud.io/llms.txt.

## Interne Befehle
Die Engine hat 173 Befehle. Diese 25 lassen sich nicht aus Skripten aufrufen, jeweils aus dem genannten Grund; alle übrigen gehören zur API oben.

- `addReferenceLayer` — Die Nutzlast enthält eine rohe ReferenceSource (Bildpixel in voller Auflösung aus einer importierten Datei) – ein Skript kann so etwas nicht erzeugen
- `autoSlice` — ein Editor-Befehl (Sprite > Auto-Slice); Skripte finden ihre eigenen Bereiche und rufen app.addSlice auf
- `insertFrame` — Rückgängig/Wiederholen-Mechanik – die Nutzlast enthält einen rohen Frame plus einen Map<CelKey, Cel>-Schnappschuss, ein Skript kann so etwas nicht erzeugen
- `insertLayer` — Rückgängig/Wiederholen-Mechanik – die Nutzlast enthält rohe Layer-Objekte plus Map<CelKey, Cel>/Map<CelKey, ReferenceTransform>-Schnappschüsse, ein Skript kann so etwas nicht erzeugen
- `insertSlice` — Rückgängig/Wiederholen-Mechanik – stellt einen entfernten Slice an seiner ursprünglichen Position wieder her; Skripte verwenden app.addSlice
- `insertTag` — Rückgängig/Wiederholen-Mechanik – die Nutzlast enthält einen rohen Tag-Schnappschuss, ein Skript kann so etwas nicht erzeugen
- `insertTilemapTile` — Die Nutzlast enthält erfasste Pixelpuffer und Instanzlisten für Rückgängig – interne Mechanik, die Umkehrung von removeTilemapTile
- `pasteCels` — Die Nutzlast ist ein von extractCels erzeugter Zwischenablage-Schnappschuss (typisierte RGBA-Arrays pro Cel), den ein Skript nicht erzeugt; Skripte kopieren mit app.moveCels / app.linkCels oder setPixel
- `replaceDocument` — Rückgängig/Wiederholen-Mechanik – die Nutzlast enthält einen Schnappschuss des ganzen Sprites, ein Skript kann so etwas nicht erzeugen
- `replaceLayerContent` — Rückgängig/Wiederholen-Mechanik für convertToTilemap / convertToNormalLayer – die Nutzlast enthält einen Schnappschuss der Cels und Platzierungen einer Ebene
- `restoreCel` — Rückgängig/Wiederholen-Mechanik – die Nutzlast enthält einen rohen Cel-Schnappschuss (oder null), ein Skript kann so etwas nicht erzeugen
- `restoreCelRegion` — Rückgängig-Mechanik – der Teil eines Cels, den ein Pixelschreibvorgang ersetzt hat, von der Engine erfasst
- `restoreCels` — Rückgängig/Wiederholen-Mechanik – die Nutzlast enthält rohe Cel-Schnappschüsse (oder Löschungen), ein Skript kann so etwas nicht erzeugen
- `restoreDocumentParts` — Rückgängig/Wiederholen-Mechanik für Zusammenführen, Reduzieren, Hintergrundumwandlung, Leinwandgeometrie und Palettenneuzuordnungen – die Nutzlast enthält rohe Ebenen, Cels und Platzierungen
- `restoreFrameDurations` — Rückgängig/Wiederholen-Mechanik für setAllFrameDurations – app.setAllFrameDurations / app.setFrameDuration decken die echten Skript-Anwendungsfälle bereits ab
- `restoreLayerTree` — Rückgängig/Wiederholen-Mechanik für groupLayers / ungroupLayer – die Nutzlast ist eine ganze Ebenenreihenfolge plus rohe Gruppen-Layer-Objekte; Skripte verwenden app.groupLayers, app.ungroupLayer und app.moveLayer
- `restoreMoveState` — Rückgängig-Mechanik für movePixels – die Nutzlast enthält einen exakten Cel- und Selection-Schnappschuss, den ein Skript nicht erzeugen muss
- `restorePalette` — Rückgängig/Wiederholen-Mechanik für Farbanpassungen an einer Palette: setzt die Palette unverändert, ohne Pixel neu zuzuordnen (app.setPalette ordnet neu zu)
- `restoreTilemapState` — Rückgängig/Wiederholen-Mechanik für paintTilemapPixels – die Nutzlast enthält erfasste Tile-Puffer und eine Instanzliste
- `setCelText` — Der Editor zeichnet den Text mit eigenen Schriften und schickt die Pixel mit; ein Skript hat keine Schriften und zeichnet Text daher als Pixel (app.pastePixels)
- `setColorCycles` — Rückgängig/Wiederholen-Mechanik – stellt die Liste der Farbzyklen wieder her; Skripte verwenden app.addColorCycle und verwandte Funktionen
- `setGrid` — Ansichtseinstellung des Editors (der Dialog Rastereinstellungen) – sie positioniert ein Overlay und das Einrasten, ändert aber nicht das Kunstwerk, das ein Skript erzeugt
- `setGuides` — Ansichtseinstellung des Editors (Ansicht > Hilfslinien) – Hilfslinien positionieren ein Overlay und das Einrasten, ändern aber nicht das Kunstwerk, das ein Skript erzeugt
- `setPerspective` — Ansichtseinstellung des Editors (Ansicht > Perspektivraster) – sie positioniert ein Overlay, ändert aber nicht das Kunstwerk, das ein Skript erzeugt
- `setSlices` — Rückgängig/Wiederholen-Mechanik – stellt die Slice-Liste wieder her, die autoSlice ersetzt hat