الفئة BigTiffImage

Summary: With the BigTiffImage class you can effortlessly manipulate
BigTiff image format files. Our API offering seamless handling and customization
options, ensuring optimal processing of large-scale image data with versatile features
tailored to your specific requirements.

Module: aspose.imaging.fileformats.bigtiff

Full Name: aspose.imaging.fileformats.bigtiff.BigTiffImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IMultipageImage, IMultipageImageExt, TiffImage

Constructors

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

Properties

Name	Type	Access	الوصف
active_frame	TiffFrame	r/w	قم بإدارة الإطار النشط بسلاسة، مما يسهل التنقل الديناميكي و التلاعب داخل السياق المحدد. مكن تطبيقك من التفاعل بكفاءة مع محتوى الوسائط المتعددة، مما يعزز تفاعل المستخدم والإنتاجية.
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	يحصل أو يعيّن تلميح حجم المخزن المؤقت الذي يُعرف كأقصى حجم مسموح به لجميع المخازن الداخلية.
byte_order	TiffByteOrder	r/w	بدّل ترتيب البايت لملفات TIFF بسلاسة، مما يضمن تحكمًا دقيقًا في تفسير البيانات. مكن تطبيقاتك من المرونة للتكيف مع مواصفات الملفات المتنوعة، مما يعزز التوافق والكفاءة في معالجة البيانات.
container	Image	r	يحصل على حاوية Image.
data_stream_container	StreamContainer	r	يحصل على تدفق بيانات الكائن.
تم التخلص	bool	r	يحصل على قيمة تشير إلى ما إذا كانت هذه المثيلة تم التخلص منها.
exif_data	ExifData	r/w	يحصل أو يعيّن كائن Exif.
file_format	FileFormat	r	يحصل على تنسيق الملف لهذا المثيل من Image
frames	TiffFrame[]	r	استرجع مصفوفة من مثيلات TiffFrame، مما يتيح وصولًا شاملاً و تلاعبًا بالإطارات الفردية داخل صورة TIFF. استغل قوة هذه المصفوفة لتبسيط سير عمل معالجة الصور، مما يضمن تحكمًا دقيقًا وتحسين المحتوى البصري.
has_alpha	bool	r	حدد ما إذا كانت الصورة تحتوي على قناة ألفا، مما يوفر معلومات حاسمة للتصوير وعمليات التركيب. دمج هذه الميزة لتحسين سير عمل المعالجة البصرية، مما يضمن تمثيلًا دقيقًا وتلاعبًا بالعناصر الشفافة.
has_background_color	bool	r/w	يحصل أو يعيّن قيمة تشير إلى ما إذا كانت الصورة لديها لون خلفية.
has_transparent_color	bool	r/w	يحصل على قيمة تشير إلى ما إذا كانت الصورة لديها لون شفاف.
height	int	r	يحصل على ارتفاع الكائن.
horizontal_resolution	float	r/w	استرجع الدقة الأفقية للصورة المحددة Image بوحدات البكسل لكل بوصة، مما يسهل الضبط الدقيق وقدرات العرض. احصل على بيانات التعريف الأساسية للصورة بسهولة، مما يمكّن سير عمل معالجة الصور المبسط لتجارب مستخدم محسّنة.
image_opacity	float	r	يحصل على شفافية هذه الصورة.
interrupt_monitor	InterruptMonitor	r/w	يحصل أو يعيّن مراقب المقاطعة.
is_cached	bool	r	يحصل على قيمة تشير إلى ما إذا كانت بيانات الصورة مخزنة مؤقتاً حالياً.
is_raw_data_available	bool	r	يحصل على قيمة تشير إلى ما إذا كان تحميل البيانات الخام مدعومًا.
metadata	ImageMetadata	r	يحصل أو يعيّن بيانات XMP من الإطار.
page_count	int	r	استرجاع العدد الكلي للصفحات داخل المستند المحدد، مما يسهل التنقل الفعال وإدارة المحتوى متعدد الصفحات. دمج هذه الوظيفة لتعزيز تجربة المستخدم، وتمكين الوصول السلس إلى هياكل المستند الشاملة.
pages	Image[]	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	يحصل على حجم السطر الخام بالبايت.
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	الوصول إلى الدقة العمودية للصورة المحددة Image بوحدات البكسل لكل بوصة، مما يتيح ضبطًا دقيقًا وتحسينات في العرض. استخدم بيانات الصورة الأساسية بسهولة لتبسيط سير عمل معالجة الصور، مما يضمن جودة وأداءً فائقين في تطبيقاتك.
width	int	r	يحصل على عرض الكائن.
xmp_data	XmpPacketWrapper	r/w	يحصل أو يضبط بيانات Xmp.

