Class SvgImage
Le nom : Aspose.Imaging.FileFormats.Svg Assemblée: Aspose.Imaging.dll (25.4.0)
Manipuler les fichiers d’image Scalar Vector Graphics (SVG) avec notre API, en utilisantla puissance du format de texte basé sur XML pour la personnalisation et l’escalabilité sans fil.Facilement charger des images SVG, rasteriser les éléments vecteurs, et convertir à d’autres formats,en contrôlant les niveaux de compression pour optimiser la taille et la qualité des fichiers pour vos projets.
[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
I membri ereditari
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
L’exemple ci-dessous montre comment convertir une image svgz à un 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});
}
L’exemple ci-dessous montre comment convertir une image svg à un fromat svz
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});
}
Cet exemple montre comment charger une image SVG d’un flux de fichiers et la rasteriser à 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);
}
L’exemple ci-dessous montre comment convertir une image comprimée (et EMZ,.wmz, *.svgz) pour 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(Le string)
Installe un nouvel objet de la classe Aspose.Imaging.FileFormats.Svg.VgImage, en utilisant leroute spécifiée pour localiser et charger l’image.Cet constructeur facilite laCréation d’images SVG à partir de fichiers externes, ce qui permet des images sans signeintégration dans les systèmes logiciels et les flux de travail.
public SvgImage(string path)
Parameters
path
string
Le chemin pour charger l’image de et initialiser les pixels et les données de palette avec.
Exceptions
Le chemin est zéro.
SvgImage(Stream)
Création d’une nouvelle instance de la classe Aspose.Imaging.FileFormats.Svg.VgImage, en chargant l’imagedu courant fourni. ce constructeur permet le chargement direct de SVGImages provenant des courants, améliorant la flexibilité et l’efficacité dans le traitement de l’imageressources dans les applications logicielles.
public SvgImage(Stream stream)
Parameters
stream
Stream
Le courant pour charger l’image de et initialiser les pixels et les données de palette avec.
Examples
Cet exemple montre comment charger une image SVG d’un flux de fichiers et la rasteriser à 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
Le flux est null.
SvgImage(int, int)
Installe un nouvel objet Aspose.Imaging.FileFormats.Svg.VVG avec la largeur spécifiée etCe constructeur permet aux développeurs de créer des images SVG avec desdimensions, facilitant le contrôle précis de la taille de l’image pendantLa initialisation.
public SvgImage(int width, int height)
Parameters
width
int
La largeur de l’image.
height
int
La hauteur de l’image.
SvgImage(Mise à jour int, int)
Création d’une nouvelle instance de la classe Aspose.Imaging.FileFormats.Svg.VVgImage avec SVG spécifiéoptions, largeur d’image, et paramètres de hauteur. Ce constructeur permetles développeurs pour initialiser les images SVG avec des options et des dimensions personnalisées,Fournir une flexibilité dans la gestion du contenu et du layout SVG.
public SvgImage(SvgOptions svgOptions, int width, int height)
Parameters
svgOptions
SvgOptions
Les options SVG.
width
int
Immagini di larghezza.
height
int
Altezza dell’immagine.
Properties
BitsPerPixel
Retire les bits par nombre de pixels de l’image. il est important de noter queCe paramètre ne s’applique pas aux images vectorielles, car elles ne sont pas mesurées danspixels. cette propriété fournit des informations essentielles sur la couleur de l’imageaide dans les tâches de traitement et de manipulation.
public override int BitsPerPixel { get; }
Valore di proprietà
Exceptions
Invalidité pour les images vectorielles
FileFormat
Retire le format de fichier de l’image, fournissant des métadonnées essentielles pourTraitement et vérification de compatibilité.Cette propriété est instrumentale dansdéterminer les stratégies de décodage et de codage appropriées pour gérer lesdonnées d’image efficacement sur différents systèmes et applications.
public override FileFormat FileFormat { get; }
Valore di proprietà
IsCached
Retire une valeur boolienne indiquant si les données de l’objet sont actuellementcaché, éliminant la nécessité d’autres opérations de lecture de données.La propriété fournit un aperçu de l’état de caching actuel, optimisant les donnéesrécupérer et traiter les flux de travail pour améliorer les performances et l’efficacité.
public override bool IsCached { get; }
Valore di proprietà
XmpData
Obtenir ou établir des données XMP.
public XmpPacketWrapper XmpData { get; set; }
Valore di proprietà
Methods
CacheData()
Cache les données et garantit qu’il n’y aura pas de chargement ultérieur des donnéesle sous-jacent Aspose.Imaging.DataStreamSupporter.ToutL’optimisation améliore les performances en éliminant la récupération de données redondantedes opérations, particulièrement bénéfiques dans les scénarios nécessitant un accès fréquent auxdonnées d’image.
public override void CacheData()
Crop(Rectangle)
Crosta il rectangolo specificato.
public override void Crop(Rectangle rectangle)
Parameters
rectangle
Rectangle
Il rectangolo .
GetDefaultOptions(Objets[])
Retirer les options par défaut configurées pour l’image, fournissant une baseconfiguration pour diverses opérations telles que la récitation, la compression ou l’encodage.La méthode est essentielle pour assurer un comportement cohérent et des normes de qualitéLes tâches de traitement d’image sans nécessité de paramétérisation explicite.
public override ImageOptionsBase GetDefaultOptions(object[] args)
Parameters
args
object
[ ]
Gli argomenti .
Returns
Opzioni di default
GetImage2Export(ImageOptionsBase, Rectangle, IImageExporter)
L’immagine è da esportare.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)
Parameters
optionsBase
ImageOptionsBase
La base delle opzioni di immagine.
boundsRectangle
Rectangle
I limiti sono rectangoli.
exporter
IImageExporter
à l’exportateur.
Returns
L’immagine da esportare
ReleaseManagedResources()
Assicurati di non rilasciare risorse non gestite qui, poiché potrebbero essere già state rilasciate.
protected override void ReleaseManagedResources()
Resize(int, int, resizeType)
Récupérer l’image pour correspondre aux dimensions spécifiées tout en préservant son aspectCette méthode fournit un moyen pratique d’ajuster la taille de l’imagesans distorsion de ses proportions, garantissant une affichage ou un stockage optimalselon les dimensions souhaitées.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)
Parameters
newWidth
int
La nuova larghezza.
newHeight
int
La nuova altezza.
resizeType
ResizeType
Il tipo di ritorno.
Rotate(Flotte)
Immagini girate intorno al centro.
public override void Rotate(float angle)
Parameters
angle
float
L’angolo di rotazione in gradi. valori positivi gireranno in orologio.
SaveData(Stream)
Économisez les données.
protected override void SaveData(Stream stream)
Parameters
stream
Stream
Le flux pour sauvegarder les données.
SetPalette(Méditerranée, Bool)
Applique une palette spécifiée à l’image, permettant la personnalisation des couleursdes systèmes à des fins esthétiques ou fonctionnelles.Cette méthode fournit une flexibilitédans la gestion des palettes de couleurs pour répondre à divers besoins de conception ou d’application.
public override void SetPalette(IColorPalette palette, bool updateColors)
Parameters
palette
IColorPalette
La paletta da impostare.
updateColors
bool
se impostati a colori ‘giuri’ verrà aggiornato in base alla nuova paletta; altrimenti gli indici di colore rimangono invariati. Nota che gli indici invariati possono crollare l’immagine sul carico se alcuni indici non hanno entrate di paletta corrispondenti.