Özellikler ve İşlevsellik

Özellikler ve İşlevsellik

Özellikler ve İşlevsellikler

Bu sayfa, Aspose.Imaging FOSS’in .NET’ın format algılama ve başlık tarama API için her özellik alanını, çalışan C# örnekleriyle kapsar. Kütüphane asla piksel verisini çözümlmez — her yöntem yalnızca dosya başlığını okur.


Format Algılama

ImageProbe statik giriş noktasıdır. Üç aşırı yükleme bir dosya yolu, bir akış ve ham bayt dizisini kapsar:

using Aspose.Imaging.Foss;

var fromPath   = ImageProbe.ProbeFile("photo.jpg");
var fromBytes  = ImageProbe.Probe(byteArray);
var fromStream = ImageProbe.Probe(stream);

var formatOnly = ImageProbe.DetectFormat(byteArray); // ImageFormat only, no header parse

Yalnızca formata göre dallanmanız gerektiğinde DetectFormat kullanın; ayrıca boyutlar, bit derinliği veya çerçeve sayısına da ihtiyacınız olduğunda Probe/ProbeFile kullanın.


Başlık Üst Verilerini Okuma

ProbeFile/Probe, nullable Width, Height, BitDepth ve FrameCount içeren bir ImageInfo döndürür — bu değerler, algılanan formatın başlığının gerçekten o değeri taşıdığı durumlarda doldurulur:

var info = ImageProbe.ProbeFile("scan.dcm");
if (info.Width.HasValue && info.Height.HasValue)
{
    Console.WriteLine($"{info.Format}: {info.Width}x{info.Height}");
}

Format (ImageFormat bir enum değeri) başlık tanındığında her zaman ayarlanır — bu, doldurulması garantilenmiş tek alandır.


Biçim Başına Notlar

Bazı biçimlerin başlık tuhaflıkları vardır; ImageInfo bunları normalleştirir veya doğrudan ortaya çıkar:

BiçimBehavior
GIFFrameCount, dosya birden fazla kare içerdiğinde kare sayısını yansıtır; sayı belirlenemiyorsa atlanır
BMPBaşlıktaki negatif yükseklik (üstten alta satır sırası) normalleştirilir — Height, pozitif büyüklüğü döndürür
DICOMBaşlık ayrıştırması, Implicit VR Little Endian ve Explicit VR Little/Big Endian aktarım sözdizimlerini işler, satırları, sütunları ve tahsis edilen bitleri çıkarır
// DICOM: rows -> Height, columns -> Width, bitsAllocated -> BitDepth,
// across any of the three common transfer syntaxes
var dicomInfo = ImageProbe.Probe(dicomBytes);
Console.WriteLine($"{dicomInfo.Width}x{dicomInfo.Height}, {dicomInfo.BitDepth}-bit");

Desteklenen Biçimler

11 biçimin tamamı aynı şekilde tespit edilir — ImageProbe biçimi tanımlar ve başlık meta verilerini okur; bunların hiçbiri için piksel verisini asla çözümlmez veya yeniden kodlamaz. Ancak alan doldurulması gerçekten biçime göre değişir — her biçim Format ayarlar, ancak yalnızca bazıları başlıklarında bit derinliği veya çerçeve sayısını taşır:

BiçimGenişlik / YükseklikBit derinliğiKare sayısı
PNG✓✓✓
JPEG✓✓—
GIF✓—✓
BMP✓✓—
WebP✓——
ICO✓✓✓
TIFF✓✓✓
PSD✓✓—
EMF✓ (sınırdan)——
WMF (yerleştirilebilir)✓ (96 DPI varsayılır)——
DICOM✓ (Satırlar/Sütunlar)✓ (BitsAllocated)—

Tanımlanamayan bir başlık, hata fırlatmak yerine ImageFormat.Unknown olarak çözülür. Birkaç dikkat çekici alan doldurma detayı: PNG’nin FrameCount değeri her zaman 1‘dir (sabit bir değer, gerçek animasyonlu PNG çerçeve algılaması değildir); ICO’nun FrameCount değeri, dizindeki gömülü simge boyutlarının gerçek sayısıdır ve bir ICO dizin girişindeki 0 boyut baytı, format spesifikasyonuna göre 256px anlamına gelir; TIFF’in FrameCount değeri, dosyanın IFD zincirinin sınırlı bir yürüyüşünü yansıtır (her IFD bir sayfadır); yerleştirilemeyen WMF hâlâ doğru şekilde ImageFormat.Wmf olarak tanımlanır ancak yalnızca Format döndürür — boyutlar yalnızca yerleştirilebilir WMF için, başlığın birim-inç sınırlarından sabit 96 DPI dönüşümüyle doldurulur; EMF’de hiç açık bir genişlik/yükseklik alanı yoktur, bu yüzden boyutları bunun yerine rclBounds aygıt-alanı dikdörtgeninden türetilir.


