TgaImage Class

Summary: Manipulate TGA raster image files with our API, tailored for the TARGA
(Truevision Advanced Raster Adapter) format, enabling seamless loading and
customization. Easily update public properties such as author, timestamp,
image ID, and software version, while using various bits per pixel settings,
alpha channel and color transparency. Additionally, you can export TGA images
to other popular raster formats, ensuring compatibility for your projects.

Module: aspose.imaging.fileformats.tga

Full Name: aspose.imaging.fileformats.tga.TgaImage

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

Constructors

Name	الوصف
TgaImage(path)	يقوم بتهيئة كائن جديد من TgaImage باستخدام مسار الملف المقدم لـ تحميل محتوى الصورة. يقوم هذا المُنشئ بتهيئة نسخة الصورة بكفاءة مما يسمح بالوصول السلس إلى ملفات صور TGA، مبسطًا عملية التكامل في سير عمل تطبيقك.
TgaImage(raster_image)	إنشاء نسخة جديدة من فئة TgaImage عن طريق توفير كائن صورة نقطية . يسهّل هذا المُنشئ التكامل المباشر للصور النقطية الموجودة في تنسيق صورة TGA، مما يبسط عملية التحويل لتحقيق توافقية محسّنة داخل أنظمة البرمجيات الخاصة بك.
TgaImage(stream)	تهيئة نسخة جديدة من فئة TgaImage باستخدام تدفق لتحميل الصورة. يتيح هذا المُنشئ التكامل السلس لبيانات الصورة من التدفقات، مما يُسهل المعالجة الفعّالة للصور بصيغة TGA داخل تطبيقات البرمجيات الخاصة بك.

Properties

