Crea miniature di forme di presentazione in .NET
Introduzione
Aspose.Slides per .NET viene utilizzato per creare file di presentazione in cui ogni pagina è una diapositiva. Queste diapositive possono essere visualizzate aprendo i file di presentazione con Microsoft PowerPoint. Ma a volte gli sviluppatori possono aver bisogno di visualizzare le immagini delle forme separatamente in un visualizzatore di immagini. In tali casi, Aspose.Slides per .NET ti aiuta a generare immagini di anteprima delle forme della diapositiva. Come utilizzare questa funzionalità è descritto in questo articolo.
Questo articolo spiega come generare le miniature delle diapositive in diversi modi:
- Generare una miniatura di una forma all’interno di una diapositiva.
- Generare una miniatura di una forma per una forma di diapositiva con dimensioni definite dall’utente.
- Generare una miniatura di una forma nei limiti dell’aspetto di una forma.
Generare una Miniatura di una Forma da una Diapositiva
Per generare una miniatura di una forma da qualsiasi diapositiva usando Aspose.Slides per .NET:
- Crea un’istanza della classe Presentation.
- Ottieni il riferimento di qualsiasi diapositiva utilizzando il suo ID o indice.
- Ottieni l’immagine della miniatura della forma della diapositiva di riferimento alla scala predefinita.
- Salva l’immagine della miniatura in qualsiasi formato immagine desiderato.
L’esempio seguente genera una miniatura della forma.
using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
IShape shape = presentation.Slides[0].Shapes[0];
using (IImage image = shape.GetImage())
{
image.Save("Shape_thumbnail_out.png", ImageFormat.Png);
}
}
Generare una Miniatura con Fattore di Scala Definito dall’Utente
Per generare la miniatura della forma di qualsiasi forma di diapositiva usando Aspose.Slides per .NET:
- Crea un’istanza della classe
Presentation. - Ottieni il riferimento di qualsiasi diapositiva utilizzando il suo ID o indice.
- Ottieni l’immagine della miniatura della diapositiva di riferimento con i limiti della forma.
- Salva l’immagine della miniatura in qualsiasi formato immagine desiderato.
L’esempio seguente genera una miniatura con un fattore di scala definito dall’utente.
ShapeThumbnailBounds bounds = ShapeThumbnailBounds.Shape;
float scale = 1; // Scalatura sugli assi X e Y.
using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
IShape shape = presentation.Slides[0].Shapes[0];
using (IImage image = shape.GetImage(bounds, scale, scale))
{
image.Save("Scaling Factor Thumbnail_out.png", ImageFormat.Png);
}
}
Creare una Miniatura dell’Aspetto di una Forma Basata sui Limiti
Questo metodo per creare miniature di forme consente agli sviluppatori di generare una miniatura nei limiti dell’aspetto della forma. Tiene conto di tutti gli effetti della forma. La miniatura generata è limitata dai limiti della diapositiva. Per generare una miniatura di qualsiasi forma di diapositiva nei limiti del suo aspetto, utilizzare il seguente codice di esempio:
- Crea un’istanza della classe
Presentation. - Ottieni il riferimento di qualsiasi diapositiva utilizzando il suo ID o indice.
- Ottieni l’immagine della miniatura della diapositiva di riferimento con i limiti della forma come aspetto.
- Salva l’immagine della miniatura in qualsiasi formato immagine desiderato.
L’esempio seguente crea una miniatura con un fattore di scala definito dall’utente.
ShapeThumbnailBounds bounds = ShapeThumbnailBounds.Appearance;
float scale = 1; // Scalatura sugli assi X e Y.
using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
IShape shape = presentation.Slides[0].Shapes[0];
using (IImage image = shape.GetImage(bounds, scale, scale))
{
image.Save("Shape_thumbnail_Bound_Shape_out.png", ImageFormat.Png);
}
}
Ottenere i Limiti Visivi Effettivi di una Forma
Le proprietà del frame di IShape — le sue proprietà X, Y, Width e Height — descrivono il rettangolo memorizzato nel modello della presentazione. Il contenuto realmente renderizzato può estendersi oltre quel frame o occupare un rettangolo allineato agli assi diverso. Rotazione, contorni, punte di freccia, layout del testo e overflow, geometria SmartArt generata e altri effetti di rendering possono tutti modificare l’area occupata.
Usa GetVisualBounds per calcolare quell’area occupata senza creare un’immagine. Il metodo restituisce un RectangleF nelle coordinate della diapositiva. Il rettangolo restituito non è ritagliato alla diapositiva, quindi le sue coordinate possono essere negative quando il contenuto si estende oltre l’origine della diapositiva.
GetVisualBounds non è attualmente dichiarato dall’interfaccia IShape. Pertanto, conserva la forma ottenuta dalla raccolta di forme della diapositiva come valore di interfaccia e castala solo quando chiami il metodo.
Il seguente esempio ottiene e confronta i limiti del frame e i limiti visivi:
using var presentation = new Presentation("example.pptx");
var slide = presentation.Slides[0];
IShape shape = slide.Shapes[0];
var visualBounds = ((Shape)shape).GetVisualBounds();
var frameBounds = new RectangleF(shape.X, shape.Y, shape.Width, shape.Height);
Console.WriteLine($"Frame bounds: {frameBounds}");
Console.WriteLine($"Visual bounds: {visualBounds}");
Il medesimo RectangleF può essere usato per allineare forme vicine al suo bordo Left, Right, Top o Bottom; riservare spazio sufficiente in un layout generato; o rilevare contenuti fuori da una regione consentita. I limiti visivi sono particolarmente utili per SmartArt, caselle di testo, frecce, immagini, forme ruotate e forme di gruppo, dove il frame memorizzato potrebbe non rappresentare il risultato renderizzato completo.
Usa GetVisualBounds quando hai bisogno di coordinate per layout o validazione e non ti serve una bitmap. Usa IShape.GetImage quando devi renderizzare la forma. Con ShapeThumbnailBounds, ShapeThumbnailBounds.Shape dimensiona l’immagine in base ai limiti della forma, includendo le impostazioni del contorno, mentre ShapeThumbnailBounds.Appearance la dimensiona in base all’aspetto della forma e limita il risultato ai limiti della diapositiva. Al contrario, GetVisualBounds restituisce solo il rettangolo calcolato e non lo ritaglia alla diapositiva.
FAQ
Quali formati immagine possono essere usati quando si salvano le miniature delle forme?
PNG, JPEG, BMP, GIF, TIFF, e altri. Le forme possono anche essere esportate come SVG vettoriale salvando il contenuto della forma come SVG.
Qual è la differenza tra i limiti Shape e Appearance quando si rende una miniatura?
Shape utilizza la geometria della forma; Appearance prende in considerazione effetti visivi (ombreggiature, bagliori, ecc.).
Cosa succede se una forma è contrassegnata come nascosta? Verrà comunque resa come miniatura?
Una forma nascosta rimane parte del modello e può essere resa; il flag nascosto influisce sulla visualizzazione della presentazione ma non impedisce la generazione dell’immagine della forma.
Le forme di gruppo, i grafici, SmartArt e altri oggetti complessi sono supportati?
Sì. Qualsiasi oggetto rappresentato come Shape (inclusi GroupShape, Chart, e SmartArt) può essere salvato come miniatura o come SVG.
I font installati a livello di sistema influenzano la qualità delle miniature per forme di testo?
Sì. È necessario fornire i font richiesti (o configurare le sostituzioni dei font) per evitare fallback indesiderati e il riflusso del testo.