فئة JpegImage

Summary: Efficiently manipulate JPEG raster images with our API, offering support
for various color profiles such as RGB and CMYK, customizable bits per pixel
resolution, and processing of EXIF, JFIF, and XMP metadata containers.
Enjoy automated rotation based on orientation data and choose from different
compression levels, including lossless JPEG, to achieve optimal image quality
and file size balance for your projects.

Module: aspose.imaging.fileformats.jpeg

Full Name: aspose.imaging.fileformats.jpeg.JpegImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IHasJpegExifData, RasterCachedImage

Constructors

Name	الوصف
JpegImage(jpeg_options, width, height)	إنشاء كائن JpegImage جديد مع خيارات JPEG المقدمة. يتيح لك هذا المُنشئ تخصيص إعدادات مختلفة لصورة JPEG، مثل مستوى الضغط، الجودة، ومعلمات إضافية، مما يمنحك سيطرة دقيقة على تنسيق الصورة الناتج.
JpegImage(path)	تبدأ فئة JpegImage بسهولة عن طريق استدعاء مُنشئها مع معامل المسار المحدد. يتيح هذا المُنشئ إنشاء صور JPEG بسلاسة، مما يضمن دمجًا سريعًا في مشاريعك بسهولة.
JpegImage(raster_image)	إنشاء نسخة جديدة من فئة JpegImage باستخدام معامل صورة نقطية . يوفّر هذا المُنشئ طريقة مريحة لإنشاء صور JPEG مباشرةً من الصور النقطية، مما يُبسّط سير العمل عند التعامل مع صور JPEG في تطبيقاتك.
JpegImage(stream)	إنشاء كائن صورة JPEG باستخدام فئة JpegImage مع معامل تدفق . يُبسّط هذا المُنشئ عملية التعامل مع صور JPEG، موفرًا نهجًا مباشرًا لدمجها في مشاريعك بسهولة.
JpegImage(width, height)	إنشاء نسخة جديدة من فئة JpegImage باستخدام معلمات العرض والارتفاع المحددة. يتيح لك هذا المُنشئ إنشاء صور JPEG بأبعاد مخصصة، مما يمنحك مرونة في إدارة أحجام الصور في تطبيقك.

Properties

