Files
SnapOtter/apps/docs/tr/tools/image/watermark-image.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

2.4 KiB
Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Yapılandırılabilir konum, opaklık ve ölçekle bir logo veya görüntüyü filigran olarak yerleştirin. c73ab0ef8ab9 human f0bc773265df

Görüntü Filigranı

Bir logo veya ikincil görüntüyü bir temel görüntü üzerinde filigran olarak yerleştirin. Filigran, temel görüntü genişliğine göre ölçeklenir ve bir köşede veya merkezde konumlandırılır.

API Uç Noktası

POST /api/v1/tools/image/watermark-image

İki görüntü dosyası ve bir JSON settings alanı içeren multipart form verisini kabul eder.

Parametreler

Parametre Tür Zorunlu Varsayılan Açıklama
position string Hayır "bottom-right" Filigran yerleşimi: center, top-left, top-right, bottom-left, bottom-right
opacity number Hayır 50 Filigran opaklık yüzdesi (0 ile 100 arası)
scale number Hayır 25 Ana görüntü genişliğinin yüzdesi olarak filigran genişliği (1 ile 100 arası)

Dosya Alanları

Alan Adı Zorunlu Açıklama
file Evet Ana/temel görüntü
watermark Evet Filigran/logo görüntüsü

Örnek İstek

curl -X POST http://localhost:1349/api/v1/tools/image/watermark-image \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F "watermark=@logo.png" \
  -F 'settings={"position": "bottom-right", "opacity": 60, "scale": 20}'

Örnek Yanıt

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 2520000
}

Notlar

  • Her iki görüntü de doğrulanır ve çözülür (HEIC, RAW, PSD, SVG desteklenir).
  • Filigran, genişliği ana görüntü genişliğinin %scale'sine eşit olacak şekilde orantılı olarak yeniden boyutlandırılır.
  • Opaklık, dest-in harmanlamayla birleştirilen bir alfa maskesi aracılığıyla uygulanır.
  • Köşe konumları görüntü kenarından 20px dolgu kullanır.
  • Filigran görüntüsünde saydamlık varsa (örn. bir PNG logosu), birleştirme sırasında korunur.
  • İşlemeden önce her iki görüntüde de EXIF yönü otomatik olarak uygulanır.