Features
Funkcje
Aspose.PSD FOSS dla Python ładuje, inspekcjonuje i zapisuje dokumenty PSD i PSB bez renderowania danych pikseli. Zestaw funkcji jest zorganizowany w kilku obszarach, z których każdy jest opisany w osobnym przewodniku.
Ładowanie, inspekcja i zapisywanie dokumentów
PsdImage.load() wczytuje dokument zścieżki pliku lub strumienia; PsdImage.save() zapisuje go zpowrotem. PsdImage udostępnia sparsowany nagłówek (width, height, color_mode, compression, iwięcej) oraz sparsowane zasoby obrazu. Zobacz Core API dla pełnej referencji.
Sekcje dokumentu
Poza nagłówkiem najwyższego poziomu, PsdImage udostępnia podsumowania tylko do odczytu dla sekcji danych kolorów i danych obrazu. Zobacz Sections dla pełnej referencji.
Metadane warstwy
Każdy przetworzony Layer udostępnia swoją geometrię, widoczność, krycie, przycinanie i tryb mieszania, a także metadane kanału, maski i zakresu mieszania. Podzbiór właściwości warstwy może być zmieniony i zapisany z powrotem; sama kolekcja warstw może być ponownie przypisana. Zobacz Layers dla pełnej referencji.
Zasoby obrazu
PsdImage udostępnia bloki zasobów obrazu dokumentu w dwóch formach, a także osobne podsumowanie palet kolorów indeksowanych. Zobacz Resources dla pełnej referencji.
Obsługa błędów
Błędy ładowania i zapisu są zgłaszane przez PsdLoadException and PsdSaveException, oba rozszerzające standard Exception klasa. Zobacz Podstawowe wyjątki dla pełnej dokumentacji.
Zapisywanie dokumentów na zewnątrz
PsdImage.save() jest jedynym publicznym punktem wejścia do zapisywania dokumentu w ścieżkę pliku lub strumień. Zobacz Deskryptory zapisu dla pełnej dokumentacji.
Konwersja surowych bajtów
BigEndianBitConverter dekoduje liczby całkowite w formacie big-endian z surowych bajtów, które sam uzyskałeś — na przykład z nierozpoznanego zasobu obrazu. Zobacz Conversion dla pełnej dokumentacji.
Co nie jest obsługiwane
Ta biblioteka nie renderuje danych pikselowych i nie konwertuje PSD/PSB na inne formaty obrazu (takie jak PNG lub JPEG). Jest to czytnik i zapisujący skoncentrowany na metadanych dla formatu kontenera PSD/PSB.
Wskazówki i najlepsze praktyki
- Zacznij od Rdzeń API do ładowania, przeglądania i zapisywania dokumentu.
- Użyj Layers gdy potrzebujesz odczytać lub edytować metadane poszczególnych warstw.
- Wrap
load()/save()wywołania w obsłudze wyjątków opisanej w Wyjątki Rdzenia.
Typowe problemy
| Problem | Przyczyna | Napraw |
|---|---|---|
| Oczekiwany wynik renderowanych pikseli | Ta biblioteka jest tylko metadanymi | Użyj innej biblioteki do renderowania; ta jedynie ładuje, przegląda i zapisuje metadane PSD/PSB |
FAQ
Czy ta biblioteka renderuje lub konwertuje pliki PSD?
Nie. Ładuje, przegląda i zapisuje wyłącznie dokumenty PSD/PSB — nie renderuje danych pikselowych ani nie konwertuje do innych formatów obrazów.
Gdzie zacząć?
Rdzeń API dla PsdImage punkt wejścia, potem Layers dla metadanych na poziomie warstwy, oraz Podstawowe wyjątki do obsługi błędów.
API Reference Podsumowanie
| Area | Omówiono w |
|---|---|
| Ładowanie, inspekcja i zapisywanie dokumentu | Podstawowy API |
| Sekcje dokumentu (nagłówek, dane kolorów, dane obrazu) | Sections |
| Metadane warstwy | Layers |
| Zasoby obrazu | Resources |
| Obsługa błędów przy ładowaniu/zapisywaniu | Podstawowe wyjątki |
| Tworzenie dokumentów | Zapisywanie deskryptorów |
| Konwersja surowych bajtów | Conversion |
