mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
3.1 KiB
3.1 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Hizalama, boşluk, kenarlık ve yeniden boyutlandırma modu üzerinde denetimle görüntüleri yan yana, üst üste veya bir ızgarada birleştirin. | 670c5cc944b1 | human | b7f7b4ff7d50 |
Görüntüleri Birleştir
Birden fazla görüntüyü yan yana, dikey olarak üst üste veya bir ızgara halinde birleştirin. Hizalama, boşluk, kenarlık, köşe yarıçapı ve birden fazla yeniden boyutlandırma modunu destekler.
API Uç Noktası
POST /api/v1/tools/image/stitch
Parametreler
| Parametre | Tür | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
| direction | string | Hayır | "horizontal" |
Yerleşim yönü: horizontal, vertical, grid |
| gridColumns | integer | Hayır | 2 | Yön grid olduğunda sütun sayısı (2 ile 100 arası) |
| resizeMode | string | Hayır | "fit" |
Görüntülerin nasıl yeniden boyutlandırılacağı: fit, original, stretch, crop |
| alignment | string | Hayır | "center" |
Çapraz eksen hizalaması: start, center, end |
| gap | number | Hayır | 0 | Piksel cinsinden görüntüler arası boşluk (0 ile 1000 arası) |
| border | number | Hayır | 0 | Piksel cinsinden dış kenarlık genişliği (0 ile 500 arası) |
| cornerRadius | number | Hayır | 0 | Nihai çıktıya uygulanan köşe yarıçapı (0 ile 500 arası) |
| backgroundColor | string | Hayır | "#FFFFFF" |
Hex olarak arka plan/kenarlık rengi (örn. #FF0000) |
| format | string | Hayır | "png" |
Çıktı biçimi: png, jpeg, webp, avif, jxl |
| quality | number | Hayır | 90 | Çıktı kalitesi (1 ile 100 arası) |
Örnek İstek
curl -X POST http://localhost:1349/api/v1/tools/image/stitch \
-F "file=@image1.png" \
-F "file=@image2.png" \
-F "file=@image3.png" \
-F 'settings={"direction":"horizontal","resizeMode":"fit","gap":10,"backgroundColor":"#FFFFFF","format":"png"}'
Örnek Yanıt
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/stitch.png",
"originalSize": 1234567,
"processedSize": 987654
}
Notlar
- En az 2 görüntü gerektirir. Multipart isteğinde birden fazla görüntü dosyası yükleyin.
- HEIC, RAW, PSD ve SVG giriş biçimlerini destekler (otomatik olarak çözülür).
- Yeniden boyutlandırma modları:
fit- Görüntüleri birleştirme ekseni boyunca en küçük boyuta uyacak şekilde ölçekler.original- Orijinal boyutları korur (düzensiz kenarlar oluşturabilir).stretch- En-boy oranını korumadan görüntüleri en küçük boyuta uymaya zorlar.crop- En küçük boyuta uyacak şekilde görüntüleri kaplama-kırpma yapar.
gridmodunda hücreler, tüm görüntülerin medyan boyutlarına göre boyutlandırılır.cornerRadius, tek tek görüntülere değil, tüm nihai çıktıya uygulanır.- Bellek tükenmesini önlemek için tuval boyutu
MAX_CANVAS_PIXELSsunucu yapılandırmasıyla sınırlandırılır.