DocumentWriter¶

This class is for PDF only.

v1.21.0의 새로운 기능

이 클래스는 PyMuPDF 가 지원하는 다양한 문서 유형 을 출력할 수 있는 유틸리티를 나타냅니다.

PyMuPDF 에서는 Story DOM으로 페이지가 채워진 PDF 문서를 출력하는 데만 사용됩니다.

DocumentWriter 를 다른 문서 유형에도 사용하는 것은 향후 가능할 수 있습니다.

메서드 / 속성	간단한 설명
`DocumentWriter.begin_page()`	새 출력 페이지 시작
`DocumentWriter.end_page()`	현재 출력 페이지 완료
`DocumentWriter.close()`	대기 중인 출력을 플러시하고 파일 닫기

클래스 API

class DocumentWriter¶

__init__(self, path, options=None)¶

Python 파일 포인터 또는 파일 경로를 전달하여 문서 작성자 객체를 생성합니다. 파일을 저장할 때 사용할 옵션도 전달할 수 있습니다.

이 클래스는 Python 컨텍스트 관리자로도 사용할 수 있습니다.

매개변수:

path –
출력 파일. 이것은 문자열 파일 이름이거나 모든 Python 파일 포인터일 수 있습니다.

참고

io.BytesIO() 객체를 파일 포인터로 사용하면 문서 작성자가 메모리에서 PDF를 생성할 수 있습니다. 그런 다음 이 PDF를 입력용으로 다시 열고 추가로 조작할 수 있습니다. 이 기술은 Stories recipes 의 여러 예제 스크립트에서 사용됩니다.
options (str) – 출력 PDF의 저장 옵션을 지정합니다. 일반적인 옵션은 “compress” 또는 “clean”입니다. 더 많은 가능한 값은 mutool convert CLI 유틸리티의 도움말 출력에서 가져올 수 있습니다.

begin_page(mediabox)¶

주어진 크기의 새 출력 페이지를 시작합니다.

매개변수:: mediabox (rect_like) – 페이지 크기를 지정하는 사각형. 이 메서드 후에 출력 작업이 페이지에 콘텐츠를 쓸 수 있습니다.

end_page()¶: 페이지를 완료합니다. 이것은 대기 중인 모든 데이터를 플러시하고 페이지를 출력 문서에 추가합니다.

close()¶: 출력 파일을 닫습니다. 대기 중인 데이터를 쓰려면 이 메서드가 필요합니다.

사용 예제는 Story 섹션을 참조하세요.

This software is provided AS-IS with no warranty, either express or implied. This software is distributed under license and may not be copied, modified or distributed except as expressly authorized under the terms of that license. Refer to licensing information at artifex.com or contact Artifex Software Inc., 39 Mesa Street, Suite 108A, San Francisco CA 94129, United States for further information.