فئة WmfImage

Summary: Manipulate Microsoft Windows Metafile (WMF) images with our API, seamlessly
handling both vector and bitmap data stored within variable-length records.
Resize, rotate, and flip images with ease while setting custom image palettes.
Convert WMF files to compressed WMZ formats or save them in raster image formats
for versatile usage across platforms and applications.

Module: aspose.imaging.fileformats.wmf

Full Name: aspose.imaging.fileformats.wmf.WmfImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, MetaImage

Constructors

Nameالوصف
WmfImage()إنشاء نسخة جديدة من الفئة WmfImage ، مع تهيئتها لـ
المزيد من المعالجة والتعامل مع بيانات صورة ملف Windows (WMF). هذا
المُنشئ يوفر كائنًا أساسيًا للعمل مع صور WMF، مما يتيح
دمجًا سلسًا لقدرات معالجة صور WMF في وظائف تطبيقك.
WmfImage(width, height)إنشاء نسخة جديدة من الفئة WmfImage مع معلمات عرض وارتفاع قابلة للتخصيص، مما يسهل إنشاء صور WMF فارغة
مخصصة لأبعاد محددة. استخدم هذا المُنشئ لتوليد صور WMF بأبعاد دقيقة بشكل ديناميكي، مما يتيح إنشاء صور مرنًا و
معالجتها داخل تطبيقك.

Properties

NameTypeAccessالوصف
auto_adjust_paletteboolr/wيحصل أو يضبط قيمة تشير إلى ما إذا كان سيتم تعديل لوحة الألوان تلقائيًا.
background_colorColorr/wيحصل أو يضبط قيمة للون الخلفية.
bits_per_pixelintrاسترجاع عدد البتات لكل بكسل في الصورة، مما يشير إلى مستوى عمق اللون
أو الدقة. استخدم هذه الخاصية لتحديد تمثيل اللون في الصورة
ودقتها، مما يسهل فحص التوافق ومعالجة المتعلقة باللون
داخل تطبيقك.
boundsRectanglerيحصل على حدود الكائن.
buffer_size_hintintr/wيحصل أو يعيّن تلميح حجم المخزن المؤقت الذي يُعرف كأقصى حجم مسموح به لجميع المخازن الداخلية.
containerImagerيحصل على حاوية Image.
data_stream_containerStreamContainerrيحصل على تدفق بيانات الكائن.
تم التخلصboolrيحصل على قيمة تشير إلى ما إذا كانت هذه المثيلة تم التخلص منها.
exif_dataExifDatar/wيحصل أو يعيّن كائن Exif.
file_formatFileFormatrالوصول إلى قيمة تنسيق الملف المرتبط بالصورة، وتوفير معلومات
حول التنسيق الذي تُخزن به الصورة. استخدم هذه الخاصية لتحديد
تنسيق ملف الصورة، مما يسهل فحوصات التوافق و
المعالجة الخاصة بالتنسيق داخل تطبيقك.
frame_boundsRectanglerالوصول إلى حدود الإطار، موضحًا موقعه وأبعاده داخل
الصورة. استخدم هذه الخاصية لاسترجاع معلومات مفصلة عن موقع الإطار
المكاني، مما يتيح معالجة دقيقة وعرضًا داخل تطبيقك.
has_background_colorboolr/wيحصل أو يعيّن قيمة تشير إلى ما إذا كانت الصورة لديها لون خلفية.
heightintrيحصل على ارتفاع الكائن.
height_ffloatrالوصول إلى ارتفاع الصورة، ممثلاً عدد البكسلات على المحور العمودي
لها. استخدم هذه الخاصية لتحديد أبعاد الصورة المكانية ونسبة العرض إلى الارتفاع، مما يتيح تعديلًا دقيقًا للتخطيط والعرض داخل تطبيقك.
بوصةintr/wالوصول إلى خاصية البوصة أو تعديلها، ممثلةً وحدة قياس عادةً ما تُستخدم لتحديد الأبعاد الفيزيائية في الطباعة أو العرض. استخدم هذه
الخاصية لتعيين أو استرجاع قيم البوصة المرتبطة بالصورة،
مما يسهل تمثيلًا دقيقًا للأبعاد الفيزيائية داخل تطبيقك.
interrupt_monitorInterruptMonitorr/wيحصل أو يعيّن مراقب المقاطعة.
is_cachedboolrاسترجاع قيمة منطقية تشير إلى ما إذا كانت بيانات الكائن مخزنة مؤقتًا حاليًا،
مما يلغي الحاجة إلى عمليات قراءة بيانات إضافية. استخدم هذه الخاصية
لتحسين الأداء من خلال تحديد ما إذا كانت بيانات الكائن متاحة بسهولة
دون الحاجة إلى عمليات استرجاع مكلفة داخل تطبيقك.
metadataImageMetadatarيحصل على بيانات التعريف الخاصة بالصورة.
paletteIColorPaletter/wيحصل أو يضبط لوحة الألوان. لا تُستخدم لوحة الألوان عندما يتم تمثيل البكسلات مباشرةً.
recordsMetaObjectListr/wيحصل أو يعيّن السجلات.
sizeSizerيحصل على حجم الكائن.
size_fSizeFrيحصل على حجم الكائن، بالبوصة.
use_paletteboolrيحصل على قيمة تشير إلى ما إذا كانت لوحة ألوان الصورة مستخدمة.
widthintrيحصل على عرض الكائن.
width_ffloatrالوصول إلى عرض الصورة، موضحًا عدد البكسلات على المحور الأفقي لها. استخدم هذه الخاصية لتحديد أبعاد الصورة المكانية
ونسبة العرض إلى الارتفاع، مما يتيح تعديلًا دقيقًا للتخطيط والعرض داخل
تطبيقك.
xmp_dataXmpPacketWrapperr/wيحصل أو يضبط بيانات Xmp.

