Class SvgImage

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

ArgumentNullException

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

ArgumentNullException

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

int

Exceptions

NotImplementedException

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

FileFormat

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

bool

XmpData

Obté o col·loca dades XMP.

public XmpPacketWrapper XmpData { get; set; }

Valor de la propietat

XmpPacketWrapper

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

ImageOptionsBase

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

Image

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.

Exceptions

NotImplementedException

 Català