فئة DjvuImage

Summary: DjVu document class supports graphics file format and facilitates seamless
management of scanned documents and books, integrating text, drawings, images,
and photos into a single format. Supporting multi-page operations, you can
efficiently access unique document identifiers, count pages, set active pages,
and retrieve specific document pages. With features for resizing, rotating,
dithering, cropping, grayscale transformation, gamma corrections, adjustments,
and filters application, this class empowers precise manipulation and enhancement
of DjVu images to meet diverse application needs with ease and precision.

Module: aspose.imaging.fileformats.djvu

Full Name: aspose.imaging.fileformats.djvu.DjvuImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IMultipageImage, RasterCachedMultipageImage

Constructors

Name	الوصف
DjvuImage(stream)	ابدأ العمل مع صور DjVu عن طريق إنشاء نسخة جديدة من DjvuImage الفئة باستخدام معامل Stream. مثالي لـ المطورين الذين يرغبون في دمج سلس لمعالجة صور DjVu في مشاريعهم.
DjvuImage(stream, load_options)	ابدأ العمل مع صور DjVu بسلاسة باستخدام هذا المُنشئ، الذي ينشئ نسخة جديدة من فئة DjvuImage باستخدام Stream و معاملات LoadOptions. مثالي للمطورين الذين يرغبون في تحكم دقيق في خيارات تحميل صور DjVu مع الحفاظ على البساطة والكفاءة.

Properties

Name	Type	Access	الوصف
active_page	DjvuPage	r/w	تصفح مستند DjVu الخاص بك عن طريق الوصول إلى الصفحة النشطة حاليًا أو تعيينها باستخدام هذه الخاصية. انتقل بسلاسة بين الصفحات للتركيز على المحتوى المحدد وتعزيز تجربة عرض المستند.
auto_adjust_palette	bool	r/w	يحصل أو يضبط قيمة تشير إلى ما إذا كان سيتم تعديل لوحة الألوان تلقائيًا.
background_color	Color	r/w	يحصل أو يضبط قيمة للون الخلفية.
bits_per_pixel	int	r	يحصل على عدد البتات في الصورة لكل بكسل.
bounds	Rectangle	r	يحصل على حدود الكائن.
buffer_size_hint	int	r/w	يحصل أو يعيّن تلميح حجم المخزن المؤقت الذي يُعرف كأقصى حجم مسموح به لجميع المخازن الداخلية.
container	Image	r	يحصل على حاوية Image.
data_stream_container	StreamContainer	r	يحصل على تدفق بيانات الكائن.
تم التخلص	bool	r	يحصل على قيمة تشير إلى ما إذا كانت هذه المثيلة تم التخلص منها.
djvu_pages	DjvuPage[]	r	استرجع بسرعة جميع الصفحات الموجودة في مستند DjVu الخاص بك باستخدام هذه الخاصية. بسط سير عمل معالجة المستندات الخاص بك من خلال الوصول السهل وإدارة الصفحات الفردية داخل ملفات DjVu. حسّن الكفاءة و نظم مهامك باستخدام استرجاع الصفحات المريح.
exif_data	ExifData	r/w	يحصل أو يعيّن كائن Exif.
file_format	FileFormat	r	احصل على معلومات تنسيق الملف المرتبط بملف صورة DjVu الخاص بك. حدد بسرعة تنسيق ملفك لتكامل سلس في سير عملك.
first_page	DjvuPage	r	الوصول إلى الصفحة الأولى من مستند DjVu الخاص بك باستخدام هذه الخاصية. استرجع بسرعة الصفحة الأولية لبدء عرض أو معالجة المستند بكفاءة.
has_alpha	bool	r	حدد بسرعة ما إذا كان ملف صورة DjVu الخاص بك يحتوي على قناة ألفا. بسط سير عملك من خلال التحقق من وجود معلومات الشفافية في صورك.
has_background_color	bool	r/w	يحصل أو يعيّن قيمة تشير إلى ما إذا كانت الصورة لديها لون خلفية.
has_transparent_color	bool	r/w	يحصل على قيمة تشير إلى ما إذا كانت الصورة لديها لون شفاف.
height	int	r	يحصل على ارتفاع الصورة.
horizontal_resolution	float	r/w	يحصل أو يعيّن الدقة الأفقية، بوحدات البكسل لكل بوصة، لهذه RasterImage.
معرف	int	r	يحصل على المعرف الفريد للمستند
image_opacity	float	r	يحصل على شفافية هذه الصورة.
interrupt_monitor	InterruptMonitor	r/w	يحصل أو يعيّن مراقب المقاطعة.
is_cached	bool	r	يحصل على قيمة تشير إلى ما إذا كانت بيانات الصورة مخزنة مؤقتاً حالياً.
is_raw_data_available	bool	r	يحصل على قيمة تشير إلى ما إذا كان تحميل البيانات الخام مدعومًا.
last_page	DjvuPage	r	استرجع الصفحة الأخيرة من مستند DjVu الخاص بك باستخدام هذه الخاصية. وصول سريع إلى الصفحة النهائية للعرض أو المعالجة بسهولة.
metadata	ImageMetadata	r	يحصل أو يعيّن بيانات XMP من الإطار.
next_page	DjvuPage	r	تصفح مستند DjVu الخاص بك عن طريق الوصول إلى الصفحة التالية باستخدام هذه الخاصية المريحة. تحرك بسرعة إلى الأمام في مهام عرض أو معالجة المستند.
page_count	int	r	استرجع العدد الإجمالي للصفحات في مجموعة صور DjVu الخاصة بك باستخدام هذه الخاصية. مثالي لتقييم سريع لحجم المستند أو الكتاب المخزن بصيغة DjVu. حسّن كفاءة سير عملك بمعلومات دقيقة عن عدد الصفحات.
pages	Image[]	r	الوصول إلى الصفحات الفردية في مجموعة صور DjVu الخاصة بك باستخدام هذه الخاصية. بسط التنقل والتعامل مع المستند أو الكتاب المخزن بصيغة DjVu من خلال الوصول إلى كل صفحة مباشرة. حسّن كفاءة سير عملك باستخدام استرجاع الصفحات بسهولة.
palette	IColorPalette	r/w	يحصل أو يضبط لوحة الألوان. لا تُستخدم لوحة الألوان عندما يتم تمثيل البكسلات مباشرةً.
premultiply_components	bool	r/w	يحصل أو يضبط قيمة تشير إلى ما إذا كان يجب ضرب مكونات الصورة مسبقًا.
previous_page	DjvuPage	r	تحرك بسرعة إلى الخلف في مهام عرض أو معالجة مستند DjVu الخاص بك عن طريق الوصول إلى الصفحة السابقة باستخدام هذه الخاصية المريحة. تنقل بكفاءة عبر المستند بسهولة.
raw_custom_color_converter	IColorConverter	r/w	يحصل أو يضبط محول الألوان المخصص
raw_data_format	PixelDataFormat	r	يحصل على تنسيق البيانات الخام.
raw_data_settings	RawDataSettings	r	يحصل على إعدادات البيانات الخام الحالية. لاحظ أنه عند استخدام هذه الإعدادات يتم تحميل البيانات دون تحويل.
raw_fallback_index	int	r/w	يحصل أو يضبط فهرس الاحتياطي لاستخدامه عندما يكون فهرس اللوحة خارج النطاق
raw_indexed_color_converter	IIndexedColorConverter	r/w	يحصل أو يضبط محول الألوان المفهرسة
raw_line_size	int	r	يحصل على حجم السطر الخام بالبايت.
size	Size	r	يحصل على حجم الكائن.
transparent_color	Color	r/w	يحصل على لون شفافية الصورة.
update_xmp_data	bool	r/w	يحصل أو يضبط قيمة تشير إلى ما إذا كان يجب تحديث بيانات XMP الوصفية.
use_palette	bool	r	يحصل على قيمة تشير إلى ما إذا كانت لوحة ألوان الصورة مستخدمة.
use_raw_data	bool	r/w	يحصل أو يضبط قيمة تشير إلى ما إذا كان يجب استخدام تحميل البيانات الخام عندما يكون تحميل البيانات الخام متاحًا.
vertical_resolution	float	r/w	يحصل أو يضبط الدقة العمودية، بوحدة البكسل لكل بوصة، لهذا RasterImage.
width	int	r	يحصل على عرض الصورة.
xmp_data	XmpPacketWrapper	r/w	يحصل أو يضبط بيانات Xmp.

Methods

