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

Files

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

2.9 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Redimensione imagens por pixels, porcentagem ou com modos de ajuste.	00d1bffa4d38	human	c6cbb0a923c7

Redimensionar

Redimensione imagens especificando dimensões exatas em pixels, um fator de escala em porcentagem ou um modo de ajuste que controla como a imagem se adapta às dimensões de destino.

Endpoint da API

POST /api/v1/tools/image/resize

Aceita dados de formulário multipart com um arquivo de imagem e um campo JSON settings.

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
width	integer	Não	-	Largura de destino em pixels (máximo 16383)
height	integer	Não	-	Altura de destino em pixels (máximo 16383)
fit	string	Não	`"contain"`	Como a imagem se ajusta às dimensões: `contain`, `cover`, `fill`, `inside`, `outside`
withoutEnlargement	boolean	Não	`false`	Impedir o aumento de escala se a imagem for menor que o destino
percentage	number	Não	-	Escalonar por porcentagem (por exemplo, 50 para metade do tamanho)

Pelo menos um de width, height ou percentage deve ser fornecido.

Modos de Ajuste

contain - Redimensiona para caber dentro das dimensões, preservando a proporção (pode deixar espaço vazio)
cover - Redimensiona para cobrir as dimensões, preservando a proporção (pode recortar)
fill - Estica para corresponder exatamente às dimensões (ignora a proporção)
inside - Como contain, mas apenas reduz a escala, nunca a aumenta
outside - Como cover, mas apenas reduz a escala, nunca a aumenta

Exemplo de Requisição

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"width": 800, "height": 600, "fit": "contain"}'

Redimensionar por porcentagem:

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"percentage": 50}'

Exemplo de Resposta

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 980000
}

Notas

A dimensão máxima é de 16383 pixels em qualquer eixo (limite do Sharp/libvips).
O formato de saída corresponde ao formato de entrada. Entradas HEIC, RAW, PSD e SVG são decodificadas automaticamente antes do processamento.
A orientação EXIF é aplicada automaticamente antes do redimensionamento.
O sinalizador withoutEnlargement é útil para processamento em lote, onde algumas imagens já podem ser menores que o destino.

2.9 KiB Raw Blame History