mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.

2026-07-11 13:52:47 +08:00

2.8 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Mehrere Bilder zu einem einzigen Sprite-Sheet-Raster mit Frame-Metadaten kombinieren.	1938d7fb100d	human	52bd054d3541

Sprite-Sheet

Kombiniert mehrere Bilder zu einem einzigen Sprite-Sheet-Raster. Jedes Bild wird auf die Abmessungen des ersten Bildes skaliert und im Raster platziert. Gibt das Sprite-Sheet-Bild zusammen mit Koordinaten-Metadaten pro Frame zurück.

API-Endpunkt

POST /api/v1/tools/image/sprite-sheet

Nimmt Multipart-Formulardaten mit zwei oder mehr Bilddateien und einem JSON-Feld settings entgegen.

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
columns	integer	Nein	`4`	Anzahl der Spalten im Raster (1-16)
padding	integer	Nein	`0`	Abstand zwischen den Zellen in Pixeln (0-64)
background	string	Nein	`"#ffffff"`	Hintergrund-Hexfarbe
format	string	Nein	`"png"`	Ausgabeformat: `png`, `webp` oder `jpeg`
quality	integer	Nein	`90`	Ausgabequalität (1-100)

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/sprite-sheet \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@frame1.png" \
  -F "file=@frame2.png" \
  -F "file=@frame3.png" \
  -F "file=@frame4.png" \
  -F 'settings={"columns": 2, "padding": 4, "format": "png"}'

Beispielantwort

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/sprite-sheet.png",
  "originalSize": 120000,
  "processedSize": 95000,
  "frames": [
    { "index": 0, "left": 0, "top": 0, "width": 128, "height": 128 },
    { "index": 1, "left": 132, "top": 0, "width": 128, "height": 128 },
    { "index": 2, "left": 0, "top": 132, "width": 128, "height": 128 },
    { "index": 3, "left": 132, "top": 132, "width": 128, "height": 128 }
  ],
  "cols": 2,
  "rows": 2,
  "cellWidth": 128,
  "cellHeight": 128,
  "canvasWidth": 260,
  "canvasHeight": 260
}

Hinweise

Nimmt 2 bis 64 Bilder entgegen. Alle Bilder werden auf die Abmessungen des ersten hochgeladenen Bildes skaliert.
Das Array frames liefert die exakten Pixelkoordinaten jedes Frames in der Ausgabe, geeignet für CSS-Sprite-Definitionen oder Frame-Maps von Spiel-Engines.
Die Anzahl der Zeilen wird automatisch aus der Bildanzahl und dem Wert columns berechnet.
Verwenden Sie den Parameter padding, um Abstand zwischen den Zellen einzufügen. Die Farbe background ist in Abstandsbereichen und in etwaigen leeren nachfolgenden Zellen sichtbar.
HEIC-, RAW-, PSD- und SVG-Eingaben werden vor der Verarbeitung automatisch dekodiert.

2.8 KiB Raw Blame History