Aspose.Imaging FOSS
Getting Started
Швидкий старт

Швидкий старт

Швидкий старт

Ця сторінка демонструє найменший робочий приклад: аналіз файлу на предмет його формату та властивостей заголовка, а потім показує, як бібліотека обробляє пошкоджений файл замість викидання виключення.

Перевірка файлу

ImageProbe є єдиною статичною точкою входу. ProbeFile зчитує лише достатньо заголовка файлу, щоб заповнити результат ImageInfo — він ніколи не декодує піксельні дані:

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 та FrameCount — заповнюються лише коли виявлений формат дійсно містить ці дані.

Перевірка потоку або масиву байтів

Probe приймає Stream або byte[] безпосередньо, і DetectFormat повертає лише ImageFormat, коли вам не потрібен повний заголовок:

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

Обробка урізаного або пошкодженого вводу

ImageProbe ніколи не генерує виключення при пошкодженому або урізаному вводу. Замість підняття виключення, він повертає частковий ImageInfo з усіма полями, які вдалося прочитати — Format завжди встановлюється, коли маркер формату заголовка був розпізнаний, навіть якщо решта файлу урізана:

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

Це робить ImageProbe безпечним для запуску на ненадійних або частково завантажених файлах без необхідності обгортати кожний виклик у try/catch.

Наступні кроки

Дивіться також

 Українська