Name	Type	Access	الوصف
author_comments	string	r/w	يقوم باسترجاع أو تعيين التعليقات التي قدمها مؤلف الصورة. غالبًا ما تحتوي هذه التعليقات على معلومات قيّمة، مثل الأوصاف، التعليقات التوضيحية، أو سياق إضافي حول الصورة. من خلال الوصول إلى خاصية تعليقات المؤلف (Author Comments) أو تعديلها، يمكن للمطورين تحسين البيانات الوصفية المرتبطة بالصورة، وتزويد المستخدمين برؤى قيمة وسياق حول محتواها أو إنشائها. هذا حقل ASCII يتألف من 324 بايتًا مُنظمًا كأربع أسطر كل سطر يحتوي على 80 حرفًا، يتبع كل سطر مُنهيًا بصفر.
author_name	string	r/w	يقوم باسترجاع أو تعيين اسم المؤلف المرتبط بالصورة. تسمح هذه الخاصية للمطورين بالوصول إلى بيانات اسم المؤلف أو تعديلها، مما يوفر معلومات قيّمة حول صانع الصورة. باستخدام خاصية اسم المؤلف (Author Name)، يمكن للمستخدمين بسهولة التعرف على الفرد المسؤول عن إنشاء أو المساهمة في الصورة، مما يعزز البيانات الوصفية العامة لها ويقدم سياقًا قيمًا للمشاهدين. هذا الحقل يتألف من 40 حرفًا ASCII للاسم. إذا تم استخدام الحقل، يجب أن يحتوي على اسم الشخص الذي أنشأ الصورة (المؤلف).
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	يحصل أو يعيّن تلميح حجم المخزن المؤقت الذي يُعرف كأقصى حجم مسموح به لجميع المخازن الداخلية.
bytes_per_pixel	int	r	الحصول على قيمة البايتات لكل بكسل، التي تُظهر مقدار الذاكرة التي يشغلها كل بكسل في الصورة. تُعد هذه الخاصية مقياسًا مهمًا لإدارة الذاكرة وتحسينها، مما يساعد المطورين على تخصيص الموارد بكفاءة ومعالجة بيانات الصورة.
container	Image	r	يحصل على حاوية Image.
data_stream_container	StreamContainer	r	يحصل على تدفق بيانات الكائن.
date_time_stamp	System.Nullable`1[[System.DateTime]]	r/w	يقوم بالحصول على أو تعيين طابع التاريخ/الوقت. يحدد هذا الحقل قيمة التاريخ والوقت الذي تم حفظ الصورة فيه. على الرغم من أن أنظمة التشغيل عادةً ما تضيف طوابع زمنية وتاريخية للملفات، فإن هذه الميزة مُقدمة لأن نظام التشغيل قد يغيّر طابع الوقت والتاريخ إذا تم نسخ الملف. باستخدام هذه المنطقة، تضمن وجود منطقة غير معدلة لتسجيل التاريخ والوقت.
تم التخلص	bool	r	يحصل على قيمة تشير إلى ما إذا كانت هذه المثيلة تم التخلص منها.
exif_data	ExifData	r/w	يحصل أو يعيّن كائن Exif.
file_format	FileFormat	r	احصل على معلومات حيوية حول تنسيق ملف الصورة الممثلة بهذه النسخة من TgaImage. فهم تنسيق الملف أمر أساسي لـ فحص التوافق وضمان التكامل السلس داخل أنظمة البرمجيات، مما يتيح معالجة فعّالة وتعديل الصور.
gamma_value_denominator	int	r	يقوم باسترجاع الجزء المقام من قيمة جاما، وهو عامل أساسي في تحديد تمثيل الألوان داخل الصور. بالنسبة للصور التي تفتقر إلى تصحيح جاما، يجب أن تكون هذه القيمة 1.0، لضمان عرض ألوان دقيق. تقدير واستخدام هذه المعلمة أساسي للحفاظ على دقة الألوان وتحقيق تصور صورة دقيق.
gamma_value_numerator	int	r	يقوم بالحصول على الجزء البسط من قيمة الجاما، وهو ضروري لتمثيل ألوان دقيق في الصور. في الصور بدون تصحيح جاما، يجب أن تكون هذه القيمة 1.0. فهم واستخدام هذه القيمة أمر حاسم للحفاظ على دقة الألوان وضمان عرض صورة صحيح.
has_alpha	bool	r	استرجاع قيمة منطقية تشير إلى ما إذا كانت TgaImage تشمل قناة ألفا، مما يُسهل تأثيرات الشفافية. توفر هذه الخاصية معلومات أساسية لمعالجة تركيب الصورة وعرضها، وتساعد المطورين على تنفيذ تأثيرات بصرية متنوعة وعمليات تركيب.
has_background_color	bool	r/w	يقوم باسترجاع أو تعيين قيمة تشير إلى ما إذا كانت الصورة تحتوي على لون خلفية. هذه الخاصية مفيدة لتحديد ما إذا كانت الصورة تشمل لون خلفية مميز منفصل عن محتوى المقدمة. تمكّنك من تخصيص معالجة الصورة أو عرضها بناءً على وجود أو عدم وجود لون خلفية.
has_color_map	bool	r	استرجاع ما إذا كانت هذه النسخة من TgaImage تحتوي على خريطة ألوان. فهم وجود خريطة الألوان أمر حاسم للتفسير الدقيق ومعالجة بيانات ألوان الصورة.
has_transparent_color	bool	r/w	يقوم باسترجاع أو تعيين قيمة منطقية تشير إلى ما إذا كانت الصورة تحتوي على لون شفاف. هذه الخاصية أساسية لتحديد ما إذا كانت الصورة تدعم الشفافية، مما يساعدك على تنفيذ معالجة مناسبة للعمليات المتعلقة بالشفافية مثل الدمج، التركيب، أو القناع.
height	int	r	احصل على ارتفاع الصورة المغلفة بهذا TgaImage المثيل. توفر هذه الخاصية للمطورين تفاصيل حيوية حول الأبعاد الرأسية للصورة، مما يتيح دمجًا سلسًا ومعالجة الصور ضمن حلولهم البرمجية.
horizontal_resolution	float	r/w	يحصل أو يعيّن الدقة الأفقية، بوحدات البكسل لكل بوصة، لهذه RasterImage.
image_id	string	r/w	يحصل أو يعيّن المعرف الفريد المرتبط بالصورة. يعمل هذا المعرف كنقطة مرجعية لتحديد وتمييز الصورة عن غيرها داخل نظام أو تطبيق. من خلال تعيين أو استرجاع معرف الصورة، يمكنك إدارة وتتبع الصور بفعالية، مما يسهل عمليات إدارة واسترجاع الصور المنظمة. هذا الحقل الاختياري يحتوي على معلومات تعريفية حول الصورة. الحد الأقصى لطول هذا الحقل هو 255 بايت.
image_opacity	float	r	يحصل على شفافية هذه الصورة.
interrupt_monitor	InterruptMonitor	r/w	يحصل أو يعيّن مراقب المقاطعة.
is_cached	bool	r	يحصل على قيمة تشير إلى ما إذا كانت بيانات الصورة مخزنة مؤقتاً حالياً.
is_gray_scale	bool	r	احصل على قيمة منطقية تشير إلى ما إذا كان TgaImage يمثل صورة ذات تدرج رمادي. هذه الخاصية حاسمة للتمييز بين الصور الملونة وصور التدرج الرمادي، مما يساعد المطورين على تطبيق تقنيات المعالجة والعرض المناسبة بناءً على خصائص اللون في الصورة.
is_raw_data_available	bool	r	يحصل على قيمة تشير إلى ما إذا كان تحميل البيانات الخام مدعومًا.
job_name_or_id	string	r/w	يحصل أو يعيّن اسم المهمة أو المعرف المرتبط بالصورة. تتيح هذه الخاصية لك الوصول إلى بيانات التعريف المتعلقة بالمهمة أو المشروع المحدد المرتبط بالصورة أو تعديلها. باستخدام خاصية اسم/معرف المهمة، يمكن للمستخدمين بسهولة تحديد المشروع أو المهمة التي تتعلق بها الصورة، مما يسهل تنظيم وإدارة أصول الصورة ضمن سير عمل أو مشاريع أكبر.
job_time	System.Nullable`1[[System.TimeSpan]]	r/w	يحصل أو يعيّن الطابع الزمني الذي يشير إلى وقت المهمة المرتبط بالصورة. تتيح هذه الخاصية للمطورين الوصول إلى بيانات التعريف الزمنية المتعلقة بالمهمة أو المشروع المحدد المرتبط بالصورة أو تعديلها.
metadata	ImageMetadata	r	يحصل على بيانات التعريف الخاصة بالصورة.
palette	IColorPalette	r/w	يحصل أو يضبط لوحة الألوان. لا تُستخدم لوحة الألوان عندما يتم تمثيل البكسلات مباشرةً.
pixel_aspect_ratio_denominator	int	r	يحصل على الجزء المقام من نسبة أبعاد البكسل، وهو عامل حاسم في تحديد المظهر البصري للبكسلات داخل الصورة. هذه القيمة أساسية للحفاظ على تمثيل دقيق للبكسل ونسب الأبعاد عبر عمليات عرض ومعالجة الصور المختلفة، مما يضمن مخرجات بصرية عالية الجودة.
pixel_aspect_ratio_numerator	int	r	يحصل على الجزء البسط من نسبة أبعاد البكسل، الذي يؤثر على المظهر البصري للبكسلات داخل الصورة. فهم هذه القيمة وتعديلها أمر أساسي لتحقيق تمثيل دقيق للبكسل ونسب الأبعاد في عرض ومعالجة الصور.
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	يحصل على حجم الكائن.
software_id	string	r/w	يدير تعريف البرنامج (المعرف) المرتبط بالصورة، مع السماح بما يصل إلى 40 حرفًا ASCII. تُستخدم هذه الخاصية لتحديد البرنامج المستخدم في إنشاء أو معالجة الصورة بشكل فريد، وتوفر بيانات تعريفية قيمة لأغراض التنظيم والمعلومات.
software_version	string	r/w	يحصل أو يعيّن إصدار البرنامج المرتبط بالصورة. عادةً ما يكون طول سلسلة الإصدار المقبول من 3 إلى 4 أحرف. هذه الخاصية مفيدة لتتبع البرنامج المستخدم لإنشاء أو تعديل الصورة ويمكن أن توفر سياقًا قيمًا لمعالجة الصور وفحوصات التوافق.
software_version_letter	System.Char	r/w	يحصل أو يعيّن الحرف المكوّن لإصدار البرنامج المرتبط بالصورة. تمثل هذه الخاصية تفصيلًا إضافيًا داخل سلسلة إصدار البرنامج ويمكن أن تكون مفيدة للتمييز الدقيق بين الإصدارات.
software_version_number	int	r/w	يحصل أو يعيّن المكوّن الرقمي لإصدار البرنامج المرتبط بالصورة. تمثل هذه الخاصية الجزء الرقمي من سلسلة إصدار البرنامج، وتوفر معلومات هامة حول نسخة البرنامج المستخدمة لإنشاء أو تعديل الصورة.
transparent_color	Color	r/w	يحصل أو يعيّن اللون المفتاح المرتبط بالصورة. تتيح هذه الخاصية لك الوصول إلى اللون المحدد كلون مفتاح لمهام أو تأثيرات معالجة الصورة المحددة أو تعديلها. يتيح استخدام خاصية اللون المفتاح للمستخدمين تطبيق عمليات تعتمد على اللون مثل إزالة الخلفية (chroma key) أو استبدال اللون، مما يعزز قدرات تعديل الصورة وإمكانيات الإبداع. يمكن اعتبار اللون المفتاح كـ ‘لون الخلفية’ أو ‘اللون الشفاف’. هذا هو لون المنطقة ‘غير الصورة’ على الشاشة، وهو نفس اللون الذي ستُمسح إليه الشاشة إذا تم مسحها في التطبيق.
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	احصل على عرض الصورة التي يمثلها هذا TgaImage المثيل. توفر هذه الخاصية للمطورين معلومات أساسية حول أبعاد الصورة، مما يسهل مهام معالجة وتعديل الصور المختلفة ضمن تطبيقاتهم البرمجية.
x_origin	int	r/w	يحصل أو يضبط الإحداثي الأفقي المطلق للزاوية السفلية اليسرى للصورة كما يتم وضعها على جهاز عرض يكون أصله في الزاوية السفلية اليسرى لل الشاشة (مثال، سلسلة TARGA).
xmp_data	XmpPacketWrapper	r/w	يحصل أو يضبط بيانات Xmp.
y_origin	int	r/w	يحصل أو يضبط الإحداثي الرأسي المطلق للزاوية السفلية اليسرى للصورة كما يتم وضعها على جهاز عرض يكون أصله في الزاوية السفلية اليسرى لل الشاشة (مثال، سلسلة TARGA).

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)	يحدد ما إذا كان يمكن حفظ الصورة إلى تنسيق الملف المحدد الممثل بخيارات الحفظ الممررة.
clone()	ينتج نسخة مكررة من الكائن الحالي، مُنشئًا كائنًا جديدًا ينسخ جميع السمات والخصائص للنسخة الأصلية. تُسهل هذه الطريقة إنشاء نسخ مطابقة، مما يضمن سلامة البيانات ويحافظ على حالة الكائن الحالي دون التأثير على الكائن الأصلي.
clone(tga_image)	تكرار خصائص كائن TgaImage آخر، وإنشاء نسخة جديدة ذات سمات مطابقة. يضمن هذا الإجراء الحفاظ على سلامة البيانات ويسهل تكرار خصائص الصورة دون تعديل الكائن المصدر.
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)	يُهيئ نسخة جديدة من الفئة TgaImage.
create_from_images(images)	ينشئ صورة جديدة باستخدام الصور المحددة كصفحات
create_from_images(images, dispose_images)	ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.
create_from_stream(stream)	يُهيئ نسخة جديدة من الفئة TgaImage.
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()	يحصل على الخيارات بناءً على إعدادات الملف الأصلي. يمكن أن يكون ذلك مفيدًا للحفاظ على عمق البت وغيرها من معلمات الصورة الأصلية دون تغيير. على سبيل المثال، إذا قمنا بتحميل صورة PNG بالأبيض والأسود بعمق 1 بت لكل بكسل ثم حفظناها باستخدام طريقة DataStreamSupporter.save(file_path)، سيتم إنتاج صورة PNG ناتجة بعمق 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بعمق 1 بت لكل بكسل، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة ومررها إلى طريقة Image.save(file_path, options) كمعامل ثانٍ.
get_pixel(x, y)	يحصل على بكسل صورة.
get_proportional_height(width, height, new_width)	يحصل على ارتفاع نسبي.
get_proportional_width(width, height, new_height)	يحصل على عرض نسبي.
get_serialized_stream(image_options, clipping_rectangle, page_number)	يحوّل إلى aps.
get_skew_angle()	يحصل على زاوية الانحراف. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا، لتحديد زاوية الانحراف أثناء المسح.
grayscale()	تحويل الصورة إلى تمثيلها بتدرج الرمادي
is_digital_signed(password, percentage_threshold)	يُجري فحصًا سريعًا لتحديد ما إذا كانت الصورة موقعة رقمياً، باستخدام كلمة المرور والعتبة المقدمة.
load(file_path)	يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد. إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط. إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.
load(file_path, load_options)	يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد. إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط. إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.
load(stream)	يحمّل صورة جديدة من الدفق المحدد.
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 إلى 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)	تتيح طريقة “RotateFlip” إجراء عمليات الدوران والقلب على الصورة. فهي توفر وظائف متعددة لتعديل اتجاه الصورة، مما يسمح للمستخدمين بأداء الدورانات والقلب وفقًا لمتطلباتهم، مما يسهل مهام معالجة الصور بكفاءة داخل تطبيقات البرمجيات.
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: TgaImage(path)

 TgaImage(path) 

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

