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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Porównaj dwa obrazy obok siebie z wizualizacją różnic na poziomie pikseli i wynikiem podobieństwa.	cc0a02bd75c6	human	7ad8cdc9a3da

Porównywanie obrazów

Prześlij dwa obrazy, aby obliczyć mapę różnic na poziomie pikseli oraz liczbowy procent podobieństwa. Wynikiem jest obraz różnic wyróżniający zmienione obszary na czerwono.

Punkt końcowy API

POST /api/v1/tools/image/compare

Przyjmuje dane formularza multipart z dwoma plikami obrazów. Pole ustawień nie jest wymagane.

Parametry

To narzędzie nie ma konfigurowalnych parametrów. Prześlij dokładnie dwa pliki obrazów.

Pole	Typ	Wymagane	Opis
file (pierwszy)	file	Tak	Pierwszy obraz
file (drugi)	file	Tak	Drugi obraz

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "similarity": 94.52,
  "dimensions": { "width": 1920, "height": 1080 },
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/diff.png",
  "originalSize": 4900000,
  "processedSize": 280000
}

Pola odpowiedzi

Pole	Typ	Opis
jobId	string	Identyfikator zadania do pobrania obrazu różnic
similarity	number	Procent podobieństwa między dwoma obrazami (od 0 do 100)
dimensions	object	Szerokość i wysokość użyte do porównania
downloadUrl	string	Adres URL do pobrania wygenerowanego obrazu różnic
originalSize	number	Łączny rozmiar obu obrazów wejściowych w bajtach
processedSize	number	Rozmiar wyjściowego obrazu różnic w bajtach

Uwagi

Oba obrazy są skalowane do tych samych wymiarów (maksimum z każdej osi) przed porównaniem.
Obraz różnic wyróżnia różnice na czerwono z przezroczystością proporcjonalną do wielkości zmiany. Piksele identyczne lub prawie identyczne (różnica < 10) są pokazywane jako półprzezroczyste wersje oryginału.
Podobieństwo jest obliczane jako odwrotność średniej różnicy pikseli w całym obrazie, wyrażona procentowo.
Podobieństwo 100% oznacza, że obrazy są identyczne co do piksela (w rozdzielczości porównania).
Wynikowy obraz różnic ma zawsze format PNG, niezależnie od formatów wejściowych.
Oba obrazy są walidowane i dekodowane (obsługiwane HEIC, RAW, PSD, SVG) przed porównaniem.
Orientacja EXIF jest automatycznie stosowana do obu obrazów przed przetwarzaniem.

2.8 KiB Raw Blame History