Introduzione

Aspose.PSD FOSS per .NET carica, ispeziona e salva documenti PSD e PSB attraverso un piccolo set di classi. Questo post esamina parti del core API che il post introduttivo non ha coperto in profondità: la relazione di ereditarietà Image/PsdImage, i tipi di valore geometrico usati in tutta la libreria e come la libreria segnala errori di caricamento e salvataggio.


Cosa è incluso

Immagine e PsdImage

Image è la classe base astratta e espone Width, Height, Bounds, Load(), Save() e Dispose(). PsdImage è l’implementazione concreta, sigillata, restituita da Image.Load() per input PSD/PSB — il cast del risultato a PsdImage espone il resto della superficie del documento: ColorMode, Version, Layers, Compression, BitsPerChannel e altro.

using var image = (PsdImage)Image.Load(inputPath);
Console.WriteLine($"Bounds: {image.Bounds}");       // from the Image base class
Console.WriteLine($"ColorMode: {image.ColorMode}");  // PsdImage-specific

Tipi di Valore Geometrico

Point, Size, Rectangle e RectangleF sono i tipi di valore usati per i limiti e le coordinate in tutto il API — Layer.Bounds e Image.Bounds sono entrambi Rectangle, e PsdImage.Size è un Size. Rectangle contiene veri metodi geometrici: Contains(), Intersect(), Union(), Inflate() e FromLeftTopRightBottom(), tra gli altri.

Rectangle layerBounds = image.Layers[0].Bounds;
Rectangle imageBounds = image.Bounds;

bool fullyInside = imageBounds.Contains(layerBounds);
Rectangle overlap = Rectangle.Intersect(imageBounds, layerBounds);
Console.WriteLine($"Layer fits inside image: {fullyInside}, overlap: {overlap}");

Blocchi di risorse e eccezioni

PsdImage.ImageResources restituisce l’array ResourceBlock[] analizzato — ogni blocco espone ID, DataSize, Name e Signature. In questa build FOSS, ImageResources, GlobalLayerResources, ActiveLayer e HasTransparencyData possono essere letti ma non riassegnati — ognuno ha un setter che lancia NotSupportedException se chiamato, quindi trattali come di sola lettura anche se appaiono come proprietà.

Gli errori di caricamento e salvataggio si presentano come due tipi di eccezione dedicati: PsdLoadException quando un documento non può essere analizzato, e PsdSaveException quando un documento non può essere riscritto.

try
{
    using var image = (PsdImage)Image.Load(inputPath);
    foreach (ResourceBlock resource in image.ImageResources)
    {
        Console.WriteLine($"Resource {resource.ID}: {resource.Name} ({resource.DataSize} bytes)");
    }
}
catch (PsdLoadException ex)
{
    Console.WriteLine($"Failed to load {inputPath}: {ex.Message}");
}

Avvio rapido

dotnet add package Aspose.PSD.FOSS
using Aspose.PSD.FileFormats.Psd;

try
{
    using var image = (PsdImage)Image.Load("input.psd");
    Console.WriteLine($"Bounds: {image.Bounds}, ColorMode: {image.ColorMode}");
    Console.WriteLine($"ImageResources: {image.ImageResources.Length}");
}
catch (PsdLoadException ex)
{
    Console.WriteLine($"Load failed: {ex.Message}");
}

Formati supportati

FormatoEstensioneLeggiScrivi
Documento Photoshoppsd✓✓
Documento Photoshop di grandi dimensionipsb✓✓

Open Source e Licenze

Aspose.PSD FOSS per .NET è rilasciato con licenza MIT e può essere usato in prodotti commerciali senza royalty, senza filigrana di valutazione o limite di utilizzo.

Il pacchetto è alla versione 1.0.0 e richiede solo .NET 10.0 a runtime — non ha altre dipendenze di terze parti.


Guida introduttiva

Risorse correlate