Methods

Nameالوصف
add_record(record)دمج كائن السجل المحدد في الصورة، مما يثري محتواها ببيانات أو بيانات وصفية إضافية. استخدم هذه الطريقة لدمج كائنات السجل
بسلاسة في الصورة، مما يسهل تخزين البيانات الشامل وتنظيمها
داخل تطبيقك.
cache_data()تخزين البيانات مؤقتًا بكفاءة، مما يلغي الحاجة إلى تحميل إضافي من
DataStreamSupporter.data_stream_container. استخدم هذه
الطريقة لتحسين الأداء وتقليل استهلاك الموارد داخل تطبيقك
عن طريق تخزين والوصول إلى ذاكرة التخزين المؤقت المحلي.
can_load(file_path)يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد.
can_load(file_path, load_options)يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد واستخدام خيارات الفتح المحددة اختياريًا.
can_load(stream)يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد.
can_load(stream, load_options)يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد واستخدام loadOptions المحددة اختياريًا.
can_load_stream(stream)يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد.
can_load_stream_with_options(stream, load_options)يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد واستخدام loadOptions المحددة اختياريًا.
can_load_with_options(file_path, load_options)يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد واستخدام خيارات الفتح المحددة اختياريًا.
can_save(options)يحدد ما إذا كان يمكن حفظ الصورة إلى تنسيق الملف المحدد الممثل بخيارات الحفظ الممررة.
create(files)ينشئ صورة متعددة الصفحات تحتوي على الملفات المحددة.
create(files, throw_exception_on_load_error)ينشئ صورة متعددة الصفحات تحتوي على الملفات المحددة.
create(image_options, width, height)ينشئ صورة جديدة باستخدام خيارات الإنشاء المحددة.
create(image_options, width, height, pixels)ينشئ مثيلًا من RasterImage من مصفوفة البكسل المقدمة.

