Features
คุณสมบัติ
Aspose.PSD FOSS สำหรับ Python โหลด, ตรวจสอบ, และบันทึกเอกสาร PSD และ PSB โดยไม่ต้องเรนเดอร์ข้อมูลพิกเซล ชุดคุณลักษณะถูกจัดเป็นหลายส่วน แต่ละส่วนมีคู่มือของตนเอง.
การโหลดเอกสาร, การตรวจสอบ, และการบันทึก
PsdImage.load() โหลดเอกสารจากเส้นทางไฟล์หรือสตรีม; PsdImage.save() เขียนมันออกมาใหม่. PsdImage เปิดเผยส่วนหัวที่แยกวิเคราะห์ (width, height, color_mode, compression, และอื่น ๆ) และทรัพยากรภาพที่แยกวิเคราะห์ ดู Core API สำหรับการอ้างอิงเต็มรูปแบบ.
ส่วนของเอกสาร
เหนือส่วนหัวระดับบนสุด, PsdImage เปิดเผยสรุปแบบอ่านอย่างเดียวสำหรับส่วนข้อมูลสีและส่วนข้อมูลภาพ ดู Sections สำหรับการอ้างอิงเต็มรูปแบบ.
เมทาดาต้าเลเยอร์
แต่ละที่ถูกวิเคราะห์ Layer เปิดเผยเรขาคณิต, การมองเห็น, ความทึบแสง, การคลิป, และโหมดผสม, รวมถึงข้อมูลเมตาแชนแนล, มาสก์, และช่วงการผสม. ชุดย่อยของคุณสมบัติของเลเยอร์สามารถเปลี่ยนแปลงและบันทึกกลับได้; คอลเลกชันของเลเยอร์เองสามารถกำหนดใหม่ได้. ดู Layers สำหรับการอ้างอิงเต็มรูปแบบ.
ทรัพยากรภาพ
PsdImage เปิดเผยบล็อกทรัพยากรภาพของเอกสารในสองรูปแบบ, พร้อมสรุปแยกต่างหากสำหรับพาเลตสีแบบจัดทำดัชนี. ดู Resources สำหรับการอ้างอิงเต็มรูปแบบ.
การจัดการข้อผิดพลาด
ข้อผิดพลาดในการโหลดและบันทึกจะถูกรายงานผ่าน PsdLoadException and PsdSaveException, ทั้งสองขยายมาตรฐาน Exception คลาส. ดู ข้อยกเว้นหลัก สำหรับการอ้างอิงเต็ม.
การเขียนเอกสารออกใหม่
PsdImage.save() เป็นจุดเข้าถึงสาธารณะเดียวสำหรับการเขียนเอกสารไปยังเส้นทางไฟล์หรือสตรีม. ดู เขียนตัวบรรยาย สำหรับการอ้างอิงเต็ม.
การแปลงไบต์ดิบ
BigEndianBitConverter ถอดรหัสจำนวนเต็มแบบ big-endian จากไบต์ดิบที่คุณได้มาด้วยตนเอง — ตัวอย่างเช่น จากทรัพยากรภาพที่ไม่รู้จัก. ดู Conversion สำหรับการอ้างอิงเต็ม.
สิ่งที่ไม่รองรับ
ไลบรารีนี้ไม่ได้เรนเดอร์ข้อมูลพิกเซลและไม่ได้แปลง PSD/PSB ไปเป็นรูปแบบภาพอื่น (เช่น PNG หรือ JPEG) มันเป็นตัวอ่านและเขียนที่มุ่งเน้นเมตาดาต้าสำหรับรูปแบบคอนเทนเนอร์ PSD/PSB.
เคล็ดลับและแนวปฏิบัติที่ดีที่สุด
- เริ่มต้นด้วย Core API สำหรับการโหลด, ตรวจสอบ, และบันทึกเอกสาร.
- ใช้ Layers เมื่อคุณต้องการอ่านหรือแก้ไขเมตาดาต้าของเลเยอร์แต่ละชั้น.
- Wrap
load()/save()การเรียกในส่วนการจัดการข้อยกเว้นที่อธิบายไว้ใน ข้อยกเว้นหลัก.
ปัญหาที่พบบ่อย
| ปัญหา | สาเหตุ | วิธีแก้ไข |
|---|---|---|
| คาดหวังผลลัพธ์พิกเซลที่เรนเดอร์ | ไลบรารีนี้เป็นแบบเมตาดาต้าเท่านั้น | ใช้ไลบรารีอื่นสำหรับการเรนเดอร์; ตัวนี้จะทำการโหลด ตรวจสอบ และบันทึก metadata PSD/PSB เท่านั้น |
FAQ
ไลบรารีนี้สามารถเรนเดอร์หรือแปลงไฟล์ PSD ได้หรือไม่?
ไม่. มันโหลด ตรวจสอบ และบันทึกเอกสาร PSD/PSB เท่านั้น — มันไม่ได้เรนเดอร์ข้อมูลพิกเซลหรือแปลงเป็นรูปแบบภาพอื่น.
ฉันควรเริ่มจากที่ไหน?
Core API สำหรับ PsdImage จุดเริ่มต้น, จากนั้น Layers สำหรับ metadata ระดับชั้น, และ Core Exceptions สำหรับการจัดการข้อผิดพลาด.
API Reference สรุป
| Area | ครอบคลุมใน |
|---|---|
| การโหลดเอกสาร, การตรวจสอบ, และการบันทึก | คอร์ API |
| ส่วนของเอกสาร (ส่วนหัว, ข้อมูลสี, ข้อมูลรูปภาพ) | Sections |
| เมตาดาต้าชั้น | Layers |
| ทรัพยากรภาพ | Resources |
| การจัดการข้อผิดพลาดในการโหลด/บันทึก | ข้อยกเว้นหลัก |
| การเขียนเอกสาร | เขียน Descriptors |
| การแปลงไบต์ดิบ | Conversion |
