SnapOtter/apps/docs/tr/tools/image/collage.md

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
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.	cd50a782239d	human	32baf2d667fc

Kolaj ve Izgara

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ı

POST /api/v1/tools/image/collage

Parametreler

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

Ş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

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

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/collage.png",
  "originalSize": 2456789,
  "processedSize": 1823456
}

Notlar

• Ç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.