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

  • PsdHeader ve 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.version ile (bağlantısız, her zaman 6 olan 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

SorunNedenDüzeltme
header.color_mode eşleşmiyor image.color_modePsdHeader.color_mode dosyadan gelen ham tamsayı alanıdır; PsdImage.color_mode ondan oluşturulan güçlü tipli ColorModes enumudurTiplenmiş 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öntemAçıklama
PsdImage.headerBelge başlığı özeti (PsdHeader)
PsdImage.color_data_info / parsed_color_dataRenk veri bölümü özeti (PsdColorDataInfo / ColorData)
PsdImage.image_data_info / image_data_kind / compressionGörüntü veri bölümü özeti
PsdImage.resources / resource_count / has_image_resourcesGörüntü kaynakları bölümü özeti

Ayrıca Bakınız

 Türkçe