يتحقق من أن العرض والارتفاع المحددين يتطابقان مع أبعاد بيانات البكسل.
لا يمكن استخدام هذه الطريقة إلا عندما تكون المكتبة في وضع الترخيص.
create(images)ينشئ صورة جديدة باستخدام الصور المحددة كصفحات
create(images, dispose_images)ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.
create(multipage_create_options)ينشئ خيارات الإنشاء المتعددة الصفحات المحددة.
create_from_files(files)ينشئ الصورة المتعددة الصفحات التي تحتوي على الملفات المحددة كصفحات تحميل كسول.
create_from_files(files, throw_exception_on_load_error)ينشئ الصورة المتعددة الصفحات التي تحتوي على الملفات المحددة كصفحات تحميل كسول.
create_from_images(images)ينشئ صورة جديدة باستخدام الصور المحددة كصفحات
create_from_images(images, dispose_images)ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.
crop(left_shift, right_shift, top_shift, bottom_shift)قص الصورة مع إزاحات.
crop(rectangle)يقص المستطيل المحدد.
get_default_options(args)يحصل على خيارات الصورة الافتراضية.
get_embedded_images()يحصل على الصور المضمنة.
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_missed_fonts()يعيد قائمة الخطوط التي تم استخدامها داخل ملف الميتا ولكن لم يتم العثور عليها.
get_original_options()يحصل على خيارات الصورة الأصلية.
get_post_script()الوصول إلى بيانات PostScript المرتبطة بالصورة، مع توفير معلومات مفصلة
حول هيكلها أو محتواها. استخدم هذه الطريقة لاسترجاع
بيانات PostScript لمزيد من التحليل أو المعالجة داخل تطبيقك،
مما يتيح وظائف متقدمة متعلقة بعرض أو تعديل PostScript.
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_used_fonts()استرجع قائمة الخطوط المستخدمة داخل ملف الميتا، مع توفير نظرة على
موارد الخط المستخدمة في الصورة. استخدم هذه الطريقة لتحليل استخدام الخطوط
وضمان توفر الخطوط للعرض أو المعالجة الإضافية داخل تطبيقك.
load(file_path)يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد.
إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط.
إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.
load(file_path, load_options)يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد.
إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط.
إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.
load(stream)يحمّل صورة جديدة من الدفق المحدد.
load(stream, load_options)يحمّل صورة جديدة من الدفق المحدد.
load_stream(stream)يحمّل صورة جديدة من الدفق المحدد.
load_stream_with_options(stream, load_options)يحمّل صورة جديدة من الدفق المحدد.
load_with_options(file_path, load_options)يحمّل صورة جديدة من مسار الملف أو عنوان URL المحدد.
إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط.
إذا كان filePath عنوان URL، فإن الطريقة تُنزّل الملف، تخزّنه مؤقتًا، وتفتحه.
remove_background()يزيل الخلفية.
remove_background(settings)يزيل الخلفية.
remove_metadata()يزيل البيانات الوصفية.
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_canvas(new_rectangle)غيّر حجم لوحة الرسم للصورة، مع تعديل أبعادها مع الحفاظ على محتوى الصورة
. استخدم هذه الطريقة لتعديل حجم اللوحة دون تغيير
المحتوى، مما يسهل تعديل التخطيط وتغييرات التركيب داخل
تطبيقك.
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_flip(rotate_flip_type)يدور، يقلب، أو يدور ويقلب الصورة.
save()يقوم بحفظ بيانات الصورة إلى الدفق الأساسي.
save(file_path)يقوم بحفظ الصورة إلى موقع الملف المحدد.
save(file_path, options)يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save(file_path, options, bounds_rectangle)يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save(file_path, over_write)يقوم بحفظ بيانات الكائن إلى موقع الملف المحدد.
save(stream)يحفظ البيانات إلى stream المحدد.
save(stream, options_base)يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
save(stream, options_base, bounds_rectangle)يقوم بحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق المحدد وفقاً لخيارات الحفظ.
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_palette(palette, update_colors)طبق لوحة ألوان محددة على الصورة، مما يتيح تخصيص تمثيل اللون
. استخدم هذه الطريقة لتحسين العرض البصري وتحقيق
تأثيرات لونية محددة داخل تطبيقك.
try_set_metadata(metadata)يحاول ضبط مثال metadata، إذا كان مثال هذا Image يدعم ويطبق مثال IImageMetadataFormat .

Constructor: WmfImage()

 WmfImage() 