Name	الوصف
adjust_brightness(brightness)	ضبط السطوع للصورة باستخدام معامل محدد، توفير التحكم في مستويات الإضاءة للحصول على وضوح بصري مثالي. هذه الطريقة تعزز أو تقلل السطوع العام للصورة، مما يسمح بتعديلات دقيقة لتحقيق تأثيرات إضاءة مرغوبة. من خلال تعديل السطوع، يمكن للمستخدمين تحسين رؤية الصورة وتعزيز إعادة إنتاج التفاصيل لتجربة مشاهدة محسنة.
adjust_contrast(contrast)	حسّن تباين Image لتحسين الوضوح البصري و إبراز التفاصيل باستخدام هذه الطريقة، التي تضبط الفرق في السطوع بين المناطق الفاتحة والداكنة. من خلال ضبط مستويات التباين بدقة، يمكن للمستخدمين الحصول على صور أكثر حيوية وتأثيرًا، مما يعزز جودة الصورة العامة ويزيد من وضوح التفاصيل. يساعد هذا التعديل على إظهار الفروق الدقيقة في اللون والملمس، مما ينتج عنه صور أكثر ديناميكية وجاذبية بصريًا.
adjust_gamma(gamma)	تصحيح جاما، خاصة لقنوات الأحمر والأخضر والأزرق، يتضمن تعديل سطوع كل مكوّن لوني على حدة. من خلال تطبيق معاملات جاما مختلفة على قنوات RGB، يمكنك ضبط السطوع العام والتباين للصورة بدقة. تضمن هذه التقنية تمثيلًا لونيًا دقيقًا وتحسن الجودة البصرية للصورة عبر مختلف أجهزة العرض.
adjust_gamma(gamma_red, gamma_green, gamma_blue)	يُطبق تصحيح جاما على الصورة باستخدام معاملات قابلة للتخصيص لقنوات الأحمر والأخضر، والأزرق، مما يسمح بضبط دقيق لتوازن الألوان والسطوع. هذه الطريقة تعزز جودة الصورة من خلال ضبط تمثيل الألوان بدقة، لضمان عرض مثالي عبر مختلف أجهزة العرض. تعديل قيم جاما للقنوات الفردية يحسن توازن الألوان والجاذبية البصرية.
analyze_percentage_digital_signature(password)	يحسب نسبة التشابه بين البيانات المستخرجة وكلمة المرور الأصلية.
auto_brightness_contrast()	ينفّذ تطبيعًا تلقائيًا متكيفًا للسطوع والتباين لكامل الصورة.
auto_rotate()	يدور الصورة تلقائيًا بناءً على بيانات الاتجاه المستخرجة من Exif metadata. تضمن هذه الطريقة عرض الصور بالاتجاه الصحيح، مما يعزز تجربة المستخدم ويزيل الحاجة إلى التعديلات اليدوية. من خلال تحليل معلومات Exif، يتم تدوير الصورة وفقًا لذلك، موفرًا تجربة مشاهدة سلسة عبر منصات وأجهزة مختلفة. تُبسّط عملية الدوران الآلية التعامل مع الصور وتُحسّن القابلية العامة للاستخدام، خاصةً عند التعامل مع دفعات كبيرة من الصور ذات الاتجاهات المتنوعة.
binarize_bradley(brightness_difference)	تحويل الصورة إلى ثنائية باستخدام خوارزمية العتبة التكيفية لبرايدلي باستخدام عتبة الصورة المتكاملة
binarize_bradley(brightness_difference, window_size)	التصنيف الثنائي باستخدام خوارزمية العتبة التكيفية لبرايدلي مع الصورة المتكاملة العتبة هي طريقة تحسب عتبة محلية لكل بكسل بناءً على الجوار المحلي. تتكيف مع تغيرات الإضاءة عبر الصورة، مما يجعلها مناسبة للصور ذات ظروف الإضاءة غير المتساوية. من خلال حساب العتبة باستخدام الصور المتكاملة، تتعامل بكفاءة مع أحياء كبيرة، مما يجعلها قابلة للتطبيق على التطبيقات في الوقت الحقيقي. تُستخدم هذه التقنية عادةً في معالجة المستندات، OCR (التعرف الضوئي على الأحرف)، ومهام تقسيم الصور حيث يكون التصنيف الثنائي الدقيق ضروريًا للتحليل اللاحق.
binarize_fixed(threshold)	التصنيف الثنائي باستخدام عتبة محددة مسبقًا يبسط الصور المعقدة إلى تمثيلات ثنائية حيث يتم تصنيف البكسلات إما كالسوداء أو البيضاء بناءً على شدة إضاءتها مقارنةً بقيمة العتبة المحددة. تُستخدم هذه التقنية عادةً في معالجة الصور لتعزيز الوضوح، تبسيط التحليل، وتحضير الصور للخطوات اللاحقة مثل التعرف الضوئي على الأحرف (OCR). من خلال تطبيق عتبة ثابتة، يمكنك بسرعة تحويل الصور ذات التدرج الرمادي إلى شكل ثنائي، مما يجعلها أسهل في الفهم واستخراج المعلومات ذات المعنى منها.
binarize_otsu()	التصنيف الثنائي باستخدام عتبة أوتسو هو تقنية تحسب تلقائيًا قيمة عتبة مثالية بناءً على هيستوغرام الصورة. تفصل الصورة إلى المقدمة والخلفية عن طريق تقليل التباين داخل الفئة. طريقة أوتسو تُستخدم على نطاق واسع لتقسيم الصور إلى شكل ثنائي، خاصةً عندما يكون توزيع شدة البكسلات ثنائي القمة أو متعدد القمم. هذا النهج مفيد للمهام مثل اكتشاف الكائنات، تقسيم الصور، واستخراج الميزات، حيث يكون التحديد الدقيق بين المقدمة والخلفية أمرًا حيويًا.
blend(origin, overlay, overlay_alpha)	يمزج هذه النسخة من الصورة مع الصورة overlay.
blend(origin, overlay, overlay_area, overlay_alpha)	يمزج هذه النسخة من الصورة مع الصورة overlay.
cache_data()	قم بتخزين البيانات مؤقتًا بشكل خاص لتحسين الأداء وتقليل الحاجة إلى استرجاع البيانات المتكرر من المصادر الخارجية. يساعد هذا النهج أيضًا في حفظ الموارد، خاصةً في السيناريوهات التي يكون فيها الوصول إلى البيانات متكررًا أو الموارد محدودة.
can_load(file_path)	يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد.
can_load(file_path, load_options)	يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد واستخدام خيارات الفتح المحددة اختياريًا.
can_load(stream)	يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد.
can_load(stream, load_options)	يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد واستخدام loadOptions المحددة اختياريًا.
can_load_stream(stream)	يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد.
can_load_stream_with_options(stream, load_options)	يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد واستخدام loadOptions المحددة اختياريًا.
can_load_with_options(file_path, load_options)	يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد واستخدام خيارات الفتح المحددة اختياريًا.
can_save(options)	يحدد ما إذا كان يمكن حفظ الصورة إلى تنسيق الملف المحدد الممثل بخيارات الحفظ الممررة.
create(files)	ينشئ صورة متعددة الصفحات تحتوي على الملفات المحددة.
create(files, throw_exception_on_load_error)	ينشئ صورة متعددة الصفحات تحتوي على الملفات المحددة.
create(image_options, width, height)	ينشئ صورة جديدة باستخدام خيارات الإنشاء المحددة.
create(image_options, width, height, pixels)	ينشئ مثيلًا من RasterImage من مصفوفة البكسل المقدمة. يتحقق من أن العرض والارتفاع المحددين يتطابقان مع أبعاد بيانات البكسل. لا يمكن استخدام هذه الطريقة إلا عندما تكون المكتبة في وضع الترخيص.
create(images)	ينشئ صورة جديدة باستخدام الصور المحددة كصفحات
create(images, dispose_images)	ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.
create(multipage_create_options)	ينشئ خيارات الإنشاء المتعددة الصفحات المحددة.
create_from_files(files)	ينشئ الصورة المتعددة الصفحات التي تحتوي على الملفات المحددة كصفحات تحميل كسول.
create_from_files(files, throw_exception_on_load_error)	ينشئ الصورة المتعددة الصفحات التي تحتوي على الملفات المحددة كصفحات تحميل كسول.
create_from_images(images)	ينشئ صورة جديدة باستخدام الصور المحددة كصفحات
create_from_images(images, dispose_images)	ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.
crop(left_shift, right_shift, top_shift, bottom_shift)	يتيح لك الاقتصاص مع الإزاحات ضبط موضع وأبعاد المنطقة المقتصة داخل الصورة بدقة. هذه الميزة لا تقدر بثمن لتحسين التكوينات، محاذاة العناصر، وتأكيد النقاط البؤرية في مرئياتك. من خلال دمج الإزاحات في عملية الاقتصاص، يمكنك تحقيق دقة بكسلية مثالية وتعديل إطار صورك بسهولة.
crop(rectangle)	يُقصّ “Crop” صورتك للتركيز على تفاصيل محددة أو إزالة العناصر غير المرغوب فيها، مما يعزز تكوينها وتأثيرها البصري. سواءً كنت تعدل الصور لوسائل التواصل الاجتماعي، تنشئ لافتات مواقع الويب، أو تصمم مواد مطبوعة، فإن هذه الأداة تساعدك على تحسين صورك بدقة ووضوح.
dither(dithering_method, bits_count)	يُجري تمويهًا على الصورة الحالية.
dither(dithering_method, bits_count, custom_palette)	تطبق وظيفة “Dither” تأثير التدرج على صورتك، مما يحسن جودتها البصرية عن طريق تقليل الخطوط المتدرجة وتحسين انتقالات الألوان. سواءً كنت تعمل على فن رقمي، تصوير فوتوغرافي، أو مشاريع تصميم جرافيكي، فإن هذه الميزة تضيف لمسة احترافية لصورك، تجعلها تبدو أكثر سلاسة وتفصيلاً.
embed_digital_signature(password)	أدمج توقيعًا رقميًا يعتمد على كلمة المرور المقدمة في كل صفحة من الصورة.
filter(rectangle, options)	طبق فلاتر على منطقة مستطيلة محددة داخل الصورة لتحسين أو تعديل مظهرها من خلال استهداف مناطق معينة، تسمح هذه الطريقة بإجراء تعديلات دقيقة، مثل التمويه، التعزيز، أو تطبيق تأثيرات فنية، لتحقيق النتائج البصرية المطلوبة. يتيح ضبط الفلاتر بدقة على المناطق المختارة للمستخدمين تخصيص جمالية الصورة، تحسين الوضوح، وإنشاء تأثيرات فنية مخصصة وفقًا لتفضيلاتهم.
get_argb_32_pixel(x, y)	يحصل على بكسل صورة 32-بت ARGB.
get_default_argb_32_pixels(rectangle)	يحصل على مصفوفة بكسلات ARGB 32-بت الافتراضية.
get_default_options(args)	يحصل على الخيارات الافتراضية.
get_default_pixels(rectangle, partial_pixel_loader)	يحصل على مصفوفة البكسلات الافتراضية باستخدام محمل البكسل الجزئي.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)	يحصل على مصفوفة البيانات الخام الافتراضية باستخدام محمل البكسل الجزئي.
get_default_raw_data(rectangle, raw_data_settings)	يحصل على مصفوفة البيانات الخام الافتراضية.
get_file_format(file_path)	يحصل على تنسيق الملف.
get_file_format(stream)	يحصل على تنسيق الملف.
get_file_format_of_stream(stream)	يحصل على تنسيق الملف.
get_fitting_rectangle(rectangle, pixels, width, height)	يحصل على المستطيل الذي يناسب الصورة الحالية.
get_fitting_rectangle(rectangle, width, height)	يحصل على المستطيل الذي يناسب الصورة الحالية.
get_modify_date(use_default)	يحصل على تاريخ ووقت آخر تعديل لصورة المورد.
get_original_options()	يحصل على الخيارات بناءً على إعدادات الملف الأصلي. يمكن أن يكون ذلك مفيدًا للحفاظ على عمق البت وغيرها من معلمات الصورة الأصلية دون تغيير. على سبيل المثال، إذا قمنا بتحميل صورة PNG بالأبيض والأسود بعمق 1 بت لكل بكسل ثم حفظناها باستخدام طريقة DataStreamSupporter.save(file_path)، سيتم إنتاج صورة PNG ناتجة بعمق 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بعمق 1 بت لكل بكسل، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة ومررها إلى طريقة Image.save(file_path, options) كمعامل ثانٍ.
get_pixel(x, y)	يحصل على بكسل صورة.
get_proportional_height(width, height, new_width)	يحصل على ارتفاع نسبي.
get_proportional_width(width, height, new_height)	يحصل على عرض نسبي.
get_serialized_stream(image_options, clipping_rectangle, page_number)	يحوّل إلى aps.
get_skew_angle()	يحصل على زاوية الانحراف. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا، لتحديد زاوية الانحراف أثناء المسح.
grayscale()	تحويل إلى تدرج الرمادي يحول الصورة إلى تمثيل أبيض-أسود، حيث يتم تمثيل شدة كل بكسل بقيمة واحدة تتراوح بين الأسود والأبيض. يزيل هذا العملية معلومات اللون، مما ينتج صورة أحادية اللون. تُستخدم صور التدرج الرمادي عادةً في التطبيقات التي لا تكون فيها الألوان ضرورية أو حيث يُفضَّل البساطة، مثل مسح المستندات، الطباعة، وبعض أنواع تحليل الصور.
is_digital_signed(password, percentage_threshold)	يُجري فحصًا سريعًا لتحديد ما إذا كانت الصورة موقعة رقمياً، باستخدام كلمة المرور والعتبة المقدمة.
load(file_path)	يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد. إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط. إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.
load(file_path, load_options)	يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد. إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط. إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.
load(stream)	حمّل مستند DjVu الخاص بك باستخدام هذه الطريقة. سهل عمليتك عن طريق الوصول السريع واستيراد ملفات DjVu إلى تطبيقك.
load(stream, load_options)	استورد مستند DjVu الخاص بك باستخدام هذه الطريقة مع معلمات stream و loadOptions. سهل عمليتك عن طريق الوصول السريع واستيراد ملفات DjVu إلى تطبيقك، مما يوفر مرونة وخيارات تخصيص لتلبية احتياجاتك.
load_argb_32_pixels(rectangle)	يحمّل بكسلات ARGB 32‑بت.
load_argb_64_pixels(rectangle)	يحمّل بكسلات ARGB 64‑بت.
load_cmyk_32_pixels(rectangle)	يحمّل بكسلات بتنسيق CMYK.
load_cmyk_pixels(rectangle)	يحمّل بكسلات بتنسيق CMYK. هذه الطريقة مهجورة. يرجى استخدام الطريقة الأكثر فاعلية RasterImage.load_cmyk_32_pixels(rectangle).
load_document(stream)	حمّل مستند DjVu الخاص بك باستخدام هذه الطريقة. سهل عمليتك عن طريق الوصول السريع واستيراد ملفات DjVu إلى تطبيقك.
load_document(stream, load_options)	استورد مستند DjVu الخاص بك باستخدام هذه الطريقة مع معلمات stream و loadOptions. سهل عمليتك عن طريق الوصول السريع واستيراد ملفات DjVu إلى تطبيقك، مما يوفر مرونة وخيارات تخصيص لتلبية احتياجاتك.
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)	يحمّل بكسلات ARGB 32‑بت جزئيًا (حسب الكتل).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)	يحمّل بكسلات ARGB 64‑بت جزئيًا حسب الحزم.
load_partial_pixels(desired_rectangle, pixel_loader)	يحمّل بكسلات جزئيًا حسب الحزم.
load_pixels(rectangle)	يحمّل بكسلات.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)	يحمّل بيانات خام.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)	يحمّل بيانات خام.
load_stream(stream)	يحمّل صورة جديدة من الدفق المحدد.
load_stream_with_options(stream, load_options)	يحمّل صورة جديدة من الدفق المحدد.
load_with_options(file_path, load_options)	يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد. إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط. إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.
normalize_angle()	يُعَدِّل الزاوية. هذه الطريقة قابلة للتطبيق على مستندات النص الممسوحة ضوئياً للتخلص من الانحراف. تستخدم هذه الطريقة RasterImage.get_skew_angle() و RasterImage.rotate(angle) .
normalize_angle(resize_proportionally, background_color)	يُعَدِّل الزاوية. هذه الطريقة قابلة للتطبيق على مستندات النص الممسوحة ضوئياً للتخلص من الانحراف. تستخدم هذه الطريقة RasterImage.get_skew_angle() و RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color) .
normalize_histogram()	يُعَدِّل مدرج الصورة — يضبط قيم البكسل لاستخدام كامل النطاق المتاح.
read_argb_32_scan_line(scan_line_index)	يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.
read_scan_line(scan_line_index)	يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.
remove_metadata()	يزيل بيانات التعريف لهذه الصورة عن طريق تعيين قيمة IHasXmpData.xmp_data إلى None.
replace_argb(old_color_argb, old_color_diff, new_color_argb)	يستبدل لونًا بآخر مع فرق مسموح به ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.
replace_color(old_color, old_color_diff, new_color)	يستبدل لونًا بآخر مع فرق مسموح به ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.
replace_color(old_color_argb, old_color_diff, new_color_argb)	يستبدل لونًا بآخر مع فرق مسموح به ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.
replace_non_transparent_colors(new_color)	يستبدل جميع الألوان غير الشفافة بلون جديد ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة. ملاحظة: إذا استخدمتها على صور بدون شفافية، سيتم استبدال جميع الألوان بلون واحد.
replace_non_transparent_colors(new_color_argb)	يستبدل جميع الألوان غير الشفافة بلون جديد ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة. ملاحظة: إذا استخدمتها على صور بدون شفافية، سيتم استبدال جميع الألوان بلون واحد.
resize(new_width, new_height)	يُعيد تحجيم الصورة. يتم استخدام القيمة الافتراضية ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.
resize(new_width, new_height, resize_type)	قم بتغيير حجم الصورة باستخدام طريقة Resize، مما يوفر طريقة بسيطة وفعّالة لضبط أبعاد صورك وفقًا لمتطلباتك. هذه الوظيفة المتعددة الاستخدامات تمكنك من تكبير الصور بسهولة إلى الحجم المطلوب، مما يعزز قابلية استخدامها عبر منصات وتطبيقات مختلفة.
resize(new_width, new_height, settings)	غيّر حجم الصورة إلى العرض والارتفاع المحددين مع تطبيق إعدادات إضافية حسب الحاجة. تتيح هذه الطريقة للمستخدمين ضبط أبعاد الصورة مع الحفاظ على الخصائص المطلوبة مثل نسبة الأبعاد، جودة الصورة، وإعدادات الضغط. من خلال توفير مرونة في خيارات تغيير الحجم، يمكن للمستخدمين تخصيص الصورة لتتناسب مع المتطلبات المحددة وتحسين مظهرها لتطبيقات ومنصات مختلفة.
resize_by_settings(new_width, new_height, settings)	يقوم بتغيير حجم الصورة.
resize_by_type(new_width, new_height, resize_type)	يقوم بتغيير حجم الصورة.
resize_height_proportionally(new_height)	يقوم بتغيير ارتفاع الصورة بنسبة متناسبة. يتم استخدام ResizeType.NEAREST_NEIGHBOUR_RESAMPLE الافتراضي.
resize_height_proportionally(new_height, resize_type)	تتيح طريقة ResizeHeightProportionally لك ضبط ارتفاع صورتك مع الحفاظ على نسبة الأبعاد. هذا يضمن أن تظل صورتك تحتفظ بنسبها، مما يمنع التشويه ويحافظ على سلامتها البصرية. سواءً كنت تُحسّن الصور لصفحات الويب، التطبيقات المحمولة، أو الوسائط المطبوعة، فإن هذه الطريقة تضمن أن تبدو صورك بأفضل شكل عبر منصات وأجهزة مختلفة.
resize_height_proportionally(new_height, settings)	يقوم بتغيير ارتفاع الصورة بنسبة متناسبة.
resize_height_proportionally_settings(new_height, settings)	يقوم بتغيير ارتفاع الصورة بنسبة متناسبة.
resize_width_proportionally(new_width)	يقوم بتغيير عرض الصورة بنسبة متناسبة. يتم استخدام ResizeType.NEAREST_NEIGHBOUR_RESAMPLE الافتراضي.
resize_width_proportionally(new_width, resize_type)	توفر طريقة ResizeWidthProportionally حلاً مريحًا لضبط عرض صورتك مع الحفاظ على نسبة الأبعاد. من خلال تغيير حجم العرض بشكل متناسب، يمكنك التأكد من أن صورك تظل جذابة بصريًا و متسقة عبر أجهزة مختلفة وأحجام الشاشات، مما يعزز مرونتها وقابليتها للاستخدام في سياقات متعددة.
resize_width_proportionally(new_width, settings)	يقوم بتغيير عرض الصورة بنسبة متناسبة.
resize_width_proportionally_settings(new_width, settings)	يقوم بتغيير عرض الصورة بنسبة متناسبة.
rotate(angle)	تدوير الصورة حول المركز.
rotate(angle, resize_proportionally, background_color)	دوّر الصورة حول مركزها باستخدام طريقة Rotate الخاصة بـ فئة RasterCachedMultipageImage. تتيح هذه الميزة المريحة لك تعديل اتجاه الصور بسهولة مع الحفاظ على موضع المركز، مما يعزز قدراتك على معالجة الصور.
rotate_flip(rotate_flip_type)	توفر طريقة RotateFlip خيارات معالجة متعددة لصورتك، مما يسمح لك بالدوران، الانعكاس، أو تنفيذ كلا العمليتين على الإطار النشط بشكل مستقل. سواءً كنت تعدل الصور، تنشئ رسومات، أو تحسن الفن الرقمي، فإن هذه الطريقة توفر تحكمًا دقيقًا في اتجاه وتكوين صورك، مما يضمن تحقيق رؤيتك الإبداعية بسهولة وكفاءة.
rotate_flip_all(rotate_flip)	يقوم بتدوير جميع القلب.
save()	يقوم بحفظ بيانات الصورة إلى الدفق الأساسي.
save(file_path)	يقوم بحفظ الصورة إلى موقع الملف المحدد.
save(file_path, options)	يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save(file_path, options, bounds_rectangle)	يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save(file_path, over_write)	يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد.
save(stream)	يقوم بحفظ البيانات.
save(stream, options_base)	يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save(stream, options_base, bounds_rectangle)	يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save_argb_32_pixels(rectangle, pixels)	يقوم بحفظ بكسلات ARGB 32‑بت.
save_cmyk_32_pixels(rectangle, pixels)	يقوم بحفظ البكسلات.
save_cmyk_pixels(rectangle, pixels)	يقوم بحفظ البكسلات. هذه الطريقة مهجورة. يرجى استخدام الطريقة الأكثر فعالية RasterImage.save_cmyk_32_pixels(rectangle, pixels).
save_pixels(rectangle, pixels)	يقوم بحفظ البكسلات (طريقة خاصة بالتنسيق).
save_raw_data(data, data_offset, rectangle, raw_data_settings)	يحفظ البيانات الخام.
save_to_stream(stream)	يحفظ بيانات الكائن إلى الدفق المحدد.
save_to_stream_with_options(stream, options_base)	يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)	يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save_with_options(file_path, options)	يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save_with_options_rect(file_path, options, bounds_rectangle)	يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
set_argb_32_pixel(x, y, argb_32_color)	يضبط بكسل صورة 32-بت ARGB للموقع المحدد.
set_palette(palette, update_colors)	يضبط لوحة ألوان الصورة.
set_pixel(x, y, color)	يضبط بكسل صورة للموقع المحدد.
set_resolution(dpi_x, dpi_y)	يضبط الدقة لهذه RasterImage.
try_set_metadata(metadata)	يحاول ضبط مثال metadata، إذا كان مثال هذا Image يدعم ويطبق مثال IImageMetadataFormat .
write_argb_32_scan_line(scan_line_index, argb_32_pixels)	يكتب كامل سطر المسح إلى فهرس سطر المسح المحدد.
write_scan_line(scan_line_index, pixels)	يكتب كامل سطر المسح إلى فهرس سطر المسح المحدد.

