디스크립터 쓰기

쓰기 디스크립터

PsdImage.save은(는) 문서를 다시 쓰기 위한 유일한 공개 진입점이며, 파일 경로나 이미 열린 쓰기 가능한 스트림을 받아들입니다. 실제 바이트 인코딩을 수행하는 저수준 섹션 라이터는 내부 구현 상세이며, 직접 호출하는 것이 아닙니다.

from aspose_psd_foss.psdimage import PsdImage

image = PsdImage.load(input_path)
image.save("output.psd")

경로 대신 스트림을 전달하면 스트림이 이후에도 열려 있게 됩니다 — 언제 닫을지는 사용자가 제어합니다:

with open("output.psd", "wb") as stream:
    image.save(stream)

저장 시 출력 컨테이너 형식을 선택할 수 있는 공개 API가 없습니다 — 저장은 항상 문서가 로드된 형식(is_large_document / is_psb)을 그대로 반영합니다. 이 FOSS 빌드에서는 PSD와 PSB 간의 지원되는 변환 경로가 없습니다.

이미지를 해제하기 전에 save를 호출하십시오 — 해제된 PsdImage에 대해 save을 수행하면 RuntimeError이 발생합니다.
save에 의해 호출되는 내부 섹션 수준 라이터는 자체적으로 문서화되거나 지원되는 진입점이 아닙니다; 항상 PsdImage.save을 통해 사용하십시오.

문제	원인	해결 방법
`RuntimeError: PsdImage has been disposed.`	`save`가 `dispose()` 이후에 호출되었습니다 (또는 `with` 블록이 종료된 후)	이미지를 해제하기 전에 `save`를 호출하십시오
Pascal 문자열 길이에 대한 `PsdSaveException`	문자열 값이 255바이트를 초과합니다	참조 핵심 예외

아니요 — save에 스트림을 전달하면 이후에도 스트림이 열려 있어 라이프사이클을 직접 제어할 수 있습니다. 반면 파일 경로에 저장하면 파일을 내부적으로 열고 닫습니다.

아니요 — 저장 시 컨테이너 형식을 재정의할 수 있는 공개 API가 없으며, 항상 로드된 문서의 형식을 그대로 반영합니다.

클래스/메서드	설명
`PsdImage.save(file_path)` / `PsdImage.save(stream)`	문서를 저장합니다