اكتب المُوَصِّفات

كتابة الأوصاف

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

الحفظ إلى مسار ملف أو تدفق

from aspose_psd_foss.psdimage import PsdImage

image = PsdImage.load(input_path)
image.save("output.psd")

تمرير تدفق بدلاً من مسار يترك التدفق مفتوحًا بعد ذلك — أنت تتحكم متى تغلقه:

with open("output.psd", "wb") as stream:
    image.save(stream)

اختيار تنسيق الحاوية

لا يوجد API عام لاختيار تنسيق الحاوية الناتج عند الحفظ — عملية الحفظ دائمًا تعكس التنسيق الذي تم تحميل المستند به (is_large_document / is_psb). لا توجد مسار تحويل مدعوم بين PSD و PSB في هذا الإصدار المفتوح المصدر.

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

• استدعِ save قبل التخلص من الصورة — يؤدي save على PsdImage تم التخلص منه إلى إثارة RuntimeError.
• الكاتب الداخلي على مستوى القسم الذي يتم استدعاؤه بواسطة save ليس نقطة دخول موثقة أو مدعومة بمفرده؛ يجب دائمًا المرور عبر PsdImage.save.

المشكلات الشائعة

FAQ

هل يؤدي حفظ البيانات إلى تدفق إلى إغلاق التدفق لاحقًا؟

لا — تمرير تدفق إلى save يتركه مفتوحًا بعد ذلك بحيث تتحكم في دورة حياته. بالمقابل، حفظ إلى مسار ملف يفتح الملف ويغلقه داخليًا.

هل يمكنني إنشاء ملف PSB من مستند تم تحميله كـ PSD؟

لا — لا يوجد API عام لتجاوز تنسيق الحاوية عند الحفظ؛ فهو دائمًا يعكس تنسيق المستند المحمَّل نفسه.

API Reference ملخص

انظر أيضاً

• النواة API
• الاستثناءات الأساسية
• Aspose.PSD — Enterprise Documentation