Name	Type	Access	الوصف
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	يحصل أو يعيّن تلميح حجم المخزن المؤقت الذي يُعرف كأقصى حجم مسموح به لجميع المخازن الداخلية.
cmyk_color_profile	StreamSource	r/w	ملف تعريف اللون CMYK المرتبط بصور JPEG بنوعي CMYK وYCCK يضمن تحويل لون دقيق وموثوقية. يعمل بالتنسيق مع RGBColorProfile لتأكيد تمثيل لون صحيح عبر مختلف الأجهزة والتطبيقات. هذا الزوج ضروري للحفاظ على اتساق عرض الألوان وتحقيق جودة صورة مثالية.
تعليق	string	r/w	إدارة تعليقات ملفات JPEG باستخدام هذه الخاصية، مما يتيح لك إضافة أو استرجاع تعليقات وصفية مرتبطة بالصورة. سواء كان ذلك بوضع وسوم على الصور مع البيانات الوصفية أو إلحاق سياق إضافي، توفر هذه الخاصية مرونة في تنظيم وتصنيف ملفات JPEG الخاصة بك.
container	Image	r	يحصل على حاوية Image.
data_stream_container	StreamContainer	r	يحصل على تدفق بيانات الكائن.
destination_cmyk_color_profile	StreamSource	r/w	ملف تعريف اللون CMYK ضروري للتحويل الدقيق للألوان في صور JPEG بنوعي CMYK وYCCK أثناء عملية الحفظ. يعمل بالتوازي مع RGBColorProfile لضمان تمثيل لون صحيح، محافظًا على الاتساق والجودة عبر مختلف الأجهزة والبرمجيات. هذه المزامنة أساسية لتحقيق عرض لون دقيق وموثوق في الصور المحفوظة نهائيًا.
destination_rgb_color_profile	StreamSource	r/w	ملف تعريف اللون RGBColorProfile أساسي للتحويل الدقيق للألوان في صور JPEG بنوعي CMYK وYCCK أثناء عملية الحفظ. عند اقترانه بملف تعريف اللون CMYKColorProfile، يضمن أن الألوان تُعرض بشكل صحيح ويحافظ على الاتساق عبر مختلف الأجهزة والتطبيقات. هذا الجمع ضروري للحفاظ على تمثيل اللون المقصود وتحقيق مخرجات صورة عالية الجودة.
تم التخلص	bool	r	يحصل على قيمة تشير إلى ما إذا كانت هذه المثيلة تم التخلص منها.
exif_data	JpegExifData	r/w	إدارة بيانات EXIF باستخدام هذه الخاصية، مما يتيح لك إضافة أو استرجاع البيانات الوصفية المرتبطة بالصورة. سواء كان ذلك باستخراج معلومات حول إعدادات الكاميرا أو تعديل البيانات الوصفية الحالية، توفر هذه الخاصية مرونة في إدارة حاوية بيانات EXIF.
file_format	FileFormat	r	استرجع تنسيق الصورة بسهولة باستخدام هذه الخاصية. فهي توفر نظرة قيمة على تنسيق الملف، مما يساعد في دمج سلس وفحوصات توافق عبر مختلف المنصات والتطبيقات.
has_alpha	bool	r	يحصل على قيمة تشير إلى ما إذا كان هذا المثيل يحتوي على قناة ألفا.
has_background_color	bool	r/w	يحصل أو يعيّن قيمة تشير إلى ما إذا كانت الصورة لديها لون خلفية.
has_transparent_color	bool	r/w	يحصل أو يضبط قيمة تشير إلى ما إذا كان هذا المثيل RasterImage يحتوي على لون شفاف.
height	int	r	استرجع ارتفاع الصورة بسهولة باستخدام هذه الخاصية. فهي توفر وصولًا سريعًا إلى البُعد العمودي للصورة، مما يتيح لك تحديد حجمها ونسبة أبعادها بكفاءة دون الحاجة إلى حسابات معقدة أو طرق إضافية.
horizontal_resolution	float	r/w	هذه الخاصية تمنحك الوصول إلى الدقة الأفقية لـ RasterImage، المقاسة بالبكسل لكل بوصة. عن طريق تعيين أو استرجاع هذه القيمة، يمكنك التحكم بدقة في دقة الصورة، مما يضمن أنها تلبي متطلباتك المحددة للجودة والوضوح.
ignore_embedded_color_profile	bool	r/w	يسترجع أو يعدل العلامة التي تشير إلى ما إذا كان ملف تعريف اللون المدمج يتم تجاهله. عن طريق تعيين هذه العلامة، يمكن للمستخدمين تحديد ما إذا كان يجب استخدام ملف تعريف اللون الافتراضي بدلاً من المدمج. يضمن هذا الخيار تحكمًا أكبر في إدارة الألوان، مما يسهل التعديلات لتحقيق التناسق و التوافق عبر مختلف المنصات والتطبيقات.
image_opacity	float	r	يحصل على شفافية هذه الصورة.
interrupt_monitor	InterruptMonitor	r/w	يحصل أو يعيّن مراقب المقاطعة.
is_cached	bool	r	يحصل على قيمة تشير إلى ما إذا كانت بيانات الصورة مخزنة مؤقتاً حالياً.
is_raw_data_available	bool	r	يحصل على قيمة تشير إلى ما إذا كان تحميل البيانات الخام مدعومًا.
jfif	JFIFData	r/w	تتيح لك هذه الخاصية الوصول إلى بيانات JFIF (JPEG File Interchange Format) المرتبطة بصورة JPEG أو تعديلها. JFIF هو تنسيق قياسي لـ تبادل الصور المضغوطة بصيغة JPEG بين الحواسيب والأجهزة الأخرى. عن طريق استرجاع أو تعيين هذه الخاصية، يمكنك التفاعل مع بيانات JFIF، والتي قد تشمل معلومات مثل دقة الصورة، نسبة العرض إلى الارتفاع، والصورة المصغرة.
jpeg_options	JpegOptions	r	احصل على الوصول إلى خيارات JPEG المستخدمة أثناء إنشاء أو تحميل هذه JpegImage بسهولة. توفر هذه الخاصية تفاصيل قيمة حول الإعدادات المحددة المستخدمة، مما يمكّن المستخدمين من فهم وتكرار سير عمل معالجة الصور بفعالية. سواء كانت مستويات الضغط، إعدادات الجودة أو معلمات أخرى، توفر هذه الخاصية رؤى أساسية لـ تعديل الصور بسلاسة.
metadata	ImageMetadata	r	يحصل على بيانات التعريف الخاصة بالصورة.
palette	IColorPalette	r/w	يحصل أو يضبط لوحة الألوان. لا تُستخدم لوحة الألوان عندما يتم تمثيل البكسلات مباشرةً.
premultiply_components	bool	r/w	يحصل أو يضبط قيمة تشير إلى ما إذا كان يجب ضرب مكونات الصورة مسبقًا.
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	يحصل على حجم السطر الخام بالبايت.
rgb_color_profile	StreamSource	r/w	ملف تعريف اللون RGB لصور JPEG بصيغة CMYK وYCCK يضمن تحويلًا دقيقًا للون وتمثيله. يجب إقرانه بـ CMYKColorProfile للحفاظ على التناسق والدقة في عرض اللون. هذا الاقتران ضروري للتطبيقات التي تتطلب إدارة لون دقيقة وإعادة إنتاج الصور، مما يضمن تفسير وعرض بيانات RGB بشكل صحيح.
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)	تباين الصورة
adjust_gamma(gamma)	تصحيح جاما لصورة.
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)	تحويل الصورة إلى ثنائية باستخدام خوارزمية العتبة التكيفية لبرايدلي باستخدام عتبة الصورة المتكاملة
binarize_fixed(threshold)	تحويل الصورة إلى ثنائية باستخدام عتبة محددة مسبقًا
binarize_otsu()	تحويل الصورة إلى ثنائية باستخدام عتبة Otsu
blend(origin, overlay, overlay_alpha)	يمزج هذه النسخة من الصورة مع الصورة overlay.
blend(origin, overlay, overlay_area, overlay_alpha)	يمزج هذه النسخة من الصورة مع الصورة overlay.
cache_data()	يقوم بتخزين البيانات مؤقتًا ويضمن عدم تحميل أي بيانات إضافية من DataStreamSupporter.data_stream_container.
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_image(raster_image)	يُنشئ مثيلًا جديدًا من الفئة JpegImage.
create_from_images(images)	ينشئ صورة جديدة باستخدام الصور المحددة كصفحات
create_from_images(images, dispose_images)	ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.
create_from_stream(stream)	يُنشئ مثيلًا جديدًا من الفئة JpegImage.
crop(left_shift, right_shift, top_shift, bottom_shift)	قص الصورة مع إزاحات.
crop(rectangle)	قص الصورة.
dither(dithering_method, bits_count)	يُجري تمويهًا على الصورة الحالية.
dither(dithering_method, bits_count, custom_palette)	يُجري تمويهًا على الصورة الحالية.
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()	يحصل على خيارات الصورة الأصلية لهذا المثيل Image.
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)	يحمّل صورة جديدة من الدفق المحدد.
load(stream, load_options)	يحمّل صورة جديدة من الدفق المحدد.
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_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() و RasterImage.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 و IHasExifData.exif_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(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)	يقوم بتغيير ارتفاع الصورة بنسبة متناسبة.
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)	يقوم بتغيير عرض الصورة بنسبة متناسبة.
resize_width_proportionally(new_width, settings)	يقوم بتغيير عرض الصورة بنسبة متناسبة.
resize_width_proportionally_settings(new_width, settings)	يقوم بتغيير عرض الصورة بنسبة متناسبة.
rotate(angle)	تدوير الصورة حول المركز.
rotate(angle, resize_proportionally, background_color)	تدوير الصورة حول المركز.
rotate_flip(rotate_flip_type)	يدور، يقلب، أو يدور ويقلب الصورة.
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: JpegImage(jpeg_options, width, height)

 JpegImage(jpeg_options, width, height) 

