الفئة CdrImage
محتويات
[
يخفي
]CdrImage class
واجهة برمجة التطبيقات لدعم تنسيق صورة CorelDRAW CDR المتجهة هي مجموعة أدوات أساسية للمطورين الذين يعملون مع الرسومات المتجهة. تمكّن هذه API من معالجة ملفات CDR بسلاسة، مما يسمح بتخزين وتعديل عناصر متنوعة مثل النصوص، الخطوط، الأشكال، الصور، الألوان، والتأثيرات. بفضل قدراتها الشاملة، يمكن للمطورين العمل بفعالية مع تمثيلات متجهة لمحتوى الصور، مما يضمن الدقة والمرونة في إنشاء وتحرير رسومات CorelDRAW المتجهة برمجيًا.
public class CdrImage : VectorMultipageImage, ICdrImage
المنشئات
| الاسم | الوصف |
|---|---|
| CdrImage(Stream, LoadOptions) | ابدأ العمل مع الفئة CdrImage بسهولة عن طريق تهيئة مثيل جديد باستخدام معلمات التدفق وloadOptions. مثالي للمطورين الذين يبحثون عن طريقة مريحة لتحميل صور CDR من مصادر بيانات مختلفة مع تخصيص عملية التحميل حسب الحاجة. |
الخصائص
| الاسم | الوصف |
|---|---|
| AutoAdjustPalette { get; set; } | الحصول على أو تعيين قيمة تشير إلى ما إذا كان يتم تعديل اللوحة تلقائيًا. |
| virtual BackgroundColor { get; set; } | الحصول على أو تعيين قيمة للون الخلفية. |
| override BitsPerPixel { get; } | استرجع عمق البت للصورة بسهولة باستخدام هذه الخاصية السهلة الاستخدام. مثالي للمطورين الذين يرغبون في تحديد مستوى التفاصيل أو عمق اللون في صورهم، مما يضمن معالجة وتعديل دقيقة. |
| Bounds { get; } | الحصول على حدود الصورة. |
| BufferSizeHint { get; set; } | الحصول على أو تعيين تلميح حجم المخزن المؤقت الذي يحدد الحد الأقصى المسموح به لجميع المخازن الداخلية. |
| CdrDocument { get; } | استرجع أو حدّث مستند CDR بسهولة باستخدام هذه الخاصية البديهية. مثالي للمطورين الذين يرغبون في الوصول إلى مستند CDR أو تعديله، مما يضمن المرونة والكفاءة في تطبيقاتهم. |
| 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; } | حدد بسهولة ما إذا كانت بيانات الكائن مخزنة مؤقتاً حالياً، مما يلغي الحاجة لقراءة البيانات. مثالي للمطورين الذين يسعون لتحسين الأداء باستخدام البيانات المخزنة مؤقتاً بفعالية، مما يضمن وصولاً أسرع إلى معلومات الكائن. |
| override Metadata { get; } | يحصل على بيانات تعريف الصورة. |
| override PageCount { get; } | استرجع أو حدّث عدد الصفحات الإجمالي للصورة بسهولة باستخدام هذه الخاصية البديهية. مثالي للمطورين الذين يرغبون في إدارة الصور متعددة الصفحات بشكل ديناميكي، مما يضمن تنقلاً فعالاً وتعديل محتوى الصورة. |
| virtual PageExportingAction { get; set; } | يحصل أو يعيّن إجراء تصدير الصفحة. يرجى ملاحظة أن ضبط هذه الطريقة سيؤدي تلقائيًا إلى تحرير موارد الصفحة بعد تنفيذها. سيتم تنفيذها مباشرةً قبل حفظ كل صفحة. |
| override Pages { get; } | استرجع صفحات الصورة بسلاسة باستخدام هذه الخاصية البديهية. مثالي للمطورين الذين يسعون للوصول إلى صفحات فردية داخل الصور متعددة الصفحات ومعالجتها، مما يضمن تنقلًا فعالًا ومعالجةً كفء. |
| Palette { get; set; } | يحصل أو يعيّن لوحة الألوان. لا تُستخدم لوحة الألوان عندما يتم تمثيل البكسلات مباشرةً. |
| 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. |
أمثلة
يوضح المثال التالي كيفية تخزين جميع صفحات صورة CDR مؤقتًا.
[C#]
string dir = "c:\\temp\\";
// حمّل صورة من ملف CDR.
using (Aspose.Imaging.FileFormats.Cdr.CdrImage image = (Aspose.Imaging.FileFormats.Cdr.CdrImage)Aspose.Imaging.Image.Load(dir + "sample.cdr"))
{
// هذه العملية تخزن الصفحة الافتراضية فقط مؤقتًا.
image.CacheData();
// قم بتخزين جميع الصفحات مؤقتًا بحيث لا يتم تحميل بيانات إضافية من تدفق البيانات الأساسي.
foreach (Aspose.Imaging.FileFormats.Cdr.CdrImagePage page in image.Pages)
{
page.CacheData();
}
}
انظر أيضًا
- class Image
- interface ICdrImage
- class VectorMultipageImage
- namespace Aspose.Imaging.FileFormats.Cdr
- assembly Aspose.Imaging
