Class SvgImage
Nama dari : Aspose.Imaging.FileFormats.Svg Pengumpulan: Aspose.Imaging.dll (25.4.0)
Memanipulasi Scalar Vector Graphics (SVG) file gambar dengan API kami, menggunakanKekuatan format teks berbasis XML untuk penyesuaian dan scalability yang tak terbatas.Mudah memuat gambar SVG, rasterize elemen vektor, dan konversi ke format lain,sementara mengontrol tingkat kompresi untuk mengoptimalkan ukuran file dan kualitas untuk proyek Anda.
[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
anggota yang diwarisi
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
Contoh berikut menunjukkan bagaimana mengubah gambar svgz menjadi 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});
}
Contoh berikut menunjukkan bagaimana mengubah gambar svg menjadi svgz dariat
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});
}
Contoh ini menunjukkan cara memuat gambar SVG dari arus file dan rasterize ke 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);
}
Contoh berikut menunjukkan bagaimana untuk menukar gambar yang dikompresi (dengan EMZ,.wmz, *.svgz) untuk raster dariat
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)
Instantiasi objek baru dari kelas Aspose.Imaging.FileFormats.Svg.SvgImage, menggunakanjalan yang ditentukan untuk menemukan dan mengisi gambar. konstruktor ini memfasilitasipenciptaan contoh gambar SVG dari file eksternal, memungkinkanIntegrasi ke dalam sistem perangkat lunak dan aliran kerja.
public SvgImage(string path)
Parameters
path
string
Jalan untuk memuat gambar dari dan memulai data piksel dan palet dengan.
Exceptions
Jalan adalah null.
SvgImage(Stream)
Mencipta contoh baru dari Aspose.Imaging.FileFormats.Svg.SvgImage kelas, memuat gambardari aliran yang disediakan. konstruktor ini memungkinkan pengisian langsung SVGGambar dari aliran, meningkatkan fleksibilitas dan efisiensi dalam pengendalian gambarsumber daya dalam aplikasi software.
public SvgImage(Stream stream)
Parameters
stream
Stream
Aliran untuk memuat gambar dari dan memulai data piksel dan palet dengan.
Examples
Contoh ini menunjukkan cara memuat gambar SVG dari arus file dan rasterize ke 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 adalah nol.
SvgImage(dengan int, int)
Menginstal objek Aspose.Imaging.FileFormats.Svg.SvgImage baru dengan lebar danKonstruktor ini memungkinkan pengembang untuk membuat gambar SVG dengandimensi, memfasilitasi kontrol yang tepat atas ukuran gambar selamadengan inisiatif.
public SvgImage(int width, int height)
Parameters
width
int
Gambar yang luas.
height
int
Ukuran gambar tinggi.
SvgImage(Perbedaan, int, int)
Mencipta contoh baru dari Aspose.Imaging.FileFormats.Svg.SvgImage kelas dengan spesifikasi SVGopsi, lebar gambar, dan parameter ketinggian. konstruktor ini memungkinkanpengembang untuk memulai gambar SVG dengan pilihan dan dimensi tersuai,memberikan fleksibilitas dalam mengelola konten dan layout SVG.
public SvgImage(SvgOptions svgOptions, int width, int height)
Parameters
svgOptions
SvgOptions
Opsi dari SVG.
width
int
Gambar yang luas.
height
int
Ukuran gambar.
Properties
BitsPerPixel
Mengembalikan bit per piksel dari gambar. penting untuk diperhatikan bahwaparameter ini tidak berlaku untuk gambar vektor, karena mereka tidak diukur dalamProperti ini memberikan informasi penting tentang warna gambarmendalam, membantu dalam tugas pemrosesan dan manipulasi.
public override int BitsPerPixel { get; }
Nilai Properti
Exceptions
Invalid untuk gambar vektor
FileFormat
Mengembalikan format file dari gambar, memberikan metadata penting untukpemrosesan dan pemeriksaan kompatibilitas. sifat ini adalah instrumen dalammenentukan strategi decoding dan encoding yang sesuai untuk menanganiData gambar secara efektif di berbagai sistem dan aplikasi.
public override FileFormat FileFormat { get; }
Nilai Properti
IsCached
Mengembalikan nilai boolean yang menunjukkan apakah data objek saat inicache, menghapus kebutuhan untuk operasi pembacaan data tambahan.Properti memberikan wawasan tentang status caching saat ini, mengoptimalkan datamengembalikan dan memproses aliran kerja untuk peningkatan kinerja dan efisiensi.
public override bool IsCached { get; }
Nilai Properti
XmpData
Dapatkan atau mengatur data XMP.
public XmpPacketWrapper XmpData { get; set; }
Nilai Properti
Methods
CacheData()
Cache data dan menjamin bahwa tidak akan ada pengisian data lebih lanjut dariadalah Aspose.Imaging.DataStreamSupporter.DataStreamContainer.Optimisasi meningkatkan kinerja dengan menghapus pengambilan data redundantOperasi, terutama bermanfaat dalam skenario yang membutuhkan akses yang sering keData gambar.
public override void CacheData()
Crop(Rectangle)
Merusak rektangle yang ditentukan.
public override void Crop(Rectangle rectangle)
Parameters
rectangle
Rectangle
dengan rektangle.
GetDefaultOptions(objek[])
Memulihkan opsi default yang dikonfigurasi untuk gambar, memberikan garis dasarpengaturan untuk berbagai operasi seperti resing, kompresi, atau koding.Metode ini sangat penting dalam memastikan perilaku dan standar kualitas yang konsisten diTugas pemrosesan gambar tanpa kebutuhan untuk parameterisasi eksplisit.
public override ImageOptionsBase GetDefaultOptions(object[] args)
Parameters
args
object
[ ]
dengan argumen tersebut.
Returns
Pilihan default
GetImage2Export(ImageOptionsBase, Rectangle, IImageExporter)
Dapatkan gambar untuk mengekspor.
protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)
Parameters
optionsBase
ImageOptionsBase
opsi dasar gambar.
boundsRectangle
Rectangle
Perbatasan dengan rektangle.
exporter
IImageExporter
dan eksportirnya.
Returns
Gambar untuk mengekspor
ReleaseManagedResources()
Pastikan tidak ada sumber daya yang tidak dikelola yang dilepaskan di sini, karena mereka mungkin sudah dilepaskan.
protected override void ReleaseManagedResources()
Resize(int, int, resizeType)
Memperbaiki gambar untuk menyesuaikan dimensi yang ditentukan sambil mempertahankan aspeknyaMetode ini memberikan cara yang nyaman untuk menyesuaikan ukuran gambartanpa mengganggu proporsinya, memastikan tampilan atau penyimpanan yang optimalsesuai dengan dimensi yang diinginkan.
public override void Resize(int newWidth, int newHeight, ResizeType resizeType)
Parameters
newWidth
int
dengan lebar yang baru.
newHeight
int
ketinggian yang baru.
resizeType
ResizeType
dengan jenis resize.
Rotate(kapal)
Gambar berputar di sekitar pusat.
public override void Rotate(float angle)
Parameters
angle
float
Sudut berputar dalam derajat. nilai positif akan berputar secara jam.
SaveData(Stream)
Simpan data tersebut.
protected override void SaveData(Stream stream)
Parameters
stream
Stream
Aliran untuk menyimpan data ke.
SetPalette(Tembakau dan Bool)
Menerapkan palet spesifik pada gambar, memungkinkan penyesuaian warnauntuk tujuan estetika atau fungsional. metode ini memberikan fleksibilitasdalam mengelola palet warna untuk memenuhi berbagai kebutuhan desain atau aplikasi.
public override void SetPalette(IColorPalette palette, bool updateColors)
Parameters
palette
IColorPalette
Palet yang harus ditentukan.
updateColors
bool
Jika ditetapkan pada warna ‘kebenaran’ akan diperbarui sesuai dengan palet baru; jika tidak indeks warna tetap tidak berubah. perhatikan bahwa indeks yang tidak berubah dapat merusak gambar pada muatan jika beberapa indeks tidak memiliki entri palet yang sesuai.