إنشاء كائن JpegImage جديد مع خيارات JPEG المقدمة.
يتيح لك هذا المُنشئ تخصيص إعدادات مختلفة لصورة JPEG، مثل
مستوى الضغط، الجودة، ومعلمات إضافية، مما يمنحك سيطرة دقيقة
على تنسيق الصورة الناتج.

Parameters:

معامل	نوع	الوصف
jpeg_options	JpegOptions	خيارات JPEG.
width	int	عرض الصورة.
height	int	ارتفاع الصورة.

Constructor: JpegImage(path)

 JpegImage(path) 

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

Parameters:

معامل	نوع	الوصف
المسار	string	المسار لتحميل الصورة منه وتهيئة بيانات البكسل ولوحة الألوان.

See also:

Example # 1: The example shows how to load a JpegImage from a file.

Constructor: JpegImage(raster_image)

 JpegImage(raster_image) 

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

Parameters:

معامل	نوع	الوصف
raster_image	RasterImage	الصورة لتهيئة بيانات البكسل ولوحة الألوان معها.

See also:

Example # 1: The example shows how to load a JpegImage from another RasterImage.

Constructor: JpegImage(stream)

 JpegImage(stream) 

إنشاء كائن صورة JPEG باستخدام فئة JpegImage مع معامل تدفق
. يُبسّط هذا المُنشئ عملية التعامل مع صور JPEG، موفرًا نهجًا مباشرًا لدمجها في مشاريعك بسهولة.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	دفق التحميل للصور منه وتهيئة بيانات البكسل ولوحة الألوان.

