Class SvgImage
Nom dels espais: Aspose.Imaging.FileFormats.Svg Assemblea: Aspose.Imaging.dll (25.4.0)
Manipular els fitxers d’imatge Scalar Vector Graphics (SVG) amb la nostra API, utilitzantEl poder del format de text basat en XML per a la personalització i l’escalabilitat.fàcilment carregar imatges SVG, rasteritzar elements vectors, i convertir-se en altres formats,mentre controla els nivells de compressió per optimitzar la mida i la qualitat del fitxer per als seus projectes.
[JsonObject(MemberSerialization.OptIn)]
public sealed class SvgImage : VectorImage, IDisposable, IObjectWithBounds, IObjectWithSizeF, IHasXmpData, IHasMetadata
Inheritance
object ← DisposableObject ← DataStreamSupporter ← Image ← VectorImage ← SvgImage
Implements
IDisposable , IObjectWithBounds , IObjectWithSizeF , IHasXmpData , IHasMetadata
Membres heretats
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’exemple següent mostra com convertir una imatge svgz a un SVG
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’exemple següent mostra com convertir una imatge svg a un sacral
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});
}
Aquest exemple mostra com carregar una imatge SVG d’un flux de fitxers i rasteritzar-la a 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);
}
L’exemple següent mostra com convertir una imatge compresa (de EMZ,.wmz, *.svgz) per a 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(Tàrrega)
Instal·la un nou objecte de la classe Aspose.Imaging.FileFormats.Svg, utilitzant ella ruta especificada per localitzar i carregar la imatge. aquest constructor facilita laCreació d’instàncies de imatge SVG a partir de fitxers externs, que permeten sense segellIntegració en sistemes de programari i fluxos de treball.
public SvgImage(string path)
Parameters
path
string
El camí per carregar la imatge i inicialitzar les dades de píxels i paletes amb.
Exceptions
El camí és zero.
SvgImage(Stream)
Crea una nova instància de la classe Aspose.Imaging.FileFormats.Svg.VgImage, carregant la imatgeAquest constructor permet la càrrega directa de SVGImatges de fluxos, augmentant la flexibilitat i l’eficiència en el tractament d’imatgerecursos dins de les aplicacions de programari.
public SvgImage(Stream stream)
Parameters
stream
Stream
El flux per carregar la imatge i inicialitzar les dades de píxels i paletes amb.
Examples
Aquest exemple mostra com carregar una imatge SVG d’un flux de fitxers i rasteritzar-la a 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
El flux és zero.
SvgImage(Int, Int)
Instal·la un nou objecte Aspose.Imaging.FileFormats.Svg.VgImage amb la amplada especificada iAquest constructor permet als desenvolupadors crear imatges SVG amb predefinitsdimensions, facilitant el control precís sobre la mida de la imatge durantIniciació →
public SvgImage(int width, int height)
Parameters
width
int
Amplitud de la imatge.
height
int
Alçada de la imatge.
SvgImage(Càlcul, int i int)
Crea una nova instància de la classe Aspose.Imaging.FileFormats.Svg.VgImage amb SVG especificadaopcions, l’amplada de la imatge i els paràmetres d’altura. aquest constructor permetdesenvolupadors per iniciar imatges SVG amb opcions i dimensions personalitzades,Garantir flexibilitat en la gestió del contingut i el disseny de SVG.
public SvgImage(SvgOptions svgOptions, int width, int height)
Parameters
svgOptions
SvgOptions
Les opcions del SVG.
width
int
Ampliació de la imatge.
height
int
Alçada de la imatge.
Properties
BitsPerPixel
Retreu els bits per nombre de píxels de la imatge. és important notar queAquest paràmetre no s’aplica a les imatges de vectors, ja que no són mesurades enAquesta propietat proporciona informació crucial sobre el color de la imatgeAjudar en les tasques de processament i manipulació.
public override int BitsPerPixel { get; }
Valor de la propietat
Exceptions
Invaliditat per a imatges vectores
FileFormat
Retreu el format de fitxers de la imatge, proporcionant metadades essencials perprocessament i comprovació de la compatibilitat. aquesta propietat és instrumental enIdentificar les estratègies de decodificació i codificacions adequades per a gestionar elDades d’imatge eficaçment a través de diferents sistemes i aplicacions.
public override FileFormat FileFormat { get; }
Valor de la propietat
IsCached
Retreu un valor booleà que indica si les dades de l’objecte són actualscache, eliminant la necessitat d’operacions addicionals de lectura de dades.La propietat proporciona una visió de l’estat de càstig actual, optimitzant les dadesRecuperació i processament de fluxos de treball per a un millor rendiment i eficiència.
public override bool IsCached { get; }
Valor de la propietat
XmpData
Obté o col·loca dades XMP.
public XmpPacketWrapper XmpData { get; set; }
Valor de la propietat
Methods
CacheData()
Cache les dades i garanteix que no hi haurà més carregament de dades del’àrea subjacent Aspose.Imaging.DataStreamSupporter.data StreamContainer. aquestL’optimització millora el rendiment eliminant la recuperació de dades redundantsoperacions, especialment beneficioses en els escenaris que requereixen accés freqüent a ladades de la imatge.
public override void CacheData()
Crop(Rectangle)
Creu el rectangle especificat.
public override void Crop(Rectangle rectangle)
Parameters
rectangle
Rectangle
El rectangle
GetDefaultOptions(Objecte[])
Retirar les opcions estàndard configurades per a la imatge, proporcionant una línia de baseconfiguració per a diverses operacions com ara la resignació, la compressió o el codificació.El mètode és fonamental per assegurar un comportament coherent i els estàndards de qualitat a tot arreu.Les tasques de processament d’imatge sense la necessitat de parameterització explícita.
public override ImageOptionsBase GetDefaultOptions(object[] args)
Parameters
args
object
[]
Els arguments .
Returns
Opcions de default
GetImage2Export(ImageOptionsBase, Rectangle, IImageExporter)
Obtenir la imatge per exportar.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)
Parameters
optionsBase
ImageOptionsBase
La base de les opcions d’imatge.
boundsRectangle
Rectangle
Els límits són rectangles.
exporter
IImageExporter
El seu exportador.
Returns
La imatge per exportar
ReleaseManagedResources()
Assegureu-vos que no es lliuren recursos no gestionats aquí, ja que poden haver estat ja alliberats.
protected override void ReleaseManagedResources()
Resize(Int, int, ResizeTyp)
Recuperar la imatge per adaptar-se a les dimensions especificades mentre conserva el seu aspecteAquest mètode proporciona una manera convenient d’ajustar la mida de la imatgesense distorsionar les seves proporcions, assegurant l’exposició o el seu emmagatzematge òptimsegons les dimensions desitjades.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)
Parameters
newWidth
int
La nova amplada.
newHeight
int
La nova alçada.
resizeType
ResizeType
El tipus de residus.
Rotate(Float)
Rotació de la imatge al voltant del centre.
public override void Rotate(float angle)
Parameters
angle
float
L’angle de rotació en graus. els valors positius giraran de manera horària.
SaveData(Stream)
Estalvia les dades.
protected override void SaveData(Stream stream)
Parameters
stream
Stream
El flux per salvar les dades a.
SetPalette(Col·lecció, Bool)
Aplica una paleta especificada a la imatge, permetent la personalització del colorsistemes per a finalitats estètiques o funcionals. aquest mètode proporciona flexibilitaten la gestió de paletes de colors per adaptar-se a diferents requisits de disseny o aplicació.
public override void SetPalette(IColorPalette palette, bool updateColors)
Parameters
palette
IColorPalette
La paleta s’ha de fixar.
updateColors
bool
si s’estableix a “verd” colors es actualitzarà d’acord amb la nova paleta; en cas contrari, els índexs de color romandran inalterats.