Hızlı Başlangıç
Hızlı Başlangıç
Bu sayfa, en küçük çalışan örneği adım adım gösterir: bir dosyanın formatını ve başlık özelliklerini saptamak, ardından kütüphanenin bir hatalı dosyayı atmak yerine nasıl işlediğini görmek.
Dosyayı incele
ImageProbe tek statik giriş noktasıdır. ProbeFile, bir ImageInfo sonucunu doldurmak için dosya başlığından yeterli miktarı okur — piksel verilerini asla çözmez:
using Aspose.Imaging.Foss;
var info = ImageProbe.ProbeFile("photo.jpg");
Console.WriteLine($"{info.Format}: {info.Width}x{info.Height}, {info.BitDepth}-bit");ImageInfo, Format, Width, Height, BitDepth ve FrameCount öğelerini ortaya çıkarır — yalnızca algılanan format gerçekten bu verileri taşıyorsa doldurulur.
Bir akışı veya bayt dizisini incele
Probe, doğrudan bir Stream veya bir byte[] kabul eder ve DetectFormat, tam başlığa ihtiyacınız olmadığında yalnızca ImageFormat döndürür:
using Aspose.Imaging.Foss;
using System.IO;
byte[] bytes = File.ReadAllBytes("photo.jpg");
var format = ImageProbe.DetectFormat(bytes);
using var stream = File.OpenRead("photo.jpg");
var info = ImageProbe.Probe(stream);Kırpılmış veya hatalı girişin işlenmesi
ImageProbe hatalı veya kırpılmış girişte asla hata fırlatmaz. Bir istisna yükseltmek yerine, okuduğu alanlarla sınırlı bir ImageInfo döndürür — Format, başlığın format işaretçisi tanındığında her zaman ayarlanır, dosyanın geri kalanı kesilmiş olsa bile:
using Aspose.Imaging.Foss;
byte[] truncated = fullGifBytes[..^2]; // last two bytes missing
var info = ImageProbe.Probe(truncated);
Console.WriteLine(info.Format); // Gif — detected from the header aloneBu, ImageProbe‘ı güvensiz veya kısmen indirilmiş dosyalar üzerinde, her çağrıyı try/catch içine almadan güvenli bir şekilde çalıştırmayı sağlar.
Sonraki Adımlar
- Installation — paket kurulumu ve ortam gereksinimleri
- Geliştirici Rehberi — tam format algılaması API
- License — MIT lisans koşulları