Ядро API

Основной API

Aspose.Imaging FOSS для всей публичной поверхности .NET состоит из трёх классов: ImageProbe (статический фасад), ImageInfo (значение результата), и ImageFormat (перечисление формата). Эта страница объясняет, как они сочетаются в виде контракта, помимо обзора по функциям в Функции и возможности.

Контракт из трёх классов

• ImageProbe — статический, без состояния. Каждый вызов независим; ничего не нужно настраивать или освобождать.
• ImageInfo — запечатанный, неизменяемый. Все пять свойств (Format, Width, Height, BitDepth, FrameCount).
• ImageFormat — перечисление с одним значением для каждого распознанного формата, плюс Unknown.

using Aspose.Imaging.Foss;

var info = ImageProbe.ProbeFile("photo.jpg");
ImageFormat format = info.Format;   // always set
int? width = info.Width;            // set only when the format's header carries it

Создание ImageInfo напрямую

Конструктор ImageInfo публичный — требуется только format, все остальные параметры по умолчанию равны null. Это полезно для модульных тестов, которым нужен подставной результат без обращения к реальному файлу:

using Aspose.Imaging.Foss;

// Fake a PNG result for a test double, with no dimensions
var fakeInfo = new ImageInfo(ImageFormat.Png);

// Fake a fully-populated result
var fullInfo = new ImageInfo(ImageFormat.Gif, width: 64, height: 48, bitDepth: 8, frameCount: 3);

Нет соответствующего способа mutate an ImageInfo после создания — каждое свойство только для чтения, поэтому проверенный или сконструированный экземпляр безопасно передавать и кэшировать без защитного копирования.

Выбор правильной перегрузки

ProbeFile открывает и читает файл сам — нет необходимости сначала открывать FileStream, лишь бы вызвать Probe(stream).

Пакетное сканирование каталога

Поскольку ImageProbe никогда не бросает исключение, сканирование каталога может вызывать его в плотном цикле без try/catch для каждого файла:

using Aspose.Imaging.Foss;

foreach (var path in Directory.GetFiles("incoming"))
{
    var info = ImageProbe.ProbeFile(path);

    if (info.Format == ImageFormat.Unknown)
    {
        Console.WriteLine($"{path}: not a recognized image format, skipping");
        continue;
    }

    Console.WriteLine($"{path}: {info.Format} {info.Width}x{info.Height}");
}

Любой файл, заголовок которого не соответствует одному из 11 распознаваемых форматов, преобразуется в ImageFormat.Unknown, а не вызывает исключение — приведённый выше цикл никогда не требует блока catch.

Контракт never-throws

Это не случайное поведение — это преднамеренная часть контракта API. Если заголовок распознаваемого формата обрезан или искажен в процессе разбора, ImageProbe всё равно возвращает ImageInfo с установленным Format, указывающим на распознанный формат; он не передаёт исключение парсинга вызывающему коду. Гарантируется только Format — все остальные свойства следует считать опциональными, независимо от того, какой формат был обнаружен.

Общие проблемы

FAQ

Могу ли я создать подкласс ImageInfo или ImageProbe?

Нет. ImageInfo является sealed, а ImageProbe — static — ни то, ни другое не предназначено для наследования или создания экземпляров через наследование.

Является ли ImageProbe потокобезопасным?

У ImageProbe нет изменяемого состояния между вызовами — каждый вызов Probe, ProbeFile или DetectFormat независим, что делает одновременные вызовы из нескольких потоков безопасными.

Нужно ли мне что-нибудь освобождать?

Нет. У ImageProbe нет собственных IDisposable ресурсов. Если вы передаёте Stream, который открыли сами, вы остаётесь ответственными за освобождение этого потока — Probe(stream) его не закрывает.

API Reference Сводка

См. также:

• Aspose.Imaging — Enterprise Documentation