Features
Tính năng
Aspose.PSD FOSS cho Python tải, kiểm tra và lưu tài liệu PSD và PSB mà không render dữ liệu pixel. Bộ tính năng được tổ chức thành một số lĩnh vực, mỗi lĩnh vực được trình bày trong hướng dẫn riêng.
Tải tài liệu, Kiểm tra và Lưu
PsdImage.load() tải một tài liệu từ đường dẫn tệp hoặc luồng; PsdImage.save() ghi nó ra lại. PsdImage phô bày tiêu đề đã phân tích (width, height, color_mode, compression, và hơn nữa) và các tài nguyên hình ảnh đã phân tích. Xem Core API để tham khảo đầy đủ.
Các phần của tài liệu
Ngoài tiêu đề cấp cao nhất, PsdImage phô bày các bản tóm tắt chỉ đọc cho các phần dữ liệu màu và dữ liệu hình ảnh. Xem Sections đối với tham chiếu đầy đủ.
Siêu dữ liệu lớp
Mỗi đã phân tích Layer tiết lộ hình học, độ hiển thị, độ trong suốt, cắt và chế độ hòa trộn của nó, cùng với siêu dữ liệu kênh, mặt nạ và phạm vi hòa trộn. Một tập con các thuộc tính lớp có thể được thay đổi và lưu lại; bộ sưu tập lớp tự nó có thể được gán lại. Xem Layers đối với tham chiếu đầy đủ.
Tài nguyên hình ảnh
PsdImage tiết lộ các khối tài nguyên hình ảnh của tài liệu dưới hai dạng, cùng với một bản tóm tắt riêng cho các bảng màu chỉ mục. Xem Resources đối với tham chiếu đầy đủ.
Xử lý lỗi
Các lỗi tải và lưu được báo cáo qua PsdLoadException and PsdSaveException, cả hai đều mở rộng tiêu chuẩn Exception class. Xem Các ngoại lệ Core để xem tham chiếu đầy đủ.
Ghi lại tài liệu ra ngoài
PsdImage.save() là điểm vào công khai duy nhất để ghi tài liệu vào đường dẫn tệp hoặc luồng. Xem Mô tả ghi để xem tham chiếu đầy đủ.
Chuyển đổi byte thô
BigEndianBitConverter giải mã các số nguyên big-endian từ các byte thô mà bạn tự lấy — ví dụ, từ một tài nguyên hình ảnh không được nhận dạng. Xem Conversion để xem tham chiếu đầy đủ.
Những gì không được hỗ trợ
Thư viện này không hiển thị dữ liệu pixel và không chuyển đổi PSD/PSB sang các định dạng hình ảnh khác (như PNG hoặc JPEG). Nó là một trình đọc và ghi tập trung vào siêu dữ liệu cho định dạng container PSD/PSB.
Mẹo và Thực tiễn tốt nhất
- Bắt đầu với Core API để tải, kiểm tra và lưu tài liệu.
- Sử dụng Layers khi bạn cần đọc hoặc chỉnh sửa siêu dữ liệu lớp riêng lẻ.
- Wrap
load()/save()các cuộc gọi trong việc xử lý ngoại lệ được mô tả trong Core Exceptions.
Các vấn đề thường gặp
| Vấn đề | Nguyên nhân | Khắc phục |
|---|---|---|
| Mong đợi đầu ra pixel đã render | Thư viện này chỉ chứa siêu dữ liệu | Sử dụng thư viện khác để render; thư viện này chỉ tải, kiểm tra và lưu siêu dữ liệu PSD/PSB |
FAQ
Thư viện này có render hoặc chuyển đổi các tệp PSD không?
Không. Nó chỉ tải, kiểm tra và lưu các tài liệu PSD/PSB — nó không render dữ liệu pixel hoặc chuyển đổi sang các định dạng ảnh khác.
Tôi nên bắt đầu từ đâu?
Lõi API cho PsdImage điểm vào, sau đó Layers cho siêu dữ liệu mức lớp, và Core Exceptions để xử lý lỗi.
API Reference Tóm tắt
| Area | Bao gồm trong |
|---|---|
| Tải tài liệu, kiểm tra và lưu | Core API |
| Các phần của tài liệu (đầu trang, dữ liệu màu, dữ liệu hình ảnh) | Sections |
| Siêu dữ liệu lớp | Layers |
| Tài nguyên hình ảnh | Resources |
| Xử lý lỗi tải/lưu | Ngoại lệ lõi |
| Viết tài liệu | Ghi các mô tả |
| Chuyển đổi byte thô | Conversion |
