Files
SnapOtter/apps/docs/nl/tools/image/split.md
T
SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520)
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
2026-07-15 21:55:51 +08:00

2.5 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Eén afbeelding opsplitsen in rastertegels op basis van rijen en kolommen of op pixelgrootte, geretourneerd als ZIP-archief. 838f5fa791b0 human b64e36398c5b

Afbeelding splitsen

Splits één afbeelding op in rastertegels op basis van het aantal kolommen/rijen of specifieke pixelafmetingen. Retourneert een ZIP-archief met alle tegels.

API Endpoint

POST /api/v1/tools/image/split

Parameters

Parameter Type Vereist Standaard Beschrijving
columns integer Nee 3 Aantal kolommen om in op te splitsen (1 tot 100)
rows integer Nee 3 Aantal rijen om in op te splitsen (1 tot 100)
tileWidth integer Nee - Tegelbreedte in pixels (min. 10). Overschrijft columns wanneer zowel tileWidth als tileHeight zijn ingesteld.
tileHeight integer Nee - Tegelhoogte in pixels (min. 10). Overschrijft rows wanneer zowel tileWidth als tileHeight zijn ingesteld.
outputFormat string Nee "original" Uitvoerformaat voor tegels: original, png, jpg, webp, avif, jxl
quality number Nee 90 Uitvoerkwaliteit voor lossy formaten (1 tot 100)

Voorbeeldverzoek

curl -X POST http://localhost:1349/api/v1/tools/image/split \
  -F "file=@large-image.png" \
  -F 'settings={"columns":3,"rows":3,"outputFormat":"png"}' \
  --output split-tiles.zip

Voorbeeldrespons

De respons wordt rechtstreeks gestreamd als een ZIP-bestand met Content-Type: application/zip. De bestandsnaam volgt het patroon split-<jobId>.zip.

Elke tegel in de ZIP heet <originalBaseName>_r<row>_c<col>.<ext> (bijv. photo_r1_c1.png, photo_r2_c3.webp).

Opmerkingen

  • Accepteert één afbeeldingsbestand.
  • Ondersteunt HEIC-, RAW-, PSD- en SVG-invoerformaten (automatisch gedecodeerd).
  • Wanneer zowel tileWidth als tileHeight zijn opgegeven, krijgen deze voorrang boven columns/rows. De rasterafmetingen worden berekend als ceil(imageWidth / tileWidth) en ceil(imageHeight / tileHeight).
  • Randtegels (meest rechtse kolom, onderste rij) kunnen kleiner zijn dan de opgegeven tegelgrootte als de afbeeldingsafmetingen niet gelijkmatig deelbaar zijn.
  • De maximale rastergrootte is begrensd op 100x100 (10.000 tegels).
  • De respons streamt de ZIP rechtstreeks, dus er is geen JSON-responsbody. Gebruik --output met curl om het bestand op te slaan.