إنشاء نسخة جديدة من الفئة WmfImage ، مع تهيئتها لـ
المزيد من المعالجة والتعامل مع بيانات صورة ملف Windows (WMF). هذا
المُنشئ يوفر كائنًا أساسيًا للعمل مع صور WMF، مما يتيح
دمجًا سلسًا لقدرات معالجة صور WMF في وظائف تطبيقك.

Constructor: WmfImage(width, height)

 WmfImage(width, height) 

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

Parameters:

معاملنوعالوصف
widthintالعرض.
heightintالارتفاع.

Method: add_record(record)

 add_record(record) 

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

Parameters:

معاملنوعالوصف
recordWmfObjectالسجل.

Returns

نوعالوصف
intعدد السجل.

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف.

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف.
load_optionsLoadOptionsخيارات التحميل.

Returns

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

Method: can_load(stream) [static]

 can_load(stream) 

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف.
load_optionsLoadOptionsخيارات التحميل.

Returns

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

Method: can_save(options)

 can_save(options) 

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

Parameters:

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

Returns

نوعالوصف
booltrue إذا كان يمكن حفظ الصورة إلى تنسيق الملف المحدد الممثل بخيارات الحفظ الممررة؛ وإلا، 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_errorboolإذا تم الضبط على true [إلقاء استثناء عند خطأ التحميل].

Returns

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

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

 create(image_options, width, height) 

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

Parameters:

معاملنوعالوصف
image_optionsImageOptionsBaseخيارات الصورة.
widthintالعرض.
heightintالارتفاع.

Returns

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

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

 create(image_options, width, height, pixels) 

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

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images) 

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

Parameters:

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

Returns

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

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

معاملنوعالوصف
imagesImage[]الصور.
dispose_imagesboolإذا تم الضبط على true [إزالة الصور].

Returns

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

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

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

Parameters:

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

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_errorboolإذا تم الضبط على true إلقاء استثناء عند خطأ التحميل.

Returns

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

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

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

Returns

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

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

معاملنوعالوصف
imagesImage[]الصور.
dispose_imagesboolإذا تم الضبط على true [إزالة الصور].

Returns

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

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

قص الصورة مع إزاحات.

Parameters:

معاملنوعالوصف
left_shiftintالإزاحة اليسرى.
right_shiftintالإزاحة اليمنى.
top_shiftintالإزاحة العلوية.
bottom_shiftintالإزاحة السفلية.

Method: crop(rectangle)

 crop(rectangle) 

يقص المستطيل المحدد.

Parameters:

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

Method: get_default_options(args)

 get_default_options(args) 

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

Parameters:

معاملنوعالوصف
argsSystem.Objectالمعلمات.

Returns

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

Method: get_embedded_images()

 get_embedded_images() 

يحصل على الصور المضمنة.

Returns

نوعالوصف
EmbeddedImage[]مصفوفة من الصور

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف.

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:

معاملنوعالوصف
rectangleRectangleالمستطيل للحصول على المستطيل المناسب.
البكسلاتint[]بكسلات ARGB 32-بت.
widthintعرض الكائن.
heightintارتفاع الكائن.

Returns

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

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

 get_fitting_rectangle(rectangle, width, height) 

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

Parameters:

معاملنوعالوصف
rectangleRectangleالمستطيل للحصول على المستطيل المناسب.
widthintعرض الكائن.
heightintارتفاع الكائن.

Returns

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

Method: get_missed_fonts()

 get_missed_fonts() 

يعيد قائمة الخطوط التي تم استخدامها داخل ملف الميتا ولكن لم يتم العثور عليها.

Returns

نوعالوصف
string[]قائمة الخطوط

Method: get_original_options()

 get_original_options() 

يحصل على خيارات الصورة الأصلية.

Returns

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

Method: get_post_script()

 get_post_script() 

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

Returns

نوعالوصف
stringالـ post script

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

 get_proportional_height(width, height, new_width) 

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

Parameters:

معاملنوعالوصف
widthintالعرض.
heightintالارتفاع.
new_widthintالعرض الجديد.

