Görüntü motoru

@snapotter/image-engine paketi, AI olmayan tüm görüntü işlemlerini yönetir. Sharp kitaplığını sarmalar ve harici bağımlılık olmadan tamamen işlem içinde çalışır.

İşlemler

resize

Bir görüntüyü belirli boyutlara veya yüzdeye göre ölçekler.

Parametre	Tür	Açıklama
width	number	Piksel cinsinden hedef genişlik
height	number	Piksel cinsinden hedef yükseklik
fit	string	cover, contain, fill, inside veya outside
withoutEnlargement	boolean	Doğruysa, daha küçük görüntüleri büyütmez
percentage	number	Mutlak boyutlar yerine yüzdeye göre ölçekle

width, height değerlerini veya ikisini birden ayarlayabilirsiniz. Yalnızca birini ayarlarsanız, en boy oranını korumak için diğeri hesaplanır.

crop

Görüntüden dikdörtgen bir bölge keser.

Parametre	Tür	Açıklama
left	number	Sol kenardan X ofseti
top	number	Üst kenardan Y ofseti
width	number	Kırpma alanının genişliği
height	number	Kırpma alanının yüksekliği
unit	string	px (varsayılan) veya percent

rotate

Görüntüyü belirli bir açıyla döndürür.

Parametre	Tür	Açıklama
angle	number	Derece cinsinden döndürme açısı (0-360)
background	string	Açığa çıkan alan için dolgu rengi (varsayılan: #000000). Yalnızca 90 derece olmayan açılara uygulanır.

flip

Görüntüyü yatay, dikey veya her ikisinde aynalar. En az biri doğru olmalıdır.

Parametre	Tür	Açıklama
horizontal	boolean	Soldan sağa aynala
vertical	boolean	Yukarıdan aşağıya aynala

convert

Görüntü biçimini değiştirir.

Parametre	Tür	Açıklama
format	string	Hedef biçim: jpg, png, webp, avif, tiff, gif, jxl, heic, heif, bmp, ico, jp2, qoi
quality	number	Sıkıştırma kalitesi (1-100, kayıplı biçimlere uygulanır)

İlk yedi biçim (jpg ile jxl arası) Sharp tarafından işlem içinde kodlanır. Kalan biçimler API katmanında harici kodlayıcılar kullanır: heic/heif heif-enc aracılığıyla, bmp/ico ImageMagick aracılığıyla, jp2 opj_compress aracılığıyla ve qoi satır içi bir TypeScript codec aracılığıyla.

compress

Aynı biçimi koruyarak dosya boyutunu azaltır.

Parametre	Tür	Açıklama
quality	number	Hedef kalite (1-100)
targetSizeBytes	number	Bayt cinsinden isteğe bağlı hedef dosya boyutu
format	string	İsteğe bağlı biçim geçersiz kılma

strip-metadata

Görüntüden EXIF, IPTC, XMP ve ICC meta verilerini kaldırır. Parametre olmadan (veya stripAll: true ile) her şeyi kaldırır. Seçici kaldırma için ayrı bayraklar geçirin.

Parametre	Tür	Açıklama
stripAll	boolean	Tüm meta verileri kaldır (bayrak ayarlanmadığında varsayılan)
stripExif	boolean	EXIF verilerini kaldır (stripGps ayrıca ayarlanmamışsa GPS dahil)
stripGps	boolean	GPS konum verilerini kaldır
stripIcc	boolean	ICC renk profilini kaldır
stripXmp	boolean	XMP meta verilerini kaldır

Renk ayarlamaları

Bu işlemler bir görüntünün renk özelliklerini değiştirir. Her biri tek bir sayısal değer alır.

İşlem	Parametre	Aralık	Açıklama
brightness	value	-100 ile 100	Parlaklığı ayarla
contrast	value	-100 ile 100	Kontrastı ayarla
saturation	value	-100 ile 100	Renk doygunluğunu ayarla

Renk filtreleri

Bunlar sabit bir renk dönüşümü uygular. Parametre almazlar.

İşlem	Açıklama
grayscale	Gri tonlamaya dönüştür
sepia	Sepya ton uygula
invert	Tüm renkleri tersine çevir

Renk kanalları

Bireysel RGB renk kanallarını ayarlar. Değerler, 100 = değişiklik yok olan çarpanlardır.

Parametre	Tür	Açıklama
red	number	Kırmızı kanal çarpanı (0 ile 200, 100 = değişmemiş)
green	number	Yeşil kanal çarpanı (0 ile 200, 100 = değişmemiş)
blue	number	Mavi kanal çarpanı (0 ile 200, 100 = değişmemiş)

sharpen

Tek bir değerle kontrol edilen basit keskinleştirme.

Parametre	Tür	Açıklama
value	number	Keskinleştirme yoğunluğu (0 ile 100). 0,5-10 arası bir Gauss sigma değerine eşlenir.

sharpen-advanced

Üç seçilebilir yöntem ve isteğe bağlı bir gürültü azaltma ön geçişi ile gelişmiş keskinleştirme.

Parametre	Tür	Açıklama
method	string	adaptive, unsharp-mask veya high-pass
sigma	number	Gauss bulanıklık yarıçapı, 0,5-10 (uyarlamalı)
m1	number	Düz alan keskinleştirme, 0-10 (uyarlamalı)
m2	number	Dokulu alan keskinleştirme, 0-20 (uyarlamalı)
x1	number	Düz/tırtıklı eşiği, 0-10 (uyarlamalı)
y2	number	Maksimum aydınlatma (halo kelepçesi), 0-50 (uyarlamalı)
y3	number	Maksimum karartma (halo kelepçesi), 0-50 (uyarlamalı)
amount	number	Yoğunluk yüzdesi, 0-500 (unsharp-mask)
radius	number	Bulanıklık yarıçapı, 0,1-5,0 (unsharp-mask)
threshold	number	Minimum kenar parlaklığı, 0-255 (unsharp-mask)
strength	number	Karıştırma gücü, 0-100 (high-pass)
kernelSize	number	3x3 / 5x5 çekirdek için 3 veya 5 (high-pass)
denoise	string	Gürültü azaltma ön geçişi: off, light, medium veya strong

Parametreler yönteme özgüdür. Yalnızca seçilen yöntemle ilgili olanları sağlayın.

color-blindness

3x3 renk yeniden birleştirme matrisi kullanarak bir renk görme eksikliğini simüle eder.

Parametre	Tür	Açıklama
type	string	Şunlardan biri: protanopia, deuteranopia, tritanopia, protanomaly, deuteranomaly, tritanomaly, achromatopsia, blueConeMonochromacy

edit-metadata

Tüm bloğu kaldırmadan bireysel EXIF/IPTC meta veri alanlarını yazar veya kaldırır.

Parametre	Tür	Açıklama
artist	string	EXIF Artist etiketi
copyright	string	EXIF Copyright etiketi
imageDescription	string	EXIF ImageDescription etiketi
software	string	EXIF Software etiketi
dateTime	string	EXIF DateTime etiketi
dateTimeOriginal	string	EXIF DateTimeOriginal etiketi
clearGps	boolean	Tüm GPS etiketlerini kaldır
fieldsToRemove	string[]	Silinecek EXIF alan adlarının listesi

Tüm parametreler isteğe bağlıdır. fieldsToRemove içinde listelenen alanlar mevcut EXIF bloğundan silinir. Adlandırılmış parametreler aracılığıyla ayarlanan alanlar yazılır (veya üzerine yazılır). MakerNote gibi ikili/güvenli olmayan anahtarlar sessizce yok sayılır.

Biçim algılama

Motor, giriş biçimlerini yalnızca dosya uzantılarından değil, dosya başlıklarından otomatik olarak algılar. Bu, aslında bir PNG olan bir .jpg dosyasının doğru şekilde işleneceği anlamına gelir. Algılama çok katmanlı bir yaklaşım kullanır: önce sihirli baytlar, ardından yedek olarak dosya uzantısı.

SnapOtter, 20+ markadan 23 kamera RAW biçimi, profesyonel biçimler (PSD, EPS, OpenEXR, HDR), modern codec'ler (JPEG XL, AVIF, HEIC, QOI, JPEG 2000) ve bilimsel/oyun biçimleri (FITS, DDS) dahil olmak üzere 55+ giriş biçimi ve 13 çıkış biçimi destekler. Kod çözme, mümkün olduğunda Sharp tarafından yerel olarak, ImageMagick, LibRaw ve özel CLI kod çözücülerine otomatik yedeklemeyle yönetilir.

Tam liste için Desteklenen Biçimler sayfasına bakın.

Meta veri çıkarma

info aracı görüntü meta verilerini döndürür. Tam alan referansı için Görüntü Bilgisi sayfasına bakın.

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "width": 4032,
  "height": 3024,
  "format": "jpeg",
  "channels": 3,
  "hasAlpha": false,
  "colorSpace": "srgb",
  "density": 72,
  "isProgressive": false,
  "hasExif": true,
  "hasIcc": true,
  "hasXmp": false,
  "bitDepth": "8",
  "pages": 1,
  "histogram": [
    { "channel": "red", "min": 0, "max": 255, "mean": 128.45, "stdev": 52.31 },
    { "channel": "green", "min": 2, "max": 253, "mean": 115.22, "stdev": 48.76 },
    { "channel": "blue", "min": 0, "max": 250, "mean": 102.89, "stdev": 55.14 }
  ]
}