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 uma imagem em blocos de grade por linhas e colunas ou por tamanho em pixels, retornados como um arquivo ZIP.	838f5fa791b0	human	3bdfc58d5c96

Dividir Imagem

Divide uma única imagem em blocos de grade por contagem de colunas/linhas ou por dimensões específicas em pixels. Retorna um arquivo ZIP contendo todos os blocos.

Endpoint da API

POST /api/v1/tools/image/split

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
columns	integer	Não	3	Número de colunas para dividir (1 a 100)
rows	integer	Não	3	Número de linhas para dividir (1 a 100)
tileWidth	integer	Não	-	Largura do bloco em pixels (mín. 10). Sobrepõe `columns` quando `tileWidth` e `tileHeight` estão definidos.
tileHeight	integer	Não	-	Altura do bloco em pixels (mín. 10). Sobrepõe `rows` quando `tileWidth` e `tileHeight` estão definidos.
outputFormat	string	Não	`"original"`	Formato de saída para os blocos: `original`, `png`, `jpg`, `webp`, `avif`, `jxl`
quality	number	Não	90	Qualidade de saída para formatos com perdas (1 a 100)

Exemplo de Requisição

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

Exemplo de Resposta

A resposta é transmitida diretamente como um arquivo ZIP com Content-Type: application/zip. O nome do arquivo segue o padrão split-<jobId>.zip.

Cada bloco dentro do ZIP é nomeado <originalBaseName>_r<row>_c<col>.<ext> (por exemplo, photo_r1_c1.png, photo_r2_c3.webp).

Notas

Aceita um único arquivo de imagem.
Suporta os formatos de entrada HEIC, RAW, PSD e SVG (decodificados automaticamente).
Quando tileWidth e tileHeight são fornecidos, eles têm prioridade sobre columns/rows. As dimensões da grade são calculadas como ceil(imageWidth / tileWidth) e ceil(imageHeight / tileHeight).
Os blocos de borda (coluna mais à direita, linha inferior) podem ser menores que o tamanho de bloco especificado se as dimensões da imagem não forem divisíveis de forma exata.
O tamanho máximo da grade é limitado a 100x100 (10.000 blocos).
A resposta transmite o ZIP diretamente, portanto não há corpo de resposta JSON. Use --output com curl para salvar o arquivo.

2.6 KiB Raw Blame History