Class SvgImage
Il nome: Aspose.Imaging.FileFormats.Svg Assemblea: Aspose.Imaging.dll (25.4.0)
Manipolare i file di immagine Scalar Vector Graphics (SVG) con la nostra API, utilizzandoIl potere del formato di testo basato su XML per la personalizzazione e la scalabilità senza segni.Facilmente caricare le immagini SVG, rasterizzare gli elementi vectori e convertire in altri formati,controllare i livelli di compressione per ottimizzare la dimensione e la qualità del file per i tuoi progetti.
[JsonObject(MemberSerialization.OptIn)]
public sealed class SvgImage : VectorImage, IDisposable, IObjectWithBounds, IObjectWithSizeF, IHasXmpData, IHasMetadataInheritance
object ← DisposableObject ← DataStreamSupporter ← Image ← VectorImage ← SvgImage
Implements
IDisposable , IObjectWithBounds , IObjectWithSizeF , IHasXmpData , IHasMetadata
I membri ereditari
VectorImage.GetEmbeddedImages() , VectorImage.RemoveBackground() , VectorImage.RemoveBackground(RemoveBackgroundSettings) , VectorImage.Resize(int, int, ResizeType) , VectorImage.Resize(int, int, ImageResizeSettings) , VectorImage.RotateFlip(RotateFlipType) , VectorImage.Crop(Rectangle) , VectorImage.Rotate(float) , VectorImage.SizeF , VectorImage.WidthF , VectorImage.HeightF , VectorImage.Width , VectorImage.Height , Image.CanLoad(string) , Image.CanLoad(string, LoadOptions) , Image.CanLoad(Stream) , Image.CanLoad(Stream, LoadOptions) , Image.Create(ImageOptionsBase, int, int) , Image.Create(Image[]) , Image.Create(MultipageCreateOptions) , Image.Create(string[], bool) , Image.Create(string[]) , Image.Create(Image[], bool) , Image.GetFileFormat(string) , Image.GetFileFormat(Stream) , Image.GetFittingRectangle(Rectangle, int, int) , Image.GetFittingRectangle(Rectangle, int[], int, int) , Image.Load(string, LoadOptions) , Image.Load(string) , Image.Load(Stream, LoadOptions) , Image.Load(Stream) , Image.GetProportionalWidth(int, int, int) , Image.GetProportionalHeight(int, int, int) , Image.RemoveMetadata() , Image.CanSave(ImageOptionsBase) , Image.Resize(int, int) , Image.Resize(int, int, ResizeType) , Image.Resize(int, int, ImageResizeSettings) , Image.GetDefaultOptions(object[]) , Image.GetOriginalOptions() , Image.ResizeWidthProportionally(int) , Image.ResizeHeightProportionally(int) , Image.ResizeWidthProportionally(int, ResizeType) , Image.ResizeHeightProportionally(int, ResizeType) , Image.ResizeWidthProportionally(int, ImageResizeSettings) , Image.ResizeHeightProportionally(int, ImageResizeSettings) , Image.RotateFlip(RotateFlipType) , Image.Rotate(float) , Image.Crop(Rectangle) , Image.Crop(int, int, int, int) , Image.Save() , Image.Save(string) , Image.Save(string, ImageOptionsBase) , Image.Save(string, ImageOptionsBase, Rectangle) , Image.Save(Stream, ImageOptionsBase) , Image.Save(Stream, ImageOptionsBase, Rectangle) , Image.GetSerializedStream(ImageOptionsBase, Rectangle, out int) , Image.SetPalette(IColorPalette, bool) , Image.BitsPerPixel , Image.Bounds , Image.Container , Image.Height , Image.Palette , Image.UsePalette , Image.Size , Image.Width , Image.InterruptMonitor , Image.BufferSizeHint , Image.AutoAdjustPalette , Image.HasBackgroundColor , Image.FileFormat , Image.BackgroundColor , DataStreamSupporter.CacheData() , DataStreamSupporter.Save() , DataStreamSupporter.Save(Stream) , DataStreamSupporter.Save(string) , DataStreamSupporter.Save(string, bool) , DataStreamSupporter.DataStreamContainer , DataStreamSupporter.IsCached , DisposableObject.Dispose() , DisposableObject.Disposed , object.GetType() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Examples
L’esempio seguente mostra come convertire un’immagine svgz in Svg fromat
string file = "example.svgz";
string baseFolder = System.IO.Path.Combine("D:", "Compressed");
string inputFile = System.IO.Path.Combine(baseFolder, file);
string outFile = inputFile + ".svg";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFile))
{
Aspose.Imaging.ImageOptions.VectorRasterizationOptions vectorRasterizationOptions = new Aspose.Imaging.ImageOptions.SvgRasterizationOptions() { PageSize = image.Size};
image.Save(outFile, new Aspose.Imaging.ImageOptions.SvgOptions() {VectorRasterizationOptions = vectorRasterizationOptions});
}L’esempio seguente mostra come convertire un’immagine svg in sfgz fromat
string file = "juanmontoya_lingerie.svg";
string baseFolder = System.IO.Path.Combine("D:", "Compressed");
string inputFile = System.IO.Path.Combine(baseFolder, file);
string outFile = inputFile + ".svgz";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFile))
{
Aspose.Imaging.ImageOptions.VectorRasterizationOptions vectorRasterizationOptions = new Aspose.Imaging.ImageOptions.SvgRasterizationOptions() { PageSize = image.Size};
image.Save(outFile, new Aspose.Imaging.ImageOptions.SvgOptions() {VectorRasterizationOptions = vectorRasterizationOptions, Compress = true});
}Questo esempio mostra come caricare un’immagine SVG da un flusso di file e rasterizzarla in PNG.
string dir = "c:\\temp\\";
// Load an SVG image from a file stream.
using (System.IO.Stream stream = System.IO.File.OpenRead(dir + "test.svg"))
using (Aspose.Imaging.FileFormats.Svg.SvgImage svgImage = new Aspose.Imaging.FileFormats.Svg.SvgImage(stream))
{
// In order to rasterize SVG we need to specify rasterization options.
Aspose.Imaging.ImageOptions.SvgRasterizationOptions rasterizationOptions = new Aspose.Imaging.ImageOptions.SvgRasterizationOptions();
Aspose.Imaging.ImageOptions.PngOptions saveOptions = new Aspose.Imaging.ImageOptions.PngOptions();
saveOptions.VectorRasterizationOptions = rasterizationOptions;
svgImage.Save(dir + "test.output.png", saveOptions);
}Il seguente esempio mostra come convertire un’immagine compressa (di EMZ,.wmz, *.svgz) per raster fromat
string[] files = new[] {"example.emz", "example.wmz", "example.svgz"};
string baseFolder = System.IO.Path.Combine("D:","Compressed");
foreach (var file in files)
{
string inputFile = System.IO.Path.Combine(baseFolder, file);
string outFile = inputFile + ".png";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFile))
{
Aspose.Imaging.ImageOptions.VectorRasterizationOptions vectorRasterizationOptions = (Aspose.Imaging.ImageOptions.VectorRasterizationOptions)image.GetDefaultOptions(new object[] { Color.White, image.Width, image.Height });
image.Save(outFile, new Aspose.Imaging.ImageOptions.PngOptions(){VectorRasterizationOptions = vectorRasterizationOptions});
}
}Constructors
SvgImage(String)
Instantare un nuovo oggetto della classe Aspose.Imaging.FileFormats.Svg, utilizzando ilpercorso specificato per localizzare e caricare l’immagine.Questo costruttore facilita lala creazione di immagini SVG da file esterni, consentendo l’inserimentointegrazione nei sistemi software e nei flussi di lavoro.
public SvgImage(string path)Parameters
path string
Il percorso per caricare l’immagine da e inizializzare i dati di pixel e palette con.
Exceptions
Il percorso è zero.
SvgImage(Stream)
Crea una nuova instanza della classe Aspose.Imaging.FileFormats.Svg, caricando l’immagineQuesto costruttore consente il carico diretto di SVGImmagini provenienti dai flussi, migliorando la flessibilità e l’efficienza nella gestione dell’immaginerisorse all’interno delle applicazioni software.
public SvgImage(Stream stream)Parameters
stream Stream
Il flusso per caricare l’immagine da e inizializzare i dati di pixel e palette con.
Examples
Questo esempio mostra come caricare un’immagine SVG da un flusso di file e rasterizzarla in PNG.
string dir = "c:\\temp\\";
// Load an SVG image from a file stream.
using (System.IO.Stream stream = System.IO.File.OpenRead(dir + "test.svg"))
using (Aspose.Imaging.FileFormats.Svg.SvgImage svgImage = new Aspose.Imaging.FileFormats.Svg.SvgImage(stream))
{
// In order to rasterize SVG we need to specify rasterization options.
Aspose.Imaging.ImageOptions.SvgRasterizationOptions rasterizationOptions = new Aspose.Imaging.ImageOptions.SvgRasterizationOptions();
Aspose.Imaging.ImageOptions.PngOptions saveOptions = new Aspose.Imaging.ImageOptions.PngOptions();
saveOptions.VectorRasterizationOptions = rasterizationOptions;
svgImage.Save(dir + "test.output.png", saveOptions);
}Exceptions
Il flusso è zero.
SvgImage(di int, int)
Installa un nuovo oggetto Aspose.Imaging.FileFormats.Svg.VgImage con la larghezza specificata eQuesto costruttore consente agli sviluppatori di creare immagini SVG con predefinitodimensioni, facilitando il controllo accurato della dimensione dell’immagine durantedi inizializzazione.
public SvgImage(int width, int height)Parameters
width int
La larghezza dell’immagine.
height int
L’altezza dell’immagine
SvgImage(Sviluppo, int e int)
Crea una nuova instanza della classe Aspose.Imaging.FileFormats.Svg.VgImage con SVG specificatoopzioni, larghezza dell’immagine e parametri di altezza. Questo costruttore consentegli sviluppatori per inizializzare le immagini SVG con opzioni e dimensioni personalizzate,Fornire flessibilità nella gestione del contenuto e del layout SVG.
public SvgImage(SvgOptions svgOptions, int width, int height)Parameters
svgOptions SvgOptions
Le opzioni SVG.
width int
Immagini di larghezza.
height int
Altezza dell’immagine.
Properties
BitsPerPixel
Retrieve i bit per numero di pixel dell’immagine. è importante notare cheQuesto parametro non si applica alle immagini vectoriali, poiché non sono misurate inQuesta proprietà fornisce informazioni cruciali sul colore dell’immaginedi profondità, aiutando nei compiti di elaborazione e manipolazione.
public override int BitsPerPixel { get; }Valore di proprietà
Exceptions
Invalidità per le immagini vectoriali
FileFormat
Retrieve il formato del file dell’immagine, fornendo metadati essenziali percontrolli di elaborazione e compatibilità.Questa proprietà è strumentale indeterminare le strategie di decodifica e di codifica appropriate per gestire ildati di immagine efficacemente attraverso diversi sistemi e applicazioni.
public override FileFormat FileFormat { get; }Valore di proprietà
IsCached
Retrieve un valore booleano che indica se i dati dell’oggetto sono attualmentecache, eliminando la necessità di ulteriori operazioni di lettura dei dati.La proprietà fornisce una visione dello stato di caching attuale, ottimizzando i datirecupero e elaborazione dei flussi di lavoro per migliorare le prestazioni e l’efficienza.
public override bool IsCached { get; }Valore di proprietà
XmpData
Riceve o imposta i dati XMP.
public XmpPacketWrapper XmpData { get; set; }Valore di proprietà
Methods
CacheData()
Cache i dati e garantisci che non ci sarà ulteriore caricamento dei dati dail sottosegretario Aspose.Imaging.DataStreamSupporter.data StreamContainer.L’ottimizzazione migliora le prestazioni eliminando il recupero di dati redundantioperazioni, particolarmente vantaggiose in scenari che richiedono frequente accesso alladati di immagine.
public override void CacheData()Crop(Rectangle)
Crosta il rectangolo specificato.
public override void Crop(Rectangle rectangle)Parameters
rectangle Rectangle
Il rectangolo .
GetDefaultOptions(oggetto[])
Ripristinare le opzioni predefinite configurate per l’immagine, fornendo una linea di baseconfigurazione per varie operazioni come riassegnazione, compressione o codifica.Il metodo è fondamentale per garantire un comportamento coerente e standard di qualitàI compiti di elaborazione dell’immagine senza la necessità di parametrizzazione esplicita.
public override ImageOptionsBase GetDefaultOptions(object[] args)Parameters
args object
[ ]
Gli argomenti .
Returns
Opzioni di default
GetImage2Export(ImmagineOptionsBase, Rectangle, IImageExporter)
L’immagine è da esportare.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)Parameters
optionsBase ImageOptionsBase
La base delle opzioni di immagine.
boundsRectangle Rectangle
I limiti sono rectangoli.
exporter IImageExporter
per gli esportatori.
Returns
L’immagine da esportare
ReleaseManagedResources()
Assicurati di non rilasciare risorse non gestite qui, poiché potrebbero essere già state rilasciate.
protected override void ReleaseManagedResources()Resize(int, int, resizeType)
Ristrutturare l’immagine per adattarsi alle dimensioni specificate, mantenendo il suo aspettoQuesto metodo fornisce un modo conveniente per regolare la dimensione dell’immaginesenza distorcere le sue proporzioni, assicurando una visualizzazione o uno storage ottimalisecondo le dimensioni desiderate.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)Parameters
newWidth int
La nuova larghezza.
newHeight int
La nuova altezza.
resizeType ResizeType
Il tipo di ritorno.
Rotate(flotta)
Immagini girate intorno al centro.
public override void Rotate(float angle)Parameters
angle float
L’angolo di rotazione in gradi. valori positivi gireranno in orologio.
SaveData(Stream)
Salva i dati.
protected override void SaveData(Stream stream)Parameters
stream Stream
Il flusso per salvare i dati.
SetPalette(IcolorPalette, Bool)
Applica una paletta specifica all’immagine, consentendo la personalizzazione del coloreschemi per scopi estetici o funzionali.Questo metodo fornisce flessibilitànella gestione delle palette di colore per soddisfare i vari requisiti di progettazione o applicazione.
public override void SetPalette(IColorPalette palette, bool updateColors)Parameters
palette IColorPalette
La paletta da impostare.
updateColors bool
se impostati a colori ‘giuri’ verrà aggiornato in base alla nuova paletta; altrimenti gli indici di colore rimangono invariati. Nota che gli indici invariati possono crollare l’immagine sul carico se alcuni indici non hanno entrate di paletta corrispondenti.
