mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
2.8 KiB
2.8 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Seam carving-storleksändring som lägger till eller tar bort pixlar längs banor med låg vikt för att bevara viktigt innehåll och ansikten. | f383b28ab62a | human | f604ce3f5785 |
Innehållsmedveten storleksändring
Seam carving-storleksändring som intelligent tar bort eller lägger till pixlar längs banor med minst visuell betydelse, bevarar viktigt innehåll och skyddar valfritt ansikten.
API-slutpunkt
POST /api/v1/tools/image/content-aware-resize
Bearbetning: Synkron (returnerar resultatet direkt)
Modellpaket: Inget krävs för grundläggande drift. Ansiktsskydd använder paketet face-detection (200-300 MB) om det är aktiverat.
Parametrar
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|---|---|---|---|---|
| file | file | Ja | - | Bildfil (multipart) |
| width | number | Nej | - | Målbredd i pixlar |
| height | number | Nej | - | Målhöjd i pixlar |
| protectFaces | boolean | Nej | false |
Upptäck och skydda ansikten från borttagning av sömmar |
| blurRadius | number | Nej | 4 |
Oskärperadie i förbearbetningen för energiberäkning (0-20) |
| sobelThreshold | number | Nej | 2 |
Tröskelvärde för Sobel-kantdetektering (1-20). Högre värden gör algoritmen mer aggressiv |
| square | boolean | Nej | false |
Storleksändra till en kvadrat (använder den mindre dimensionen) |
Minst en av width, height eller square måste anges.
Exempelbegäran
curl -X POST http://localhost:1349/api/v1/tools/image/content-aware-resize \
-F "file=@landscape.jpg" \
-F 'settings={"width":800,"protectFaces":true}'
Svar (200 OK)
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/{jobId}/landscape_seam.png",
"originalSize": 450000,
"processedSize": 380000,
"width": 800,
"height": 600
}
Anteckningar
- Denna anpassade route returnerar för närvarande ett synkront 200-svar.
- Använder seam carving-biblioteket
caireför innehållsmedveten storleksändring. - Minskar endast dimensioner (tar bort sömmar). Kan inte utöka en bild utöver dess ursprungliga storlek.
- Alternativet
protectFacesanvänder AI-ansiktsdetektering för att markera ansiktsområden som högenergi, vilket förhindrar att sömmar passerar genom ansikten. blurRadiusstyr utjämning före beräkningen av energikartan. Högre värden gör energikartan mer enhetlig, vilket kan hjälpa med brusiga bilder.sobelThresholdpåverkar hur aggressivt kanter upptäcks. Lägre värden bevarar mer subtila kanter.- Utdatan är alltid i PNG-format.
- Stöder indataformaten HEIC/HEIF, RAW, TGA, PSD, EXR och HDR via automatisk avkodning.