Methods

Name	الوصف
add(image)	أضف الإطارات من الصورة المحددة بسلاسة إلى الإطار الحالي، موحدًا محتواها ومعززًا مرونة التركيب. دمج هذه الطريقة لتبسيط إدارة الإطارات وتلاعبها داخل تطبيقك، مما يسهل معالجة فعّالة للصور متعددة الإطارات.
add_frame(frame)	دمج الإطار المحدد بسلاسة في الصورة، موسعًا محتواها وتنوعها. استخدم هذه الطريقة لتعزيز تركيب الصورة وإدارتها، مما يمكّن من معالجة فعّالة للصور متعددة الإطارات داخل تطبيقك.
add_frames(frames)	دمج مصفوفة الإطارات بسلاسة في الصورة، مُغنيًا محتواها وتنوعها. استخدم هذه الطريقة لتعزيز تركيب الصورة وإدارتها، مما يتيح معالجة فعّالة للصور متعددة الإطارات داخل تطبيقك.
add_page(page)	قم بتوسيع صورة BigTiff الخاصة بك بسهولة بإضافة صفحة جديدة باستخدام هذه الطريقة البديهية. مثالي للمطورين الذين يسعون إلى تعزيز محتوى صورهم متعددة الصفحات ديناميكيًا.
adjust_brightness(brightness)	نفّذ تعديل السطوع للصورة، مما يسمح بتعديل مستويات الإضاءة العامة. دمج هذه الطريقة في سير عمل معالجة الصور الخاصة بك لتعزيز الرؤية وتحسين جودة الصورة البصرية للصور داخل تطبيقك.
adjust_contrast(contrast)	عزز التباين في مثيل Image ، مضخمًا الفروق بين المناطق الفاتحة والداكنة. دمج هذه الوظيفة لتحسين وضوح الصورة البصري والجودة العامة للصورة داخل تطبيقك.
adjust_gamma(gamma)	طبق تصحيح غاما على الصورة، مع تعديل شدة البكسلات لتحقيق توازن اللون المطلوب. دمج هذه الطريقة في سير عمل معالجة الصور الخاص بك لتعزيز جودة الصورة وتحسين دقة التحليل أو مهام العرض اللاحقة داخل تطبيقك.
adjust_gamma(gamma_red, gamma_green, gamma_blue)	قم بتطبيق تصحيح غاما على الصورة باستخدام معاملات فردية للقنوات الحمراء، الخضراء، والزرقاء، مما يسمح بتعديلات دقيقة لتوازن اللون والتباين. دمج هذه الطريقة في خط أنابيب معالجة الصور الخاص بك لتحقيق تحكم دقيق في عرض الألوان وتعزيز دقة الصورة داخل تطبيقك.
align_resolutions()	نفّذ طريقة المساعدة AlignResolutions لمزامنة الدقة الأفقية والعمودية، مما يضمن توحيد أبعاد الصورة. تُسهل هذه الوظيفة سير عمل معالجة الصور بسلاسة عن طريق توحيد معلمات الدقة، وتحسين جودة الصورة واتساقها عبر مختلف المنصات والأجهزة.
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)	طبق التثن binary على الصورة باستخدام عتبة محددة مسبقاً، محولاً إياها إلى صورة ثنائية ذات مناطق أمامية وخلفية متميزة. دمج هذه الطريقة في سير عمل معالجة الصور لتسهيل مهام التجزئة واستخراج الميزات، مما يعزز دقة وكفاءة تحليل الصورة داخل تطبيقك.
binarize_otsu()	استخدم عتبة أوتسو لإجراء التثن binary على الصورة، مع تحديد القيمة المثلى للعتبة تلقائياً بناءً على هيستوغرام الصورة. دمج هذه الطريقة في سير عمل معالجة الصور لتحقيق تجزئة فعّالة واستخراج ميزات، مما يعزز دقة وموثوقية تحليل الصورة داخل تطبيقك.
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)	ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.
create_with_frame(frame)	ينشئ مثيلاً جديداً من الفئة BigTiffImage.
create_with_frames(frames)	ينشئ مثيلاً جديداً من الفئة BigTiffImage.
crop(left_shift, right_shift, top_shift, bottom_shift)	قم بقص الصورة عن طريق تحديد إزاحات في الاتجاهات اليسرى، اليمنى، العليا، والسفلى. تتيح هذه الطريقة اختيار الجزء المطلوب من الصورة بدقة، مما يسهل إزالة المناطق غير المرغوبة والتركيز على المحتوى الأساسي. دمج هذه الوظيفة في خط أنابيب معالجة الصور لتعزيز الوضوح والتركيب حسب الحاجة داخل تطبيقك.
crop(rectangle)	قص الصورة باستخدام منطقة مستطيلة محددة، مما يتيح اختيار المحتوى المطلوب بدقة. دمج هذه الطريقة في سير عمل معالجة الصور لإزالة المناطق غير المرغوبة والتركيز على التفاصيل الأساسية، مما يعزز الوضوح والتركيب العام للصورة.
dither(dithering_method, bits_count)	يُجري تمويهًا على الصورة الحالية.
dither(dithering_method, bits_count, custom_palette)	نفّذ التدرج (dithering) على الصورة الحالية لتعزيز جودتها البصرية وتقليل آثار تدرج اللون. دمج هذه الطريقة في سير عمل معالجة الصور لضمان انتقالات ألوان أكثر سلاسة، مما ينتج مظهرًا بصريًا محسّنًا ووضوحًا أفضل للصورة.
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()	حوّل الصورة إلى تمثيلها الرمادي، محولاً إياها إلى صورة ذات قناة واحدة حيث يمثل كل بكسل شدة الإضاءة. دمج هذه الطريقة في خط أنابيب معالجة الصور لتبسيط التحليل وتعزيز التوافق مع الخوارزميات القائمة على التدرج الرمادي، مما يسهل مهام الرؤية الحاسوبية وتحليل الصور داخل تطبيقك.
insert_frame(index, frame)	أدرج الإطار الجديد في الفهرس المحدد داخل تسلسل الإطارات، مما يضمن تحكمًا دقيقًا في ترتيب الإطارات. استخدم هذه الطريقة لإدارة تسلسلات الإطارات بفعالية، مما يسهل التلاعب الديناميكي وتنظيم محتوى الصورة داخل تطبيقك.
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)	استخدم طريقة NormalizeAngle المصممة خصيصًا لمستندات النص الممسوحة ضوئياً لتصحيح الانحرافات، مما يضمن محاذاة دقيقة. دمج هذه الوظيفة بسلاسة في سير عمل معالجة النص لتحسين قابلية القراءة وجودة المستند، مما يعزز الكفاءة العامة في مهام التعرف على النص وتحليلها. تستخدم هذه الطريقة RasterImage.get_skew_angle() وTiffImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()	يُعَدِّل مدرج الصورة — يضبط قيم البكسل لاستخدام كامل النطاق المتاح.
read_argb_32_scan_line(scan_line_index)	يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.
read_scan_line(scan_line_index)	يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.
remove_frame(frame)	أزل الإطار المحدد بفعالية من تسلسل الصور، مما يسهل إدارة الإطارات بسلاسة داخل تطبيقك. دمج هذه الوظيفة لتعزيز الدقة والمرونة في التلاعب بالإطارات، وضمان تنظيم وعرض محتوى الصورة بسلاسة.
remove_frame(index)	يزيل الإطار وفقًا لموقعه.
remove_frame_by_index(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_frame(index, new_frame)	استبدل الإطار في الموضع المحدد بإطار آخر بسلاسة، مما يسهل إدارة الإطارات الديناميكية داخل تسلسل الصور. دمج هذه الطريقة لتعزيز المرونة والدقة في التلاعب بالإطارات، وضمان تنظيم وعرض محتوى الصورة بشكل أمثل داخل تطبيقك.
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)	قم بإجراء عملية تغيير حجم متناسبة على الصورة، مع الحفاظ على نسبة العرض إلى الارتفاع أثناء تعديل أبعادها. استخدم هذه الطريقة لتوسيع الصور ديناميكيًا داخل تطبيقك، مما يضمن تمثيلًا بصريًا متسقًا للمحتوى وسلامة التكامل. سيقوم تغيير الحجم المتناسب بتغيير حجم كل إطار وفقًا لنسبة newWidth/العرض و newHeight/الارتفاع.
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_proportional(new_width, new_height, resize_type)	قم بإجراء عملية تغيير حجم متناسبة على الصورة، مع الحفاظ على نسبة العرض إلى الارتفاع أثناء تعديل أبعادها. استخدم هذه الطريقة لتوسيع الصور ديناميكيًا داخل تطبيقك، مما يضمن تمثيلًا بصريًا متسقًا للمحتوى وسلامة التكامل. سيقوم تغيير الحجم المتناسب بتغيير حجم كل إطار وفقًا لنسبة newWidth/العرض و newHeight/الارتفاع.
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)	نفّذ دورانًا أو انعكاسًا أو مزيجًا من كلا العمليتين حصريًا على الإطار النشط. تتيح هذه الطريقة تعديلًا دقيقًا لإطارات فردية داخل تسلسل الصورة، مما يعزز المرونة في تحرير الصورة وتكوينها داخل تطبيقك.
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: BigTiffImage(frame)

 BigTiffImage(frame) 

