Files
SnapOtter/apps/docs/nl/tools/image/stitch.md
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

3.0 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Afbeeldingen naast elkaar, gestapeld of in een raster samenvoegen, met controle over uitlijning, tussenruimtes, randen en schaalmodus. 39333210505a human 20f87ea80878

Samenvoegen / Combineren

Voeg meerdere afbeeldingen naast elkaar, verticaal gestapeld of gerangschikt in een raster samen. Ondersteunt uitlijning, tussenruimte, rand, hoekradius en meerdere schaalmodi.

API Endpoint

POST /api/v1/tools/image/stitch

Parameters

Parameter Type Vereist Standaard Beschrijving
direction string Nee "horizontal" Lay-outrichting: horizontal, vertical, grid
gridColumns integer Nee 2 Aantal kolommen wanneer de richting grid is (2 tot 100)
resizeMode string Nee "fit" Hoe afbeeldingen worden geschaald: fit, original, stretch, crop
alignment string Nee "center" Uitlijning op de dwarsas: start, center, end
gap number Nee 0 Tussenruimte tussen afbeeldingen in pixels (0 tot 1000)
border number Nee 0 Breedte van de buitenrand in pixels (0 tot 500)
cornerRadius number Nee 0 Hoekradius toegepast op de uiteindelijke uitvoer (0 tot 500)
backgroundColor string Nee "#FFFFFF" Achtergrond-/randkleur als hex (bijv. #FF0000)
format string Nee "png" Uitvoerformaat: png, jpeg, webp, avif, jxl
quality number Nee 90 Uitvoerkwaliteit (1 tot 100)

Voorbeeldverzoek

curl -X POST http://localhost:1349/api/v1/tools/image/stitch \
  -F "file=@image1.png" \
  -F "file=@image2.png" \
  -F "file=@image3.png" \
  -F 'settings={"direction":"horizontal","resizeMode":"fit","gap":10,"backgroundColor":"#FFFFFF","format":"png"}'

Voorbeeldrespons

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/stitch.png",
  "originalSize": 1234567,
  "processedSize": 987654
}

Opmerkingen

  • Vereist ten minste 2 afbeeldingen. Upload meerdere afbeeldingsbestanden in het multipart-verzoek.
  • Ondersteunt HEIC-, RAW-, PSD- en SVG-invoerformaten (automatisch gedecodeerd).
  • Schaalmodi:
    • fit - Schaal afbeeldingen zodat ze overeenkomen met de kleinste afmeting langs de samenvoegas.
    • original - Behoud de oorspronkelijke afmetingen (kan ongelijke randen opleveren).
    • stretch - Dwing afbeeldingen om overeen te komen met de kleinste afmeting zonder de beeldverhouding te behouden.
    • crop - Snijd afbeeldingen dekkend bij om overeen te komen met de kleinste afmeting.
  • In de modus grid worden cellen op de mediane afmetingen van alle afbeeldingen geschaald.
  • De cornerRadius wordt toegepast op de gehele uiteindelijke uitvoer, niet op individuele afbeeldingen.
  • De canvasgrootte wordt begrensd door de serverconfiguratie MAX_CANVAS_PIXELS om geheugenuitputting te voorkomen.