Parameters:

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

Constructor: TgaImage(raster_image)

 TgaImage(raster_image) 

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

Parameters:

معامل	نوع	الوصف
raster_image	RasterImage	الصورة النقطية.

See also:

Example # 1: Loading of the PNG image, conversion of it to the TgaImage and saving as a TG…

Constructor: TgaImage(stream)

 TgaImage(stream) 

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

Parameters:

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

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

 clone() 

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

Returns

نوع	الوصف
TgaImage	يرجع كائنًا جديدًا يكون نسخة من الكائن الحالي.

Method: clone(tga_image)

 clone(tga_image) 

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

Parameters:

معامل	نوع	الوصف
tga_image	TgaImage	أخرى TgaImage

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) 

يُهيئ نسخة جديدة من الفئة TgaImage.

Parameters:

معامل	نوع	الوصف
raster_image	RasterImage	الصورة النقطية.

Returns

نوع	الوصف
TgaImage

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) 

يُهيئ نسخة جديدة من الفئة TgaImage.

Parameters:

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

Returns

نوع	الوصف
TgaImage

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

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

Returns

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

Method: get_pixel(x, y)

 get_pixel(x, y) 

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

Parameters:

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

Returns

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

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

 get_proportional_height(width, height, new_width) 

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

Parameters:

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