أنشئ مثلاً جديدًا من الفئة BigTiffImage عن طريق تهيئته
باستخدام معامل TiffFrame. مثالي للمطورين الذين يبحثون عن طريقة مريحة
للعمل مع كائنات BigTiffImage، مما يضمن المرونة وسهولة التكامل
في مشاريعهم.

Parameters:

معامل	نوع	الوصف
frame	TiffFrame	إطار TIFF لبدء الصورة به.

Constructor: BigTiffImage(frames)

 BigTiffImage(frames) 

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

Parameters:

معامل	نوع	الوصف
frames	TiffFrame[]	الإطارات.

Method: add(image)

 add(image) 

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

Parameters:

معامل	نوع	الوصف
image	TiffImage	صورة المصدر.

Method: add_frame(frame)

 add_frame(frame) 

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

Parameters:

معامل	نوع	الوصف
frame	TiffFrame	الإطار للإضافة.

Method: add_frames(frames)

 add_frames(frames) 

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

Parameters:

معامل	نوع	الوصف
frames	TiffFrame[]	مصفوفة الإطارات للإضافة

Method: add_page(page)

 add_page(page) 

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

Parameters:

معامل	نوع	الوصف
page	RasterImage	الصفحة للإضافة.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

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

Parameters:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

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

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) 

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

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_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_with_frame(frame) [static]

 create_with_frame(frame) 

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

