Class SvgImage
Namn på plats: Aspose.Imaging.FileFormats.Svg Församling: Aspose.Imaging.dll (25.4.0)
Manipulera Scalar Vector Graphics (SVG) bildfiler med vår API,kraften i XML-baserat textformat för smidig anpassning och skalbarhet.Lätt ladda SVG-bilder, rasterisera vektorelement och konvertera till andra format,samtidigt som du kontrollerar komprimeringsnivåer för att optimera filstorlek och kvalitet för dina projekt.
[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
Arvsmedlemmar
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öljande exempel visar hur man konverterar en svgz bild till 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});
}
Följande exempel visar hur man konverterar en svg-bild till svgz frånat
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});
}
Detta exempel visar hur man laddar en SVG-bild från en filström och rasterar den till 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öljande exempel visar hur man konverterar en komprimerad bild (och EMZ,.wmz, *.svgz) till raster frånat
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äng)
Instantera ett nytt objekt i Aspose.Imaging.FileFormats.Svg.SvgImage klass, med hjälp avangivna vägar för att hitta och ladda bilden. Denna byggare underlättarSkapa SVG-bildinstanser från externa filer, vilket gör det möjligt attIntegration i mjukvarusystem och arbetsflöden.
public SvgImage(string path)
Parameters
path
string
Vägen att ladda bilden från och initialisera pixel- och palettdata med.
Exceptions
Vägen är noll.
SvgImage(Stream)
Skapar en ny instans av Aspose.Imaging.FileFormats.Svg.SvgImage klass, ladda bildenfrån den tillhandahållna strömmen. Denna konstruktör möjliggör direkt laddning av SVGbilder från strömmar, öka flexibiliteten och effektiviteten i bildhanteringresurser inom programvaruapplikationer.
public SvgImage(Stream stream)
Parameters
stream
Stream
Strömmen för att ladda bilden från och initialisera pixel- och palettdata med.
Examples
Detta exempel visar hur man laddar en SVG-bild från en filström och rasterar den till 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
Stream är noll.
SvgImage(int, int)
Installerar ett nytt Aspose.Imaging.FileFormats.Svg.SvgImage objekt med angiven bredd ochDenna konstruktör tillåter utvecklare att skapa SVG-bilder med fördefinieradedimensioner, vilket underlättar exakt kontroll över bildens storlek underoch initialisering.
public SvgImage(int width, int height)
Parameters
width
int
Bilden är bred.
height
int
bildens höjd.
SvgImage(SvgOptions, int, int)
Skapar en ny instans av Aspose.Imaging.FileFormats.Svg.SvgImage klass med specifik SVGalternativ, bildbredd och parametrar för höjd. Denna konstruktör kanutvecklare att initialisera SVG-bilder med anpassade alternativ och dimensioner,ge flexibilitet i hantering av SVG-innehåll och layout.
public SvgImage(SvgOptions svgOptions, int width, int height)
Parameters
svgOptions
SvgOptions
De SVG alternativen.
width
int
Bild i bredd.
height
int
Bild höjd .
Properties
BitsPerPixel
Returnerar bits per pixel räkning av bilden. det är viktigt att notera attDenna parameter är inte tillämplig på vektorbilder, eftersom de inte mäts iDenna egenskap ger viktig information om bildens färgdjup, hjälpa till i bearbetning och manipulation uppgifter.
public override int BitsPerPixel { get; }
Fastighetsvärde
Exceptions
Invalid för vektorbilder
FileFormat
återställer filformat av bilden, vilket ger väsentliga metadata förbearbetning och kompatibilitetskontroller. Denna egendom är instrumentell ifastställa lämpliga dekoderings- och kodningsstrategier för hantering avbilddata effektivt över olika system och applikationer.
public override FileFormat FileFormat { get; }
Fastighetsvärde
IsCached
Returnerar ett booleanvärde som indikerar om objektets data är aktuellacached, eliminerar behovet av ytterligare dataläsningsverksamhet.fastighet ger insikt i den aktuella cachingstatus, optimerar dataåterhämtning och bearbetning av arbetsflöden för förbättrad prestanda och effektivitet.
public override bool IsCached { get; }
Fastighetsvärde
XmpData
Få eller sätta XMP-data.
public XmpPacketWrapper XmpData { get; set; }
Fastighetsvärde
Methods
CacheData()
Hämta data och garantera att det inte kommer att finnas någon ytterligare laddning av data frånden underliggande Aspose.Imaging.DataStreamSupporter.DataStreamContainer.optimering förbättrar prestanda genom att eliminera redundant data återhämtningverksamheter, särskilt fördelaktiga i scenarier som kräver frekvent tillgång tillbild data .
public override void CacheData()
Crop(Rectangle)
Skär den angivna rektangeln.
public override void Crop(Rectangle rectangle)
Parameters
rectangle
Rectangle
och rektangeln.
GetDefaultOptions(Objektet[])
Återställa de standardalternativ som konfigurerats för bilden, vilket ger en baslinjeinställningar för olika operationer som resing, komprimering eller kodning.Metoden är avgörande för att säkerställa konsekvent beteende och kvalitetsstandarder mellanBildbearbetningsuppgifter utan behov av explicit parameterisering.
public override ImageOptionsBase GetDefaultOptions(object[] args)
Parameters
args
object
[ ]
och argumenten .
Returns
Standardalternativ
GetImage2Export(ImageOptionsBase, Rectangle, IImageExporter)
Få bilden att exportera.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)
Parameters
optionsBase
ImageOptionsBase
Basen för bildalternativ.
boundsRectangle
Rectangle
Gränserna är rektangulära.
exporter
IImageExporter
och exportören .
Returns
Bilden att exportera
ReleaseManagedResources()
Se till att inga okontrollerade resurser släpps här, eftersom de kanske redan har släppts.
protected override void ReleaseManagedResources()
Resize(int, int, resizeType)
Återskapa bilden för att matcha de angivna dimensionerna samtidigt som dess utseende bevarasDenna metod ger ett bekvämt sätt att justera storleken på bildenutan att förvränga dess proportioner, säkerställa optimal display eller lagringenligt de önskade dimensionerna.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)
Parameters
newWidth
int
Den nya bredden.
newHeight
int
Den nya höjden.
resizeType
ResizeType
Den återställande typen.
Rotate(Flotta)
Rotera bilden runt centrum.
public override void Rotate(float angle)
Parameters
angle
float
Den roterade vinkeln i grader. Positiva värden roterar klockvis.
SaveData(Stream)
Spara dina data.
protected override void SaveData(Stream stream)
Parameters
stream
Stream
Strömmen för att spara data till.
SetPalette(IcolorPalette, Bool)
Anpassa en specifik palett till bilden, vilket möjliggör anpassning av färgsystem för estetiska eller funktionella ändamål. denna metod ger flexibiliteti hantering av färgpaletter för att passa olika design- eller applikationsbehov.
public override void SetPalette(IColorPalette palette, bool updateColors)
Parameters
palette
IColorPalette
Paletten att ställa in.
updateColors
bool
om du ställer in “true” färger kommer att uppdateras enligt den nya paletten; annars färgindex förblir oförändrade. notera att oförändrade index kan krascha bilden på laddningen om vissa index inte har motsvarande palettinsatser.