Constructor: DjvuImage(stream)

 DjvuImage(stream) 

ابدأ العمل مع صور DjVu عن طريق إنشاء نسخة جديدة من
DjvuImage الفئة باستخدام معامل Stream. مثالي لـ
المطورين الذين يرغبون في دمج سلس لمعالجة صور DjVu في
مشاريعهم.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق.

See also:

Example # 1: This example shows how to load a DJVU image from a file stream.

Constructor: DjvuImage(stream, load_options)

 DjvuImage(stream, load_options) 

ابدأ العمل مع صور DjVu بسلاسة باستخدام هذا المُنشئ، الذي
ينشئ نسخة جديدة من فئة DjvuImage باستخدام Stream و
معاملات LoadOptions. مثالي للمطورين الذين يرغبون في تحكم دقيق في
خيارات تحميل صور DjVu مع الحفاظ على البساطة والكفاءة.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق للتحميل منه.
load_options	LoadOptions	خيارات التحميل.

See also:

Example # 1: This example shows how to load a DJVU image from a file stream to stay within…

Property: pages

الوصول إلى الصفحات الفردية في مجموعة صور DjVu الخاصة بك باستخدام هذه الخاصية.
بسط التنقل والتعامل مع المستند أو الكتاب المخزن بصيغة DjVu
من خلال الوصول إلى كل صفحة مباشرة. حسّن كفاءة سير عملك باستخدام
استرجاع الصفحات بسهولة.

