man/multimedia
man · Multimedya

$ sips

Bölüm 1 · Multimedya

betiklenebilir görüntü işleme sistemi

Özet

sips [görüntü-fonksiyonları] görüntü_dosyası ...
sips [profil-fonksiyonları] profil ...

Açıklama

sips, raster görüntü dosyalarını ve ColorSync ICC profillerini sorgulamak veya değiştirmek için kullanılır. İşlevselliği Image Events AppleScript paketi aracılığıyla da kullanılabilir. Ayrıca görüntüleri değiştirmek veya üretmek için JavaScript çalıştırmayı destekler.

Fonksiyonlar

Profil Sorgulama

  • -g key, --getProperty key: Anahtar için özellik değerini standart çıktıya verir.
  • -X tag tagFile, --extractTag tag tagFile: Bir profil etiketini tagFile dosyasına yazar.
  • --verify: Profil sorunlarını doğrular ve çıktıyı standart çıktıya yazar.
  • -1, --oneLine: Her dosya için çıktıyı, değerler arasında | sınırlayıcısıyla tek satırda verir.

Görüntü Sorgulama

  • -g key, --getProperty key: Anahtar için özellik değerini standart çıktıya verir.
  • -x profile, --extractProfile profile: Görüntüdeki gömülü profili alır ve profile dosyasına yazar.
  • -1, --oneLine: Her dosya için çıktıyı sekme sınırlayıcısıyla tek satırda verir.

Profil Değiştirme

  • -s key value, --setProperty key value: Anahtar için özellik değerini ayarlar.
  • -d key, --deleteProperty key: Anahtar için özellik değerini kaldırır.
  • --deleteTag tag: Etiketi profilden kaldırır.
  • --copyTag srcTag dstTag: Bir profilin srcTag öğesini dstTag öğesine kopyalar.
  • --loadTag tag tagFile: Profil etiketini tagFile içeriğine ayarlar.
  • --repair: Profil sorunlarını onarır ve çıktıyı standart çıktıya yazar.
  • -o dosya-veya-dizin, --out dosya-veya-dizin: Çıktı konumunu belirtir.

Görüntü Değiştirme

  • -s key value, --setProperty key value: Anahtar için özellik değerini ayarlar.
  • -d key, --deleteProperty key: Anahtar için özellik değerini kaldırır.
  • -e profile, --embedProfile profile: Profili görüntüye gömer.
  • -E profile, --embedProfileIfNone profile: Yalnızca görüntüde profil yoksa profili gömer.
  • -m profile, --matchTo profile: Görüntünün renklerini profille eşleştirir.
  • -M profile intent, --matchToWithIntent profile intent: Görüntünün renklerini belirtilen oluşturma amacıyla profille eşleştirir.
  • --deleteColorManagementProperties: TIFF, PNG ve EXIF sözlüklerindeki renk yönetimi özelliklerini siler.
  • -r degreesCW, --rotate degreesCW: Görüntüyü saat yönünde belirtilen derece kadar döndürür.
  • -f horizontal|vertical, --flip horizontal|vertical: Görüntüyü yatay veya dikey çevirir.
  • -c pixelsH pixelsW, --cropToHeightWidth pixelsH pixelsW: Görüntüyü belirtilen boyuta sığacak şekilde kırpar.
  • --cropOffset offsetY offsetH: Sol üst köşeden kırpma ofsetini belirtir.
  • -p pixelsH pixelsW, --padToHeightWidth pixelsH pixelsW: Görüntüyü belirtilen boyuta sığması için piksellerle doldurur.
  • --padColor hexcolor: Doldurma rengini belirtir. Örnekler: beyaz FFFFFF, kırmızı FF0000, varsayılan siyah 000000.
  • -z pixelsH pixelsW, --resampleHeightWidth pixelsH pixelsW: Görüntüyü belirtilen boyutta yeniden örnekler. Boy-en oranı değişebilir.
  • --resampleWidth pixelsW: Görüntüyü belirtilen genişliğe göre yeniden örnekler.
  • --resampleHeight pixelsH: Görüntüyü belirtilen yüksekliğe göre yeniden örnekler.
  • -Z pixelsWH, --resampleHeightWidthMax pixelsWH: Görüntüyü, yükseklik ve genişlik belirtilen boyuttan büyük olmayacak şekilde yeniden örnekler.
  • -i, --addIcon: Görüntü dosyasına Finder simgesi ekler.
  • --optimizeColorForSharing: Renkleri paylaşım için optimize eder.
  • -o dosya-veya-dizin, --out dosya-veya-dizin: Çıktı konumunu belirtir.
  • -j dosya, --js dosya: JavaScript dosyasını çalıştırır.

