Class SvgImage
Der Name: Aspose.Imaging.FileFormats.Svg Versammlung: Aspose.Imaging.dll (25.4.0)
Manipulieren Sie Scalar Vector Graphics (SVG) Bilddateien mit unserer API, indem Siedie Macht des XML-basierten Textformats für unbequeme Anpassung und Skalierbarkeit.leicht SVG Bilder laden, Vektorelementen rasterisieren und in andere Formate konvertieren,während die Kompressionsniveaus kontrollieren, um die Dateigröße und die Qualität für Ihre Projekte zu optimieren.
[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
Vererbte Mitglieder
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
Das folgende Beispiel zeigt, wie man eine svgz Bilder in svg fromat umwandelt
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});
}Das folgende Beispiel zeigt, wie man eine svg Bilder in svgz ausat konvertiert
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});
}Dieses Beispiel zeigt, wie man ein SVG-Bild aus einem Dateistrom laden und es in PNG rasterisieren kann.
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);
}Das folgende Beispiel zeigt, wie man ein komprimiertes Bild konvertiert (.von EMZ,.wmz, *.svgz) zu 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)
Installieren Sie ein neues Objekt der Aspose.Imaging.FileFormats.Svg.SvgImage Klasse, indem Sie dieangegebenen Weg, um das Bild zu lokalisieren und zu laden. Dieser Konstruktor erleichtert diedie Erstellung von SVG-Bild-Einstellungen aus externen Dateien, die es ermöglichen,Integration in Software-Systeme und Workflows.
public SvgImage(string path)Parameters
path string
Der Weg zum Laden von Bild und Initialisieren von Pixel und Palette-Daten mit.
Exceptions
Der Weg ist null.
SvgImage(Stream)
Erstellt eine neue Instanz der Aspose.Imaging.FileFormats.Svg.SvgImage Klasse, laden Sie das Bildvon der bereitgestellten Strom. Dieser Konstruktor ermöglicht die direkte Ladung von SVGBilder aus Strömen, die Flexibilität und Effizienz bei der Bildbehandlung verbessernRessourcen innerhalb von Softwareanwendungen.
public SvgImage(Stream stream)Parameters
stream Stream
Der Strom zum Laden von Bild und Initialisieren von Pixel und Palette-Daten mit.
Examples
Dieses Beispiel zeigt, wie man ein SVG-Bild aus einem Dateistrom laden und es in PNG rasterisieren kann.
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
Der Stream ist null.
SvgImage(und int, int)
Installieren Sie ein neues Aspose.Imaging.FileFormats.Svg.SvgImage Objekt mit der angegebenen Breite undDieser Konstruktor ermöglicht es den Entwicklern, SVG-Bilder mit vordefiniertenDimensionen, die eine genaue Kontrolle über die Bildgröße ermöglichendie Initialisierung.
public SvgImage(int width, int height)Parameters
width int
Die Bildweite.
height int
Die Bildhöhe.
SvgImage(Die Optionen, int, int)
Erstellt eine neue Instanz der Aspose.Imaging.FileFormats.Svg.SvgImage Klasse mit angegebenem SVGOptionen, Bildbreite und Höhenparameter. Dieser Konstruktor ermöglichtEntwickler initialisieren SVG Bilder mit benutzerdefinierten Optionen und Dimensionen,Flexibilität bei der Verwaltung von SVG-Inhalt und Layout.
public SvgImage(SvgOptions svgOptions, int width, int height)Parameters
svgOptions SvgOptions
Die SVG Optionen.
width int
Bild Breite.
height int
Bildhöhe zu sehen.
Properties
BitsPerPixel
Retrieves die Bits pro Pixel-Zahl des Bildes. Es ist wichtig zu beachten, dassDieser Parameter gilt nicht für Vektorbilder, da sie nicht inPixel. Diese Eigenschaft bietet wichtige Informationen über die Farbe des BildesTiefe, hilft bei Verarbeitung und Manipulation Aufgaben.
public override int BitsPerPixel { get; }Eigentumswert
Exceptions
Invalid für Vektorbilder
FileFormat
Wiederherstellt das Dateiformat des Bildes, bietet wesentliche Metadaten fürVerarbeitung und Kompatibilitätskontrolle. Diese Eigenschaft ist instrumental inzur Festlegung geeigneter Dekodierungs- und Codierungsstrategien zur Verwaltung derBilddaten wirksam über verschiedene Systeme und Anwendungen.
public override FileFormat FileFormat { get; }Eigentumswert
IsCached
Retriebe einen Booleanwert, der angibt, ob die Daten des Objekts derzeitcached, beseitigt die Notwendigkeit für zusätzliche Datenlesungsoperationen.Eigentum bietet Einblick in den aktuellen Caching-Status, optimiert DatenWiederherstellung und Verarbeitung von Workflows für verbesserte Leistung und Effizienz.
public override bool IsCached { get; }Eigentumswert
XmpData
Erhalte oder setze XMP-Daten.
public XmpPacketWrapper XmpData { get; set; }Eigentumswert
Methods
CacheData()
Die Daten verbergen und sicherstellen, dass keine weitere Datenlastung vondie unterliegende Aspose.Imaging.DataStreamSupporter.DataStreamContainer.Optimierung verbessert die Leistung durch die Beseitigung der redundanten DatenerholungOperationen, vor allem in Szenarien, in denen häufiger Zugang zumBilddaten zu sehen.
public override void CacheData()Crop(Rectangle)
Die angegebenen Rechtangel schneidet.
public override void Crop(Rectangle rectangle)Parameters
rectangle Rectangle
Die rechte Ecke.
GetDefaultOptions(Objekt[])
Wiederherstellen Sie die für das Bild konfigurierten Standard-Optionen, die eine Baseline bietenSetup für verschiedene Operationen wie Recycling, Kompression oder Codierung.Die Methode ist entscheidend, um ein konsistentes Verhalten und Qualitätsstandards zu gewährleisten.Bildverarbeitung Aufgaben ohne die Notwendigkeit der expliciten Parameterisierung.
public override ImageOptionsBase GetDefaultOptions(object[] args)Parameters
args object
[][]
Die Argumente.
Returns
Default Optionen
GetImage2Export(ImageOptionsBase, Rectangle, IImageExporter)
Das Bild soll exportiert werden.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)Parameters
optionsBase ImageOptionsBase
Die Bildoptionen basieren.
boundsRectangle Rectangle
Die Grenzen rechteckend.
exporter IImageExporter
Der Exporteur.
Returns
Bild zum Exportieren
ReleaseManagedResources()
Stellen Sie sicher, dass hier keine nicht verwalteten Ressourcen veröffentlicht werden, da sie möglicherweise bereits veröffentlicht wurden.
protected override void ReleaseManagedResources()Resize(int, int, ResizeType)
Wiederherstellen des Bildes, um die angegebenen Dimensionen anzupassen, während sein Aspekt beibehalten wirdDiese Methode bietet einen bequemen Weg, um die Größe des Bildes anzupassenohne ihre Proportionen zu verzerren, um eine optimale Anzeige oder Speicherung zu gewährleistennach den gewünschten Dimensionen.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)Parameters
newWidth int
Die neue Breite.
newHeight int
Die neue Höhe.
resizeType ResizeType
Die Resize Art.
Rotate(Flotte)
Drehen Sie das Bild um das Zentrum.
public override void Rotate(float angle)Parameters
angle float
Der Rotationswinkel in Grad. Positive Werte werden die Uhr drehen.
SaveData(Stream)
Sparen Sie die Daten.
protected override void SaveData(Stream stream)Parameters
stream Stream
Der Stream, um die Daten zu speichern.
SetPalette(IColorPalette und Bool)
Anwendung einer angegebenen Palette auf das Bild, die die Anpassung der Farbe ermöglichtSysteme für ästhetische oder funktionelle Zwecke. Diese Methode bietet Flexibilitätin der Verwaltung von Farbpaletten, um verschiedene Design- oder Anwendungsanforderungen zu entsprechen.
public override void SetPalette(IColorPalette palette, bool updateColors)Parameters
palette IColorPalette
Die Palette zu setzen.
updateColors bool
wenn auf “richtige” Farben festgelegt wird, wird gemäß der neuen Palette aktualisiert; sonst bleiben die Farb-Indizes unverändert. Bitte beachten Sie, dass unveränderte Indizes das Bild auf der Ladung verschwinden können, wenn einige Indizes keine entsprechenden Palette-Einnahmen haben.
