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

Files

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.7 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Découpe une image en tuiles de grille selon des lignes et des colonnes ou selon une taille en pixels, renvoyées sous forme d'archive ZIP.	838f5fa791b0	human	bc8f0812ff9f

Découper une image

Découpe une seule image en tuiles de grille selon un nombre de colonnes/lignes ou selon des dimensions en pixels précises. Renvoie une archive ZIP contenant toutes les tuiles.

Point d'accès de l'API

POST /api/v1/tools/image/split

Paramètres

Paramètre	Type	Requis	Défaut	Description
columns	integer	Non	3	Nombre de colonnes de découpage (1 à 100)
rows	integer	Non	3	Nombre de lignes de découpage (1 à 100)
tileWidth	integer	Non	-	Largeur des tuiles en pixels (min 10). Remplace `columns` lorsque `tileWidth` et `tileHeight` sont tous deux définis.
tileHeight	integer	Non	-	Hauteur des tuiles en pixels (min 10). Remplace `rows` lorsque `tileWidth` et `tileHeight` sont tous deux définis.
outputFormat	string	Non	`"original"`	Format de sortie des tuiles : `original`, `png`, `jpg`, `webp`, `avif`, `jxl`
quality	number	Non	90	Qualité de sortie pour les formats avec perte (1 à 100)

Exemple de requête

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

Exemple de réponse

La réponse est diffusée directement sous forme de fichier ZIP avec Content-Type: application/zip. Le nom de fichier suit le modèle split-<jobId>.zip.

Chaque tuile à l'intérieur du ZIP est nommée <originalBaseName>_r<row>_c<col>.<ext> (par exemple photo_r1_c1.png, photo_r2_c3.webp).

Remarques

Accepte un seul fichier image.
Prend en charge les formats d'entrée HEIC, RAW, PSD et SVG (décodés automatiquement).
Lorsque tileWidth et tileHeight sont tous deux fournis, ils sont prioritaires sur columns/rows. Les dimensions de la grille sont calculées comme ceil(imageWidth / tileWidth) et ceil(imageHeight / tileHeight).
Les tuiles de bord (colonne la plus à droite, ligne du bas) peuvent être plus petites que la taille de tuile spécifiée si les dimensions de l'image ne sont pas divisibles de façon égale.
La taille maximale de la grille est plafonnée à 100x100 (10 000 tuiles).
La réponse diffuse le ZIP directement, il n'y a donc pas de corps de réponse JSON. Utilisez --output avec curl pour enregistrer le fichier.

2.7 KiB Raw Blame History