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.FOSSusing 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
| Formato | Estensione | Leggi | Scrivi |
|---|---|---|---|
| Documento Photoshop | psd | ✓ | ✓ |
| Documento Photoshop di grandi dimensioni | psb | ✓ | ✓ |
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.