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

3.5 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Veja metadados detalhados da imagem, propriedades e estatísticas de histograma por canal.	8a0f7a0b0153	human	1773326fc536

Info da Imagem

Ferramenta de análise somente leitura que retorna metadados abrangentes da imagem, incluindo dimensões, formato, espaço de cor, presença de EXIF/ICC/XMP e estatísticas de histograma por canal. Não produz um arquivo de saída processado.

Endpoint da API

POST /api/v1/tools/image/info

Aceita dados de formulário multipart com um arquivo de imagem. Nenhum campo de configuração é necessário.

Parâmetros

Esta ferramenta não tem parâmetros configuráveis. Basta enviar o arquivo de imagem.

Campo	Tipo	Obrigatório	Descrição
file	file	Sim	A imagem a analisar

Exemplo de Requisição

curl -X POST http://localhost:1349/api/v1/tools/image/info \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg"

Exemplo de Resposta

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "width": 4032,
  "height": 3024,
  "format": "jpeg",
  "channels": 3,
  "hasAlpha": false,
  "colorSpace": "srgb",
  "density": 72,
  "isProgressive": false,
  "orientation": 1,
  "hasProfile": true,
  "hasExif": true,
  "hasIcc": true,
  "hasXmp": false,
  "bitDepth": "8",
  "pages": 1,
  "histogram": [
    { "channel": "red", "min": 0, "max": 255, "mean": 128.45, "stdev": 52.31 },
    { "channel": "green", "min": 2, "max": 253, "mean": 115.22, "stdev": 48.76 },
    { "channel": "blue", "min": 0, "max": 250, "mean": 102.89, "stdev": 55.14 }
  ]
}

Campos da Resposta

Campo	Tipo	Descrição
filename	string	Nome do arquivo sanitizado
fileSize	number	Tamanho do arquivo em bytes
width	number	Largura da imagem em pixels
height	number	Altura da imagem em pixels
format	string	Formato detectado (jpeg, png, webp, etc.)
channels	number	Número de canais de cor
hasAlpha	boolean	Se a imagem tem um canal alfa
colorSpace	string	Espaço de cor (srgb, cmyk, etc.)
density	number ou null	Resolução DPI/PPI
isProgressive	boolean	Se o JPEG usa codificação progressiva
orientation	number ou null	Valor de orientação EXIF (1-8)
hasProfile	boolean	Se um perfil ICC está incorporado
hasExif	boolean	Se há metadados EXIF presentes
hasIcc	boolean	Se um perfil de cor ICC está presente
hasXmp	boolean	Se há metadados XMP presentes
bitDepth	string ou null	Bits por amostra
pages	number	Número de páginas (para formatos com várias páginas como TIFF, GIF)
histogram	array	Estatísticas por canal (mínimo, máximo, média, desvio padrão)

Observações

Este é um endpoint somente leitura. Ele não produz um arquivo de saída baixável nem um jobId.
Para imagens em formato RAW (DNG, CR2, NEF, ARW, etc.), o ExifTool é usado para extrair as dimensões reais do sensor e os sinalizadores de metadados que o Sharp não consegue ler diretamente.
Arquivos HEIC/HEIF são decodificados para PNG internamente para extrair as estatísticas de pixels, já que o Sharp não consegue decodificar pixels HEVC.
O histograma fornece mínimo/máximo/média/desvio padrão por canal, não uma distribuição completa de 256 bins.
O campo density reflete os metadados de DPI incorporados, se presentes.

3.5 KiB Raw Blame History