الفئة OdgImage
محتويات
[
يخفي
]OdgImage class
التعامل مع تنسيق ملف الصورة المتجهة OpenDocument Graphic (ODG) باستخدام واجهة برمجة التطبيقات الخاصة بنا، وهو مستخدم على نطاق واسع من قبل تطبيقات OpenOffice وLibreOffice Draw لتخزين عناصر الرسم بصيغة متجهة. قم بتحليل المستندات بسلاسة، والوصول إلى الصفحات، وتغيير حجم الصور وتدويرها، مما يضمن معالجة فعّالة وتخصيص ملفات ODG لتلبية متطلباتك الخاصة.
public class OdgImage : OdImage
المنشئات
| الاسم | الوصف |
|---|---|
| OdgImage(StreamContainer) | تم تصميمه للتكامل السلس في حلول البرمجيات، يقوم المُنشئ OdgImage بتهيئة نسخة جديدة باستخدام حاوية تدفق. تضمن هذه الطريقة معالجة فعّالة لبيانات صورة ODG داخل بيئات البرمجيات، مع تحسين استهلاك الموارد وتسهيل سير عمل معالجة الصور بشكل مبسط. |
| OdgImage(StreamContainer, LoadOptions) | ابدأ بإنشاء جديد لكائن الفئة OdgImage مع تهيئة نسخة جديدة. استغل إمكانات حاوية التدفق المقترنة بمعلمات خيارات التحميل، حافظ على مُنشئ متعدد الاستخدامات لتحميل الصور بسلاسة. يمنح هذا المُنشئ قدرة معالجة صور فعّالة، مع توفير تكوينات تحميل قابلة للتخصيص لتعزيز التكيف والأداء عبر سيناريوهات متعددة. |
الخصائص
| الاسم | الوصف |
|---|---|
| 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; } | يحصل على قيمة تنسيق الملف |
| 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. |
أمثلة
هذا المثال يحمل صورة ODG متعددة الصفحات.
[C#]
string dir = "c:\\temp\\";
// استخدام Aspose.Imaging.Image.Load هو طريقة موحدة لتحميل الصورة.
using (Aspose.Imaging.FileFormats.OpenDocument.OdImage image = (Aspose.Imaging.FileFormats.OpenDocument.OdImage)Aspose.Imaging.Image.Load(dir + "sample.odg"))
{
// تحويل إلى OdgImage
Aspose.Imaging.FileFormats.OpenDocument.OdgImage odgImage = (Aspose.Imaging.FileFormats.OpenDocument.OdgImage)image;
// احصل على جميع الصفحات
Aspose.Imaging.Image[] pages = odgImage.Pages;
// قم ببعض معالجة الصورة
}
المثال التالي يوضح كيفية تصدير صورة FODG (قالب ODF XML مسطح) إلى صيغة PDF.
[C#]
string dir = "c:\\aspose.imaging\\issues\\net\\3635";
string inputFileName = System.IO.Path.Combine(dir, "VariousObjectsMultiPage.fodg");
string outputFileName = inputFileName + ".pdf";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFileName))
{
Aspose.Imaging.ImageOptions.OdgRasterizationOptions rasterizationOptions = new Aspose.Imaging.ImageOptions.OdgRasterizationOptions();
rasterizationOptions.BackgroundColor = Aspose.Imaging.Color.White;
rasterizationOptions.PageSize = image.Size;
Aspose.Imaging.ImageOptions.PdfOptions saveOptions = new Aspose.Imaging.ImageOptions.PdfOptions();
saveOptions.VectorRasterizationOptions = rasterizationOptions;
image.Save(outputFileName, saveOptions);
}
انظر أيضًا
- class OdImage
- namespace Aspose.Imaging.FileFormats.OpenDocument
- assembly Aspose.Imaging