Returns

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

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

 get_proportional_width(width, height, new_height) 

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

Parameters:

معاملنوعالوصف
widthintالعرض.
heightintالارتفاع.
new_heightintالارتفاع الجديد.

Returns

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

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

يحوّل إلى aps.

Parameters:

معاملنوعالوصف
image_optionsImageOptionsBaseخيارات الصورة.
clipping_rectangleRectangleمستطيل القص.
page_numberint[]رقم الصفحة.

Returns

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

Method: get_used_fonts()

 get_used_fonts() 

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

Returns

نوعالوصف
string[]قائمة الخطوط

Method: load(file_path) [static]

 load(file_path) 

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

Parameters:

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

Returns

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

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف أو URL لتحميل الصورة منه.
load_optionsLoadOptionsخيارات التحميل.

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_optionsLoadOptionsخيارات التحميل.

Returns

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

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_optionsLoadOptionsخيارات التحميل.

Returns

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

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف أو URL لتحميل الصورة منه.
load_optionsLoadOptionsخيارات التحميل.

Returns

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

Method: remove_background(settings)

 remove_background(settings) 

يزيل الخلفية.

Parameters:

معاملنوعالوصف
settingsRemoveBackgroundSettingsالإعدادات.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

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

Parameters:

معاملنوعالوصف
new_widthintالعرض الجديد.
new_heightintالارتفاع الجديد.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

يعيد تحجيم العرض الجديد المحدد.

Parameters:

معاملنوعالوصف
new_widthintالعرض الجديد.
new_heightintالارتفاع الجديد.
resize_typeResizeTypeنوع التحجيم.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

يعيد تحجيم الصورة باستخدام خيارات موسعة.

Parameters:

معاملنوعالوصف
new_widthintالعرض الجديد.
new_heightintالارتفاع الجديد.
settingsImageResizeSettingsإعدادات التحجيم.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

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

Parameters:

معاملنوعالوصف
new_widthintالعرض الجديد.
new_heightintالارتفاع الجديد.
settingsImageResizeSettingsإعدادات التحجيم.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

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

Parameters:

معاملنوعالوصف
new_widthintالعرض الجديد.
new_heightintالارتفاع الجديد.
resize_typeResizeTypeنوع التحجيم.

Method: resize_canvas(new_rectangle)

 resize_canvas(new_rectangle) 

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

Parameters:

معاملنوعالوصف
new_rectangleRectangleالمستطيل الجديد.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

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

Parameters:

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

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

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

Parameters:

معاملنوعالوصف
new_heightintالارتفاع الجديد.
resize_typeResizeTypeنوع التحجيم.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

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

Parameters:

معاملنوعالوصف
new_heightintالارتفاع الجديد.
settingsImageResizeSettingsإعدادات تحجيم الصورة.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

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

Parameters:

معاملنوعالوصف
new_heightintالارتفاع الجديد.
settingsImageResizeSettingsإعدادات تحجيم الصورة.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

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

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

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

Parameters:

معاملنوعالوصف
new_widthintالعرض الجديد.
resize_typeResizeTypeنوع التحجيم.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

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

Parameters:

معاملنوعالوصف
new_widthintالعرض الجديد.
settingsImageResizeSettingsإعدادات تحجيم الصورة.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

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

Parameters:

معاملنوعالوصف
new_widthintالعرض الجديد.
settingsImageResizeSettingsإعدادات تحجيم الصورة.

Method: rotate(angle)

 rotate(angle) 

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

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

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

Parameters:

معاملنوعالوصف
rotate_flip_typeRotateFlipTypeنوع تدوير/قلب الصورة.

Method: save(file_path)

 save(file_path) 

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

Parameters:

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

Method: save(file_path, options)

 save(file_path, options) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف.
optionsImageOptionsBaseالخيارات.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف.
optionsImageOptionsBaseالخيارات.
bounds_rectangleRectangleمستطيل حدود الصورة الوجهة. اضبط المستطيل الفارغ لاستخدام حدود المصدر.

Method: save(file_path, over_write)

 save(file_path, over_write) 

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