See also:

Example # 1: This example shows how to load a DJVU image from a file stream.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

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

Parameters:

معامل	نوع	الوصف
السطوع	int	قيمة السطوع.

See also:

Example # 1: The following example performs brightness correction of a DJVU image.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

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

Parameters:

معامل	نوع	الوصف
التباين	float	قيمة التباين (في النطاق [-100; 100])

See also:

Example # 1: The following example performs contrast correction of a DJVU image.

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

تصحيح جاما، خاصة لقنوات الأحمر والأخضر والأزرق، يتضمن تعديل
سطوع كل مكوّن لوني على حدة. من خلال تطبيق معاملات جاما مختلفة على قنوات RGB، يمكنك ضبط السطوع العام والتباين
للصورة بدقة. تضمن هذه التقنية تمثيلًا لونيًا دقيقًا وتحسن
الجودة البصرية للصورة عبر مختلف أجهزة العرض.

Parameters:

معامل	نوع	الوصف
جاما	float	معامل جاما للقنوات الحمراء والخضراء والزرقاء

See also:

Example # 1: The following example performs gamma-correction of a DJVU image.

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

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

Parameters:

معامل	نوع	الوصف
gamma_red	float	معامل جاما للقناة الحمراء
gamma_green	float	معامل جاما للقناة الخضراء
gamma_blue	float	معامل جاما للقناة الزرقاء

See also:

Example # 1: The following example performs gamma-correction of a DJVU image applying diff…

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password) 

يحسب نسبة التشابه بين البيانات المستخرجة وكلمة المرور الأصلية.

Parameters:

معامل	نوع	الوصف
password	string	كلمة المرور المستخدمة لاستخراج البيانات المدمجة.

Returns

نوع	الوصف
int	قيمة نسبة التشابه.

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

تحويل الصورة إلى ثنائية باستخدام خوارزمية العتبة التكيفية لبرايدلي باستخدام عتبة الصورة المتكاملة

Parameters:

معامل	نوع	الوصف
brightness_difference	float	فرق السطوع بين البكسل ومتوسط نافذة s × s من البكسلات المتمركزة حول هذا البكسل.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

التصنيف الثنائي باستخدام خوارزمية العتبة التكيفية لبرايدلي مع الصورة المتكاملة
العتبة هي طريقة تحسب عتبة محلية لكل بكسل بناءً على
الجوار المحلي. تتكيف مع تغيرات الإضاءة عبر الصورة، مما يجعلها
مناسبة للصور ذات ظروف الإضاءة غير المتساوية. من خلال حساب العتبة باستخدام
الصور المتكاملة، تتعامل بكفاءة مع أحياء كبيرة، مما يجعلها قابلة للتطبيق على
التطبيقات في الوقت الحقيقي. تُستخدم هذه التقنية عادةً في معالجة المستندات، OCR
(التعرف الضوئي على الأحرف)، ومهام تقسيم الصور حيث يكون التصنيف الثنائي الدقيق
ضروريًا للتحليل اللاحق.

Parameters:

معامل	نوع	الوصف
brightness_difference	float	فرق السطوع بين البكسل ومتوسط نافذة s × s من البكسلات المتمركزة حول هذا البكسل.
window_size	int	حجم نافذة s × s من البكسلات المتمركزة حول هذا البكسل

See also:

Example # 1: The following example binarizes a DJVU image with Bradley’s adaptive threshol…

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

التصنيف الثنائي باستخدام عتبة محددة مسبقًا يبسط الصور المعقدة إلى تمثيلات ثنائية
حيث يتم تصنيف البكسلات إما كالسوداء أو البيضاء بناءً على شدة إضاءتها مقارنةً بقيمة العتبة المحددة. تُستخدم هذه التقنية عادةً في
معالجة الصور لتعزيز الوضوح، تبسيط التحليل، وتحضير الصور للخطوات اللاحقة
مثل التعرف الضوئي على الأحرف (OCR). من خلال تطبيق عتبة ثابتة، يمكنك بسرعة تحويل الصور ذات التدرج الرمادي إلى شكل ثنائي، مما يجعلها
أسهل في الفهم واستخراج المعلومات ذات المعنى منها.

Parameters:

معامل	نوع	الوصف
الحدّ	System.Byte	قيمة العتبة. إذا كانت القيمة الرمادية المقابلة لبكسل أكبر من العتبة، سيتم تعيين القيمة 255 له، وإلا 0.

See also:

Example # 1: The following example binarizes a DJVU image with the predefined threshold. B…

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

يمزج هذه النسخة من الصورة مع الصورة overlay.

Parameters:

معامل	نوع	الوصف
origin	Point	مصدر دمج صورة الخلفية.
overlay	RasterImage	صورة التراكب.
overlay_alpha	System.Byte	قيمة ألفا للتراكب.

Method: blend(origin, overlay, overlay_area, overlay_alpha)

 blend(origin, overlay, overlay_area, overlay_alpha) 

يمزج هذه النسخة من الصورة مع الصورة overlay.

Parameters:

