Funkce a vlastnosti

Funkce a vlastnosti

Tato stránka pokrývá všechny oblasti funkcí Aspose.Imaging FOSS pro .NET detekci formátu a prohledávání hlaviček API, s funkčními C# příklady. Knihovna nikdy neprovádí dekódování pixelových dat — každá metoda čte pouze hlavičku souboru.

Detekce formátu

ImageProbe je statický vstupní bod. Tři přetížení pokrývají cestu k souboru, proud a surové pole bajtů:

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

Použijte DetectFormat, když potřebujete jen rozlišit formát; použijte Probe/ProbeFile, když potřebujete také rozměry, bitovou hloubku nebo počet snímků.

Čtení metadat hlavičky

ProbeFile/Probe vrací ImageInfo s nullable Width, Height, BitDepth a FrameCount — každý je naplněn pouze tehdy, když hlavička detekovaného formátu skutečně obsahuje tuto hodnotu:

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

Format (hodnota výčtu ImageFormat) je vždy nastavena, jakmile je hlavička rozpoznána — je to jediné pole, o kterém je zaručeno, že bude vyplněno.

Poznámky k formátům

Některé formáty mají zvláštnosti v hlavičce, které ImageInfo normalizuje nebo přímo zpřístupňuje:

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

Podporované formáty

Všech 11 formátů je detekováno stejným způsobem — ImageProbe identifikuje formát a čte metadata hlavičky; nikdy ne dekóduje ani neenkóduje pixelová data pro žádný z nich. Vyplňování polí se však skutečně liší podle formátu — každý formát nastavuje Format, ale jen některé v hlavičce obsahují hloubku bitů nebo počet snímků:

Nerozpoznaná hlavička se vyhodnotí na ImageFormat.Unknown místo vyhození výjimky. Několik pozoruhodných detailů ohledně vyplňování polí: PNG FrameCount je vždy 1 (konstanta, ne skutečná detekce animovaného PNG snímku); ICO FrameCount je skutečný počet vložených velikostí ikon v adresáři a 0 bajt rozměru v položce adresáře ICO znamená 256px podle specifikace formátu; TIFF FrameCount odráží omezený průchod řetězcem IFD souboru (každý IFD je jedna stránka); non-placeable WMF je stále správně identifikován jako ImageFormat.Wmf, ale vrací pouze Format — rozměry jsou vyplněny jen pro placeable WMF pomocí pevně zakódovaného převodu 96DPI z jednotek na palec v hlavičce; EMF vůbec neobsahuje explicitní pole šířka/výška, takže jeho rozměry jsou odvozeny z rclBounds obdélníku v device-space místo toho.

Odolný díky návrhu

ImageProbe nikdy nevyhazuje výjimku při poškozeném nebo zkráceném vstupu. Místo vyvolání výjimky vrací částečný ImageInfo — Format je nastaveno vždy, když byl rozpoznán formátový marker hlavičky, i když je zbytek souboru oříznutý nebo poškozený:

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

To umožňuje bezpečně spouštět proti nedůvěryhodným, částečným nebo probíhajícím stažením bez try/catch kolem každého volání.

Tipy a osvědčené postupy

• Použijte DetectFormat místo Probe, pokud potřebujete pouze formát, nikoli rozměry
• Zkontrolujte Width/Height/BitDepth/FrameCount na null před jejich použitím — nejsou vyplněny pro každý formát
• Upřednostněte Probe(stream) před načítáním celého souboru do pole bajtů, když pracujete s velkými soubory
• ImageProbe je zcela statické — žádná instance, žádný IDisposable, žádný konfigurační objekt

Časté problémy

FAQ

Dekóduje ImageProbe data pixelů?

Ne. Každá metoda čte jen hlavičku souboru — rozměry, bitovou hloubku a počet snímků — nikdy obsah pixelů. Dekódování a vykreslování jsou mimo rozsah této knihovny.

Co se stane, když prozkoumám poškozený nebo zkrácený soubor?

ImageProbe nikdy nevyhazuje výjimku pro špatně formovaný nebo zkrácený vstup. Vrací ImageInfo s jakýmikoli poli, která mohla určit z dostupných bajtů hlavičky — Format je nastaveno, kdykoli byl rozpoznán samotný značkový formát.

Mohu prozkoumat stream, který není seekovatelný?

Ano. Probe(stream) přijímá jak seekovatelné, tak ne-seekovatelné streamy.

API Reference Shrnutí

Viz také:

• Aspose.Imaging — Enterprise Documentation