mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
f858c4cea0
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.
93 lines
4.6 KiB
Markdown
93 lines
4.6 KiB
Markdown
---
|
||
description: "Birden fazla görüntüyü 25'ten fazla şablon, ayarlanabilir boşluklar ve köşeler ve hücre başına kaydırma ve yakınlaştırma ile ızgara kolajlarında birleştirin."
|
||
i18n_source_hash: cd50a782239d
|
||
i18n_provenance: human
|
||
i18n_output_hash: 32baf2d667fc
|
||
---
|
||
|
||
# Kolaj ve Izgara {#collage-grid}
|
||
|
||
Birden fazla görüntüyü 25'ten fazla şablonla güzel ızgara kolajlarında birleştirin. Özelleştirilebilir boşluk, köşe yarıçapı, arka plan rengi ve hücre başına kaydırma/yakınlaştırma denetimleriyle 2-9 görüntülü düzenleri destekler.
|
||
|
||
## API Uç Noktası {#api-endpoint}
|
||
|
||
`POST /api/v1/tools/image/collage`
|
||
|
||
## Parametreler {#parameters}
|
||
|
||
| Parametre | Tür | Zorunlu | Varsayılan | Açıklama |
|
||
|-----------|------|----------|---------|-------------|
|
||
| templateId | string | Evet | - | Şablon düzeni kimliği (örn. `2-h-equal`, `3-left-large`, `4-grid`, `9-grid`) |
|
||
| cells | array | Hayır | - | `imageIndex`, `panX`, `panY`, `zoom`, `objectFit` içeren hücre başına ayarlar dizisi |
|
||
| cells[].imageIndex | integer | Evet | - | Bu hücreye yerleştirilecek görüntünün dizini (0 tabanlı) |
|
||
| cells[].panX | number | Hayır | 0 | Yatay kaydırma ofseti (-100 ile 100 arası) |
|
||
| cells[].panY | number | Hayır | 0 | Dikey kaydırma ofseti (-100 ile 100 arası) |
|
||
| cells[].zoom | number | Hayır | 1 | Yakınlaştırma düzeyi (1 ile 10 arası) |
|
||
| cells[].objectFit | string | Hayır | `"cover"` | Görüntünün hücreyi nasıl doldurduğu: `cover` veya `contain` |
|
||
| gap | number | Hayır | 8 | Hücreler arasındaki boşluk, piksel cinsinden (0 ile 500 arası) |
|
||
| cornerRadius | number | Hayır | 0 | Her hücre için köşe yarıçapı, piksel cinsinden (0 ile 500 arası) |
|
||
| backgroundColor | string | Hayır | `"#FFFFFF"` | Arka plan rengi, hex olarak veya `"transparent"` |
|
||
| aspectRatio | string | Hayır | `"free"` | Tuval en boy oranı: `free`, `1:1`, `4:3`, `3:2`, `16:9`, `9:16`, `4:5` |
|
||
| outputFormat | string | Hayır | `"png"` | Çıktı biçimi: `png`, `jpeg`, `webp`, `avif`, `jxl` |
|
||
| quality | number | Hayır | 90 | Çıktı kalitesi (1 ile 100 arası) |
|
||
|
||
## Kullanılabilir Şablonlar {#available-templates}
|
||
|
||
| Şablon Kimliği | Görüntüler | Düzen |
|
||
|-------------|--------|--------|
|
||
| `2-h-equal` | 2 | İki eşit sütun |
|
||
| `2-v-equal` | 2 | İki eşit satır |
|
||
| `2-h-left-large` | 2 | Sol 2/3, sağ 1/3 |
|
||
| `2-h-right-large` | 2 | Sol 1/3, sağ 2/3 |
|
||
| `3-left-large` | 3 | Büyük sol, sağda iki üst üste |
|
||
| `3-right-large` | 3 | Solda iki üst üste, büyük sağ |
|
||
| `3-top-large` | 3 | Büyük üst, altta iki sütun |
|
||
| `3-h-equal` | 3 | Üç eşit sütun |
|
||
| `3-v-equal` | 3 | Üç eşit satır |
|
||
| `4-grid` | 4 | 2x2 ızgara |
|
||
| `4-left-large` | 4 | Büyük sol, sağda üç üst üste |
|
||
| `4-top-large` | 4 | Büyük üst, altta üç sütun |
|
||
| `4-bottom-large` | 4 | Üstte üç sütun, büyük alt |
|
||
| `5-top2-bottom3` | 5 | Üstte iki, altta üç |
|
||
| `5-top3-bottom2` | 5 | Üstte üç, altta iki |
|
||
| `5-left-large` | 5 | Büyük sol, sağda dört üst üste |
|
||
| `5-center-large` | 5 | Büyük merkez, dört köşe |
|
||
| `6-grid-2x3` | 6 | 2 sütun x 3 satır |
|
||
| `6-grid-3x2` | 6 | 3 sütun x 2 satır |
|
||
| `6-top-large` | 6 | Büyük üst, altta beş sütun |
|
||
| `7-mosaic` | 7 | Mozaik düzeni |
|
||
| `8-mosaic` | 8 | Mozaik düzeni |
|
||
| `9-grid` | 9 | 3x3 ızgara |
|
||
|
||
## Örnek İstek {#example-request}
|
||
|
||
```bash
|
||
curl -X POST http://localhost:1349/api/v1/tools/image/collage \
|
||
-F "file=@photo1.jpg" \
|
||
-F "file=@photo2.jpg" \
|
||
-F "file=@photo3.jpg" \
|
||
-F "file=@photo4.jpg" \
|
||
-F 'settings={"templateId":"4-grid","gap":12,"cornerRadius":8,"backgroundColor":"#F5F5F5","outputFormat":"png","quality":90}'
|
||
```
|
||
|
||
## Örnek Yanıt {#example-response}
|
||
|
||
```json
|
||
{
|
||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/collage.png",
|
||
"originalSize": 2456789,
|
||
"processedSize": 1823456
|
||
}
|
||
```
|
||
|
||
## Notlar {#notes}
|
||
|
||
- Çok parçalı istekte birden fazla görüntü dosyası yükleyin. Görüntüler, yükleme sırasına göre şablon hücrelerine atanır.
|
||
- Şablonun desteklediğinden daha fazla görüntü yüklenirse, fazladan görüntüler yok sayılır.
|
||
- HEIC, RAW, PSD ve SVG giriş biçimlerini destekler (otomatik olarak çözülür).
|
||
- Tuvalin temel boyutu en uzun kenarda 2400px'dir ve seçilen en boy oranına göre ölçeklenir.
|
||
- `aspectRatio` değeri `"free"` olduğunda, tuval varsayılan olarak 4:3'e (2400x1800) ayarlanır.
|
||
- Hücre başına `panX`/`panY` değerleri, kırpma penceresini hücre içinde kaydırır. 100 değeri bir kenara tamamen, -100 diğer kenara taşır.
|
||
- `"transparent"` arka plan rengi yalnızca `png`, `webp` veya `avif` çıktı biçimleriyle korunur.
|