معامل	نوع	الوصف
origin	Point	مصدر دمج صورة الخلفية.
overlay	RasterImage	صورة التراكب.
overlay_area	Rectangle	منطقة التراكب.
overlay_alpha	System.Byte	قيمة ألفا للتراكب.

Method: can_load(file_path) [static]

 can_load(file_path) 

يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف.

Returns

نوع	الوصف
bool	true إذا كان يمكن تحميل الصورة من الملف المحدد؛ وإلا، false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد واستخدام خيارات الفتح المحددة اختياريًا.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف.
load_options	LoadOptions	خيارات التحميل.

Returns

نوع	الوصف
bool	true إذا كان يمكن تحميل الصورة من الملف المحدد؛ وإلا، false.

Method: can_load(stream) [static]

 can_load(stream) 

يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق للتحميل منه.

Returns

نوع	الوصف
bool	true إذا كان يمكن تحميل الصورة من الدفق المحدد؛ وإلا، false.

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد واستخدام loadOptions المحددة اختياريًا.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق للتحميل منه.
load_options	LoadOptions	خيارات التحميل.

Returns

نوع	الوصف
bool	true إذا كان يمكن تحميل الصورة من الدفق المحدد؛ وإلا، false.

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق للتحميل منه.

Returns

نوع	الوصف
bool	true إذا كان يمكن تحميل الصورة من الدفق المحدد؛ وإلا، false.

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد واستخدام loadOptions المحددة اختياريًا.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق للتحميل منه.
load_options	LoadOptions	خيارات التحميل.

Returns

نوع	الوصف
bool	true إذا كان يمكن تحميل الصورة من الدفق المحدد؛ وإلا، false.

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد واستخدام خيارات الفتح المحددة اختياريًا.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف.
load_options	LoadOptions	خيارات التحميل.

Returns

نوع	الوصف
bool	true إذا كان يمكن تحميل الصورة من الملف المحدد؛ وإلا، false.

Method: can_save(options)

 can_save(options) 

يحدد ما إذا كان يمكن حفظ الصورة إلى تنسيق الملف المحدد الممثل بخيارات الحفظ الممررة.

Parameters:

معامل	نوع	الوصف
options	ImageOptionsBase	خيارات الحفظ للاستخدام.

Returns

نوع	الوصف
bool	true إذا كان يمكن حفظ الصورة إلى تنسيق الملف المحدد الممثل بخيارات الحفظ الممررة؛ وإلا، false.

Method: create(files) [static]

 create(files) 

ينشئ صورة متعددة الصفحات تحتوي على الملفات المحددة.

Parameters:

معامل	نوع	الوصف
ملفات	string[]	الملفات.

Returns

نوع	الوصف
Image	الصورة متعددة الصفحات

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

ينشئ صورة متعددة الصفحات تحتوي على الملفات المحددة.

Parameters:

معامل	نوع	الوصف
ملفات	string[]	الملفات.
throw_exception_on_load_error	bool	إذا تم الضبط على true [إلقاء استثناء عند خطأ التحميل].

Returns

نوع	الوصف
Image	الصورة متعددة الصفحات

Method: create(image_options, width, height) [static]

 create(image_options, width, height) 

ينشئ صورة جديدة باستخدام خيارات الإنشاء المحددة.

Parameters:

معامل	نوع	الوصف
image_options	ImageOptionsBase	خيارات الصورة.
width	int	العرض.
height	int	الارتفاع.

Returns

نوع	الوصف
Image	الصورة التي تم إنشاؤها حديثًا.

Method: create(image_options, width, height, pixels) [static]

 create(image_options, width, height, pixels) 

ينشئ مثيلًا من RasterImage من مصفوفة البكسل المقدمة.

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

Parameters:

معامل	نوع	الوصف
image_options	ImageOptionsBase	الخيارات المستخدمة لإنشاء الـ RasterImage.
width	int	عرض الـ RasterImage.
height	int	ارتفاع الـ RasterImage.
البكسلات	int[]	المصفوفة من قيم البكسل المستخدمة لملء الصورة.

Returns

نوع	الوصف
Image	صورة RasterImage مملوءة ببيانات البكسل المقدمة.

Method: create(images) [static]

 create(images) 

ينشئ صورة جديدة باستخدام الصور المحددة كصفحات

Parameters:

معامل	نوع	الوصف
images	Image[]	الصور.

Returns

نوع	الوصف
Image	الصورة كـ IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.

Parameters:

معامل	نوع	الوصف
images	Image[]	الصور.
dispose_images	bool	إذا تم الضبط على true [إزالة الصور].

Returns

نوع	الوصف
Image	الصورة كـ IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

ينشئ خيارات الإنشاء المتعددة الصفحات المحددة.

Parameters:

معامل	نوع	الوصف
multipage_create_options	MultipageCreateOptions	خيارات إنشاء متعدد الصفحات.

Returns

نوع	الوصف
Image	الصورة متعددة الصفحات

Method: create_from_files(files) [static]

 create_from_files(files) 

ينشئ الصورة المتعددة الصفحات التي تحتوي على الملفات المحددة كصفحات تحميل كسول.

Parameters:

معامل	نوع	الوصف
ملفات	string[]	الملفات.

Returns

نوع	الوصف
Image	الصورة متعددة الصفحات

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

ينشئ الصورة المتعددة الصفحات التي تحتوي على الملفات المحددة كصفحات تحميل كسول.

Parameters:

معامل	نوع	الوصف
ملفات	string[]	الملفات.
throw_exception_on_load_error	bool	إذا تم الضبط على true إلقاء استثناء عند خطأ التحميل.

Returns

نوع	الوصف
Image	الصورة متعددة الصفحات

Method: create_from_images(images) [static]

 create_from_images(images) 

ينشئ صورة جديدة باستخدام الصور المحددة كصفحات

Parameters:

معامل	نوع	الوصف
images	Image[]	الصور.

Returns

نوع	الوصف
Image	الصورة كـ IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.

Parameters:

معامل	نوع	الوصف
images	Image[]	الصور.
dispose_images	bool	إذا تم الضبط على true [إزالة الصور].

Returns

نوع	الوصف
Image	الصورة كـ IMultipageImage

Method: crop(left_shift, right_shift, top_shift, bottom_shift)

 crop(left_shift, right_shift, top_shift, bottom_shift) 

يتيح لك الاقتصاص مع الإزاحات ضبط موضع وأبعاد المنطقة المقتصة داخل الصورة بدقة. هذه الميزة لا تقدر بثمن لتحسين التكوينات،
محاذاة العناصر، وتأكيد النقاط البؤرية في مرئياتك. من خلال دمج الإزاحات في عملية الاقتصاص، يمكنك تحقيق دقة بكسلية مثالية وتعديل إطار صورك بسهولة.

Parameters:

معامل	نوع	الوصف
left_shift	int	الإزاحة اليسرى.
right_shift	int	الإزاحة اليمنى.
top_shift	int	الإزاحة العلوية.
bottom_shift	int	الإزاحة السفلية.

Method: crop(rectangle)

 crop(rectangle) 

يُقصّ “Crop” صورتك للتركيز على تفاصيل محددة أو إزالة العناصر غير المرغوب فيها،
مما يعزز تكوينها وتأثيرها البصري. سواءً كنت تعدل الصور لوسائل التواصل الاجتماعي،
تنشئ لافتات مواقع الويب، أو تصمم مواد مطبوعة، فإن هذه الأداة تساعدك
على تحسين صورك بدقة ووضوح.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل.

See also:

Example # 1: The following example crops a DJVU image. The cropping area is be specified v…

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

يُجري تمويهًا على الصورة الحالية.

Parameters:

معامل	نوع	الوصف
dithering_method	DitheringMethod	طريقة التمويه.
bits_count	int	عدد البتات النهائي للتدرج.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

تطبق وظيفة “Dither” تأثير التدرج على صورتك، مما يحسن جودتها البصرية عن طريق تقليل الخطوط المتدرجة وتحسين انتقالات الألوان. سواءً كنت تعمل
على فن رقمي، تصوير فوتوغرافي، أو مشاريع تصميم جرافيكي، فإن هذه الميزة تضيف لمسة
احترافية لصورك، تجعلها تبدو أكثر سلاسة وتفصيلاً.

Parameters:

معامل	نوع	الوصف
dithering_method	DitheringMethod	طريقة التمويه.
bits_count	int	عدد البتات النهائي للتدرج.
custom_palette	IColorPalette	لوحة الألوان المخصصة للتدرج.

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

أدمج توقيعًا رقميًا يعتمد على كلمة المرور المقدمة في كل صفحة من الصورة.

Parameters:

معامل	نوع	الوصف
password	string	كلمة المرور المستخدمة لإنشاء بيانات التوقيع الرقمي

Method: filter(rectangle, options)

 filter(rectangle, options) 

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

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل.
options	FilterOptionsBase	الخيارات.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

يحصل على بكسل صورة 32-بت ARGB.

Parameters:

معامل	نوع	الوصف
x	int	موقع البكسل x.
y	int	موقع البكسل y.

Returns

نوع	الوصف
int	بكسل ARGB 32-بت للموقع المحدد.

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

يحصل على مصفوفة بكسلات ARGB 32-بت الافتراضية.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل للحصول على البكسلات.

Returns

نوع	الوصف
int[]	مصفوفة البكسلات الافتراضية.

Method: get_default_options(args)

 get_default_options(args) 

يحصل على الخيارات الافتراضية.

Parameters:

معامل	نوع	الوصف
args	System.Object	المعلمات.

Returns

نوع	الوصف
ImageOptionsBase	الخيارات الافتراضية

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

يحصل على مصفوفة البكسلات الافتراضية باستخدام محمل البكسل الجزئي.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل للحصول على البكسلات.
partial_pixel_loader	IPartialArgb32PixelLoader	محمل البكسل الجزئي.

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

