Class SvgImage
Navne til: Aspose.Imaging.FileFormats.Svg Sammensætning: Aspose.Imaging.dll (25.4.0)
Manipulere Scalar Vector Graphics (SVG) billedfiler med vores API, ved hjælp afkraften i XML-baseret tekstformatet til sømløs tilpasning og skalerbarhed.Let oplader SVG-billeder, rasteriserer vektorelementer og konverterer til andre formater,mens du kontrollerer komprimeringsniveauet for at optimere filstørrelsen og kvaliteten for dine projekter.
[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
De arvede medlemmer
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
Følgende eksempel viser, hvordan man konverterer en svgz-billede til svd fraat
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});
}Følgende eksempel viser, hvordan man konverterer en svg-billede til svz fraat
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});
}Dette eksempel viser, hvordan man lader et SVG-billede fra en filstrøm og rasterer det til 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);
}Følgende eksempel viser, hvordan man konverterer et komprimeret billede (af EMZ,.wmz, *.svgz) til raster fraat
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)
Installerer et nyt objekt i Aspose.Imaging.FileFormats.Svg.VgImage-klassen ved hjælp afangivet vej til at lokalisere og oplade billedet. Denne konstruktør gør det nemmere atoprettelse af SVG-billedeindstillinger fra eksterne filer, der muliggør seamlessintegration i software-systemer og arbejdsprocesser.
public SvgImage(string path)Parameters
path string
Vejen til at lade billedet fra og initialisere pixel og palette data med.
Exceptions
Vejen er null.
SvgImage(Stream)
Skaber en ny instans af Aspose.Imaging.FileFormats.Svg.VvGimage klasse, oplader billedetDenne konstruktør muliggør direkte opladning af SVGbilleder fra strømme, der forbedrer fleksibilitet og effektivitet i billedbehandlingRessourcer inden for softwareapplikationer.
public SvgImage(Stream stream)Parameters
stream Stream
Strømmen til at lade billedet fra og initialisere pixel og palette data med.
Examples
Dette eksempel viser, hvordan man lader et SVG-billede fra en filstrøm og rasterer det til 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
Strøm er null.
SvgImage(Det er int)
Installerer et nyt Aspose.Imaging.FileFormats.Svg.VVgImage-objekt med den angivne bredde ogDenne konstruktør giver udviklere mulighed for at oprette SVG-billeder med forhåndsdefineretdimensioner, der gør det nemmere at kontrollere størrelsen af billedet underog initialisering.
public SvgImage(int width, int height)Parameters
width int
Billedet er bredt.
height int
Billedens højde.
SvgImage(Størrelse, int og int)
Skaber en ny instans af Aspose.Imaging.FileFormats.Svg.VgImage klasse med angivet SVGvalgmuligheder, billedbredde og højdeparametrer. Denne konstruktor kanudviklere til at initialisere SVG-billeder med tilpassede muligheder og dimensioner,giver fleksibilitet i at administrere SVG-indhold og layout.
public SvgImage(SvgOptions svgOptions, int width, int height)Parameters
svgOptions SvgOptions
Der er SVG muligheder.
width int
Billedsvidde er bred.
height int
Billedens højde.
Properties
BitsPerPixel
Returnerer bits pr. pixel antal af billedet. det er vigtigt at bemærke, atDenne parameter gælder ikke for vektorbilleder, da de ikke måles iDenne ejendom giver afgørende information om billedets farveHjælp til behandling og manipulation af opgaver.
public override int BitsPerPixel { get; }Ejendomsværdi
Exceptions
Invalid til vektorbilleder
FileFormat
Returnerer filformatet af billedet, der giver essentielle metadata tilbehandlings- og kompatibilitetskontrol. Denne ejendom er instrumental ifastsættelse af passende dekoderings- og kodingsstrategier til håndtering afBilleddata effektivt over forskellige systemer og applikationer.
public override FileFormat FileFormat { get; }Ejendomsværdi
IsCached
Retrerer et booleanværdi, der angiver, om objektets data er i øjeblikketcache, eliminerer behovet for yderligere data læsningsoperationer.Ejendommen giver indsigt i den aktuelle cachingstatus, optimerer datatilbagetrækning og behandling af arbejdsprocesser for forbedret ydeevne og effektivitet.
public override bool IsCached { get; }Ejendomsværdi
XmpData
Få eller indsætte XMP-data.
public XmpPacketWrapper XmpData { get; set; }Ejendomsværdi
Methods
CacheData()
Cache dataene og garanterer, at der ikke vil være yderligere opladning af data fraden underliggende Aspose.Imaging.DataStreamSupporter.DatastreamContainer. DetteOptimering forbedrer ydeevnen ved at eliminere redundant data tilbagetrækningaktiviteter, især gunstige i scenarier, der kræver hyppig adgang tilBilledoplysninger .
public override void CacheData()Crop(Rectangle)
Skrue den angivne rektangle.
public override void Crop(Rectangle rectangle)Parameters
rectangle Rectangle
Det rektangulære.
GetDefaultOptions(Objekt[])
Returner de standardindstillinger konfigureret for billedet, der giver en baselineindstilling til forskellige operationer som resing, kompression eller kodning.Metoden er afgørende for at sikre konsekvent adfærd og kvalitetsstandarder på tværs afBilledbehandling opgaver uden behovet for eksplicit parameterisering.
public override ImageOptionsBase GetDefaultOptions(object[] args)Parameters
args object
[]
og argumenterne.
Returns
Undtagelsesmuligheder
GetImage2Export(ImageOptionsBase, Rectangle, IImageExporter)
Gør billedet til eksport.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)Parameters
optionsBase ImageOptionsBase
Billedmuligheder baseret p.
boundsRectangle Rectangle
Grænserne er rektangle.
exporter IImageExporter
Det er eksportøren.
Returns
Billedet til eksport
ReleaseManagedResources()
Sørg for, at der ikke frigives uadministrerede ressourcer her, da de måske allerede er blevet frigivet.
protected override void ReleaseManagedResources()Resize(Int, Int, ResizeType)
Gennemskifte billedet til at matche de angivne dimensioner samtidig med at dets udseende bevaresDenne metode giver en praktisk måde at justere størrelsen af billedet påuden at forvrænge dens proportioner, der sikrer optimal visning eller opbevaringefter de ønskede dimensioner.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)Parameters
newWidth int
Den nye bredde.
newHeight int
Den nye højde.
resizeType ResizeType
Den modsatte type.
Rotate(Flåder)
Gør billedet rundt i centrum.
public override void Rotate(float angle)Parameters
angle float
Den roterende hjørne i grader. Positive værdier vil rotere klokkevis.
SaveData(Stream)
Sparer de data.
protected override void SaveData(Stream stream)Parameters
stream Stream
Strømmen til at gemme data til.
SetPalette(Fællesskab, Bool)
Anvende en specifik palette til billedet, hvilket gør det muligt at tilpasse farvensystemer til æstetiske eller funktionelle formål. denne metode giver fleksibiliteti håndtering af farvepaletter til at imødekomme forskellige design- eller applikationskrav.
public override void SetPalette(IColorPalette palette, bool updateColors)Parameters
palette IColorPalette
Paletten skal indstilles.
updateColors bool
Hvis du er indstillet til ’true’ farver vil blive opdateret i henhold til den nye palet; ellers farveindekser forbliver uændrede. bemærke, at uændrede indekser kan bryde billedet på opladning, hvis nogle indekser ikke har de tilsvarende palet indtægter.
