Aspose.PSD FOSS
Python
Developer Guide
코어 API

코어 API

코어 API

PsdImage은(는) PSD/PSB 문서를 로드하고, 검사하고, 저장하기 위한 진입점입니다. 이것은 추상 Image 기본 클래스를 확장하며, 해당 클래스는 load()만 선언합니다 — 나머지 문서 표면(width, height, save(), 컨텍스트 매니저 지원)은 PsdImage 자체에 정의되어 있으며 상속되지 않습니다.

문서 로드 및 저장

Image.load()은(는) 파일 경로나 스트림을 받아 Image을 반환합니다; PSD/PSB 입력의 경우 이는 항상 PsdImage이므로, 명시적 형 변환 없이 문서 표면을 즉시 사용할 수 있습니다. PsdImage은(는) 자동 정리를 위한 with 구문도 지원하며, PsdImage.save()는 문서를 파일 경로나 스트림으로 다시 씁니다.

from aspose_psd_foss.psdimage import PsdImage

with PsdImage.load(input_path) as image:
    # ... inspect or edit ...
    image.save(output_path)

문서 헤더 속성

PsdImage은(는) 구문 분석된 헤더를 타입이 지정된 속성으로 노출합니다: width, height, bits_per_channel, color_mode, version, compression, size, 및 is_flatten.

print(f"Width: {image.width}, Height: {image.height}")
print(f"ColorMode: {image.color_mode}, Version: {image.version}")
print(f"Compression: {image.compression}, IsFlatten: {image.is_flatten}")

이미지 리소스

PsdImage.image_resources은(는) 구문 분석된 ResourceBlock 객체 목록을 반환합니다. 이 FOSS 빌드에서는 image_resources, global_layer_resources, active_layer, 및 has_transparency_data를 읽을 수는 있지만 재할당할 수는 없습니다 — 해당 setter는 NotSupportedException을 발생시킵니다.

for resource in image.image_resources:
    print(f"Resource {resource.id}: {resource.name} ({resource.data_size} bytes)")

팁 및 모범 사례

  • Image.load()은 PSD/PSB 입력에 대해 PsdImage을 이미 반환합니다 — 이 라이브러리의 다른 언어 포트와 달리 캐스트가 필요하지 않습니다.
  • with 문을 사용하세요; PsdImage은 정리 작업을 위한 컨텍스트 관리자 프로토콜을 지원합니다.
  • image_resources, global_layer_resources, active_layer, 및 has_transparency_data은 설정자를 노출하지만 읽기 전용으로 취급하십시오.
  • image.layers에 인덱싱하기 전에 image.layer_count을 확인하세요 — 평탄화된 문서는 레이어가 없을 수 있습니다.

일반적인 문제

문제원인수정
설정 시 image_resources에 대한 NotSupportedException이 속성은 setter가 있음에도 불구하고 FOSS 빌드에서는 읽기 전용입니다.값을 읽으세요; 다시 할당하려고 시도하지 마세요
플랫화된 문서에서 빈 image.layers 목록is_flatten은(는) True이며 문서에 파싱된 레이어가 없습니다.인덱싱하기 전에 image.layer_count (또는 image.is_flatten)을 확인하십시오 image.layers에

FAQ

PSD 문서를 로드하면 픽셀 데이터가 디코딩됩니까?

아니요. PsdImage.load()는 문서 헤더, 레이어 메타데이터 및 리소스를 픽셀 데이터를 디코딩하거나 렌더링하지 않고 파싱합니다.

PSD 파일을 다른 이미지 형식으로 변환할 수 있나요?

아니요. 이 라이브러리는 PSD/PSB 문서를 로드하고, 검사하며, 저장만 합니다 — 픽셀 데이터를 렌더링하거나 다른 이미지 형식으로 변환하지 않습니다.

API Reference 요약

클래스/메서드설명
Image.load(path) / Image.load(stream)PSD 또는 PSB 문서를 로드합니다.
PsdImage.save(path) / PsdImage.save(stream)문서를 저장합니다.
PsdImage.width / height / bits_per_channel / color_mode / version / compression / size / is_flatten문서 헤더 속성
PsdImage.image_resources구문 분석된 이미지 리소스 블록 (읽기 전용)

참조

 한국어