Returns

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

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

 get_proportional_width(width, height, new_height) 

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

Parameters:

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

Returns

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

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

يحوّل إلى aps.

Parameters:

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

Returns

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

Method: get_skew_angle()

 get_skew_angle() 

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

Returns

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

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

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

Parameters:

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

Returns

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

Method: load(file_path) [static]

 load(file_path) 

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

Parameters:

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

Returns

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

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: load(stream) [static]

 load(stream) 

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

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 سيتغير حجم الصورة وفقًا لإسقاطات المستطيل المدور (نقاط الزوايا) في الحالة الأخرى يترك الأبعاد دون تغيير وتُدوَّر محتويات الصورة internal فقط.
background_color	Color	لون الخلفية.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

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

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

Saving of the JPG image as a TGA image.


from aspose.imaging import Image
from aspose.imaging.imageoptions import TgaOptions

with Image.load("test.jpg") as image:
	image.save("test.tga"", TgaOptions())
	

Loading of the PNG image, conversion of it to the TgaImage and saving as a TGA image.

from aspose.pycore import as_of
from aspose.imaging import Image, RasterImage
from aspose.imaging.fileformats.tga import TgaImage

with as_of(Image.load("test.png"), RasterImage) as image:
	with TgaImage(image) as tgaImage:
		tgaImage.save("test.tga")