Class SvgImage

Class SvgImage

نام ها : Aspose.Imaging.FileFormats.Svg جمع آوری: Aspose.Imaging.dll (25.4.0)

دستکاری فایل های تصویر Scalar Vector Graphics (SVG) با استفاده از API ماقدرت فرمت متن مبتنی بر XML برای سفارشی سازی بی سیم و مقیاس پذیری.به راحتی تصاویر SVG را بارگذاری کنید، عناصر وکتور را rasterize کنید و به فرمت های دیگر تبدیل کنید.در حالی که کنترل سطح فشرده سازی برای بهینه سازی اندازه و کیفیت فایل برای پروژه های خود را.

[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

اعضای ارثی

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

مثال زیر نشان می دهد که چگونه یک تصویر svgz را به 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});
                                                                                 }

مثال زیر نشان می دهد که چگونه یک تصویر svg را به svgz fromat تبدیل کنیم.

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});
                                                                                 }

این مثال نشان می دهد که چگونه یک تصویر SVG را از یک جریان فایل بارگذاری کنید و آن را به 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);
                                                                                                  }

مثال زیر نشان می دهد که چگونه برای تبدیل یک تصویر فشرده (امز ،.wmz، *.svgz) به 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)

یک موضوع جدید از کلاس Aspose.Imaging.FileFormats.Svg.SvgImage را با استفاده ازمسیر مشخص شده برای یافتن و بارگذاری تصویر.این سازنده تسهیلایجاد نمونه های تصویر SVG از فایل های خارجی، امکان بی سیمادغام در سیستم های نرم افزاری و جریان های کاری

public SvgImage(string path)

Parameters

path string

مسیر برای بارگذاری تصویر از و شروع پیکسل و داده های پالت با.

Exceptions

ArgumentNullException

مسیر صفر است.

SvgImage(Stream)

ایجاد یک مثال جدید از کلاس Aspose.Imaging.FileFormats.Svg.SvgImage، بارگذاری تصویراین سازنده امکان شارژ مستقیم SVG را فراهم می کند.تصاویر از جریان، افزایش انعطاف پذیری و بهره وری در پردازش تصویرمنابع در برنامه های نرم افزاری

public SvgImage(Stream stream)

Parameters

stream Stream

جریان برای بارگذاری تصویر از و شروع پیکسل و داده های پالت با.

Examples

این مثال نشان می دهد که چگونه یک تصویر SVG را از یک جریان فایل بارگذاری کنید و آن را به 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

ArgumentNullException

جریان صفر است.

SvgImage(int، int)

نصب یک اشیاء Aspose.Imaging.FileFormats.Svg.SvgImage جدید با عرض مشخص شده واین سازنده به توسعه دهندگان اجازه می دهد تا تصاویر SVG را بااندازه ها، کنترل دقیق اندازه تصویر را در طولاولویت بندی

public SvgImage(int width, int height)

Parameters

width int

تصویر گسترده است.

height int

ارتفاع تصویر است.

SvgImage(دایرکتوری، int، int)

ایجاد یک مثال جدید از کلاس Aspose.Imaging.FileFormats.Svg.SvgImage با SVG مشخص شدهگزینه ها، عرض تصویر، و پارامترهای ارتفاع.این سازنده اجازه می دهدتوسعه دهندگان برای شروع تصاویر SVG با گزینه های سفارشی و ابعاد،ارائه انعطاف پذیری در مدیریت محتوای SVG و طرح.

public SvgImage(SvgOptions svgOptions, int width, int height)

Parameters

svgOptions SvgOptions

گزینه های SVG

width int

تصویر گسترده

height int

ارتفاع تصویر

Properties

BitsPerPixel

بازگرداندن بیت ها در هر پیکسل از تصویر.این مهم است که توجه داشته باشید کهاین پارامتر برای تصاویر وکتور اعمال نمی شود، زیرا آنها دراین ویژگی اطلاعات مهمی را در مورد رنگ تصویر ارائه می دهد.عمق، کمک در پردازش و دستکاری وظایف.

public override int BitsPerPixel { get; }

ارزش املاک

int

Exceptions

NotImplementedException

ناسازگاری برای تصاویر وکتور

FileFormat

بازگرداندن فرمت فایل از تصویر، ارائه داده های ضروری برایپردازش و بررسی سازگاری.این دارایی درتعیین استراتژی های دکوراسیون و رمزگذاری مناسب برای رسیدگی بهداده های تصویر به طور موثر در سراسر سیستم ها و برنامه های مختلف.

public override FileFormat FileFormat { get; }

ارزش املاک

FileFormat

IsCached

