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.7 KiB
2.7 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Bir görüntüyü satır ve sütuna göre veya piksel boyutuna göre ızgara döşemelerine bölün, ZIP arşivi olarak döndürülür. | 57a2e11e7cce | human | 01424920320f |
Görüntü Bölme
Tek bir görüntüyü sütun/satır sayısına göre veya belirli piksel boyutlarına göre ızgara döşemelerine bölün. Tüm döşemeleri içeren bir ZIP arşivi döndürür.
API Uç Noktası
POST /api/v1/tools/image/split
Parametreler
| Parametre | Tür | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
| columns | integer | Hayır | 3 | Bölünecek sütun sayısı (1 ile 100 arası) |
| rows | integer | Hayır | 3 | Bölünecek satır sayısı (1 ile 100 arası) |
| tileWidth | integer | Hayır | - | Piksel cinsinden döşeme genişliği (min 10). Hem tileWidth hem tileHeight ayarlandığında columns değerini geçersiz kılar. |
| tileHeight | integer | Hayır | - | Piksel cinsinden döşeme yüksekliği (min 10). Hem tileWidth hem tileHeight ayarlandığında rows değerini geçersiz kılar. |
| outputFormat | string | Hayır | "original" |
Döşemeler için çıktı biçimi: original, png, jpg, webp, avif, jxl |
| quality | number | Hayır | 90 | Kayıplı biçimler için çıktı kalitesi (1 ile 100 arası) |
Örnek İstek
curl -X POST http://localhost:1349/api/v1/tools/image/split \
-F "file=@large-image.png" \
-F 'settings={"columns":3,"rows":3,"outputFormat":"png"}' \
--output split-tiles.zip
Örnek Yanıt
Yanıt, Content-Type: application/zip ile doğrudan bir ZIP dosyası olarak aktarılır. Dosya adı split-<jobId>.zip desenini izler.
ZIP içindeki her döşeme <originalBaseName>_r<row>_c<col>.<ext> olarak adlandırılır (örn. photo_r1_c1.png, photo_r2_c3.webp).
Notlar
- Tek bir görüntü dosyası kabul eder.
- HEIC, RAW, PSD ve SVG giriş biçimlerini destekler (otomatik olarak çözülür).
- Hem
tileWidthhemtileHeightsağlandığında, bunlarcolumns/rowsüzerinde önceliğe sahiptir. Izgara boyutlarıceil(imageWidth / tileWidth)veceil(imageHeight / tileHeight)olarak hesaplanır. - Kenar döşemeleri (en sağdaki sütun, alt satır), görüntü boyutları eşit olarak bölünemiyorsa belirtilen döşeme boyutundan daha küçük olabilir.
- Maksimum ızgara boyutu 100x100 (10.000 döşeme) ile sınırlandırılmıştır.
- Yanıt ZIP'i doğrudan aktarır, bu nedenle JSON yanıt gövdesi yoktur. Dosyayı kaydetmek için curl ile
--outputkullanın.