Sections

Sections

로드된 PsdImage는 PSD/PSB 문서의 구조 섹션—헤더, 색상 데이터 섹션, 이미지 데이터 섹션, 이미지 리소스 섹션—에 대한 읽기 전용 요약 객체를 제공하며, 모두 타입이 지정된 속성을 통해 제공되고, 수동 바이트 수준 파싱이 필요하지 않습니다.


헤더 섹션 검사

PsdImage.header는 문서의 원시 구조 필드를 포함하는 PsdHeader를 반환합니다. PsdHeader.version는 원시 PSD 컨테이너 버전(PSD는 1, PSB는 2)이며 — 이는 무관한 PsdImage.version와 다른 속성으로, API 고정 버전 번호이며 파일 형식 값이 아닙니다.

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}")

색상 데이터 섹션 검사

PsdImage.color_data_info는 PsdColorDataInfo 요약을 반환합니다; kind는 PsdColorDataKind 값이며 (NONE, INDEXED_PALETTE, RGB_PAYLOAD, CMYK_PAYLOAD 또는 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}")

이미지 데이터 섹션 검사

PsdImage.image_data_info은(는) 병합된 픽셀 데이터가 어떻게 인코딩되는지 설명하는 PsdImageDataInfo 요약을 반환합니다; image.compression는 별도의 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}")

이미지 리소스 섹션 검사

PsdImage.resources, resource_count, 그리고 has_image_resources 이미지 리소스 섹션의 내용을 표시합니다. 참조 Resources 전체 리소스 API에 대해서는.

print(f"Resource count: {image.resource_count}")

팁 및 모범 사례

  • PsdHeader 및 관련 섹션 요약(PsdColorDataInfo, ColorData, PsdImageDataInfo)은 이 FOSS 빌드에서 모두 읽기 전용입니다 — 속성에 대한 공개 setter가 없습니다.
  • PsdHeader.version (실제 PSD/PSB 컨테이너 버전)와 PsdImage.version (관련 없고 항상 6인 고정 API 버전 번호)을 혼동하지 마십시오.
  • image.has_color_mode_data을(를) 확인한 후 color_data_info을(를) 읽으십시오 — 색 모드 데이터가 없는 문서도 요약 객체를 반환하지만, 해당 필드가 의미가 없을 수 있습니다.

일반적인 문제

문제원인해결 방법
header.color_mode이(가) image.color_mode와 일치하지 않습니다PsdHeader.color_mode은 파일에서 가져온 원시 정수 필드이며; PsdImage.color_mode은 그것을 기반으로 만든 강력하게 타입된 ColorModes 열거형입니다형식화된 값에는 image.color_mode을(를) 사용하고, 원시 정수가 필요할 경우에만 header.color_mode을(를) 사용하십시오.
color_data_info.indexed_palette은(는) None입니다.문서의 색상 데이터 종류는 INDEXED_PALETTE이(가) 아닙니다.인덱스 색상 문서만 팔레트를 포함합니다 — 먼저 color_data_info.kind을(를) 확인하십시오.

FAQ

헤더, 색상 데이터, 또는 이미지 데이터 섹션을 직접 수정할 수 있나요?

아니요 — PsdHeader, PsdColorDataInfo, ColorData, 및 PsdImageDataInfo은(는) 이 FOSS 빌드에서 모두 읽기 전용 요약 객체입니다.

image.compression와 image.image_data_info.kind의 차이점은 무엇인가요?

두 개의 별도 열거형을 통해 동일한 기본 인코딩을 설명합니다: image.compression은 CompressionMethod 값을 반환하고, image.image_data_info.kind은 ImageDataKind 값을 반환합니다.


API Reference 요약

클래스/메서드설명
PsdImage.header문서 헤더 요약 (PsdHeader)
PsdImage.color_data_info / parsed_color_data색상 데이터 섹션 요약 (PsdColorDataInfo / ColorData)
PsdImage.image_data_info / image_data_kind / compression이미지 데이터 섹션 요약
PsdImage.resources / resource_count / has_image_resources이미지 리소스 섹션 요약

참조

 한국어