Class SvgImage
De naam: Aspose.Imaging.FileFormats.Svg Verzameling: Aspose.Imaging.dll (25.4.0)
Manipuleer Scalar Vector Graphics (SVG) beeldbestanden met onze API, met behulp vande kracht van XML-gebaseerde tekstformaat voor onbepaalde aanpassing en schaalbaarheid.gemakkelijk laden SVG beelden, rasterize vectorelementen, en converteren naar andere formaten,Controleer de compressie niveaus om de bestandgrootte en kwaliteit voor uw projecten te optimaliseren.
[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
Geëerbiede leden
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
Het volgende voorbeeld laat zien hoe je een svgz-afbeelding kunt converteren naar 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});
}
Het volgende voorbeeld laat zien hoe je een svg-afbeelding kunt converteren naar svGz 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});
}
Dit voorbeeld laat zien hoe je een SVG-afbeelding van een bestandstromen kunt laden en deze naar PNG kunt rasteriseren.
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);
}
Het volgende voorbeeld laat zien hoe je een compressieve afbeelding kunt converteren (van EMZ,.wmz, *.svgz) naar 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)
Instantieert een nieuw object van de Aspose.Imaging.FileFormats.Svg.VvGImage-klasse, met behulp van hetaangegeven pad om de afbeelding te lokaliseren en op te laden. deze constructor faciliteert dehet creëren van SVG-afbeeldingsinstanties van externe bestanden, waardoor het mogelijk is om onbeleefdintegratie in software-systemen en werkstromen.
public SvgImage(string path)
Parameters
path
string
De route om het beeld uit te laden en de pixel- en paletgegevens met te initialiseren.
Exceptions
De weg is nul.
SvgImage(Stream)
Creëert een nieuwe instantie van de Aspose.Imaging.FileFormats.Svg.VvGImage-klasse, loopt de afbeeldingvan de geleverde stroom. deze constructor maakt het rechtstreeks laden van SVG mogelijkbeelden uit stromen, het verbeteren van flexibiliteit en efficiëntie in beeldbehandelingResources binnen software toepassingen.
public SvgImage(Stream stream)
Parameters
stream
Stream
De stroom om het beeld uit te laden en de pixel- en paletgegevens met te initialiseren.
Examples
Dit voorbeeld laat zien hoe je een SVG-afbeelding van een bestandstromen kunt laden en deze naar PNG kunt rasteriseren.
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
Stream is nul.
SvgImage(int, int)
Installeert een nieuw Aspose.Imaging.FileFormats.Svg.VVgImage object met de aangegeven breedte enDeze constructor stelt ontwikkelaars in staat om SVG-afbeeldingen te maken met vooraf gedefinieerdedimensies, waardoor nauwkeurige controle over de grootte van de afbeelding tijdens deDe initialisering.
public SvgImage(int width, int height)
Parameters
width
int
De afbeelding breedte.
height
int
De beeldhoogte.
SvgImage(Opties, int en int)
Creëert een nieuwe instantie van de Aspose.Imaging.FileFormats.Svg.VVgImage-klasse met specifieke SVGopties, afbeeldingsbreedte en hoogteparameters. deze constructor kanontwikkelaars om SVG-beelden te initialiseren met aangepaste opties en dimensies,Flexibiliteit bieden bij het beheren van SVG-inhoud en layout.
public SvgImage(SvgOptions svgOptions, int width, int height)
Parameters
svgOptions
SvgOptions
De SVG opties.
width
int
afbeelding breedte.
height
int
afbeelding hoogte.
Properties
BitsPerPixel
Verwijder de bits per pixel getal van de afbeelding. het is belangrijk om op te merken datDeze parameter is niet van toepassing op vectorafbeeldingen, aangezien ze niet worden gemeten inpixels. deze eigenschap biedt cruciale informatie over de kleur van het beelddiepte, helpt bij het verwerken en manipuleren van taken.
public override int BitsPerPixel { get; }
Eigendomswaarde
Exceptions
Invalid voor vectorfoto’s
FileFormat
Verwijder het bestandformaat van de afbeelding, met essentiële metadata voorverwerking en compatibiliteit controles. deze eigenschap is instrumental in dehet vaststellen van passende decodering- en coderingsstrategieën voor het beheer van debeeldgegevens effectief over verschillende systemen en toepassingen.
public override FileFormat FileFormat { get; }
Eigendomswaarde
IsCached
Retrieveert een booleanwaarde die aangeeft of de gegevens van het object momenteel zijncached, het elimineren van de behoefte aan aanvullende gegevens lezen operaties.eigendom geeft inzicht in de huidige cachingstatus, optimaliseren van gegevensherstel en verwerking van werkstromen voor verbeterde prestaties en efficiëntie.
public override bool IsCached { get; }
Eigendomswaarde
XmpData
Geeft of instelt XMP-gegevens.
public XmpPacketWrapper XmpData { get; set; }
Eigendomswaarde
Methods
CacheData()
De gegevens verbergen en garanderen dat er geen verdere loading van gegevens zal plaatsvinden.de onderliggende Aspose.Imaging.DataStreamSupporter.DatastroomContainer. DitOptimalisatie verbetert de prestaties door redundante gegevensopname te eliminerenoperaties, met name gunstig in scenario’s die frequente toegang tot deafbeeldingsgegevens .
public override void CacheData()
Crop(Rectangle)
De gespecificeerde rectangle.
public override void Crop(Rectangle rectangle)
Parameters
rectangle
Rectangle
De rechthoek.
GetDefaultOptions(Objecten[])
Verwijder de standaardopties die zijn geconfigureerd voor de afbeelding, met een baselineconfiguratie voor verschillende operaties zoals resing, compressie of codering.De methode is cruciaal om consistent gedrag en kwaliteitsnormen te garanderen.beeldverwerking taken zonder de behoefte aan uitdrukkelijke parameterisatie.
public override ImageOptionsBase GetDefaultOptions(object[] args)
Parameters
args
object
[]
De argumenten .
Returns
De standaardopties
GetImage2Export(ImageOptionsBase, Rectangle, IImageExporter)
Geeft de afbeelding om te exporten.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)
Parameters
optionsBase
ImageOptionsBase
De afbeelding opties basis.
boundsRectangle
Rectangle
De grenzen rectangle.
exporter
IImageExporter
De exporteur .
Returns
Het beeld om te exporteren
ReleaseManagedResources()
Verwijder de beheerde middelen. zorg ervoor dat geen beheerde middelen hier worden vrijgegeven, omdat ze misschien al zijn vrijgegeven.
protected override void ReleaseManagedResources()
Resize(int, int, resizeType)
De afbeelding herstellen om aan de aangegeven dimensies te passen terwijl het aspect behouden wordtdeze methode biedt een handige manier om de grootte van de afbeelding aan te passenzonder de proporties te verstoorden, optimale weergave of opslag te garanderenvolgens de gewenste dimensies.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)
Parameters
newWidth
int
De nieuwe breedte.
newHeight
int
De nieuwe hoogte.
resizeType
ResizeType
De resize type.
Rotate(Vloot)
Ronde afbeelding rond het centrum.
public override void Rotate(float angle)
Parameters
angle
float
De rotatie van de hoek in graden. positieve waarden zullen rotatie horloge.
SaveData(Stream)
Bespaar de gegevens.
protected override void SaveData(Stream stream)
Parameters
stream
Stream
De stroom om gegevens op te slaan.
SetPalette(IColorPalette, Bool)
Gebruik een gespecificeerde palet aan de afbeelding, waardoor de aanpassing van kleur mogelijk isschema’s voor esthetische of functionele doeleinden. deze methode biedt flexibiliteitin het beheren van kleurpaletten om aan verschillende ontwerp- of applicatievereisten te voldoen.
public override void SetPalette(IColorPalette palette, bool updateColors)
Parameters
palette
IColorPalette
De palet om te zetten.
updateColors
bool
als de ‘waar’ kleuren worden ingesteld zal worden bijgewerkt volgens de nieuwe palet; anders blijven de kleurindices onveranderd.