Features
Funkce
Aspose.PSD FOSS pro Python načítá, inspektuje a ukládá PSD a PSB dokumenty bez vykreslování pixelových dat. Sada funkcí je organizována do několika oblastí, z nichž každá je pokryta ve svém vlastním průvodci.
Načítání, inspekce a ukládání dokumentu
PsdImage.load() načte dokument z cesty k souboru nebo proudu; PsdImage.save() zapíše jej zpět. PsdImage zveřejňuje analyzovanou hlavičku (width, height, color_mode, compression, a další) a analyzované zdroje obrázku. Viz Core API pro úplnou referenci.
Sekce dokumentu
Mimo hlavní hlavičku, PsdImage zveřejňuje jen pro čtení souhrny sekcí s daty barev a daty obrázku. Viz Sections pro úplnou referenci.
Metadata vrstvy
Každý parsovaný Layer zveřejňuje svou geometrii, viditelnost, neprůhlednost, ořez a režim prolnutí, plus metadata kanálu, masky a rozsahu prolnutí. Podmnožina vlastností vrstvy může být změněna a uložena zpět; samotná kolekce vrstev může být přeřazena. Viz Layers pro úplnou referenci.
Obrázkové zdroje
PsdImage zveřejňuje bloky obrazových zdrojů dokumentu ve dvou formách, plus samostatný souhrn pro indexované barevné palety. Viz Resources pro úplnou referenci.
Zpracování chyb
Selhání načítání a ukládání jsou hlášena prostřednictvím PsdLoadException and PsdSaveException, oba rozšiřují standardní Exception třídu. Viz Core Exceptions pro úplnou referenci.
Zápis dokumentů zpět
PsdImage.save() je jediným veřejným vstupním bodem pro zápis dokumentu do cesty souboru nebo proudu. Viz Zapsat popisovače pro úplnou referenci.
Konverze surových bajtů
BigEndianBitConverter dekóduje big-endian celá čísla z raw bajtů, které jste získali sami — například z neznámého obrazového zdroje. Viz Conversion pro úplnou referenci.
Co není podporováno
Tato knihovna nevykresluje pixelová data a nepřevádí PSD/PSB do jiných formátů obrázků (např. PNG nebo JPEG). Jedná se o čtečku a zapisovač zaměřený na metadata pro kontejnerový formát PSD/PSB.
Tipy a osvědčené postupy
- Začněte s Core API pro načítání, prohlížení a ukládání dokumentu.
- Použijte Layers jakmile potřebujete číst nebo upravovat metadata jednotlivých vrstev.
- Wrap
load()/save()volání v popisu zpracování výjimek. Základní výjimky.
Časté problémy
| Problém | Příčina | Oprava |
|---|---|---|
| Očekává se vykreslený pixelový výstup | Tato knihovna je pouze pro metadata | Použijte jinou knihovnu pro vykreslování; tato knihovna pouze načítá, prohlíží a ukládá metadata PSD/PSB |
FAQ
Vykresluje nebo převádí tato knihovna soubory PSD?
Ne. Načítá, kontroluje a ukládá pouze dokumenty PSD/PSB — neprovádí vykreslování pixelových dat ani převod do jiných formátů obrázků.
Kde mám začít?
Jádro API pro PsdImage vstupní bod, pak Layers pro metadata na úrovni vrstvy, a Základní výjimky pro zpracování chyb.
API Reference Shrnutí
| Area | Pokryto v |
|---|---|
| Načítání, inspekce a ukládání dokumentu | Jádro API |
| Sekce dokumentu (hlavička, barevná data, obrazová data) | Sections |
| Metadata vrstvy | Layers |
| Obrázkové zdroje | Resources |
| Zpracování chyb při načítání/ukládání | Základní výjimky |
| Psaní dokumentů | Zápis popisovačů |
| Převod surových bajtů | Conversion |