يحصل على مصفوفة البيانات الخام الافتراضية باستخدام محمل البكسل الجزئي.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل للحصول على البكسلات.
partial_raw_data_loader	IPartialRawDataLoader	محمل البيانات الخام الجزئي.
raw_data_settings	RawDataSettings	إعدادات البيانات الخام.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

يحصل على مصفوفة البيانات الخام الافتراضية.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل للحصول على البيانات الخام.
raw_data_settings	RawDataSettings	إعدادات البيانات الخام.

Returns

نوع	الوصف
System.Byte	مصفوفة البيانات الخام الافتراضية.

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

يحصل على تنسيق الملف.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف.

Returns

نوع	الوصف
FileFormat	تنسيق الملف المحدد.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

يحصل على تنسيق الملف.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق.

Returns

نوع	الوصف
FileFormat	تنسيق الملف المحدد.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

يحصل على تنسيق الملف.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق.

Returns

نوع	الوصف
FileFormat	تنسيق الملف المحدد.

Method: get_fitting_rectangle(rectangle, pixels, width, height) [static]

 get_fitting_rectangle(rectangle, pixels, width, height) 

يحصل على المستطيل الذي يناسب الصورة الحالية.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل للحصول على المستطيل المناسب.
البكسلات	int[]	بكسلات ARGB 32-بت.
width	int	عرض الكائن.
height	int	ارتفاع الكائن.

Returns

نوع	الوصف
Rectangle	المستطيل المناسب أو استثناء إذا لم يتم العثور على مستطيل مناسب.

Method: get_fitting_rectangle(rectangle, width, height) [static]

 get_fitting_rectangle(rectangle, width, height) 

يحصل على المستطيل الذي يناسب الصورة الحالية.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل للحصول على المستطيل المناسب.
width	int	عرض الكائن.
height	int	ارتفاع الكائن.

Returns

نوع	الوصف
Rectangle	المستطيل المناسب أو استثناء إذا لم يتم العثور على مستطيل مناسب.

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

يحصل على تاريخ ووقت آخر تعديل لصورة المورد.

Parameters:

معامل	نوع	الوصف
use_default	bool	إذا تم تعيينه إلى true يستخدم المعلومات من FileInfo كقيمة افتراضية.

Returns

نوع	الوصف
System.DateTime	التاريخ والوقت الذي تم تعديل صورة المورد فيه آخر مرة.

Method: get_original_options()

 get_original_options() 

يحصل على الخيارات بناءً على إعدادات الملف الأصلي.
يمكن أن يكون ذلك مفيدًا للحفاظ على عمق البت وغيرها من معلمات الصورة الأصلية دون تغيير.
على سبيل المثال، إذا قمنا بتحميل صورة PNG بالأبيض والأسود بعمق 1 بت لكل بكسل ثم حفظناها باستخدام
طريقة DataStreamSupporter.save(file_path)، سيتم إنتاج صورة PNG ناتجة بعمق 8 بت لكل بكسل.
لتجنب ذلك وحفظ صورة PNG بعمق 1 بت لكل بكسل، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة ومررها
إلى طريقة Image.save(file_path, options) كمعامل ثانٍ.

Returns

نوع	الوصف
ImageOptionsBase	الخيارات المستندة إلى إعدادات الملف الأصلي.

Method: get_pixel(x, y)

 get_pixel(x, y) 

يحصل على بكسل صورة.

Parameters:

معامل	نوع	الوصف
x	int	موقع البكسل x.
y	int	موقع البكسل y.

Returns

نوع	الوصف
Color	لون البكسل للموقع المحدد.

Method: get_proportional_height(width, height, new_width) [static]

 get_proportional_height(width, height, new_width) 

يحصل على ارتفاع نسبي.

Parameters:

معامل	نوع	الوصف
width	int	العرض.
height	int	الارتفاع.
new_width	int	العرض الجديد.

Returns

نوع	الوصف
int	الارتفاع النسبي.

Method: get_proportional_width(width, height, new_height) [static]

 get_proportional_width(width, height, new_height) 

يحصل على عرض نسبي.

Parameters:

معامل	نوع	الوصف
width	int	العرض.
height	int	الارتفاع.
new_height	int	الارتفاع الجديد.

Returns

نوع	الوصف
int	العرض النسبي.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

يحوّل إلى aps.

Parameters:

معامل	نوع	الوصف
image_options	ImageOptionsBase	خيارات الصورة.
clipping_rectangle	Rectangle	مستطيل القص.
page_number	int[]	رقم الصفحة.

Returns

نوع	الوصف
_io.BufferedRandom	التدفق المتسلسل

Method: get_skew_angle()

 get_skew_angle() 

يحصل على زاوية الانحراف.
هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا، لتحديد زاوية الانحراف أثناء المسح.

Returns

نوع	الوصف
float	زاوية الانحراف، بالدرجات.

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

يُجري فحصًا سريعًا لتحديد ما إذا كانت الصورة موقعة رقمياً، باستخدام كلمة المرور والعتبة المقدمة.

Parameters:

معامل	نوع	الوصف
password	string	كلمة المرور للتحقق من التوقيع.
percentage_threshold	int	الحد (بالنسبة المئوية)[0-100] الذي يحدد ما إذا كانت الصورة تعتبر موقعة. إذا لم يتم تحديده، سيتم تطبيق حد افتراضي (75).

Returns

نوع	الوصف
bool	صحيح إذا كانت الصورة موقعة، وإلا خاطئ.

Method: load(file_path) [static]

 load(file_path) 

يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد.
إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط.
إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف أو URL لتحميل الصورة منه.

Returns

نوع	الوصف
Image	الصورة المحملة.

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد.
إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط.
إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف أو URL لتحميل الصورة منه.
load_options	LoadOptions	خيارات التحميل.

Returns

نوع	الوصف
Image	الصورة المحملة.

Method: load(stream) [static]

 load(stream) 

حمّل مستند DjVu الخاص بك باستخدام هذه الطريقة. سهل عمليتك عن طريق الوصول السريع
واستيراد ملفات DjVu إلى تطبيقك.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق.

Returns

نوع	الوصف
Image	تم تحميل مستند djvu

Method: load(stream, load_options) [static]

 load(stream, load_options) 

استورد مستند DjVu الخاص بك باستخدام هذه الطريقة مع معلمات stream و loadOptions.
سهل عمليتك عن طريق الوصول السريع واستيراد ملفات DjVu
إلى تطبيقك، مما يوفر مرونة وخيارات تخصيص لتلبية
احتياجاتك.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق.
load_options	LoadOptions	خيارات التحميل.

Returns

نوع	الوصف
Image	تم تحميل مستند djvu

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

يحمّل بكسلات ARGB 32‑بت.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لتحميل البكسلات منه.

Returns

نوع	الوصف
int[]	مصفوفة البكسلات ARGB 32-بت المحملة.

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

يحمّل بكسلات ARGB 64‑بت.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لتحميل البكسلات منه.

Returns

نوع	الوصف
int[]	مصفوفة بكسلات ARGB 64-بت المحملة.

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

يحمّل بكسلات بتنسيق CMYK.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لتحميل البكسلات منه.

Returns

نوع	الوصف
int[]	مصفوفة بكسلات CMYK المحملة كقيم صحيحة 32-بت.

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

يحمّل بكسلات بتنسيق CMYK.
هذه الطريقة مهجورة. يرجى استخدام الطريقة الأكثر فاعلية RasterImage.load_cmyk_32_pixels(rectangle).

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لتحميل البكسلات منه.

Returns

نوع	الوصف
CmykColor[]	مصفوفة بكسلات CMYK المحملة.

Method: load_document(stream) [static]

 load_document(stream) 

حمّل مستند DjVu الخاص بك باستخدام هذه الطريقة. سهل عمليتك عن طريق الوصول السريع
واستيراد ملفات DjVu إلى تطبيقك.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق.

Returns

نوع	الوصف
DjvuImage	تم تحميل مستند djvu

Method: load_document(stream, load_options) [static]

 load_document(stream, load_options) 

استورد مستند DjVu الخاص بك باستخدام هذه الطريقة مع معلمات stream و loadOptions.
سهل عمليتك عن طريق الوصول السريع واستيراد ملفات DjVu
إلى تطبيقك، مما يوفر مرونة وخيارات تخصيص لتلبية
احتياجاتك.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق.
load_options	LoadOptions	خيارات التحميل.

Returns

نوع	الوصف
DjvuImage	تم تحميل مستند djvu

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

يحمّل بكسلات ARGB 32‑بت جزئيًا (حسب الكتل).

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لتحميل البكسلات منه.
partial_pixel_loader	IPartialArgb32PixelLoader	محمل البكسل الجزئي.

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

يحمّل بكسلات ARGB 64‑بت جزئيًا حسب الحزم.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل المطلوب.
partial_pixel_loader	IPartialArgb64PixelLoader	محمل بكسلات ARGB 64-بت.

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

يحمّل بكسلات جزئيًا حسب الحزم.

Parameters:

معامل	نوع	الوصف
desired_rectangle	Rectangle	المستطيل المطلوب.
pixel_loader	IPartialPixelLoader	محمل البكسلات.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

يحمّل بكسلات.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لتحميل البكسلات منه.

Returns

نوع	الوصف
Color[]	مصفوفة البكسلات المحملة.

Method: load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader) 

يحمّل بيانات خام.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لتحميل البيانات الخام منه.
dest_image_bounds	Rectangle	حدود الصورة الوجهة.
raw_data_settings	RawDataSettings	إعدادات البيانات الخام لاستخدامها مع البيانات المحملة. ملاحظة: إذا لم تكن البيانات بالتنسيق المحدد فسيتم إجراء تحويل البيانات.
raw_data_loader	IPartialRawDataLoader	محمل البيانات الخام.

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

يحمّل بيانات خام.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لتحميل البيانات الخام منه.
raw_data_settings	RawDataSettings	إعدادات البيانات الخام لاستخدامها مع البيانات المحملة. ملاحظة: إذا لم تكن البيانات بالتنسيق المحدد فسيتم إجراء تحويل البيانات.
raw_data_loader	IPartialRawDataLoader	محمل البيانات الخام.

