Files
SnapOtter/apps/docs/tr/tools/image/stitch.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
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.
2026-07-11 13:52:47 +08:00

3.1 KiB
Raw Blame History

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. 39333210505a human b7f7b4ff7d50

Birleştir / Combine

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.
  • grid modunda 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_PIXELS sunucu yapılandırmasıyla sınırlandırılır.