DocumentWriter(ドキュメントライター)#
PDFのみ。
バージョン1.21.0で導入
このクラスは、MuPDFで サポートされている さまざまなドキュメントタイプを出力できるユーティリティを表します。
PyMuPDFでは、Story (ストーリー) DOM(ドキュメントオブジェクトモデル)でページが埋められたPDFドキュメントを出力するためにのみ使用されます。
将来的には、DocumentWriter を他のドキュメントタイプにも使用することがあるかもしれません。
メソッド/属性 |
簡単な説明 |
---|---|
新しい出力ページを開始します。 |
|
現在の出力ページを終了します。 |
|
保留中の出力をフラッシュし、ファイルを閉じます。 |
クラスAPI
- class DocumentWriter#
- __init__(self, path, options=None)#
Pythonファイルポインタまたはファイルパスを渡してドキュメントライターオブジェクトを作成します。ファイルを保存する際に使用するオプションも渡すことができます。
このクラスはPythonのコンテキストマネージャとしても使用できます。
- パラメータ:
path --
出力ファイル。これは文字列のファイル名またはPythonファイルポインタのいずれかです。
注釈
io.BytesIO()
オブジェクトをファイルポインタとして使用することで、ドキュメントライターはメモリ内にPDFを作成できます。その後、このPDFは入力用に再オープンしてさらに操作できます。これは、Storiesレシピ のいくつかのサンプルスクリプトで使用されています。options (str) -- 出力PDFの保存オプションを指定します。一般的なものは「compress」や「clean」です。その他の可能な値は、
mutool convert
CLI ユーティリティのヘルプ出力から取得できます。
- begin_page(mediabox)#
指定された寸法の新しい出力ページを開始します。
- パラメータ:
mediabox (rect_like) -- ページサイズを指定する矩形。このメソッドの後、出力操作はページにコンテンツを書き込むことができます。
- end_page()#
ページを終了します。保留中のデータをフラッシュし、ページを出力ドキュメントに追加します。
- close()#
出力ファイルを閉じます。保留中のデータを書き込むためにこのメソッドが必要です。
使用例については、Story (ストーリー) のセクションを参照してください。