الفئة OtgImage
محتويات
[
يخفي
]OtgImage class
معالجة ملفات صورة الرسم OpenDocument Template (OTG) باستخدام واجهة برمجة التطبيقات الخاصة بنا، مستفيدًا من تنسيق OpenDocument XML مع محتوى الرسومات لتعديل سلس. قم بتحليل المستندات بسهولة، وتخصيص ألوان الخلفية، وضبط أبعاد الصفحات، مما يضمن تحكمًا مثاليًا ومرونة لمشاريع الرسومات المتجهة OTG الخاصة بك.
public class OtgImage : OdImage
المنشئات
| الاسم | الوصف |
|---|---|
| OtgImage(StreamContainer) | أنشئ كائنًا جديدًا من الفئة OtgImage عن طريق توفير حاوية تدفق. يتيح هذا المنشئ للمطورين إنشاء صور OTG مباشرةً من حاويات التدفق، مما يبسط عملية التعامل مع بيانات صور OTG. |
| OtgImage(StreamContainer, LoadOptions) | قم بتهيئة كائن OtgImage جديد عن طريق توفير حاوية تدفق وخيارات التحميل. يتيح هذا المنشئ للمطورين تحميل صور OTG بكفاءة من التدفقات مع تحديد تكوينات تحميل مخصصة. |
الخصائص
| الاسم | الوصف |
|---|---|
| AutoAdjustPalette { get; set; } | الحصول على أو تعيين قيمة تشير إلى ما إذا كان يتم تعديل اللوحة تلقائيًا. |
| virtual BackgroundColor { get; set; } | الحصول على أو تعيين قيمة للون الخلفية. |
| override BitsPerPixel { get; } | يسترجع عدد البتات لكل بكسل في الصورة. توفر هذه الخاصية نظرة على مستوى التفاصيل وعمق اللون الممثل في الصورة، مما يساعد في مهام معالجة الصور المختلفة والتحسينات. |
| Bounds { get; } | الحصول على حدود الصورة. |
| BufferSizeHint { get; set; } | الحصول على أو تعيين تلميح حجم المخزن المؤقت الذي يحدد الحد الأقصى المسموح به لجميع المخازن الداخلية. |
| Container { get; } | الحصول على حاوية Image. |
| DataStreamContainer { get; } | الحصول على تدفق بيانات الكائن. |
| Disposed { get; } | يحصل على قيمة تشير إلى ما إذا كان هذا المثال تم التخلص منه. |
| ExifData { get; set; } | الحصول على أو تعيين بيانات Exif. |
| override FileFormat { get; } | توفر هذه الخاصية الوصول إلى تنسيق ملف OTG، مما يمنح رؤى حاسمة حول نوع البيانات المضمنة داخل ملف الصورة. تُعد نقطة مرجعية أساسية للمطورين، تمكّنهم من التعامل بفعالية مع ملفات OTG داخل تطبيقاتهم. باستخدام هذه الخاصية، يمكنك تحديد تنسيق ملف الصورة بدقة، مما يسهل التكامل السلس والتلاعب بملفات OTG في أنظمة البرمجيات الخاصة بهم. |
| virtual HasBackgroundColor { get; set; } | الحصول على أو تعيين قيمة تشير إلى ما إذا كانت الصورة لها لون خلفية. |
| override Height { get; } | الحصول على ارتفاع الصورة. |
| virtual HeightF { get; } | يحصل على ارتفاع الكائن، بالبوصة. |
| InterruptMonitor { get; set; } | الحصول على أو تعيين مراقب المقاطعة. |
| override IsCached { get; } | يحصل على قيمة منطقية تشير إلى ما إذا كانت بيانات الكائن مخزنة مؤقتًا حاليًا، مما يلغي الحاجة إلى قراءة البيانات. تُعد هذه الخاصية مؤشرًا على التحسين، حيث تعزز الأداء من خلال تقليل عمليات الوصول المتكررة للبيانات. |
| Metadata { get; } | يسترجع البيانات الوصفية الخاصة بملفات OpenDocument. تتيح هذه الخاصية الوصول إلى المعلومات الأساسية المضمنة داخل ملفات OD، مما يسهل عمليات مختلفة مثل الاستخراج أو التعديل أو تحليل البيانات الوصفية. |
| override Metadata { get; } | يحصل على بيانات تعريف الصورة. |
| override PageCount { get; } | يسترجع العدد الإجمالي للصفحات داخل الصورة. هذه الخاصية أساسية للتطبيقات التي تدير صورًا متعددة الصفحات، مما يتيح لها تحديد عدد الصفحات المتاحة للمعالجة أو العرض بدقة. |
| virtual PageExportingAction { get; set; } | يحصل أو يعيّن إجراء تصدير الصفحة. يرجى ملاحظة أن ضبط هذه الطريقة سيؤدي تلقائيًا إلى تحرير موارد الصفحة بعد تنفيذها. سيتم تنفيذها مباشرةً قبل حفظ كل صفحة. |
| override Pages { get; } | يسترجع مجموعة الصفحات المرتبطة بالصورة، مما يمكّن مطوري البرمجيات من الوصول إلى كل صفحة على حدة ومعالجتها بكفاءة. تسهّل هذه الخاصية التكرار السلس عبر الصفحات للقيام بعمليات مختلفة، مما يعزز وظائف وتنوع تطبيقات معالجة الصور. |
| Palette { get; set; } | يحصل أو يعيّن لوحة الألوان. لا تُستخدم لوحة الألوان عندما يتم تمثيل البكسلات مباشرةً. |
| Records { get; } | يسترجع سجلات OpenDocument المخزنة داخل الصورة. تمنح هذه الخاصية الوصول إلى عناصر بيانات هيكلية محددة مدمجة داخل ملفات OpenDocument، مما يسهل استرجاع أو معالجة المعلومات ذات الصلة لمزيد من المعالجة أو التحليل. |
| Size { get; } | يحصل على حجم الصورة. |
| SizeF { get; } | يحصل على حجم الكائن، بالبوصة. |
| virtual UsePalette { get; } | يحصل على قيمة تشير إلى ما إذا كانت لوحة ألوان الصورة مستخدمة. |
| override Width { get; } | يحصل على عرض الصورة. |
| virtual WidthF { get; } | يحصل على عرض الكائن، بالبوصة. |
| XmpData { get; set; } | يحصل أو يعيّن بيانات Xmp. |
الطرق
| الاسم | الوصف |
|---|---|
| override CacheData() | يقوم بتخزين البيانات مؤقتًا ويضمن عدم تحميل بيانات إضافية من DataStreamContainer الأساسي. |
| CanSave(ImageOptionsBase) | يحدد ما إذا كان يمكن حفظ الصورة بالتنسيق المحدد الممثل بخيارات الحفظ الممررة. |
| override Crop(Rectangle) | يقص المستطيل المحدد. |
| virtual Crop(int, int, int, int) | قص الصورة مع إزاحات. |
| Dispose() | يتخلص من المثيل الحالي. |
| override GetDefaultOptions(object[]) | يحصل على خيارات الصورة الافتراضية. |
| override GetEmbeddedImages() | يحصل على الصور المضمنة. |
| virtual GetOriginalOptions() | يحصل على الخيارات بناءً على إعدادات الملف الأصلي. يمكن أن يكون هذا مفيدًا للحفاظ على عمق البت وغيرها من معلمات الصورة الأصلية دون تغيير. على سبيل المثال، إذا قمنا بتحميل صورة PNG بالأبيض والأسود بعمق 1 بت لكل بكسل ثم حفظناها باستخدام طريقة Save، سيتم إنتاج صورة PNG ناتجة بعمق 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بعمق 1 بت لكل بكسل، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة ومررها إلى طريقة Save كمعامل ثاني. |
| override GetSerializedStream(ImageOptionsBase, Rectangle, out int) | يحول إلى aps. |
| override RemoveBackground() | يزيل الخلفية. |
| override RemoveBackground(RemoveBackgroundSettings) | يزيل الخلفية. |
| virtual RemoveMetadata() | يزيل البيانات الوصفية. |
| Resize(int, int) | يُعيد تحجيم الصورة. يتم استخدام NearestNeighbourResample الافتراضي. |
| override Resize(int, int, ImageResizeSettings) | تغيير حجم الصورة. |
| override Resize(int, int, ResizeType) | تغيير حجم الصورة. |
| ResizeHeightProportionally(int) | يُعيد تحجيم الارتفاع بنسبية. يتم استخدام NearestNeighbourResample الافتراضي. |
| virtual ResizeHeightProportionally(int, ImageResizeSettings) | يُعيد تحجيم الارتفاع بنسبية. |
| virtual ResizeHeightProportionally(int, ResizeType) | يُعيد تحجيم الارتفاع بنسبية. |
| ResizeWidthProportionally(int) | يقوم بتغيير عرض الصورة بشكل متناسب. يتم استخدام NearestNeighbourResample الافتراضي. |
| virtual ResizeWidthProportionally(int, ImageResizeSettings) | يقوم بتغيير عرض الصورة بشكل متناسب. |
| virtual ResizeWidthProportionally(int, ResizeType) | يقوم بتغيير عرض الصورة بشكل متناسب. |
| override Rotate(float) | دوّر الصورة حول المركز. |
| override RotateFlip(RotateFlipType) | يدور أو يقلب أو يدور ويقلب الصورة. |
| Save() | يحفظ بيانات الصورة إلى الدفق الأساسي. |
| Save(Stream) | يحفظ بيانات الكائن إلى الدفق المحدد. |
| override Save(string) | يحفظ الصورة إلى موقع الملف المحدد. |
| Save(Stream, ImageOptionsBase) | يحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق الملف المحدد وفقًا لخيارات الحفظ. |
| virtual Save(string, bool) | يحفظ بيانات الكائن إلى موقع الملف المحدد. |
| virtual Save(string, ImageOptionsBase) | يحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق الملف المحدد وفقًا لخيارات الحفظ. |
| virtual Save(Stream, ImageOptionsBase, Rectangle) | يحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق الملف المحدد وفقًا لخيارات الحفظ. |
| virtual Save(string, ImageOptionsBase, Rectangle) | يحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق الملف المحدد وفقًا لخيارات الحفظ. |
| override SetPalette(IColorPalette, bool) | يضبط لوحة ألوان الصورة. |
| virtual TrySetMetadata(IImageMetadataFormat) | يحاول تعيين كائن metadata، إذا كان هذا Image يدعم ويطبق نوع IImageMetadataFormat. |
أمثلة
المقتطف البرمجي التالي يوضح كيفية تحويل صورة OTG إلى PDF وصيغ صور أخرى.
[C#]
string dir = "c:\\aspose.imaging\\issues\\net\\3567\\";
string inputFilePath = dir + "VariousObjectsMultiPage.otg";
Aspose.Imaging.ImageOptionsBase[] options = { new Aspose.Imaging.ImageOptions.PngOptions(), new Aspose.Imaging.ImageOptions.PdfOptions() };
foreach (Aspose.Imaging.ImageOptionsBase saveOptions in options)
{
string extension = saveOptions is Aspose.Imaging.ImageOptions.PngOptions ? ".png" : ".pdf";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFilePath))
{
Aspose.Imaging.ImageOptions.OtgRasterizationOptions otgRasterizationOptions = new Aspose.Imaging.ImageOptions.OtgRasterizationOptions();
otgRasterizationOptions.PageSize = image.Size;
saveOptions.VectorRasterizationOptions = otgRasterizationOptions;
image.Save(inputFilePath + extension, saveOptions);
}
}
انظر أيضًا
- class OdImage
- namespace Aspose.Imaging.FileFormats.OpenDocument
- assembly Aspose.Imaging