Method: load_stream(stream) [static]

 load_stream(stream) 

يحمّل صورة جديدة من الدفق المحدد.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق لتحميل الصورة منه.

Returns

نوع	الوصف
Image	الصورة المحملة.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

يحمّل صورة جديدة من الدفق المحدد.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق لتحميل الصورة منه.
load_options	LoadOptions	خيارات التحميل.

Returns

نوع	الوصف
Image	الصورة المحملة.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد.
إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط.
إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف أو URL لتحميل الصورة منه.
load_options	LoadOptions	خيارات التحميل.

Returns

نوع	الوصف
Image	الصورة المحملة.

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

يُعَدِّل الزاوية.
هذه الطريقة قابلة للتطبيق على مستندات النص الممسوحة ضوئياً للتخلص من الانحراف.
تستخدم هذه الطريقة RasterImage.get_skew_angle() و RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color) .

Parameters:

معامل	نوع	الوصف
resize_proportionally	bool	إذا تم تعيينه إلى true سيتغير حجم الصورة وفقًا لإسقاطات المستطيل المدور (نقاط الزوايا)، وفي الحالة الأخرى سيبقى الأبعاد دون تغيير وتدور محتويات الصورة الداخلية فقط.
background_color	Color	لون الخلفية.

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.

Parameters:

معامل	نوع	الوصف
scan_line_index	int	فهرس الصف الماسح يبدأ من الصفر.

Returns

نوع	الوصف
int[]	مصفوفة قيم ألوان ARGB 32-بت لصف المسح.

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.

Parameters:

معامل	نوع	الوصف
scan_line_index	int	فهرس الصف الماسح يبدأ من الصفر.

Returns

نوع	الوصف
Color[]	مصفوفة قيم ألوان بكسلات صف المسح.

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

يستبدل لونًا بآخر مع فرق مسموح به ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.

Parameters:

معامل	نوع	الوصف
old_color_argb	int	قيمة ARGB للون القديم التي سيتم استبدالها.
old_color_diff	System.Byte	الفرق المسموح به في اللون القديم لتمكين توسيع نغمة اللون المستبدل.
new_color_argb	int	قيمة ARGB للون الجديد لاستبدال اللون القديم بها.

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

يستبدل لونًا بآخر مع فرق مسموح به ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.

Parameters:

معامل	نوع	الوصف
old_color	Color
old_color_diff	System.Byte	الفرق المسموح به في اللون القديم لتمكين توسيع نغمة اللون المستبدل.
new_color	Color

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

يستبدل لونًا بآخر مع فرق مسموح به ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.

Parameters:

معامل	نوع	الوصف
old_color_argb	int	قيمة ARGB للون القديم التي سيتم استبدالها.
old_color_diff	System.Byte	الفرق المسموح به في اللون القديم لتمكين توسيع نغمة اللون المستبدل.
new_color_argb	int	قيمة ARGB للون الجديد لاستبدال اللون القديم بها.

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

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

Parameters:

معامل	نوع	الوصف
new_color	Color

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

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

Parameters:

معامل	نوع	الوصف
new_color_argb	int	قيمة ARGB للون الجديد لاستبدال الألوان غير الشفافة بها.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

يُعيد تحجيم الصورة. يتم استخدام القيمة الافتراضية ResizeType.NEAREST_NEIGHBOUR_RESAMPLE.

Parameters:

معامل	نوع	الوصف
new_width	int	العرض الجديد.
new_height	int	الارتفاع الجديد.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

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

Parameters:

معامل	نوع	الوصف
new_width	int	العرض الجديد.
new_height	int	الارتفاع الجديد.
resize_type	ResizeType	نوع التحجيم.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

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

Parameters:

معامل	نوع	الوصف
new_width	int	العرض الجديد.
new_height	int	الارتفاع الجديد.
settings	ImageResizeSettings	إعدادات التحجيم.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

يقوم بتغيير حجم الصورة.

Parameters:

معامل	نوع	الوصف
new_width	int	العرض الجديد.
new_height	int	الارتفاع الجديد.
settings	ImageResizeSettings	إعدادات التحجيم.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

يقوم بتغيير حجم الصورة.

Parameters:

معامل	نوع	الوصف
new_width	int	العرض الجديد.
new_height	int	الارتفاع الجديد.
resize_type	ResizeType	نوع التحجيم.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

يقوم بتغيير ارتفاع الصورة بنسبة متناسبة. يتم استخدام ResizeType.NEAREST_NEIGHBOUR_RESAMPLE الافتراضي.

Parameters:

معامل	نوع	الوصف
new_height	int	الارتفاع الجديد.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

تتيح طريقة ResizeHeightProportionally لك ضبط ارتفاع صورتك
مع الحفاظ على نسبة الأبعاد. هذا يضمن أن تظل صورتك تحتفظ
بنسبها، مما يمنع التشويه ويحافظ على سلامتها البصرية.
سواءً كنت تُحسّن الصور لصفحات الويب، التطبيقات المحمولة، أو الوسائط المطبوعة، فإن هذه
الطريقة تضمن أن تبدو صورك بأفضل شكل عبر منصات وأجهزة مختلفة.

Parameters:

معامل	نوع	الوصف
new_height	int	الارتفاع الجديد.
resize_type	ResizeType	نوع التحجيم.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

يقوم بتغيير ارتفاع الصورة بنسبة متناسبة.

Parameters:

معامل	نوع	الوصف
new_height	int	الارتفاع الجديد.
settings	ImageResizeSettings	إعدادات تحجيم الصورة.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

يقوم بتغيير ارتفاع الصورة بنسبة متناسبة.

Parameters:

معامل	نوع	الوصف
new_height	int	الارتفاع الجديد.
settings	ImageResizeSettings	إعدادات تحجيم الصورة.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

يقوم بتغيير عرض الصورة بنسبة متناسبة. يتم استخدام ResizeType.NEAREST_NEIGHBOUR_RESAMPLE الافتراضي.

Parameters:

معامل	نوع	الوصف
new_width	int	العرض الجديد.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

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

Parameters:

معامل	نوع	الوصف
new_width	int	العرض الجديد.
resize_type	ResizeType	نوع التحجيم.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

يقوم بتغيير عرض الصورة بنسبة متناسبة.

Parameters:

معامل	نوع	الوصف
new_width	int	العرض الجديد.
settings	ImageResizeSettings	إعدادات تحجيم الصورة.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

يقوم بتغيير عرض الصورة بنسبة متناسبة.

Parameters:

معامل	نوع	الوصف
new_width	int	العرض الجديد.
settings	ImageResizeSettings	إعدادات تحجيم الصورة.

Method: rotate(angle)

 rotate(angle) 

تدوير الصورة حول المركز.

Parameters:

معامل	نوع	الوصف
angle	float	زاوية الدوران بالدرجات. القيم الموجبة ستدور باتجاه عقارب الساعة.

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

دوّر الصورة حول مركزها باستخدام طريقة Rotate الخاصة بـ
فئة RasterCachedMultipageImage. تتيح هذه الميزة المريحة لك تعديل
اتجاه الصور بسهولة مع الحفاظ على موضع المركز،
مما يعزز قدراتك على معالجة الصور.

Parameters:

معامل	نوع	الوصف
angle	float	زاوية الدوران بالدرجات. القيم الموجبة ستدور باتجاه عقارب الساعة.
resize_proportionally	bool	إذا تم تعيينه إلى true سيتغير حجم الصورة وفقًا لإسقاطات المستطيل المدور (نقاط الزوايا) في الحالة الأخرى يترك الأبعاد دون تغيير وتُدوَّر محتويات الصورة internal فقط.
background_color	Color	لون الخلفية.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

توفر طريقة RotateFlip خيارات معالجة متعددة لصورتك، مما يسمح لك
بالدوران، الانعكاس، أو تنفيذ كلا العمليتين على الإطار النشط بشكل مستقل.
سواءً كنت تعدل الصور، تنشئ رسومات، أو تحسن الفن الرقمي، فإن هذه
الطريقة توفر تحكمًا دقيقًا في اتجاه وتكوين صورك،
مما يضمن تحقيق رؤيتك الإبداعية بسهولة وكفاءة.

Parameters:

معامل	نوع	الوصف
rotate_flip_type	RotateFlipType	نوع دوران الانعكاس.

See also:

Example # 1: This example loads a DJVU image, rotates it by 90 degrees clockwise and optio…

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

يقوم بتدوير جميع القلب.

Parameters:

معامل	نوع	الوصف
rotate_flip	RotateFlipType	دوران الانعكاس.

Method: save(file_path)

 save(file_path) 

يقوم بحفظ الصورة إلى موقع الملف المحدد.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف لحفظ الصورة فيه.

Method: save(file_path, options)

 save(file_path, options) 

يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف.
options	ImageOptionsBase	الخيارات.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف.
options	ImageOptionsBase	الخيارات.
bounds_rectangle	Rectangle	مستطيل حدود الصورة الوجهة. اضبط المستطيل الفارغ لاستخدام حدود المصدر.

Method: save(file_path, over_write)

 save(file_path, over_write) 

يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف لحفظ بيانات الكائن فيه.
over_write	bool	إذا تم تعيينه إلى true سيكتب فوق محتويات الملف، وإلا سيحدث الإلحاق.

Method: save(stream)

 save(stream) 

يقوم بحفظ البيانات.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق لحفظ البيانات فيه.

Method: save(stream, options_base)

 save(stream, options_base) 

يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق لحفظ بيانات الصورة فيه.
options_base	ImageOptionsBase	خيارات الحفظ.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق لحفظ بيانات الصورة فيه.
options_base	ImageOptionsBase	خيارات الحفظ.
bounds_rectangle	Rectangle	مستطيل حدود الصورة الوجهة. اضبط المستطيل الفارغ لاستخدام حدود المصدر.

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

