Aspose.PSD FOSS
Python
Developer Guide
Sections

Sections

Sections

يُظهر PsdImage المُحمَّل كائنات ملخص للقراءة فقط لأقسام البنية في مستند PSD/PSB — الرأس، وقسم بيانات اللون، وقسم بيانات الصورة، وقسم موارد الصورة — جميعها عبر خصائص مُعرفة النوع، دون الحاجة إلى أي تحليل يدوي على مستوى البايت.

فحص قسم الرأس

PsdImage.header يُعيد PsdHeader يحتوي على الحقول الهيكلية الخام للمستند. PsdHeader.version هو إصدار حاوية PSD الخام (1 لـ PSD، 2 لـ PSB) — هذه خاصية مختلفة عن PsdImage.version غير المرتبطة، والتي هي رقم إصدار API ثابت، وليس قيمة تنسيق ملف.

from aspose_psd_foss.psdimage import PsdImage

image = PsdImage.load(input_path)
header = image.header

print(f"Size: {header.width}x{header.height}, channels: {header.channels}")
print(f"Bit depth: {header.bit_depth}, raw container version: {header.version}")
print(f"Is PSB: {header.is_large_document}")

فحص قسم بيانات اللون

PsdImage.color_data_info يُعيد ملخص PsdColorDataInfo؛ kind هو قيمة PsdColorDataKind (NONE، INDEXED_PALETTE، RGB_PAYLOAD، CMYK_PAYLOAD أو RAW_PRESERVED).

if image.has_color_mode_data:
    color_info = image.color_data_info
    print(f"Color data kind: {color_info.kind}, raw bytes: {color_info.raw_data_length}")

فحص قسم بيانات الصورة

PsdImage.image_data_info تُعيد ملخصًا PsdImageDataInfo يصف كيفية ترميز بيانات البكسل المدمجة؛ image.compression يُبلغ عن نفس الترميز عبر تعداد CompressionMethod منفصل.

data_info = image.image_data_info
print(f"Compression: {image.compression}, data kind: {data_info.kind}")
print(f"Uses prediction: {data_info.uses_prediction}")

فحص قسم موارد الصورة

PsdImage.resources, resource_count، و has_image_resources اعرض محتويات قسم موارد الصورة. انظر Resources للحصول على الموارد الكاملة API.

print(f"Resource count: {image.resource_count}")

نصائح وممارسات أفضل

  • PsdHeader وملخصات الأقسام المرتبطة به (PsdColorDataInfo، ColorData، PsdImageDataInfo) كلها للقراءة فقط في هذا الإصدار FOSS — لا توجد أي مُحددات عامة على أي من خصائصها.
  • لا تُخلط بين PsdHeader.version (الإصدار الحقيقي لحاوية PSD/PSB) وPsdImage.version (رقم إصدار API ثابت غير مرتبط دائمًا 6).
  • تحقق من image.has_color_mode_data قبل قراءة color_data_info — الوثيقة التي لا تحتوي على بيانات وضع اللون لا تزال تُعيد كائن ملخص، لكن حقوله قد لا تكون ذات معنى.

مشكلات شائعة

المشكلةالسببالإصلاح
header.color_mode لا يطابق image.color_modePsdHeader.color_mode هو الحقل العددي الخام من الملف؛ PsdImage.color_mode هو تعداد ColorModes المكتوب بنوع قوي المبني منهاستخدم image.color_mode للقيمة المكتوبة؛ استخدم header.color_mode فقط إذا كنت بحاجة إلى العدد الصحيح الخام
color_data_info.indexed_palette هو Noneنوع بيانات اللون في المستند ليس INDEXED_PALETTEفقط المستندات ذات اللون المفهرس تحوي لوحة ألوان — تحقق من color_data_info.kind أولاً

FAQ

هل يمكنني تعديل أقسام العنوان أو بيانات اللون أو بيانات الصورة مباشرةً؟

لا — PsdHeader، PsdColorDataInfo، ColorData وPsdImageDataInfo كلها كائنات ملخص للقراءة فقط في هذا الإصدار المفتوح المصدر.

ما الفرق بين image.compression وimage.image_data_info.kind؟

إنهما يصفان الترميز الأساسي نفسه من خلال تعدادين منفصلين: image.compression تُعيد قيمة CompressionMethod، بينما image.image_data_info.kind تُعيد قيمة ImageDataKind.

API Reference ملخص

فئة/طريقةوصف
PsdImage.headerملخص رأس المستند (PsdHeader)
PsdImage.color_data_info / parsed_color_dataملخص قسم بيانات اللون (PsdColorDataInfo / ColorData)
PsdImage.image_data_info / image_data_kind / compressionملخص قسم بيانات الصورة
PsdImage.resources / resource_count / has_image_resourcesملخص قسم موارد الصور

انظر أيضاً

 العربية