Ö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 parseYalnı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çim | Behavior |
|---|---|
| GIF | FrameCount, dosya birden fazla kare içerdiğinde kare sayısını yansıtır; sayı belirlenemiyorsa atlanır |
| BMP | Başlıktaki negatif yükseklik (üstten alta satır sırası) normalleştirilir — Height, pozitif büyüklüğü döndürür |
| DICOM | Baş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çim | Genişlik / Yükseklik | Bit derinliği | Kare 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 nullBu, 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
DetectFormatkullanın,Probeyerine. - Kullanmadan önce
Width/Height/BitDepth/FrameCountiçindenullolup 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. ImageProbetamamen statiktir — örnek yok,IDisposableyok, yapılandırma nesnesi yok.
Ortak Sorunlar
| Sorun | Neden | Düzeltme |
|---|---|---|
Format ImageFormat.Unknown‘dır | Header, tanınan 11 formattan hiçbirine uymuyor | Dosyanı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ır | Biç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 / Metot | Açı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 |
ImageInfo | Sonuç türü: Format, Width, Height, BitDepth, FrameCount |
ImageFormat | Enum: Unknown, Png, Jpeg, Gif, Bmp, WebP, Ico, Tiff, Psd, Emf, Wmf, Dicom |