يقوم بحفظ بكسلات ARGB 32‑بت.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لحفظ البكسلات فيه.
البكسلات	int[]	مصفوفة بكسلات ARGB 32‑بت.

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

يقوم بحفظ البكسلات.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لحفظ البكسلات فيه.
البكسلات	int[]	بكسلات CMYK معروضة كقيم صحيحة 32‑بت.

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

يقوم بحفظ البكسلات.
هذه الطريقة مهجورة. يرجى استخدام الطريقة الأكثر فعالية RasterImage.save_cmyk_32_pixels(rectangle, pixels).

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لحفظ البكسلات فيه.
pixels	CmykColor[]	مصفوفة بكسلات CMYK.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

يقوم بحفظ البكسلات (طريقة خاصة بالتنسيق).

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل لحفظ البكسلات فيه.
pixels	Color[]	مصفوفة بكسلات ARGB 32‑بت.

Method: save_raw_data(data, data_offset, rectangle, raw_data_settings)

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

يحفظ البيانات الخام.

Parameters:

معامل	نوع	الوصف
البيانات	System.Byte	البيانات الخام.
data_offset	int	إزاحة البيانات الخام الابتدائية.
rectangle	Rectangle	مستطيل البيانات الخام.
raw_data_settings	RawDataSettings	إعدادات البيانات الخام التي توجد فيها البيانات.

Method: save_to_stream(stream)

 save_to_stream(stream) 

يحفظ بيانات الكائن إلى الدفق المحدد.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	المجرى لحفظ بيانات الكائن إليه.

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق لحفظ بيانات الصورة فيه.
options_base	ImageOptionsBase	خيارات الحفظ.

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	الدفق لحفظ بيانات الصورة فيه.
options_base	ImageOptionsBase	خيارات الحفظ.
bounds_rectangle	Rectangle	مستطيل حدود الصورة الوجهة. اضبط المستطيل الفارغ لاستخدام حدود المصدر.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف.
options	ImageOptionsBase	الخيارات.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.

Parameters:

معامل	نوع	الوصف
file_path	string	مسار الملف.
options	ImageOptionsBase	الخيارات.
bounds_rectangle	Rectangle	مستطيل حدود الصورة الوجهة. اضبط المستطيل الفارغ لاستخدام حدود المصدر.

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

يضبط بكسل صورة 32-بت ARGB للموقع المحدد.

Parameters:

معامل	نوع	الوصف
x	int	موقع البكسل x.
y	int	موقع البكسل y.
argb_32_color	int	بكسل ARGB 32‑بت للموقع المحدد.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

يضبط لوحة ألوان الصورة.

Parameters:

معامل	نوع	الوصف
palette	IColorPalette	اللوحة التي يجب ضبطها.
update_colors	bool	إذا تم ضبطه على true سيتم تحديث الألوان وفقًا للوحة الجديدة؛ وإلا ستبقى مؤشرات الألوان دون تغيير. لاحظ أن المؤشرات غير المتغيرة قد تتسبب في تعطل الصورة عند التحميل إذا لم يكن لبعض المؤشرات إدخالات مطابقة في اللوحة.

Method: set_pixel(x, y, color)

 set_pixel(x, y, color) 

يضبط بكسل صورة للموقع المحدد.

Parameters:

معامل	نوع	الوصف
x	int	موقع البكسل x.
y	int	موقع البكسل y.
color	Color	لون البكسل للموقع المحدد.

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

يضبط الدقة لهذه RasterImage.

Parameters:

معامل	نوع	الوصف
dpi_x	float	الدقة الأفقية، بالنقاط لكل بوصة، لـ RasterImage.
dpi_y	float	الدقة العمودية، بالنقاط لكل بوصة، لـ RasterImage.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

يحاول ضبط مثال metadata، إذا كان مثال هذا Image يدعم ويطبق مثال IImageMetadataFormat .

Parameters:

معامل	نوع	الوصف
metadata	IImageMetadataFormat	البيانات الوصفية.

Returns

نوع	الوصف
bool	صحيح إذا كان metadata غير فارغ وكانت نسخة IMetadataContainer تدعم و/أو تنفذ نسخة IImageMetadataFormat; وإلا، خطأ.

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

يكتب كامل سطر المسح إلى فهرس سطر المسح المحدد.

Parameters:

معامل	نوع	الوصف
scan_line_index	int	فهرس الصف الماسح يبدأ من الصفر.
argb_32_pixels	int[]	مصفوفة ألوان ARGB 32‑بت للكتابة.

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

يكتب كامل سطر المسح إلى فهرس سطر المسح المحدد.

Parameters:

معامل	نوع	الوصف
scan_line_index	int	فهرس الصف الماسح يبدأ من الصفر.
pixels	Color[]	مصفوفة ألوان البكسل للكتابة.

Examples

This example shows how to load a DJVU image from a file stream.

from os.path import join
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions       

dir_: str = "c:\\temp"
# حمّل صورة DJVU من تدفق ملف.
with open(join(dir_, "sample.djvu"), "rb") as stream:
	with DjvuImage(stream) as djvu_image:
		# حفظ كل صفحة كصورة PNG منفصلة.
		for djvu_page in djvu_image.pages:
			# أنشئ اسم ملف بناءً على رقم الصفحة.
			file_name: str = "sample.{0}.png".format(djvu_page.page_number)
			djvu_page.save(join(dir_, file_name), PngOptions())

This example shows how to load a DJVU image from a file stream to stay within the specified memory limit.

from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging import LoadOptions
from os.path import join

dir_: str = "c:\\temp"
# حمّل صورة DJVU من تدفق ملف.
with open(join(dir_, "sample.djvu"), "rb") as stream:
	# الحد الأقصى المسموح لحجم جميع المخازن الداخلية هو 1 ميغابايت.
	load_options = LoadOptions()
	load_options.buffer_size_hint = 1 * 1024 * 1024
	with DjvuImage(stream, load_options) as djvu_image:
		# حفظ كل صفحة كصورة PNG منفصلة.
		for djvu_page in djvu_image.pages:
			# أنشئ اسم ملف بناءً على رقم الصفحة.
			file_name: str = "sample.{0}.png".format(djvu_page.page_number)
			djvu_page.save(join(dir_, file_name), PngOptions())

This example loads a DJVU image, rotates it by 90 degrees clockwise and optionally flips the image horizontally and(or) vertically.

from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image, RotateFlipType
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
rotate_flip_types = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X, RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]
for rotate_flip_type in rotate_flip_types:
	# تدوير، انعكاس وحفظ إلى ملف الإخراج.
	with aspycore.as_of(Image.load(join(dir_, "sample.djvu")), DjvuImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

The following example crops a DJVU image. The cropping area is be specified via aspose.imaging.Rectangle.

from aspose.pycore import as_of
from aspose.imaging import Image, Rectangle
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions

with Image.load("sample.djvu") as image:
	djvuImage = as_of(image, DjvuImage)
	# قص الصورة. منطقة القص هي المنطقة المستطيلة المركزية للصورة.
	area = Rectangle(djvuImage.width // 4, djvuImage.height // 4, djvuImage.width // 2, djvuImage.height // 2)
	djvuImage.crop(area)
	# حفظ الصورة المقصوصة إلى PNG
	djvuImage.save("sample.Crop.png", PngOptions())

The following example binarizes a DJVU image with the predefined threshold. Binarized images contain only 2 colors - black and white.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.djvu")) as image:
	djvu_image = aspycore.as_of(image, DjvuImage)
	# حوّل الصورة إلى ثنائية باستخدام قيمة العتبة 127.
	# إذا كانت القيمة الرمادية المقابلة للبكسل أكبر من 127، سيتم تعيين القيمة 255 له، وإلا ستكون 0.
	djvu_image.binarize_fixed(127)
	djvu_image.save(join(dir_, "sample.BinarizeFixed.png"), PngOptions())

The following example binarizes a DJVU image with Bradley’s adaptive thresholding algorithm with the specified window size. Binarized images contain only 2 colors - black and white.

from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.djvu")) as image:
	djvu_image = aspycore.as_of(image, DjvuImage)
	# حوّل الصورة إلى ثنائية بفارق سطوع قدره 5. السطوع هو الفرق بين البكسل ومتوسط نافذة 10 × 10 بكسل متمركزة حول هذا البكسل.
	djvu_image.binarize_bradley(5, 10)
	djvu_image.save(join(dir_, "sample.BinarizeBradley5_10x10.png"), PngOptions())

The following example performs gamma-correction of a DJVU image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.djvu")) as image:
	djvu_image = aspycore.as_of(image, DjvuImage)
	# اضبط معامل غاما للقنوات الحمراء والخضراء والزرقاء.
	djvu_image.adjust_gamma(2.5)
	djvu_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs gamma-correction of a DJVU image applying different coefficients for color components.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.djvu")) as image:
	djvu_image = aspycore.as_of(image, DjvuImage)
	# اضبط معاملات غاما الفردية للقنوات الحمراء والخضراء والزرقاء.
	djvu_image.adjust_gamma(1.5, 2.5, 3.5)
	djvu_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs brightness correction of a DJVU image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.djvu")) as image:
	djvu_image = aspycore.as_of(image, DjvuImage)
	# اضبط قيمة السطوع. القيم المقبولة للسطوع تقع في النطاق [-255، 255].
	djvu_image.adjust_brightness(50)
	djvu_image.save(join(dir_, "sample.AdjustBrightness.png"), PngOptions())

The following example performs contrast correction of a DJVU image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.djvu import DjvuImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.djvu")) as image:
	djvu_image = aspycore.as_of(image, DjvuImage)
	# اضبط قيمة التباين. القيم المقبولة للتباين تقع في النطاق [-100f، 100f].
	djvu_image.adjust_contrast(50.0)
	djvu_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())