Núcleo API

API de núcleo

Aspose.Imaging FOSS para toda a superfície pública de .NET consiste em três classes: ImageProbe (a fachada estática), ImageInfo (o valor de resultado), e ImageFormat (o enum de formato). Esta página cobre como eles se encaixam como um contrato, além do tour por recurso em Recursos e Funcionalidades.

O contrato de três classes

• ImageProbe — estático, sem estado. Cada chamada é independente; não há nada para configurar ou descartar.
• ImageInfo — selado, imutável. Todas as cinco propriedades (Format, Width, Height, BitDepth, FrameCount).
• ImageFormat — um enum com um valor por formato reconhecido, mais 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

Construindo ImageInfo diretamente

O construtor de ImageInfo é público — somente format é necessário, todos os demais parâmetros têm como padrão null. Isso é útil para testes unitários que precisam de um resultado substituto sem sondar um arquivo real:

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

Não há uma maneira correspondente de mutate an ImageInfo após a construção — cada propriedade é somente leitura, portanto, uma instância sondada ou construída é segura para ser passada e armazenada em cache sem cópia defensiva.

Escolhendo a sobrecarga correta

ProbeFile abre e lê o arquivo por si mesmo — não há necessidade de abrir um FileStream primeiro apenas para chamar Probe(stream).

Sondagem em lote de um diretório

Como ImageProbe nunca lança exceção, uma varredura de diretório pode chamá-lo em um loop apertado sem try/catch por arquivo:

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

Qualquer arquivo cujo cabeçalho não corresponda a um dos 11 formatos reconhecidos resolve para ImageFormat.Unknown em vez de lançar exceção — o loop acima nunca precisa de um bloco catch.

O contrato de nunca lançar exceção

Isso não é um comportamento incidental — é uma parte deliberada do contrato API. Se o cabeçalho de um formato reconhecido for truncado ou malformado durante a análise, ImageProbe ainda retorna um ImageInfo com Format definido para o formato que reconheceu; não propaga uma exceção de análise ao chamador. Apenas Format é garantido — trate todas as demais propriedades como opcionais, independentemente de qual formato foi detectado.

Problemas Comuns

FAQ

Posso criar uma subclasse de ImageInfo ou ImageProbe?

Não. ImageInfo é sealed e ImageProbe é static — nenhum deles foi projetado para subclassificação ou instanciação por herança.

O ImageProbe é thread-safe?

ImageProbe não mantém estado mutável entre chamadas — cada chamada a Probe, ProbeFile ou DetectFormat é independente, tornando seguras as chamadas concorrentes de múltiplas threads.

Preciso descartar algo?

Não. ImageProbe não possui recursos IDisposable próprios. Se você passar um Stream que abriu, continua responsável por descartar esse stream — Probe(stream) não o fecha.

API Reference Resumo

Ver também

• Aspose.Imaging — Enterprise Documentation