Class SvgImage

Class SvgImage

اسم الفضاء : Aspose.Imaging.FileFormats.Svg تجميع: Aspose.Imaging.dll (25.4.0)

التلاعب بملفات الصورة Scalar Vector Graphics (SVG) باستخدام API الخاص بنا، باستخدامقوة تنسيق النص القائم على XML للتخصيص اللامحدود والتوسع.تحميل صور SVG بسهولة، وتخزين عناصر الفكتور، وتحويلها إلى تنسيقات أخرى،أثناء التحكم في مستويات الضغط لتحسين حجم الملفات ونوعية المشاريع الخاصة بك.

[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(الستار)

تثبيت كائن جديد من فئة 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(إنت، إنت)

تثبيت كائن Aspose.Imaging.FileFormats.Svg.SvgImage الجديد مع عرض محدد وهذا البناء يسمح للمطورين لإنشاء صور SVG معالأبعاد، مما يسهل التحكم الدقيق في حجم الصورة خلالالمبادرة .

public SvgImage(int width, int height)

Parameters

width int

عرض الصورة .

height int

ارتفاع الصورة .

SvgImage(الخيارات، إنت، إنت)

إنشاء مثال جديد من فئة 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(اللوحة، بول)

تطبق لوحة محددة على الصورة ، مما يسمح بتخصيص الألوانالتخطيط لأغراض جمالية أو وظيفية.هذه الطريقة توفر مرونةفي إدارة لوحات الألوان لتناسب متطلبات التصميم أو التطبيق المختلفة.

public override void SetPalette(IColorPalette palette, bool updateColors)

Parameters

palette IColorPalette

اللوحة التي يجب وضعها.

updateColors bool

إذا قمت بتعيين الألوان “الحقيقية” سيتم تحديثها وفقًا للجدول الجديد ؛ وإلا فإن مؤشرات الألوان لا تزال غير متغيرة.

Exceptions

NotImplementedException

 عربي