Parameters:

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

Method: save(stream)

 save(stream) 

يحفظ البيانات إلى stream المحدد.

Parameters:

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

Method: save(stream, options_base)

 save(stream, options_base) 

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

Parameters:

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

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

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

Parameters:

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

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_baseImageOptionsBaseخيارات الحفظ.

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_baseImageOptionsBaseخيارات الحفظ.
bounds_rectangleRectangleمستطيل حدود الصورة الوجهة. اضبط المستطيل الفارغ لاستخدام حدود المصدر.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف.
optionsImageOptionsBaseالخيارات.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

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

Parameters:

معاملنوعالوصف
file_pathstringمسار الملف.
optionsImageOptionsBaseالخيارات.
bounds_rectangleRectangleمستطيل حدود الصورة الوجهة. اضبط المستطيل الفارغ لاستخدام حدود المصدر.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

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

Parameters:

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

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

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

Parameters:

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

Returns

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

Examples

This example shows how to load a WMF image from a file and convert it to SVG using WmfRasterizationOptions.


from aspose.pycore import as_of, cast
from aspose.imaging import Image, Color, SizeF
from aspose.imaging.fileformats.wmf import WmfImage, WmfRenderMode
from aspose.imaging.imageoptions import SvgOptions, WmfRasterizationOptions

# استخدام Aspose.Imaging.Image.Load هو طريقة موحدة لتحميل جميع أنواع الصور بما في ذلك WMF.
with as_of(Image.load("test.wmf") as image:
	saveOptions = SvgOptions()
	# سيتم تحويل النص إلى أشكال.
	saveOptions.text_as_shapes = True
	rasterizationOptions = WmfRasterizationOptions()
	# لون الخلفية لسطح الرسم.
	rasterizationOptions.background_color = Color.white_smoke
	# حجم الصفحة.
	rasterizationOptions.page_size = cast(SizeF, wmfImage.size)
	# إذا كان هناك emf مضمّن، فقم بعرض emf؛ وإلا عرض wmf.
	rasterizationOptions.render_mode = WmfRenderMode.AUTO
	saveOptions.vector_rasterization_options = rasterizationOptions
	wmfImage.save("test.output.svg", saveOptions)

The following example shows how to convert compressed images (.emz,.wmz, *.svgz) to a raster format

from aspose.imaging import Image, Color
from aspose.imaging.imageoptions import PngOptions, VectorRasterizationOptions
from os.path import join
from aspose.pycore import as_of

files = ["example.emz", "example.wmz", "example.svgz"]
base_folder: str = join("D:", "Compressed")
for file in files:
	input_file: str = join(base_folder, file)
	out_file: str = input_file + ".png"
	with Image.load(input_file) as image:
		vector_rasterization_options = aspycore.as_of(image.get_default_options([Color.white, image.width, image.height]), VectorRasterizationOptions)
		obj_init = PngOptions()
		obj_init.vector_rasterization_options = vector_rasterization_options
		image.save(out_file, obj_init)

The following example shows how to convert a wmz images to wmf fromat

import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import WmfRasterizationOptions, WmfOptions
from os.path import join

file: str = "example.wmz"
base_folder: str = join("D:", "Compressed")
input_file: str = join(base_folder, file)
out_file: str = input_file + ".wmf"
with Image.load(input_file) as image:
	obj_init = WmfRasterizationOptions()
	obj_init.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = WmfOptions()
	obj_init2.vector_rasterization_options = obj_init
	image.save(out_file, obj_init2)

The following example shows how to convert a wmf images to wmz format


from os.path import join as path_combine
import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import WmfRasterizationOptions, WmfOptions

file = "castle.wmf"
base_folder = path_combine("D:", "Compressed")
input_file = path_combine(base_folder, file)
out_file = input_file + ".wmz"
with Image.load(input_file) as image:
	vector_rasterization_options = WmfRasterizationOptions()
	vector_rasterization_options.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = WmfOptions()
	obj_init2.vector_rasterization_options = vector_rasterization_options
	obj_init2.compress = True
	image.save(out_file, obj_init2)