mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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.5 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Kompozit için görüntüleri konum, opaklık ve harmanlama modlarıyla katmanlayın.	c5d09eb13fde	human	30a96db223c7

Görüntü Kompozisyonu

Yapılandırılabilir konum, opaklık ve harmanlama moduyla bir temel görüntünün üzerine bir yer paylaşım görüntüsü katmanlayın. Logoları, grafikleri kompozit etmek veya birden fazla görüntüyü birleştirmek için kullanışlıdır.

API Uç Noktası

POST /api/v1/tools/image/compose

İki görüntü dosyası ve bir JSON settings alanı ile çok parçalı form verilerini kabul eder.

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
x	number	Hayır	`0`	Yer paylaşımının sol üst köşeden yatay ofseti, piksel cinsinden (min 0)
y	number	Hayır	`0`	Yer paylaşımının sol üst köşeden dikey ofseti, piksel cinsinden (min 0)
opacity	number	Hayır	`100`	Yer paylaşımı opaklık yüzdesi (0 ile 100 arası)
blendMode	string	Hayır	`"over"`	Kompozit harmanlama modu

Harmanlama Modları

Değer	Açıklama
`over`	Normal yer paylaşımı (varsayılan)
`multiply`	Piksel değerlerini çarparak koyulaştırma
`screen`	Tersine çevirerek, çarparak ve tekrar tersine çevirerek açma
`overlay`	Temel parlaklığa göre çarpma ve ekranı birleştirir
`darken`	Her katmandan daha koyu pikseli korur
`lighten`	Her katmandan daha açık pikseli korur
`hard-light`	Güçlü kontrast yer paylaşımı
`soft-light`	İnce kontrast yer paylaşımı
`difference`	Katmanlar arasındaki mutlak fark
`exclusion`	Farka benzer ancak daha düşük kontrast

Dosya Alanları

Alan Adı	Zorunlu	Açıklama
file	Evet	Temel/arka plan görüntüsü
overlay	Evet	Yer paylaşımı/ön plan görüntüsü

Örnek İstek

curl -X POST http://localhost:1349/api/v1/tools/image/compose \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@background.jpg" \
  -F "overlay=@graphic.png" \
  -F 'settings={"x": 100, "y": 50, "opacity": 80, "blendMode": "over"}'

Çarpma harmanlama modunu kullanma:

curl -X POST http://localhost:1349/api/v1/tools/image/compose \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F "overlay=@texture.jpg" \
  -F 'settings={"x": 0, "y": 0, "opacity": 50, "blendMode": "multiply"}'

Örnek Yanıt

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/background.jpg",
  "originalSize": 3200000,
  "processedSize": 3450000
}

Notlar

Her iki görüntü de kompozit etmeden önce doğrulanır ve çözülür (HEIC, RAW, PSD, SVG desteklenir).
Yer paylaşımı, x ve y tarafından belirtilen tam piksel koordinatlarına yerleştirilir. Sığdırmak için yeniden boyutlandırılmaz.
Opaklık 100'den azsa, harmanlamadan önce yer paylaşımına bir alfa maskesi uygulanır.
Yer paylaşımı, temel görüntü sınırlarının ötesine uzanabilir (kırpılır).
İşlemeden önce her iki görüntüde EXIF yönlendirmesi otomatik olarak uygulanır.
Çıktı boyutları, temel görüntü boyutlarıyla eşleşir.

3.5 KiB Raw Blame History Unescape Escape