Class SvgImage
Numele spaţiului: Aspose.Imaging.FileFormats.Svg Asamblare: Aspose.Imaging.dll (25.4.0)
Manipulați fișierele de imagine Scalar Vector Graphics (SVG) cu API-ul nostru, folosindputerea formatului de text bazat pe XML pentru personalizare și scalabilitate.încărcați cu ușurință imaginile SVG, rasterizați elementele vectorului și convertiți în alte formate,în timp ce controlează nivelul de compresie pentru a optimiza dimensiunea și calitatea fișierului pentru proiectele dvs.
[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
Membrii moștenitori
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
Următorul exemplu arată cum să convertiți o imagine svgz la o pagină 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});
}Următorul exemplu arată cum să convertiți o imagine svg la un sfgz
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});
}Acest exemplu arată cum să încărcați o imagine SVG dintr-un flux de fișiere și să o rasterizați la 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);
}Următorul exemplu arată cum să convertiți o imagine comprimată (în EMZ,.wmz, *.svgz) pentru 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(Strângere)
Instalează un nou obiect din clasa Aspose.Imaging.FileFormats.Svg.VvGimage, folosindCalea specificată pentru localizarea și încărcarea imaginii. Acest constructor faciliteazăcrearea de exemple de imagini SVG din fișiere externe, permițându-le să nu seintegrarea în sistemele software și fluxurile de lucru.
public SvgImage(string path)Parameters
path string
Calea pentru a încărca imaginea de la și inițializa pixel și datele de paletă cu.
Exceptions
Calea este zero.
SvgImage(Stream)
Creează o nouă instanță a clasei Aspose.Imaging.FileFormats.Svg.VgImage, încărcând imagineade la fluxul furnizat. acest constructor permite încărcarea directă a SVGImagini din fluxuri, îmbunătățind flexibilitatea și eficiența în gestionarea imaginiiresurse în cadrul aplicațiilor software.
public SvgImage(Stream stream)Parameters
stream Stream
Stream pentru a încărca imaginea de la și inițializa pixel și date de paletă cu.
Examples
Acest exemplu arată cum să încărcați o imagine SVG dintr-un flux de fișiere și să o rasterizați la 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
Fluxul este zero.
SvgImage(int, int)
Instalarea unui nou obiect Aspose.Imaging.FileFormats.Svg.VgImage cu lățimea specificată șiAcest constructor permite dezvoltatorilor să creeze imagini SVG cu predefinitedimensiuni, facilitând controlul precis al dimensiunii imaginii în timpulşi iniţializare.
public SvgImage(int width, int height)Parameters
width int
Amploarea imaginii .
height int
înălţimea imaginii.
SvgImage(Cuvânt cheie int, int)
Creează o nouă instanță a clasei Aspose.Imaging.FileFormats.Svg.VgImage cu SVG specificatopțiuni, lățimea imaginii și parametrii de înălțime. acest constructor permitedezvoltatorii pentru a iniția imagini SVG cu opțiuni și dimensiuni personalizate,oferă flexibilitate în gestionarea conținutului și a layoutului SVG.
public SvgImage(SvgOptions svgOptions, int width, int height)Parameters
svgOptions SvgOptions
Opţiuni ale SVG.
width int
Amploarea imaginii .
height int
înălţimea imaginii.
Properties
BitsPerPixel
Retrieves bits per pixel count of the image. este important să rețineți căAcest parametru nu se aplică imaginilor vectoriale, deoarece acestea nu sunt măsurate înAceastă proprietate oferă informații esențiale despre culoarea imaginiiadâncime, ajută la procesarea și manipularea sarcinilor.
public override int BitsPerPixel { get; }Valoarea proprietății
Exceptions
Invalid pentru imagini vectoriale
FileFormat
Retrează formatul de fișier al imaginii, furnizând metadate esențiale pentruprocesarea și verificarea compatibilității.Această proprietate este instrumentală înstabilirea strategiilor adecvate de decodare și de codare pentru gestionareaImaginile sunt utilizate în mod eficient prin diferite sisteme și aplicații.
public override FileFormat FileFormat { get; }Valoarea proprietății
IsCached
Retrează o valoare booleană care indică dacă datele obiectului sunt în prezentcache, eliminând necesitatea unor operațiuni suplimentare de citire a datelor.Proprietatea oferă o înțelegere a stării curente de caching, optimizând datelerecuperarea și prelucrarea fluxurilor de lucru pentru îmbunătățirea performanței și eficienței.
public override bool IsCached { get; }Valoarea proprietății
XmpData
Obține sau colectează datele XMP.
public XmpPacketWrapper XmpData { get; set; }Valoarea proprietății
Methods
CacheData()
Cachează datele și garantează că nu va exista încărcare suplimentară a datelor de lade bază Aspose.Imaging.DataStreamSupporter.data StreamContainer.optimizarea îmbunătățește performanța prin eliminarea recuperării redundante a dateloroperaţiuni, în special benefice în scenarii care necesită acces frecvent ladate de imagine.
public override void CacheData()Crop(Rectangle)
Încărcați rectanglul specificat.
public override void Crop(Rectangle rectangle)Parameters
rectangle Rectangle
în rectanglu .
GetDefaultOptions(Obiectul[])
Returnați opțiunile predefinite configurate pentru imagine, oferind o bazăsetarea pentru diferite operațiuni, cum ar fi reîncărcarea, compresia sau codarea.Metoda este esențială pentru asigurarea unui comportament și a unor standarde de calitate coerente.sarcinile de prelucrare a imaginii fără necesitatea unei parametrize explicite.
public override ImageOptionsBase GetDefaultOptions(object[] args)Parameters
args object
[]
Argumentele sunt.
Returns
Opțiuni deficitare
GetImage2Export(ImageOptionsBase, Rectangle, IImageExporter)
Obțineți imaginea pentru export.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)Parameters
optionsBase ImageOptionsBase
Opţiunile de bază ale imaginii.
boundsRectangle Rectangle
Liniile sunt rectangulare.
exporter IImageExporter
pentru exportatorul .
Returns
Imaginea pentru export
ReleaseManagedResources()
Asigurați-vă că resursele necontrolate nu sunt eliberate aici, deoarece acestea pot fi deja eliberate.
protected override void ReleaseManagedResources()Resize(int, int, resizeType)
Recuperați imaginea pentru a se potrivi dimensiunilor specificate, menținând în același timp aspectul săuAceastă metodă oferă o modalitate convenabilă de a ajusta dimensiunea imaginiifără a distorsiona proporțiile sale, asigurând afișarea sau stocarea optimăîn funcţie de dimensiunile dorite.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)Parameters
newWidth int
În noua lățime.
newHeight int
Înălţimea nouă.
resizeType ResizeType
Tipul de rezistenţă.
Rotate(float)
Imaginea rotată în jurul centrului.
public override void Rotate(float angle)Parameters
angle float
Angajul rotativ în grade. valorile pozitive se vor rotati pe oră.
SaveData(Stream)
salvează datele.
protected override void SaveData(Stream stream)Parameters
stream Stream
Stream pentru a salva datele la.
SetPalette(Cuvânt cheie, bool)
Se aplică o paletă specifică imaginii, permițând personalizarea culorilorscheme pentru scopuri estetice sau funcționale. această metodă oferă flexibilitateîn gestionarea paletelor de culori pentru a se potrivi diferitelor cerințe de design sau de aplicare.
public override void SetPalette(IColorPalette palette, bool updateColors)Parameters
palette IColorPalette
Paleta care trebuie stabilită.
updateColors bool
în cazul în care este setat la culori “reale” va fi actualizat în funcție de noua paletă; în caz contrar, indicele de culoare rămân inalterate.
