Aspose.Imaging FOSS
Getting Started
Rychlý start

Rychlý start

Rychlý start

Tato stránka provádí nejmenší funkční příklad: zkoumá soubor pro jeho formát a vlastnosti záhlaví, a poté ukazuje, jak knihovna zachází s poškozeným souborem místo vyvolání výjimky.

Prozkoumat soubor

ImageProbe je jediný statický vstupní bod. ProbeFile načte právě tolik záhlaví souboru, aby vytvořil výsledek ImageInfo — nikdy nedekóduje pixelová data:

using Aspose.Imaging.Foss;

var info = ImageProbe.ProbeFile("photo.jpg");
Console.WriteLine($"{info.Format}: {info.Width}x{info.Height}, {info.BitDepth}-bit");

ImageInfo poskytuje Format, Width, Height, BitDepth a FrameCount — jsou naplněny jen tehdy, když detekovaný formát skutečně obsahuje tato data.

Prozkoumat proud nebo pole bajtů

Probe přijímá přímo Stream nebo byte[] a DetectFormat vrací pouze ImageFormat, když nepotřebujete celé záhlaví:

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);

Zpracování zkráceného nebo poškozeného vstupu

ImageProbe nikdy nevyhodí výjimku při poškozeném nebo zkráceném vstupu. Místo vyvolání výjimky vrátí částečný ImageInfo s jakýmikoli poli, které se podařilo přečíst — Format je vždy nastaveno, když byl rozpoznán formátový marker hlavičky, i když je zbytek souboru oříznutý:

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 alone

To dělá ImageProbe bezpečným pro spuštění na nedůvěryhodných nebo částečně stažených souborech bez nutnosti obalovat každý volání do try/catch.

Další kroky

Viz také:

 Čeština