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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Ändra storlek på bilder efter pixlar, procent eller med anpassningslägen.	00d1bffa4d38	human	1e73827cf480

Ändra storlek

Ändra storlek på bilder genom att ange exakta pixeldimensioner, en procentuell skalfaktor eller ett anpassningsläge som styr hur bilden anpassas till måldimensionerna.

API-slutpunkt

POST /api/v1/tools/image/resize

Tar emot multipart-formulärdata med en bildfil och ett JSON-fält settings.

Parametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
width	integer	Nej	-	Målbredd i pixlar (max 16383)
height	integer	Nej	-	Målhöjd i pixlar (max 16383)
fit	string	Nej	`"contain"`	Hur bilden anpassas till dimensionerna: `contain`, `cover`, `fill`, `inside`, `outside`
withoutEnlargement	boolean	Nej	`false`	Förhindra uppskalning om bilden är mindre än målet
percentage	number	Nej	-	Skala med procent (t.ex. 50 för halv storlek)

Minst en av width, height eller percentage måste anges.

Anpassningslägen

contain - Ändra storlek för att rymmas inom dimensionerna, med bevarat bildförhållande (kan lämna tomt utrymme)
cover - Ändra storlek för att täcka dimensionerna, med bevarat bildförhållande (kan beskära)
fill - Sträck ut för att exakt matcha dimensionerna (ignorerar bildförhållande)
inside - Som contain, men skalar bara ned, aldrig upp
outside - Som cover, men skalar bara ned, aldrig upp

Exempelförfrågan

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"}'

Ändra storlek med procent:

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}'

Exempelsvar

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

Anteckningar

Maximal dimension är 16383 pixlar på vardera axeln (Sharp/libvips-gräns).
Utdataformatet matchar indataformatet. HEIC-, RAW-, PSD- och SVG-indata avkodas automatiskt före bearbetning.
EXIF-orientering appliceras automatiskt före storleksändring.
Flaggan withoutEnlargement är användbar för batchbearbetning där vissa bilder redan kan vara mindre än målet.

2.7 KiB Raw Blame History