Sections
Sections
Načtený PsdImage poskytuje objekty souhrnu jen pro čtení pro strukturační sekce PSD/PSB dokumentu — hlavičku, sekci dat barev, sekci dat obrázku a sekci zdrojů obrázku — vše prostřednictvím typovaných vlastností, aniž by vyžadoval ruční parsování na úrovni bajtů.
Prohlížení sekce hlavičky
PsdImage.header vrací PsdHeader s surovými strukturálními poli dokumentu. PsdHeader.version je surová verze kontejneru PSD (1 pro PSD, 2 pro PSB) — jedná se o jinou vlastnost než nesouvisející PsdImage.version, která je pevné číslo verze API, nikoli hodnota formátu souboru.
from aspose_psd_foss.psdimage import PsdImage
image = PsdImage.load(input_path)
header = image.header
print(f"Size: {header.width}x{header.height}, channels: {header.channels}")
print(f"Bit depth: {header.bit_depth}, raw container version: {header.version}")
print(f"Is PSB: {header.is_large_document}")Prohlížení sekce dat barev
PsdImage.color_data_info vrací souhrn PsdColorDataInfo; kind je hodnota PsdColorDataKind (NONE, INDEXED_PALETTE, RGB_PAYLOAD, CMYK_PAYLOAD nebo RAW_PRESERVED).
if image.has_color_mode_data:
color_info = image.color_data_info
print(f"Color data kind: {color_info.kind}, raw bytes: {color_info.raw_data_length}")Prohlížení sekce dat obrázku
PsdImage.image_data_info vrací PsdImageDataInfo souhrn popisující, jak jsou sloučená data pixelů kódována; image.compression hlásí stejné kódování pomocí samostatného výčtu CompressionMethod.
data_info = image.image_data_info
print(f"Compression: {image.compression}, data kind: {data_info.kind}")
print(f"Uses prediction: {data_info.uses_prediction}")Prohlížení sekce zdrojů obrázku
PsdImage.resources, resource_count, a has_image_resources zobrazit obsah sekce zdrojů obrázků. Viz Resources pro úplné zdroje API.
print(f"Resource count: {image.resource_count}")Tipy a osvědčené postupy
PsdHeadera související souhrny sekcí (PsdColorDataInfo,ColorData,PsdImageDataInfo) jsou v této FOSS verzi pouze pro čtení — neexistují žádné veřejné settery pro žádnou z jejich vlastností.- Nesmíste zaměnit
PsdHeader.version(skutečnou verzi kontejneru PSD/PSB) sPsdImage.version(nesouvisející, pevné číslo verze API, které je vždy6). - Zkontrolujte
image.has_color_mode_datapřed čtenímcolor_data_info— dokument bez dat o barevném režimu stále vrací objekt souhrnu, ale jeho pole nemusí být smysluplná.
Časté problémy
| Problém | Příčina | Oprava |
|---|---|---|
header.color_mode neodpovídá image.color_mode | PsdHeader.color_mode je surové celočíselné pole ze souboru; PsdImage.color_mode je silně typovaný výčtový typ ColorModes vytvořený z něj | Použijte image.color_mode pro typovanou hodnotu; použijte header.color_mode pouze pokud potřebujete surové celé číslo |
color_data_info.indexed_palette je None | Typ dat o barvě dokumentu není INDEXED_PALETTE | Pouze dokumenty s indexovanou barvou mají paletu — nejprve zkontrolujte color_data_info.kind |
FAQ
Mohu upravovat sekce hlavičky, dat barev nebo dat obrázku přímo?
Ne — PsdHeader, PsdColorDataInfo, ColorData a PsdImageDataInfo jsou všechny objekty souhrnu jen pro čtení v této FOSS verzi.
Jaký je rozdíl mezi image.compression a image.image_data_info.kind?
Popisují stejné základní kódování pomocí dvou samostatných výčtů: image.compression vrací hodnotu CompressionMethod, zatímco image.image_data_info.kind vrací hodnotu ImageDataKind.
API Reference Shrnutí
| Třída/Metoda | Popis: |
|---|---|
PsdImage.header | Souhrn hlavičky dokumentu (PsdHeader) |
PsdImage.color_data_info / parsed_color_data | Souhrn sekce dat o barvách (PsdColorDataInfo / ColorData) |
PsdImage.image_data_info / image_data_kind / compression | Souhrn sekce dat o obrazech |
PsdImage.resources / resource_count / has_image_resources | Souhrn sekce zdrojů obrázků |