Constructor: JpegImage(width, height)

 JpegImage(width, height) 

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

Parameters:

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

See also:

Example # 1: The following example shows how to create JPEG image of the specified size.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

ضبط سطوع الصورة.

Parameters:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

تباين الصورة

Parameters:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

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

Parameters:

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

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	معامل جاما للقناة الزرقاء

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) 

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

Parameters:

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

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

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

Parameters:

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

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_image(raster_image) [static]

 create_from_image(raster_image) 

يُنشئ مثيلًا جديدًا من الفئة JpegImage.

Parameters:

معامل	نوع	الوصف
raster_image	RasterImage	الصورة لتهيئة بيانات البكسل ولوحة الألوان معها.

Returns

نوع	الوصف
JpegImage

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: create_from_stream(stream) [static]

 create_from_stream(stream) 

يُنشئ مثيلًا جديدًا من الفئة JpegImage.

Parameters:

معامل	نوع	الوصف
دفق	_io.BufferedRandom	دفق التحميل للصور منه وتهيئة بيانات البكسل ولوحة الألوان.

Returns

نوع	الوصف
JpegImage

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) 

قص الصورة.

Parameters:

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

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) 

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

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() 

يحصل على خيارات الصورة الأصلية لهذا المثيل Image.

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) 

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

Parameters:

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

Returns

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

Method: load(stream, load_options) [static]

 load(stream, load_options) 

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

Parameters:

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

Returns

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

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_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() و RasterImage.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) 

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

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) 

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

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) 

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

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) 

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

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

يدور، يقلب، أو يدور ويقلب الصورة.

Parameters:

معامل	نوع	الوصف
rotate_flip_type	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

The example shows how to load a JpegImage from a file.

from aspose.imaging.fileformats.jpeg import JpegImage

# تحميل صورة JPEG من ملف.
with JpegImage("sample.jpg") as jpegImage:
	# إجراء بعض معالجة الصور.
	# احفظ إلى ملف JPEG آخر.
	jpegImage.save("sample.output.jpg")

The example shows how to load a JpegImage from another RasterImage.

import aspose.pycore as aspycore
from aspose.imaging import Image, Graphics, Color, RasterImage
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.jpeg import JpegImage
from os.path import join as path_join


dir_ = "c:\\temp"
# حمّل صورة JPEG من صورة نقطية أخرى.
# أولاً، أنشئ صورة PNG مؤقتة ستكون أساسًا لإنشاء صورة JPEG.
# يمكنك أيضًا تحميل صورة PNG من ملف أو استخدام صورة بأي تنسيق نقطي آخر.
with PngOptions() as create_options:
	with aspycore.as_of(Image.create(create_options, 100, 100), RasterImage) as raster_image:
		# املأ صورة PNG بالكامل باللون الأحمر.
		graphics = Graphics(raster_image)
		brush = SolidBrush(Color.red)
		graphics.fill_rectangle(brush, raster_image.bounds)
		# أنشئ صورة JPEG بناءً على صورة PNG.
		with JpegImage(raster_image) as jpeg_image:
			# احفظ إلى ملف JPEG
			jpeg_image.save(path_join(dir_, "output.jpg"))

The following example shows how to create JPEG image of the specified size.

from aspose.imaging.fileformats.jpeg import JpegImage

# أنشئ صورة JPEG بحجم 100×100 بكسل.
with JpegImage(100, 100) as jpegImage:
	# إجراء بعض معالجة الصور.
	# احفظ إلى ملف.
	jpegImage.save("output.jpg")

Access camera manufacturer maker notes in Jpeg image.

from aspose.pycore import as_of
from aspose.imaging import Image
from aspose.imaging.fileformats.jpeg import JpegImage

with as_of(Image.load("Sample.jpg"), JpegImage) as image:
	for makerNote in image.exif_data.maker_notes:
		print(f"Name = {makerNote.name}, Value = {makerNote.value}")