Sections
Sections
Yüklenmiş bir PsdImage, bir PSD/PSB belgesinin yapısal bölümleri — başlık, renk veri bölümü, görüntü veri bölümü ve görüntü kaynakları bölümü — için yalnızca okunabilir özet nesneleri sunar; tüm bunlar tiplenmiş özellikler aracılığıyla, herhangi bir manuel bayt düzeyi ayrıştırma gerektirmeden sağlanır.
Başlık Bölümünü İnceleme
PsdImage.header, belgenin ham yapısal alanlarını içeren bir PsdHeader döndürür. PsdHeader.version, ham PSD konteyner sürümüdür (PSD için 1, PSB için 2) — bu, ilgili olmayan PsdImage.version adlı farklı bir özelliktir; bu özellik sabit bir API sürüm numarasıdır, dosya formatı değeri değildir.
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}")Renk Veri Bölümünü İnceleme
PsdImage.color_data_info, bir PsdColorDataInfo özeti döndürür; kind, bir PsdColorDataKind değeridir (NONE, INDEXED_PALETTE, RGB_PAYLOAD, CMYK_PAYLOAD veya 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}")Görüntü Veri Bölümünü İnceleme
PsdImage.image_data_info, birleştirilmiş piksel verisinin nasıl kodlandığını açıklayan bir PsdImageDataInfo özet döndürür; image.compression, aynı kodlamayı ayrı bir CompressionMethod enum aracılığıyla rapor eder.
data_info = image.image_data_info
print(f"Compression: {image.compression}, data kind: {data_info.kind}")
print(f"Uses prediction: {data_info.uses_prediction}")Görüntü Kaynakları Bölümünü İnceleme
PsdImage.resources, resource_count, ve has_image_resources görüntü kaynakları bölümünün içeriğini ortaya çıkar. Bkz Resources tam kaynaklar için API.
print(f"Resource count: {image.resource_count}")İpuçları ve En İyi Uygulamalar
PsdHeaderve ilgili bölüm özetleri (PsdColorDataInfo,ColorData,PsdImageDataInfo) bu FOSS yapısında yalnızca okunabilir — özelliklerinin hiçbiri için kamuya açık ayarlayıcı (setter) yoktur.PsdHeader.version‘ı (gerçek PSD/PSB konteyner sürümü)PsdImage.versionile (bağlantısız, her zaman6olan sabit bir API sürüm numarası) karıştırmayın.image.has_color_mode_data‘ıcolor_data_info‘i okumadan önce kontrol edin — renk modu verisi olmayan bir belge yine de bir özet nesnesi döndürür, ancak alanları anlamlı olmayabilir.
Yaygın Sorunlar
| Sorun | Neden | Düzeltme |
|---|---|---|
header.color_mode eşleşmiyor image.color_mode | PsdHeader.color_mode dosyadan gelen ham tamsayı alanıdır; PsdImage.color_mode ondan oluşturulan güçlü tipli ColorModes enumudur | Tiplenmiş bir değer için image.color_mode kullanın; yalnızca ham tam sayıya ihtiyacınız varsa header.color_mode kullanın. |
color_data_info.indexed_palette, None. | Belgenin renk veri türü INDEXED_PALETTE değil. | Yalnızca indeksli renkli belgeler bir palet içerir — önce color_data_info.kind‘ı kontrol edin. |
FAQ
Üstbilgiyi, renk verisini veya görüntü veri bölümlerini doğrudan değiştirebilir miyim?
Hayır — PsdHeader, PsdColorDataInfo, ColorData ve PsdImageDataInfo bu FOSS yapıdaki sadece okunabilir özet nesnelerdir.
image.compression ile image.image_data_info.kind arasındaki fark nedir?
Aynı temel kodlamayı iki ayrı enum aracılığıyla açıklarlar: image.compression bir CompressionMethod değeri döndürür, image.image_data_info.kind ise bir ImageDataKind değeri döndürür.
API Reference Özeti
| Sınıf/Yöntem | Açıklama |
|---|---|
PsdImage.header | Belge başlığı özeti (PsdHeader) |
PsdImage.color_data_info / parsed_color_data | Renk veri bölümü özeti (PsdColorDataInfo / ColorData) |
PsdImage.image_data_info / image_data_kind / compression | Görüntü veri bölümü özeti |
PsdImage.resources / resource_count / has_image_resources | Görüntü kaynakları bölümü özeti |