بازگرداندن یک مقدار بولی نشان می دهد که آیا داده های شی در حال حاضرمخفی، حذف نیاز به عملیات خواندن داده های اضافی.اینمالکیت ارائه می دهد درک در وضعیت فعلی کچینگ، بهینه سازی داده هابازگرداندن و پردازش جریان های کار برای بهبود عملکرد و بهره وری.

public override bool IsCached { get; }

ارزش املاک

bool

XmpData

دریافت یا تنظیم داده های XMP.

public XmpPacketWrapper XmpData { get; set; }

ارزش املاک

XmpPacketWrapper

Methods

CacheData()

داده ها را پنهان کنید و اطمینان حاصل کنید که هیچ بار اضافی از داده ها ازدر زیر Aspose.Imaging.DataStreamSupporter.DataStreamContainer. اینبهینه سازی عملکرد را با از بین بردن بازگرداندن داده های خسته کننده بهبود می بخشدبه ویژه در شرایطی که نیاز به دسترسی مکرر بهتصویر داده ها

public override void CacheData()

Crop(Rectangle)

دایره ی مشخص شده را برش دهید.

public override void Crop(Rectangle rectangle)

Parameters

rectangle Rectangle

راستگوی است.

GetDefaultOptions(موضوع[])

بازگرداندن گزینه های پیش فرض تنظیم شده برای تصویر، ارائه یک خط پایهتنظیم برای عملیات های مختلف مانند بازسازی، فشرده سازی یا رمزگذاری.این روش برای اطمینان از رفتار و استانداردهای کیفیت پایدار بسیار مهم است.وظایف پردازش تصویر بدون نیاز به پارامتر سازی صریح

public override ImageOptionsBase GetDefaultOptions(object[] args)

Parameters

args object [ ]

این استدلال ها

Returns

ImageOptionsBase

گزینه های پیش فرض

GetImage2Export(ImageOptionsBase، Rectangle، IImageExporter)

این تصویر را به صادرات می رساند.

protected override Image GetImage2Export(ImageOptionsBase optionsBase, Rectangle boundsRectangle, IImageExporter exporter)

Parameters

optionsBase ImageOptionsBase

گزینه های تصویر پایه

boundsRectangle Rectangle

محدودیت های مستقیم

exporter IImageExporter

از صادرکننده

Returns

Image

تصویر برای صادرات

ReleaseManagedResources()

منابع مدیریت شده را رها کنید اطمینان حاصل کنید که منابع غیر مدیریت شده در اینجا رها نمی شوند، زیرا ممکن است در حال حاضر رها شده باشند.

protected override void ReleaseManagedResources()

Resize(int، int، ResizeType)

تصویر را بازگردانید تا با ابعاد مشخص شده مطابقت داشته باشد در حالی که ظاهر آن حفظ می شود.این روش یک راه مناسب برای تنظیم اندازه تصویر فراهم می کند.بدون خراب کردن نسبت های آن، اطمینان از نمایش یا ذخیره سازی مطلوببا توجه به ابعاد مورد نظر

public override void Resize(int newWidth, int newHeight, ResizeType resizeType)

Parameters

newWidth int

عرض جدید است.

newHeight int

ارتفاع جدید است.

resizeType ResizeType

نوع بازسازی است.

Rotate(کشتی)

چرخش تصویر در اطراف مرکز

public override void Rotate(float angle)

Parameters

angle float

زاویه چرخش در درجه ها، ارزش های مثبت به صورت ساعت چرخش می کنند.

SaveData(Stream)

داده ها را ذخیره کنید.

protected override void SaveData(Stream stream)

Parameters

stream Stream

جریان برای ذخیره اطلاعات به.

SetPalette(بایگانی برچسب ها: bool)

یک پالت مشخص شده را به تصویر اعمال می کند و امکان سفارشی سازی رنگ را فراهم می کند.برنامه ها برای اهداف زیبایی شناسی یا عملکردی.این روش انعطاف پذیری را فراهم می کنددر مدیریت پالت های رنگی برای مطابقت با طراحی یا نیازهای کاربردی مختلف.

public override void SetPalette(IColorPalette palette, bool updateColors)

Parameters

palette IColorPalette

پالت را تنظیم کنید.

updateColors bool

اگر به رنگ های “واقعی” تنظیم شده باشد، با توجه به پالت جدید به روز خواهد شد؛ در غیر این صورت شاخص های رنگی بدون تغییر باقی می مانند. توجه داشته باشید که شاخص های بدون تغییر ممکن است تصویر در بارگذاری شکسته شود اگر برخی از شاخص ها ورودی های پالت مربوطه ندارند.

Exceptions

NotImplementedException

 فارسی