Diğer

  • --debug: Hata ayıklama çıktısını etkinleştirir.
  • -h, --help: Yardımı gösterir.
  • -H, --helpProperties: Özellikler için yardımı gösterir.
  • --man: Kılavuz sayfaları üretir.
  • -v, --version: Sürümü gösterir.
  • --formats: Okuma/yazma formatlarını gösterir.

JavaScript Desteği

JavaScript HTML Canvas nesneleri oluşturulabilir ve 2B çizim bağlamı üretmek için kullanılabilir. sips global nesnesi ve bazı yardımcı sınıflar kullanılabilir:

  • sips.images: Argüman olarak geçirilen geçerli görüntülerin Image nesnesi dizisi.
  • sips.arguments: Programa geçirilen argümanların dize dizisi.
  • sips.size: Çıktı için önerilen boyut.
  • sips.longestEdge: Belirtilmişse -Z / --resampleHeightWidthMax seçeneğinin değeri.
  • sips.outputPath: Çıktı dizini. Varsayılan değer geçerli dizindir.

Image nesnesi:

  • name: Görüntünün adı.
  • size: Görüntünün piksel boyutu.
  • properties: Görüntü özellikleri.
  • getProperty(name): Varsa, belirtilen özellik değerini döndürür.
  • sizeToFitLongestEdge(length): Boy-en oranını koruyarak en uzun kenarı length olacak görüntü boyutunu döndürür.

Output nesnesi:

  • new Output(context, name[, type]): Bağlamı name ve isteğe bağlı type ile diske çıktı olarak verir.
  • addToQueue(): Çıktıyı diske yazılmak üzere sıraya ekler.

Diğer fonksiyonlar:

  • print(str): Standart çıktıya yazar. console.log(str) işlevine eşdeğerdir.

Özellik Anahtarları

--getProperty, --setProperty ve --deleteProperty komutları aşağıdaki anahtarlardan birini parametre olarak kullanabilir.

Özel Anahtarlar

  • all: İkili veri.
  • allxml: İkili veri.

Görüntü Anahtarları

  • dpiHeight, dpiWidth: Ondalıklı sayı.
  • pixelHeight, pixelWidth: Tam sayı, salt okunur.
  • typeIdentifier: Metin, salt okunur.
  • format: Metin. Örnekler: jpeg, tiff, png, gif, jp2, pict, bmp, qtif, psd, sgi, tga.
  • formatOptions: Metin. Örnekler: default, low, normal, high, best, yüzde değeri, lzw, packbits.
  • space: Metin, salt okunur.
  • samplesPerPixel, bitsPerSample: Tam sayı, salt okunur.
  • creation: Metin, salt okunur.
  • make, model, description, copyright, artist: Metin.
  • software: Metin, salt okunur.
  • profile: İkili veri.
  • hasAlpha: Mantıksal değer, salt okunur.

Profil Anahtarları

  • description: UTF-8 metin.
  • size: Tam sayı, salt okunur.
  • cmm, version, creation, platform, deviceManufacturer, creator, copyright, md5: Metin.
  • class, space, pcs: Metin, salt okunur.
  • quality: normal, draft veya best.
  • deviceModel, deviceAttributes0, deviceAttributes1: Tam sayı.
  • renderingIntent: perceptual, relative, saturation veya absolute.