Tasarım Gereği Dayanıklı

ImageProbe hatalı veya kesik girdi üzerinde asla hata fırlatmaz. Bir istisna yükseltmek yerine, kısmi bir ImageInfo döndürür — Format, başlığın format işaretleyicisi tanındığında, dosyanın geri kalanı kesilmiş ya da bozuk olsa bile ayarlanır:

byte[] truncated = fullFileBytes[..^3];
var info = ImageProbe.Probe(truncated);
// info.Format is still populated; other fields may be null

Bu, güvenilmeyen, kısmi veya hâlâ indirilmekte olan indirmelere karşı, her çağrı için bir try/catch bloğu olmadan çalıştırılmasını güvenli kılar.


İpuçları ve En İyi Uygulamalar

  • Yalnızca formatı, boyutları değil ihtiyacınız olduğunda DetectFormat kullanın, Probe yerine.
  • Kullanmadan önce Width/Height/BitDepth/FrameCount içinde null olup olmadığını kontrol edin — her format için doldurulmazlar.
  • Büyük dosyalarla çalışırken önce tüm dosyayı bir bayt dizisine okumak yerine Probe(stream) tercih edin.
  • ImageProbe tamamen statiktir — örnek yok, IDisposable yok, yapılandırma nesnesi yok.

Ortak Sorunlar

SorunNedenDüzeltme
Format ImageFormat.Unknown‘dırHeader, tanınan 11 formattan hiçbirine uymuyorDosyanın PNG, JPEG, GIF, BMP, WebP, ICO, TIFF, PSD, EMF, WMF veya DICOM formatlarından biri olduğunu doğrulayın
Width/Height null‘dırBiçimin başlığı o alanı içermiyor ya da başlık o alandan önce kesilmiş.Önce Format kontrol edin; her format için her alan doldurulmuş değildir.
BMP yüksekliği beklenmedik bir şekilde pozitif görünüyor.Kaynak dosya başlığında negatif (üstten alta) bir yükseklik kullandı.Beklenen — ImageInfo.Height her zaman pozitif büyüklüğe normalize edilir.

FAQ

ImageProbe piksel verilerini çözüyor mu?

Hayır. Her yöntem yalnızca dosya başlığını okur — boyutlar, bit derinliği ve çerçeve sayısı — piksel içeriğini asla okuma. Çözümleme ve renderleme bu kütüphanenin kapsamı dışındadır.

Bozuk ya da kesilmiş bir dosyayı sorgularsam ne olur?

ImageProbe hatalı ya da kesilmiş giriş için asla hata fırlatmaz. Mevcut başlık baytlarından belirleyebildiği alanlarla bir ImageInfo döndürür — format işaretçisi tanındığında Format ayarlanır.

Aranabilir olmayan bir akışı sorgulayabilir miyim?

Evet. Probe(stream) hem aranabilir hem de aranamaz akışları kabul eder.


API Reference Özeti

Sınıf / MetotAçıklama
ImageProbe.ProbeFile(path)Yolu kullanarak bir dosyayı sorgula, bir ImageInfo döndürerek.
ImageProbe.Probe(stream)Bir Stream ara (konumlandırılabilir veya değil)
ImageProbe.Probe(data)Ham bir byte[] ara
ImageProbe.DetectFormat(stream)Bir akış için yalnızca ImageFormat döndür
ImageProbe.DetectFormat(data)Bir byte[] için yalnızca ImageFormat döndür
ImageInfoSonuç türü: Format, Width, Height, BitDepth, FrameCount
ImageFormatEnum: Unknown, Png, Jpeg, Gif, Bmp, WebP, Ico, Tiff, Psd, Emf, Wmf, Dicom

Ayrıca Bakınız

 Türkçe