Parameters:

معامل	نوع	الوصف
frame	TiffFrame	إطار TIFF لبدء الصورة به.

Returns

نوع	الوصف
BigTiffImage	صورة BigTiffImage جديدة تتضمن الإطار.

Method: create_with_frames(frames) [static]

 create_with_frames(frames) 

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

Parameters:

معامل	نوع	الوصف
frames	TiffFrame[]	الإطارات.

Returns

نوع	الوصف
BigTiffImage

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) 

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

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: insert_frame(index, frame)

 insert_frame(index, frame) 

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

Parameters:

معامل	نوع	الوصف
index	int	فهرس frame.
frame	TiffFrame	الإطار للإدراج.

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) 

استخدم طريقة NormalizeAngle المصممة خصيصًا لمستندات النص الممسوحة ضوئياً لتصحيح الانحرافات، مما يضمن محاذاة دقيقة.
دمج هذه الوظيفة بسلاسة في سير عمل معالجة النص لتحسين قابلية القراءة وجودة المستند، مما يعزز الكفاءة العامة في مهام التعرف على النص وتحليلها.
تستخدم هذه الطريقة RasterImage.get_skew_angle() وTiffImage.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: remove_frame(frame)

 remove_frame(frame) 

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

Parameters:

معامل	نوع	الوصف
frame	TiffFrame	الإطار للإزالة.

Method: remove_frame(index)

 remove_frame(index) 

يزيل الإطار وفقًا لموقعه.

Parameters:

معامل	نوع	الوصف
index	int	فهرس الإطار الذي سيُزال.

Returns

نوع	الوصف
TiffFrame	الإطار المُزال.

Method: remove_frame_by_index(index)

 remove_frame_by_index(index) 

يزيل الإطار وفقًا لموقعه.

Parameters:

معامل	نوع	الوصف
index	int	فهرس الإطار الذي سيُزال.

Returns

نوع	الوصف
TiffFrame	الإطار المُزال.

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_frame(index, new_frame)

 replace_frame(index, new_frame) 

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

Parameters:

معامل	نوع	الوصف
index	int	موضع الإطار بدءًا من الصفر.
new_frame	TiffFrame	الإطار لاستبدال الإطار الموجود في index المحدد.

Returns

نوع	الوصف
TiffFrame	الإطار المُزال.

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) 

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

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_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

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

Parameters:

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

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: 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[]	البكسلات.

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[]	مصفوفة ألوان البكسل للكتابة.