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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Divide una imagen en teselas de cuadrícula por filas y columnas o por tamaño en píxeles, devueltas como archivo ZIP.	838f5fa791b0	human	2fb6a84c24e9

Dividir imagen

Divide una sola imagen en teselas de cuadrícula por número de columnas/filas o por dimensiones específicas en píxeles. Devuelve un archivo ZIP con todas las teselas.

API Endpoint

POST /api/v1/tools/image/split

Parámetros

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
columns	integer	No	3	Número de columnas en las que dividir (1 a 100)
rows	integer	No	3	Número de filas en las que dividir (1 a 100)
tileWidth	integer	No	-	Ancho de tesela en píxeles (mín. 10). Anula `columns` cuando se establecen tanto `tileWidth` como `tileHeight`.
tileHeight	integer	No	-	Alto de tesela en píxeles (mín. 10). Anula `rows` cuando se establecen tanto `tileWidth` como `tileHeight`.
outputFormat	string	No	`"original"`	Formato de salida de las teselas: `original`, `png`, `jpg`, `webp`, `avif`, `jxl`
quality	number	No	90	Calidad de salida para formatos con pérdida (1 a 100)

Ejemplo de solicitud

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

Ejemplo de respuesta

La respuesta se transmite directamente como un archivo ZIP con Content-Type: application/zip. El nombre del archivo sigue el patrón split-<jobId>.zip.

Cada tesela dentro del ZIP se nombra <originalBaseName>_r<row>_c<col>.<ext> (por ejemplo, photo_r1_c1.png, photo_r2_c3.webp).

Notas

Acepta un solo archivo de imagen.
Admite los formatos de entrada HEIC, RAW, PSD y SVG (decodificados automáticamente).
Cuando se proporcionan tanto tileWidth como tileHeight, tienen prioridad sobre columns/rows. Las dimensiones de la cuadrícula se calculan como ceil(imageWidth / tileWidth) y ceil(imageHeight / tileHeight).
Las teselas de los bordes (columna más a la derecha, fila inferior) pueden ser más pequeñas que el tamaño de tesela especificado si las dimensiones de la imagen no son divisibles de forma exacta.
El tamaño máximo de la cuadrícula está limitado a 100x100 (10.000 teselas).
La respuesta transmite el ZIP directamente, por lo que no hay cuerpo de respuesta en JSON. Usa --output con curl para guardar el archivo.

2.6 KiB Raw Blame History