PyMuPDF 1.23.0rc1 - en to ja translation catalogue (771 entries)

en: PyMuPDF is a high-performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents.
ja: PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。

en: PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, PDF Splitting, PDF Creation, Pyodide, PyScript
ja: PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript

en: Document
ja: Document (ドキュメント)

en: This class represents a document. It can be constructed from a file or from memory.
ja: このクラスはドキュメントを表します。ファイルまたはメモリから構築することができます。

en: There exists the alias *open* for this class, i.e. `fitz.Document(...)` and `fitz.open(...)` do exactly the same thing.
ja: このクラスには *「open」* というエイリアスが存在し、つまり、 `fitz.Document(...)` と `fitz.open(...)` はまったく同じことを行います。

en: For details on **embedded files** refer to Appendix 3.
ja: **埋め込まれたファイル** の詳細については、付録3を参照してください。

en: Starting with v1.17.0, a new page addressing mechanism for **EPUB files only** is supported. This document type is internally organized in chapters such that pages can most efficiently be found by their so-called "location". The location is a tuple *(chapter, pno)* consisting of the chapter number and the page number **in that chapter**. Both numbers are zero-based.
ja: バージョン1.17.0から、 **EPUBファイル専用** の新しいページアドレッシングメカニズムがサポートされています。このドキュメントタイプは、ページがその「場所」によって最も効率的に見つけられるように、章ごとに内部的に組織されています。場所は *（章、pno）* というタプルで構成され、章番号と **その章の中** のページ番号を指します。どちらの番号もゼロベースです。

en: While it is still possible to locate a page via its (absolute) number, doing so may mean that the complete EPUB document must be laid out before the page can be addressed. This may have a significant performance impact if the document is very large. Using the page's *(chapter, pno)* prevents this from happening.
ja: 依然として（絶対的な）番号を使用してページを見つけることは可能ですが、これを行うとページにアクセスする前に完全なEPUBドキュメントをレイアウトする必要があるかもしれません。これはドキュメントが非常に大きい場合、重要なパフォーマンスの影響を持つ可能性があります。ページの *（章、pno）* を使用することで、これを防ぐことができます。

en: To maintain a consistent API, PyMuPDF supports the page *location* syntax for **all file types** -- documents without this feature simply have just one chapter. :meth:`Document.load_page` and the equivalent index access now also support a *location* argument.
ja: 一貫性のあるAPIを維持するために、PyMuPDFは **すべてのファイルタイプ** にページの場所構文をサポートしています - この機能のないドキュメントは単に1つの章を持っています。:meth:`Document.load_page` および同等のインデックスアクセスも *場所* 引数をサポートしています。

en: There are a number of methods for converting between page numbers and locations, for determining the chapter count, the page count per chapter, for computing the next and the previous locations, and the last page location of a document.
ja: ページ番号と場所の間で変換するためのいくつかのメソッドがあり、章の数を決定するためのメソッド、章ごとのページ数を決定するためのメソッド、次の場所と前の場所を計算するためのメソッド、およびドキュメントの最後のページの場所を計算するためのメソッドがあります。

en: **Method / Attribute**
ja: **メソッド / 属性**

en: **Short Description**
ja: **短い説明**

en: PDF only: make new optional content configuration
ja: PDFのみ：新しいオプションコンテンツ設定を作成

en: PDF only: add new optional content group
ja: PDFのみ：新しいオプションコンテンツグループを追加

en: gain access to an encrypted document
ja: 暗号化されたドキュメントへのアクセスを取得

en: check if incremental save is possible
ja: インクリメンタルセーブが可能かどうかを確認

en: number of pages in chapter
ja: 章内のページ数

en: close the document
ja: ドキュメントを閉じる

en: write a PDF version to memory
ja: PDFバージョンをメモリに書き込む

en: PDF only: copy a page reference
ja: PDFのみ：ページの参照をコピー

en: PDF only: remove a single TOC item
ja: PDFのみ：単一のTOCアイテムを削除

en: PDF only: delete a page
ja: PDFのみ：ページを削除

en: PDF only: delete multiple pages
ja: PDFのみ：複数のページを削除

en: PDF only: add a new embedded file from buffer
ja: PDFのみ：バッファから新しい埋め込みファイルを追加

en: PDF only: number of embedded files
ja: PDFのみ：埋め込みファイルの数

en: PDF only: delete an embedded file entry
ja: PDFのみ：埋め込みファイルエントリを削除

en: PDF only: extract an embedded file buffer
ja: PDFのみ：埋め込みファイルバッファを抽出

en: PDF only: metadata of an embedded file
ja: PDFのみ：埋め込みファイルのメタデータ

en: PDF only: list of embedded files
ja: PDFのみ：埋め込みファイルのリスト

en: PDF only: change an embedded file
ja: PDFのみ：埋め込みファイルを変更

en: PDF only: extract a font by :data:`xref`
ja: PDFのみ： :data:`xref` によるフォントの抽出

en: PDF only: extract an embedded image by :data:`xref`
ja: PDFのみ： :data:`xref` による埋め込み画像の抽出

en: PDF only: :meth:`Document.save` with different defaults
ja: PDFのみ：異なるデフォルト値で :meth:`Document.save` を実行

en: retrieve page location after laid out document
ja: レイアウトされたドキュメント後のページ位置を取得

en: PDF only: duplicate a page
ja: PDFのみ：ページの複製

en: PDF only: lists of OCGs in ON, OFF, RBGroups
ja: PDFのみ：ON、OFF、RBGroups内のOCGのリスト

en: PDF only: list of optional content configurations
ja: PDFのみ：オプションコンテンツ設定のリスト

en: PDF only: get OCG /OCMD xref of image / form xobject
ja: PDFのみ：画像/フォームオブジェクトのOCG / OCMD xrefを取得

en: PDF only: info on all optional content groups
ja: PDFのみ：すべてのオプションコンテンツグループの情報

en: PDF only: retrieve definition of an :data:`OCMD`
ja: PDFのみ： :data:`OCMD` の定義を取得

en: PDF only: list of fonts referenced by a page
ja: PDFのみ：ページで参照されるフォントのリスト

en: PDF only: list of images referenced by a page
ja: PDFのみ：ページで参照される画像のリスト

en: PDF only: list of page label definitions
ja: PDFのみ：ページラベルの定義のリスト

en: PDF only: get page numbers having a given label
ja: PDFのみ：指定されたラベルを持つページ番号を取得

en: create a pixmap of a page by page number
ja: ページ番号によるページのピクスマップの作成

en: extract the text of a page by page number
ja: ページ番号によるページのテキストの抽出

en: PDF only: list of XObjects referenced by a page
ja: PDFのみ：ページで参照されるXObjectのリスト

en: PDF only: determine signature state
ja: PDFのみ：署名状態を確認

en: extract the table of contents
ja: 目次を抽出

en: PDF only: read the XML metadata
ja: PDFのみ：XMLメタデータを読み込む

en: PDF only: check if PDF contains any annots
ja: PDFのみ：PDFに注釈が含まれているかを確認

en: PDF only: check if PDF contains any links
ja: PDFのみ：PDFにリンクが含まれているかを確認

en: PDF only: insert a new page
ja: PDFのみ：新しいページを挿入

en: PDF only: insert pages from another PDF
ja: PDFのみ：別のPDFからページを挿入

en: PDF only: insert pages from arbitrary document
ja: PDFのみ：任意のドキュメントからページを挿入

en: PDF only: which journal actions are possible
ja: PDFのみ：どのジャーナルアクションが可能か

en: PDF only: enables journalling for the document
ja: PDFのみ：ドキュメントのジャーナルを有効にする

en: PDF only: load journal from a file
ja: PDFのみ：ファイルからジャーナルを読み込む

en: PDF only: return name of a journalling step
ja: PDFのみ：ジャーナルステップの名前を返す

en: PDF only: return journalling status
ja: PDFのみ：ジャーナリングステータスを返す

en: PDF only: redo current operation
ja: PDFのみ：現在の操作をやり直す

en: PDF only: save journal to a file
ja: PDFのみ：ジャーナルをファイルに保存

en: PDF only: start an "operation" giving it a name
ja: PDFのみ：名前を付けて「操作」を開始

en: PDF only: end current operation
ja: PDFのみ：現在の操作を終了

en: PDF only: undo current operation
ja: PDFのみ：現在の操作を元に戻す

en: PDF only: list of optional content intents
ja: PDFのみ：オプションコンテンツインテントのリスト

en: re-paginate the document (if supported)
ja: ドキュメントを再ページ化（サポートされている場合）

en: read a page
ja: ページを読み込む

en: create a page pointer in reflowable documents
ja: リフローアブルドキュメント内でページポインタを作成

en: PDF only: move a page to different location in doc
ja: PDFのみ：ページをドキュメント内の異なる場所に移動

en: PDF only: get/set `/NeedAppearances` property
ja: PDFのみ： `/NeedAppearances` プロパティを取得/設定

en: PDF only: insert a new empty page
ja: PDFのみ：新しい空白ページを挿入

en: return (chapter, pno) of following page
ja: 次のページの（章、pno）

en: PDF only: :data:`xref` a TOC item
ja: PDFのみ：TOCアイテムを :data:`xref`

en: PDF only: the unrotated page rectangle
ja: PDFのみ：回転していないページの矩形

en: PDF only: :data:`xref` of a page number
ja: PDFのみ：ページ番号の :data:`xref`

en: iterator over a page range
ja: ページ範囲のイテレータ

en: PDF only: :data:`xref` of catalog (root)
ja: PDFのみ：カタログ（ルート）の :data:`xref`

en: PDF only: trailer source
ja: PDFのみ：トレイラーソース

en: return (chapter, pno) of preceding page
ja: 前のページの（章、pno）を返す

en: PDF only: provide a new copy of a page
ja: PDFのみ：ページの新しいコピーを提供

en: PDF only: save the document
ja: PDFのみ：ドキュメントを保存

en: PDF only: save the document incrementally
ja: PDFのみ：ドキュメントを増分保存

en: PDF only: remove sensitive data
ja: PDFのみ：機密データを削除

en: search for a string on a page
ja: ページ上で文字列を検索

en: PDF only: select a subset of pages
ja: PDFのみ：ページのサブセットを選択

en: PDF only: set OCG visibility temporarily
ja: PDFのみ：一時的にOCGの表示を設定

en: PDF only: mass changing OCG states
ja: PDFのみ：OCGステータスを一括変更

en: PDF only: set the MarkInfo values
ja: PDFのみ：MarkInfoの値を設定

en: PDF only: set the metadata
ja: PDFのみ：メタデータを設定

en: PDF only: attach OCG/OCMD to image / form xobject
ja: PDFのみ：画像/フォームオブジェクトにOCG/OCMDを添付

en: PDF only: create or update an :data:`OCMD`
ja: PDFのみ：:data:`OCMD` を作成または更新

en: PDF only: add/update page label definitions
ja: PDFのみ：ページラベルの定義を追加/更新

en: PDF only: set the PageMode
ja: PDFのみ：PageModeを設定

en: PDF only: set the PageLayout
ja: PDFのみ：PageLayoutを設定

en: PDF only: change a single TOC item
ja: PDFのみ：単一のTOCアイテムを変更

en: PDF only: set the table of contents (TOC)
ja: PDFのみ：目次（TOC）を設定

en: PDF only: create or update document XML metadata
ja: PDFのみ：ドキュメントXMLメタデータを作成または更新

en: PDF only: create font subsets
ja: PDFのみ：フォントのサブセットを作成

en: PDF only: activate OC configuration
ja: PDFのみ：OC設定をアクティブ化

en: PDF only: writes document to memory
ja: PDFのみ：ドキュメントをメモリに書き込む

en: PDF only: copy a PDF dictionary to another :data:`xref`
ja: PDFのみ：PDF辞書を別の :data:`xref` にコピー

en: PDF only: get the value of a dictionary key
ja: PDFのみ：辞書キーの値を取得

en: PDF only: list the keys of object at :data:`xref`
ja: PDFのみ： :data:`xref` のオブジェクトのキーをリスト

en: PDF only: get the definition source of :data:`xref`
ja: PDFのみ：:data:`xref` の定義ソースを取得

en: PDF only: set the value of a dictionary key
ja: PDFのみ：辞書キーの値を設定

en: PDF only: raw stream source at :data:`xref`
ja: PDFのみ： :data:`xref` での生のストリームソース

en: PDF only: :data:`xref` of XML metadata
ja: PDFのみ： XMLメタデータの :data:`xref`

en: number of chapters
ja: 章の数

en: PDF only: list of global widget fonts
ja: PDFのみ：グローバルウィジェットフォントのリスト

en: has document been closed?
ja: ドキュメントが閉じられていますか？

en: PDF only: has document been changed yet?
ja: PDFのみ：ドキュメントは変更されましたか？

en: document (still) encrypted?
ja: ドキュメントは（まだ）暗号化されていますか？

en: is PDF linearized?
ja: PDFは線形化されていますか？

en: is this a Form PDF?
ja: これはフォームPDFですか？

en: is this a PDF?
ja: これはPDFですか？

en: is this a reflowable document?
ja: これはリフローアブルドキュメントですか？

en: PDF only: has this PDF been repaired during open?
ja: PDFのみ：このPDFは開いている間に修復されましたか？

en: (chapter, pno) of last page
ja: 最後のページの（章、pno）

en: metadata
ja: メタデータ

en: PDF MarkInfo value
ja: PDF MarkInfoの値

en: filename of document
ja: ドキュメントのファイル名

en: require password to access data?
ja: データにアクセスするにはパスワードが必要ですか？

en: first `Outline` item
ja: 最初のアウトラインアイテム

en: number of pages
ja: ページ数

en: permissions to access the document
ja: ドキュメントへのアクセス権限

en: PDF PageMode value
ja: PDF PageModeの値

en: PDF PageLayout value
ja: PDF PageLayoutの値

en: PDF count of versions
ja: PDFバージョンの数

en: **Class API**
ja: **クラスAPI**

en: Changed in v1.14.13: support `io.BytesIO` for memory documents.
ja: v1.14.13 で変更: メモリドキュメント用に `io.BytesIO` をサポート。

en: Changed in v1.19.6: Clearer, shorter and more consistent exception messages. File type "pdf" is always assumed if not specified. Empty files and memory areas will always lead to exceptions.
ja: v1.19.6 で変更: より明確で短く、一貫性のある例外メッセージ。ファイルタイプが指定されていない場合、常にファイルタイプ "pdf" が仮定されます。空のファイルとメモリ領域は常に例外を発生させます。

en: Creates a *Document* object.
ja: *Document* オブジェクトを作成します。

en: With default parameters, a **new empty PDF** document will be created.
ja: デフォルトのパラメータを使用すると、**新しい空の PDF** ドキュメントが作成されます。

en: If *stream* is given, then the document is created from memory and, if not a PDF, either *filename* or *filetype* must indicate its type.
ja: *stream* が指定されている場合、ドキュメントはメモリから作成され、PDF でない場合は *filename* または *filetype* のいずれかがそのタイプを示さなければなりません。

en: If *stream* is `None`, then a document is created from the file given by *filename*. Its type is inferred from the extension. This can be overruled by *filetype.*
ja: *stream* が `None` の場合、*filename* で指定されたファイルからドキュメントが作成されます。そのタイプは拡張子から推測されます。これは *filetype* によって上書きできます。

en: Parameters
ja: パラメータ

en: A UTF-8 string or *pathlib* object containing a file path. The document type is inferred from the filename extension. If not present or not matching :ref:`a supported type<Supported_File_Types>`, a PDF document is assumed. For memory documents, this argument may be used instead of `filetype`, see below.
ja: ファイルパスを含む UTF-8 文字列または *pathlib* オブジェクト。ドキュメントのタイプはファイル名の拡張子から推測されます。存在しないか、:ref:`サポートされてい<Supported_File_Types>` ないタイプに一致しない場合、PDF ドキュメントが仮定されます。メモリドキュメントの場合、`filetype` の代わりにこの引数を使用できます。詳細は以下を参照してください。

en: A memory area containing a supported document. If not a PDF, its type **must** be specified by either `filename` or `filetype`.
ja: (bytes, bytearray, BytesIO) - :ref:`サポートされている<Supported_File_Types>` ドキュメントを含むメモリ領域。PDF でない場合、そのタイプは `filename` または `filetype` のいずれかによって指定 **しなければなりません** 。

en: A string specifying the type of document. This may be anything looking like a filename (e.g. "x.pdf"), in which case MuPDF uses the extension to determine the type, or a mime type like *application/pdf*. Just using strings like "pdf"  or ".pdf" will also work. May be omitted for PDF documents, otherwise must match :ref:`a supported document type<Supported_File_Types>`.
ja: ドキュメントのタイプを指定する文字列。ファイル名のように見えるもの（例: "x.pdf"）である必要があります。この場合、MuPDF は拡張子を使用してタイプを判断します。*application/pdf* のような mime タイプも使用できます。単に "pdf" または ".pdf" のような文字列を使用することもできます。PDF ドキュメントの場合、省略可能であり、それ以外の場合は :ref:`サポートされている<Supported_File_Types>` ドキュメントタイプに一致しなければなりません。

en: a rectangle specifying the desired page size. This parameter is only meaningful for documents with a variable page layout ("reflowable" documents), like e-books or HTML, and ignored otherwise. If specified, it must be a non-empty, finite rectangle with top-left coordinates (0, 0). Together with parameter *fontsize*, each page will be accordingly laid out and hence also determine the number of pages.
ja: 希望のページサイズを指定する矩形。このパラメータは可変ページレイアウト（"reflowable" ドキュメント）を持つドキュメント（電子書籍や HTML のようなもの）にのみ意味があり、それ以外の場合は無視されます。指定される場合、非空で有限な矩形で、左上座標 (0, 0) を持っていなければなりません。*fontsize* パラメータと一緒に、各ページのレイアウトが適切に行われ、したがってページ数も決定されます。

en: may used together with *height* as an alternative to *rect* to specify layout information.
ja: レイアウト情報を指定するための *rect* の代替として、*height* と一緒に使用できます。

en: may used together with *width* as an alternative to *rect* to specify layout information.
ja: レイアウト情報を指定するための *rect* の代替として、*width* と一緒に使用できます。

en: the default :data:`fontsize` for reflowable document types. This parameter is ignored if none of the parameters *rect* or *width* and *height* are specified. Will be used to calculate the page layout.
ja: 可変ページドキュメントタイプのデフォルト :data:`fontsize`。*rect* または *width* と *height* のいずれのパラメータも指定されていない場合、このパラメータは無視されます。ページレイアウトを計算するために使用されます。

en: if the *type* of any parameter does not conform.
ja: 任意のパラメータの *型* が準拠していない場合。

en: if the file / path cannot be found. Re-implemented as subclass of `RuntimeError`.
ja: ファイル/パスが見つからない場合。`RuntimeError` のサブクラスとして再実装されました。

en: if the file / path is empty or the `bytes` object in memory has zero length. A subclass of `FileDataError` and `RuntimeError`.
ja: ファイル/パスが空であるか、メモリ内の `bytes` オブジェクトの長さがゼロの場合。`FileDataError` および `RuntimeError` のサブクラス。

en: if an unknown file type is explicitly specified.
ja: 明示的に未知のファイルタイプが指定された場合。

en: if the document has an invalid structure for the given type -- or is no file at all (but e.g. a folder). A subclass of `RuntimeError`.
ja: ドキュメントが指定されたタイプに対して無効な構造を持っているか、ファイルではない場合（たとえば、フォルダの場合）。`RuntimeError` のサブクラス。

en: A document object. If the document cannot be created, an exception is raised in the above sequence. Note that PyMuPDF-specific exceptions, `FileNotFoundError`, `EmptyFileError` and `FileDataError` are intercepted if you check for `RuntimeError`.
ja: ドキュメントオブジェクト。ドキュメントを作成できない場合、上記の順序で例外が発生します。PyMuPDF固有の例外、`FileNotFoundError` 、`EmptyFileError` 、および `FileDataError` は、`RuntimeError` をチェックする場合にキャッチされます。

en: In case of problems you can see more detail in the internal messages store: `print(fitz.TOOLS.mupdf_warnings())` (which will be emptied by this call, but you can also prevent this -- consult :meth:`Tools.mupdf_warnings`).
ja: 問題が発生した場合、内部メッセージストアで詳細を確認できます： `print(fitz.TOOLS.mupdf_warnings())` （この呼び出しによって空にされますが、これを防ぐこともできます - :meth:`Tools.mupdf_warnings` を参照してください）。

en: Not all document types are checked for valid formats already at open time. Raster images for example will raise exceptions only later, when trying to access the content. Other types (notably with non-binary content) may also be opened (and sometimes **accessed**) successfully -- sometimes even when having invalid content for the format:
ja: すべてのドキュメントタイプがオープン時に有効なフォーマットで確認されるわけではありません。例えば、ラスター画像はコンテンツにアクセスしようとした際に例外を発生させることがあります。他のタイプ（特にバイナリでないコンテンツを持つもの）は、有効なコンテンツを持たない場合でも成功してオープンされ（そして時に **アクセスされる** こともあります）：

en: HTM, HTML, XHTML: **always** opened, `metadata["format"]` is "HTML5", resp. "XHTML".
ja: HTM、HTML、XHTML: **常に** オープンされ、 `metadata["format"]` は "HTML5" または "XHTML" です。

en: XML, FB2: **always** opened, `metadata["format"]` is "FictionBook2".
ja: XML、FB2: **常に** オープンされ、 `metadata["format"]` は "FictionBook2" です。

en: Overview of possible forms, note: `open` is a synonym of `Document`::
ja: 可能なフォームの概要、注： `open` は `Document` の同義語です::

en: Raster images with a wrong (but supported) file extension **are no problem**. MuPDF will determine the correct image type when file **content** is actually accessed and will process it without complaint. So `fitz.open("file.jpg")` will work even for a PNG image.
ja: サポートされているが正しくないファイル拡張子を持つラスター画像は **問題ありません** 。MuPDFは、ファイルの実際の **内容**  がアクセスされると正しい画像タイプを判断し、何もクレームをつけずに処理します。したがって、 `fitz.open("file.jpg")` はPNG画像でも機能します。

en: The Document class can be also be used as a **context manager**. On exit, the document will automatically be closed.
ja: Document クラスは **コンテキストマネージャ** としても使用できます。終了時に、ドキュメントは自動的に閉じられます。

en: New in v1.18.4
ja: v1.18.4 で新規追加

en: Return the cross reference number of an :data:`OCG` or :data:`OCMD` attached to an image or form xobject.
ja: 画像またはフォームXObjectに添付された :data:`OCG` または :data:`OCMD` のクロスリファレンス番号を返します。

en: the :data:`xref` of an image or form xobject. Valid such cross reference numbers are returned by :meth:`Document.get_page_images`, resp. :meth:`Document.get_page_xobjects`. For invalid numbers, an exception is raised.
ja: 画像またはフォームXObjectの :data:`xref` 。有効なクロスリファレンス番号は、:meth:`Document.get_page_images` または :meth:`Document.get_page_xobjects` で返されます。無効な番号の場合、例外が発生します。

en: Return type
ja: 戻り値の型

en: the cross reference number of an optional contents object or zero if there is none.
ja: オプションコンテンツオブジェクトのクロスリファレンス番号、または存在しない場合はゼロ。

en: If *xref* represents an image or form xobject, set or remove the cross reference number *ocxref* of an optional contents object.
ja: *xref* が画像またはフォームXObjectを表す場合、オプションコンテンツオブジェクトのクロスリファレンス番号 *ocxref*  を設定または削除します。

en: the :data:`xref` of an image or form xobject [#f5]_. Valid such cross reference numbers are returned by :meth:`Document.get_page_images`, resp. :meth:`Document.get_page_xobjects`. For invalid numbers, an exception is raised.
ja: 画像またはフォームXObjectの :data:`xref` [#f5]_。有効なクロスリファレンス番号は、:meth:`Document.get_page_images` または :meth:`Document.get_page_xobjects` で返されます。無効な番号の場合、例外が発生します。

en: the :data:`xref` number of an :data:`OCG` / :data:`OCMD`. If not zero, an invalid reference raises an exception. If zero, any OC reference is removed.
ja: :data:`OCG` / :data:`OCMD` の :data:`xref` 番号。ゼロでない場合、無効な参照は例外を発生させます。ゼロの場合、任意のOC参照が削除されます。

en: New in v1.18.3
ja: v1.18.3 で新規追加

en: Show optional layer configurations. There always is a standard one, which is not included in the response.
ja: オプションのレイヤー構成を表示します。常に標準のものが存在し、それは応答に含まれていません。

en: Add an optional content configuration. Layers serve as a collection of ON / OFF states for optional content groups and allow fast visibility switches between different views on the same document.
ja: オプションのコンテンツ構成を追加します。レイヤーはオプションコンテンツグループのON / OFFの状態のコレクションとして機能し、同じドキュメントの異なるビュー間での高速な表示切り替えを可能にします。

en: arbitrary name.
ja: 任意の名前。

en: (optional) creating software.
ja: （オプション）作成ソフトウェア。

en: a sequence of OCG :data:`xref` numbers which should be set to ON when this layer gets activated. All OCGs not listed here will be set to OFF.
ja: このレイヤーがアクティブになったときにONに設定されるOCG :data:`xref`  番号のシーケンス。ここでリストされていないすべてのOCGはOFFに設定されます。

en: Switch to a document view as defined by the optional layer's configuration number. This is temporary, except if established as default.
ja: オプションレイヤーの構成番号によって定義されたドキュメントビューに切り替えます。これは一時的なものであり、デフォルトとして確立されていない限り、一時的なものです。

en: config number as returned by :meth:`Document.layer_configs`.
ja: :meth:`Document.layer_configs` によって返される構成番号。

en: make this the default configuration.
ja: これをデフォルト構成にします。

en: Activates the ON / OFF states of OCGs as defined in the identified layer. If *as_default=True*, then additionally all layers, including the standard one, are merged and the result is written back to the standard layer, and **all optional layers are deleted**.
ja: 識別されたレイヤーで定義されたOCGのON / OFFの状態をアクティブにします。 *as_default=True* の場合、追加で、標準のレイヤーを含むすべてのレイヤーがマージされ、結果が標準レイヤーに書き込まれ、 **すべてのオプションレイヤーが削除されます** 。

en: Add an optional content group. An OCG is the most important unit of information to determine object visibility. For a PDF, in order to be regarded as having optional content, at least one OCG must exist.
ja: オプションコンテンツグループを追加します。OCGはオブジェクトの表示を決定するための最も重要な情報単位です。PDFでは、オプションコンテンツとして扱われるためには、少なくとも1つのOCGが存在する必要があります。

en: arbitrary name. Will show up in supporting PDF viewers.
ja: 任意の名前。サポートするPDFビューアに表示されます。

en: layer configuration number. Default -1 is the standard configuration.
ja: レイヤー構成番号。デフォルトは-1で、標準構成です。

en: standard visibility status for objects pointing to this OCG.
ja: このOCGを指すオブジェクトの標準の表示状態。

en: a string or list of strings declaring the visibility intents. There are two PDF standard values to choose from: "View" and "Design". Default is "View". Correct **spelling is important**.
ja: 表示意図を宣言する文字列または文字列のリスト。PDF標準の2つの値から選択できます: "View" と "Design"。デフォルトは "View" です。 **正確なスペルが重要です** 。

en: another influencer for OCG visibility. This will become part of the OCG's `/Usage` key. There are two PDF standard values to choose from: "Artwork" and "Technical". Default is "Artwork". Please only change when required.
ja: OCGの表示に影響を与えるもう一つの要因。これはOCGの `/Usage` キーの一部になります。PDF標準の2つの値から選択できます: "Artwork" と "Technical"。デフォルトは "Artwork" です。必要な場合にのみ変更してください。

en: :data:`xref` of the created OCG. Use as entry for `oc` parameter in supporting objects.
ja: 作成されたOCGの :data:`xref` 。サポートオブジェクトの `oc` パラメータのエントリとして使用します。

en: Multiple OCGs with identical parameters may be created. This will not cause problems. Garbage option 3 of :meth:`Document.save` will get rid of any duplicates.
ja: 同一のパラメータを持つ複数のOCGを作成することができます。これは問題を引き起こしません。:meth:`Document.save` のゴミオプション3を使用すれば、重複を削除できます。

en: Create or update an :data:`OCMD`, **Optional Content Membership Dictionary.**
ja: :data:`OCMD` （ **Optional Content Membership Dictionary** ）を作成または更新します。

en: :data:`xref` of the OCMD to be updated, or 0 for a new OCMD.
ja: 更新するOCMDの :data:`xref` 、または新しいOCMDの場合は0

en: a sequence of :data:`xref` numbers of existing :data:`OCG` PDF objects.
ja: 既存の :data:`OCG` PDFオブジェクトの :data:`xref` 番号のシーケンス。

en: one of "AnyOn" (default), "AnyOff", "AllOn", "AllOff" (mixed or lower case).
ja: "AnyOn"（デフォルト）、"AnyOff"、"AllOn"、"AllOff"のいずれか。大文字小文字は区別されません。

en: a "visibility expression". This is a list of arbitrarily nested other lists -- see explanation below. Use as an alternative to the combination *ocgs* / *policy* if you need to formulate more complex conditions.
ja: "表示条件式"。これは他のリストを任意に入れ子にしたリストです - 説明は以下を参照してください。より複雑な条件を定式化する必要がある場合、 *ocgs* / *policy* の組み合わせの代替として使用します。

en: :data:`xref` of the OCMD. Use as `oc=xref` parameter in supporting objects, and respectively in :meth:`Document.set_oc` or :meth:`Annot.set_oc`.
ja: OCMDの :data:`xref` 。サポートオブジェクトの `oc=xref` パラメータとして使用し、:meth:`Document.set_oc` または :meth:`Annot.set_oc` にもそれぞれ使用します。

en: Like an OCG, an OCMD has a visibility state ON or OFF, and it can be used like an OCG. In contrast to an OCG, the OCMD state is determined by evaluating the state of one or more OCGs via special forms of **boolean expressions.** If the expression evaluates to true, the OCMD state is ON and OFF for false.
ja: OCGと同様に、OCMDには表示状態ONまたはOFFがあり、OCGのように使用できます。OCGとは異なり、OCMDの状態は **ブール式** の特別な形式を使用して1つ以上のOCGの状態を評価することによって決定されます。式がtrueに評価される場合、OCMDの状態はONで、falseに評価される場合はOFFです。

en: There are two ways to formulate OCMD visibility:
ja: OCMDの表示を定式化する方法は2つあります:

en: Use the combination of *ocgs* and *policy*: The *policy* value is interpreted as follows:
ja: *ocgs* と *policy* の組み合わせを使用する: *policy* の値は次のように解釈されます：

en: AnyOn -- (default) true if at least one OCG is ON.
ja: (デフォルト) 少なくとも1つのOCGがONの場合、true。

en: AnyOff -- true if at least one OCG is OFF.
ja: 少なくとも1つのOCGがOFFの場合、true。

en: AllOn -- true if all OCGs are ON.
ja: すべてのOCGがONの場合、true。

en: AllOff -- true if all OCGs are OFF.
ja: すべてのOCGがOFFの場合、true。

en: Suppose you want two PDF objects be displayed exactly one at a time (if one is ON, then the other one must be OFF):
ja: 2つのPDFオブジェクトを、必ず1つずつ表示するようにしたい場合（1つがONの場合、他の1つはOFFにする必要があります）：

en: Solution: use an **OCG** for object 1 and an **OCMD** for object 2. Create the OCMD via `set_ocmd(ocgs=[xref], policy="AllOff")`, with the :data:`xref` of the OCG.
ja: 解決策: オブジェクト1用のOCGとオブジェクト2用のOCMDを使用します。 OCMDは `set_ocmd(ocgs=[xref], policy="AllOff")` を使用して作成し、OCGの :data:`xref` を指定します。

en: Use the **visibility expression** *ve*: This is a list of two or more items. The **first item** is a logical keyword: one of the strings **"and"**, **"or"**, or **"not"**. The **second** and all subsequent items must either be an integer or another list. An integer must be the :data:`xref` number of an OCG. A list must again have at least two items starting with one of the boolean keywords. This syntax is a bit awkward, but quite powerful:
ja: **表示条件式** *ve* を使用する: これは2つ以上のアイテムから成るリストです。 **最初のアイテム** は論理キーワードで、文字列 **"and"** 、**"or"** 、または **"not"** のいずれかです。2番目以降のアイテムは整数または別のリストである必要があります。整数はOCGの :data:`xref` 番号でなければなりません。リストは再び少なくとも2つのアイテムから始まり、ブールキーワードのいずれかで始まる必要があります。この構文はやや厄介ですが、非常に強力です：

en: Each list must start with a logical keyword.
ja: 各リストは論理キーワードで始まる必要があります。

en: If the keyword is a **"not"**, then the list must have exactly two items. If it is **"and"** or **"or"**, any number of other items may follow.
ja: キーワードが **"not"** の場合、リストは正確に2つのアイテムを持たなければなりません。 **"and"** または **"or"** の場合、その後にいくつでも他のアイテムが続くことができます。

en: Items following the logical keyword may be either integers or again a list. An *integer* must be the xref of an OCG. A *list* must conform to the previous rules.
ja: 論理キーワードの後に続くアイテムは、整数または再びリストである必要があります。 *整数* はOCGのxref番号でなければなりません。 *リスト* は前述のルールに従う必要があります。

en: **Examples:**
ja: **例:**

en: `set_ocmd(ve=["or", 4, ["not", 5], ["and", 6, 7]])`. This delivers ON if the following is true: **"4 is ON, or 5 is OFF, or 6 and 7 are both ON"**.
ja: `set_ocmd(ve=["or", 4, ["not", 5], ["and", 6, 7]])` 。これは次の条件がtrueの場合にONを返します: **"4がON、または5がOFF、または6と7が両方ON** "。

en: `set_ocmd(ve=["not", xref])`. This has the same effect as the OCMD example created under 1.
ja: `set_ocmd(ve=["not", xref])` 。これは1で作成されたOCMDの例と同じ効果があります。

en: For more details and examples see page 224 of :ref:`AdobeManual`. Also do have a look at example scripts `here <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/optional-content>`_.
ja: 詳細と例については、 :ref:`AdobeManual` の224ページを参照してください。また、`こちら <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/optional-content>`_ の例のスクリプトもご覧いただけます。

en: Visibility expressions, `/VE`, are part of PDF specification version 1.6. So not all PDF viewers / readers may already support this feature and hence will react in some standard way for those cases.
ja: 表示条件式 `/VE` はPDF仕様バージョン1.6の一部です。したがって、すべてのPDFビューア/リーダーがすでにこの機能をサポートしているわけではなく

en: Retrieve the definition of an :data:`OCMD`.
ja: :data:`OCMD` の定義を取得します。

en: the :data:`xref` of the OCMD.
ja: :data:`xref` （int）- OCMDのxref。

en: a dictionary with the keys *xref*, *ocgs*, *policy* and *ve*.
ja: *xref* 、*ocgs* 、*policy*、*ve* のキーを持つ辞書

en: List of optional content groups by status in the specified configuration. This is a dictionary with lists of cross reference numbers for OCGs that occur in the arrays `/ON`, `/OFF` or in some radio button group (`/RBGroups`).
ja: 指定された構成内のステータス別オプションコンテンツグループのリスト。これは、OCGsのクロスリファレンス番号のリストを持つ辞書で、`/ON` 、`/OFF` 、またはラジオボタングループ (`/RBGroups`) のいずれかに出現するOCGsに対応しています。

en: the configuration layer (default is the standard config layer).
ja: 構成レイヤー（デフォルトは標準の構成レイヤー）。

en: Changed in v1.22.5: Support list of *locked* OCGs.
ja: バージョン1.22.5で変更: *ロックされた* OCGのリストをサポート。

en: Mass status changes of optional content groups. **Permanently** sets the status of OCGs.
ja: オプションコンテンツグループの大量ステータス変更。OCGのステータスを **永続的に** 設定します。

en: desired configuration layer, choose -1 for the default one.
ja: 希望の構成レイヤー、デフォルトのものには-1を選択します。

en: list of :data:`xref` of OCGs to set ON. Replaces previous values. An empty list will cause no OCG being set to ON anymore. Should be specified if `basestate="ON"` is used.
ja: ONに設定するOCGの :data:`xref` のリスト。以前の値を置換します。空のリストはもうOCGをONに設定しなくなります。`basestate="ON"` が使用される場合は指定する必要があります。

en: list of :data:`xref` of OCGs to set OFF. Replaces previous values. An empty list will cause no OCG being set to OFF anymore. Should be specified if `basestate="OFF"` is used.
ja: OFFに設定するOCGの :data:`xref` のリスト。以前の値を置換します。空のリストはもうOCGをOFFに設定しなくなります。 `basestate="OFF"` が使用される場合は指定する必要があります。

en: state of OCGs that are not mentioned in *on* or *off*. Possible values are "ON", "OFF" or "Unchanged". Upper / lower case possible.
ja: *on* または *off* で言及されていないOCGの状態。可能な値は「ON」、「OFF」または「Unchanged」です。大文字/小文字を区別できます。

en: a list of lists. Replaces previous values. Each sublist should contain two or more OCG xrefs. OCGs in the same sublist are handled like buttons in a radio button group: setting one to ON automatically sets all other group members to OFF.
ja: リストのリスト。以前の値を置換します。各サブリストには2つ以上のOCG xrefを含める必要があります。同じサブリスト内のOCGはラジオボタングループ内のボタンのように処理され、1つをONに設定すると他のすべてのグループメンバーがOFFに設定されます。

en: a list of OCG xref number that cannot be changed by the user interface.
ja: ユーザーインターフェースで変更できないOCG xref番号のリスト。

en: Values `None` will not change the corresponding PDF array.
ja: 値 `None` は対応するPDF配列を変更しません。

en: Details of all optional content groups. This is a dictionary of dictionaries like this (key is the OCG's :data:`xref`):
ja: オプションコンテンツグループの詳細情報。これは次のような辞書の辞書です（キーはOCGの :data:`xref` です）：

en: Show the visibility status of optional content that is modifiable by the user interface of supporting PDF viewers.
ja: サポートするPDFビューアのユーザーインターフェースで変更可能なオプションコンテンツの表示状態を表示します。

en: Only reports items contained in the currently selected layer configuration.
ja: 現在選択されているレイヤー設定に含まれるアイテムのみを報告します。

en: The meaning of the dictionary keys is as follows:
ja: 辞書のキーの意味は次の通りです：

en: *depth:* item's nesting level in the `/Order` array
ja: *depth:*  `/Order` 配列内のアイテムのネストレベル

en: *locked:* true if cannot be changed via user interfaces
ja: *locked:* ユーザーインターフェースを介して変更できない場合はtrue

en: *number:* running sequence number
ja: *number:* 連続するシーケンス番号

en: *on:* item state
ja: *on:* アイテムの状態

en: *text:* text string or name field of the originating OCG
ja: *text:* 元のOCGのテキスト文字列または名前フィールド

en: *type:* one of "label" (set by a text string), "checkbox" (set by a single OCG) or "radiobox" (set by a set of connected OCGs)
ja: *type:* "label"（テキスト文字列によって設定）、"checkbox"（単一のOCGによって設定）、または "radiobox"（接続されたOCGのセットによって設定）のいずれか

en: Modify OC visibility status of content groups. This is analog to what supporting PDF viewers would offer.
ja: コンテンツグループのOC表示状態を変更します。これは、サポートするPDFビューアが提供するものと同様です。

en: Please note that visibility is **not** a property stored with the OCG. It is not even information necessarily present in the PDF document at all. Instead, the current visibility is **temporarily** set using the user interface of some supporting PDF consumer software. The same type of functionality is offered by this method.
ja: 表示状態はOCGとして保存されるプロパティ **ではない** ことに注意してください。それはPDFドキュメントに必ずしも存在しない情報でもありません。代わりに、現在の表示状態はサポートするPDF消費者ソフトウェアのユーザーインターフェースを使用して**一時的に** 設定されます。このメソッドでも同じタイプの機能が提供されます。

en: To make **permanent** changes, use :meth:`Document.set_layer`.
ja: **永続的な** 変更を行うには、:meth:`Document.set_layer` を使用してください。

en: either the sequence number of the item in list :meth:`Document.layer_configs` or the "text" of one of these items.
ja: :meth:`Document.layer_configs` リストのアイテムのシーケンス番号またはこれらのアイテムの「テキスト」。

en: `PDF_OC_ON` = set on (default), `PDF_OC_TOGGLE` = toggle on/off, `PDF_OC_OFF` = set off.
ja: `PDF_OC_ON` = ONに設定（デフォルト）、`PDF_OC_TOGGLE` = ON/OFFを切り替え、`PDF_OC_OFF` = OFFに設定。

en: Decrypts the document with the string *password*. If successful, document data can be accessed. For PDF documents, the "owner" and the "user" have different privileges, and hence different passwords may exist for these authorization levels. The method will automatically establish the appropriate (owner or user) access rights for the provided password.
ja: 文字列の *パスワード* でドキュメントを複合化します。成功した場合、ドキュメントデータにアクセスできます。PDFドキュメントの場合、「オーナー」および「ユーザー」には異なる特権があり、したがってこれらの認証レベルに異なるパスワードが存在する可能性があります。このメソッドは提供されたパスワードに適切な（オーナーまたはユーザー）アクセス権を自動的に確立します。

en: owner or user password.
ja: オーナーまたはユーザーパスワード。

en: a positive value if successful, zero otherwise (the string does not match either password). If positive, the indicator :attr:`Document.is_encrypted` is set to *False*. **Positive** return codes carry the following information detail:
ja: 成功した場合は正の値、それ以外はゼロです（文字列がどちらのパスワードとも一致しない場合）。正の戻り値がある場合、インジケータ :attr:`Document.is_encrypted` は *False* に設定されます。**正の** 戻り値コードには、次の情報の詳細が含まれています：

en: 1 => authenticated, but the PDF has neither owner nor user passwords.
ja: 1 => 認証済み、ただしPDFにはオーナーまたはユーザーパスワードがありません。

en: 2 => authenticated with the **user** password.
ja: 2 => **ユーザー** パスワードで認証済み。

en: 4 => authenticated with the **owner** password.
ja: 4 => **オーナー** パスワードで認証済み。

en: 6 => authenticated and both passwords are equal -- probably a rare situation.
ja: 6 => 認証済みで両方のパスワードが等しい-おそらくまれな状況

en: The document may be protected by an owner, but **not** by a user password. Detect this situation via `doc.authenticate("") == 2`. This allows opening and reading the document without authentication, but, depending on the :attr:`Document.permissions` value, other actions may be prohibited. PyMuPDF (like MuPDF) in this case **ignores those restrictions**. So, -- in contrast to any PDF viewers -- you can for example extract text and add or modify content, even if the respective permission flags `PDF_PERM_COPY`, `PDF_PERM_MODIFY`, `PDF_PERM_ANNOTATE`, etc. are set off! It is your responsibility building a legally compliant application where applicable.
ja: ドキュメントはオーナーによって保護されている場合でも、ユーザーパスワードによって保護 **されていない** 場合があります。この状況は、`doc.authenticate("") == 2` を使用して検出できます。これにより、認証なしでドキュメントを開いて読むことができますが、:attr:`Document.permissions` 値に応じて、他のアクションが制限される場合があります。この場合、PyMuPDF（MuPDFと同様）はこれらの **制限を無視します** 。したがって、`PDF_PERM_COPY` 、`PDF_PERM_MODIFY` 、`PDF_PERM_ANNOTATE` などの対応する許可フラグがオフに設定されていても、テキストを抽出したり、コンテンツを追加または変更したりすることができます！該当する場合、法的に適合するアプリケーションを構築する責任があります。

en: New in v 1.18.6
ja: バージョン 1.18.6 での新機能

en: PDF only: Return a list of page numbers that have the specified label -- note that labels may not be unique in a PDF. This implies a sequential search through **all page numbers** to compare their labels.
ja: PDF のみ：指定されたラベルを持つページ番号のリストを返します。ラベルは PDF では一意でないことがあることに注意してください。これは、**すべてのページ番号** を逐次検索してそのラベルを比較することを意味します。

en: Implementation detail -- pages are **not loaded** for this purpose.
ja: 実装の詳細 - この目的でページは **読み込まれません** 。

en: the label to look for, e.g. "vii" (Roman number 7).
ja: 検索対象のラベル、例： "vii"（ローマ数字 7）。

en: stop after first hit. Useful e.g. if labelling is known to be unique, or there are many pages, etc. The default will check every page number.
ja: 最初の一致で停止します。ラベリングが一意であることがわかっている場合や、多くのページがある場合などに便利です。デフォルトではすべてのページ番号をチェックします。

en: list of page numbers that have this label. Empty if none found, no labels defined, etc.
ja: このラベルを持つページ番号のリスト。見つからない場合やラベルが定義されていない場合などは空です。

en: New in v1.18.7
ja: バージョン 1.18.7 での新機能

en: PDF only: Extract the list of page label definitions. Typically used for modifications before feeding it into :meth:`Document.set_page_labels`.
ja: PDF のみ：ページラベルの定義のリストを抽出します。通常は :meth:`Document.set_page_labels` に渡す前の変更に使用されます。

en: a list of dictionaries as defined in :meth:`Document.set_page_labels`.
ja: :meth:`Document.set_page_labels` で定義されたように辞書のリスト。

en: New in v1.18.6
ja: バージョン 1.18.6 での新機能

en: PDF only: Add or update the page label definitions of the PDF.
ja: PDF のみ：PDF のページラベルの定義を追加または更新します。

en: a list of dictionaries. Each dictionary defines a label building rule and a 0-based "start" page number. That start page is the first for which the label definition is valid. Each dictionary has up to 4 items and looks like `{'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}` and has the following items.
ja: 辞書のリスト。各辞書はラベル構築ルールと 0 ベースの "start" ページ番号を定義します。その開始ページはラベル定義が有効になる最初のページです。各辞書は最大 4 つの項目を持ち、 `{'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}` という形式で、次の項目を持ちます。

en: `startpage`: (int) the first page number (0-based) to apply the label rule. This key **must be present**. The rule is applied to all subsequent pages until either end of document or superseded by the rule with the next larger page number.
ja: `startpage` :（int）ラベルルールを適用する最初のページ番号（0 ベース）。このキーは **存在する必要があります** 。ルールはドキュメントの終端に達するか、次の大きなページ番号を持つルールに置き換えられるまで、すべての後続ページに適用されます。

en: `prefix`: (str) an arbitrary string to start the label with, e.g. "A-". Default is "".
ja: `prefix` :（str）ラベルの先頭に付ける任意の文字列、例： "A-"。デフォルトは "" です。

en: `style`: (str) the numbering style. Available are "D" (decimal), "r"/"R" (Roman numbers, lower / upper case), and "a"/"A" (lower / upper case alphabetical numbering: "a" through "z", then "aa" through "zz", etc.). Default is "". If "", no numbering will take place and the pages in that range will receive the same label consisting of the `prefix` value. If prefix is also omitted, then the label will be "".
ja: style:（str）番号付けのスタイル。使用できるのは "D"（10 進数）、"r"/"R"（ローマ数字、小文字/大文字）、および "a"/"A"（小文字/大文字のアルファベット番号： "a" から "z"、次に "aa" から "zz" など）。デフォルトは "" です。 "" の場合、番号付けは行われず、その範囲のページはプレフィックス値から成る同じラベルを受け取ります。`prefix` も省略された場合、ラベルは "" になります。

en: `firstpagenum`: (int) start numbering with this value. Default is 1, smaller values are ignored.
ja: `firstpagenum` :（int）この値から番号付けを開始します。デフォルトは 1 で、小さい値は無視されます。

en: For example::
ja: 例::

en: will generate the labels "A-10", "A-11", "A-12", "A-13", "1", "2", "3", ... for pages 6, 7 and so on until end of document. Pages 0 through 5 will have the label "".
ja: 次のラベルを生成します: "A-10"、"A-11"、"A-12"、"A-13"、"1"、"2"、"3"、... ページ 6、7、など、ドキュメントの終了まで続きます。ページ 0 から 5 まではラベル "A-" が付きます。

en: New in v.1.17.3
ja: バージョン 1.17.3 での新機能

en: Return a page pointer in a reflowable document. After re-layouting the document, the result of this method can be used to find the new location of the page.
ja: リフロータブルなドキュメント内のページポインターを返します。ドキュメントの再レイアウト後、このメソッドの結果はページの新しい位置を見つけるために使用できます。

en: Do not confuse with items of a table of contents, TOC.
ja: 目次の項目とは混同しないでください。

en: page location. Must be a valid *(chapter, pno)*.
ja: ページの位置。有効なものである必要があります *（章、ページ番号）* 。

en: a long integer in pointer format. To be used for finding the new location of the page after re-layouting the document. Do not touch or re-assign.
ja: ポインターフォーマットの長整数。ドキュメントの再レイアウト後のページの新しい位置を見つけるために使用されます。変更しないでください。

en: Return the new page location after re-layouting the document.
ja: ドキュメントの再レイアウト後の新しいページの位置を返します。

en: created by :meth:`Document.make_bookmark`.
ja: :meth:`Document.make_bookmark` によって作成されたもの。

en: the new (chapter, pno) of the page.
ja: ページの新しい（章、ページ番号）。

en: New in v.1.17.0
ja: バージョン 1.17.0 での新機能

en: Return the number of pages of a chapter.
ja: 章のページ数を返します。

en: the 0-based chapter number.
ja: 0 ベースの章番号。

en: number of pages in chapter. Relevant only for document types with chapter support (EPUB currently).
ja: 章内のページ数。章のサポートを持つドキュメントタイプに関連します（現在は EPUB のみ）。

en: Return the location of the following page.
ja: 次のページの位置を返します。

en: the current page id. This must be a tuple *(chapter, pno)* identifying an existing page.
ja: 現在のページ ID。これは既存のページを識別するタプル *（章、ページ番号）* である必要があります。

en: The tuple of the following page, i.e. either *(chapter, pno + 1)* or *(chapter + 1, 0)*, **or** the empty tuple *()* if the argument was the last page. Relevant only for document types with chapter support (EPUB currently).
ja: 次のページのタプル、つまり *（章、ページ番号 + 1）* または *（章 + 1、0）* 、**または** 引数が最後のページである場合は空のタプル *()* 。章のサポートを持つドキュメントタイプに関連します（現在は EPUB のみ）。

en: Return the locator of the preceding page.
ja: 前のページの位置を返します。

en: The tuple of the preceding page, i.e. either *(chapter, pno - 1)* or the last page of the preceding chapter, **or** the empty tuple *()* if the argument was the first page. Relevant only for document types with chapter support (EPUB currently).
ja: 前のページのタプル、つまり *（章、ページ番号 - 1）* **または** 前の章の最後のページ、または引数が最初のページである場合は空のタプル *()* 。章のサポートを持つドキュメントタイプに関連します（現在は EPUB のみ）。

en: Changed in v1.17.0: For document types supporting a so-called "chapter structure" (like EPUB), pages can also be loaded via the combination of chapter number and relative page number, instead of the absolute page number. This should **significantly speed up access** for large documents.
ja: バージョン 1.17.0 で変更: "章の構造" をサポートするドキュメントタイプ（例：EPUB）の場合、絶対ページ番号の代わりに章番号と相対ページ番号の組み合わせを使用してページをロードすることもできます。これにより、大きなドキュメントへの **アクセスが大幅に高速化される** はずです。

en: Create a :ref:`Page` object for further processing (like rendering, text searching, etc.).
ja: さらなる処理（レンダリング、テキスト検索など）のための :ref:`Page` オブジェクトを作成します。

en: *(Changed in v1.17.0)*
ja: *（バージョン 1.17.0 で変更）*

en: Either a 0-based page number, or a tuple *(chapter, pno)*. For an **integer**, any `-∞ < page_id < page_count` is acceptable. While page_id is negative, :attr:`page_count` will be added to it. For example: to load the last page, you can use *doc.load_page(-1)*. After this you have page.number = doc.page_count - 1.
ja: 0ベースのページ番号またはタプル *（章、ページ番号）* のいずれか。**整数** の場合、`-∞ < page_id < page_count` が許容されます。`page_id` が負の場合、 :attr:`page_count` が追加されます。たとえば、最後のページを読み込むには、*doc.load_page(-1)* を使用できます。これにより、 `page.number = doc.page_count - 1` となります。

en: For a tuple, *chapter* must be in range :attr:`Document.chapter_count`, and *pno* must be in range :meth:`Document.chapter_page_count` of that chapter. Both values are 0-based. Using this notation, :attr:`Page.number` will equal the given tuple. Relevant only for document types with chapter support (EPUB currently).
ja: タプルの場合、*chapter* は :attr:`Document.chapter_count` の範囲内になければならず、*ページ番号* はその章の :meth:`Document.chapter_page_count` の範囲内になければなりません。両方の値は0から始まります。この表記法を使用すると、:attr:`Page.number` は指定されたタプルに等しくなります。章のサポートを持つドキュメントタイプに関連します（現在は EPUB のみ）。

en: Documents also follow the Python sequence protocol with page numbers as indices: *doc.load_page(n) == doc[n]*.
ja: ドキュメントはページ番号をインデックスとするPythonのシーケンスプロトコルに従います：indices: *doc.load_page(n) == doc[n]* 。

en: For **absolute page numbers** only, expressions like *"for page in doc: ..."* and *"for page in reversed(doc): ..."* will successively yield the document's pages. Refer to :meth:`Document.pages` which allows processing pages as with slicing.
ja: **絶対ページ番号** の場合、式  *"for page in doc: …"* および  *"for page in reversed(doc): …"*  は文書のページを順次生成します。スライシングのようにページを処理できる :meth:`Document.pages` を参照してください。

en: You can also use index notation with the new chapter-based page identification: use *page = doc[(5, 2)]* to load the third page of the sixth chapter.
ja: 新しい章ベースのページ識別にもインデックス表記を使用できます： *page = doc[(5, 2)]* として、 6番目の章の3番目のページを読み込むことができます。

en: To maintain a consistent API, for document types not supporting a chapter structure (like PDFs), :attr:`Document.chapter_count` is 1, and pages can also be loaded via tuples *(0, pno)*. See this [#f3]_ footnote for comments on performance improvements.
ja: 一貫性のあるAPIを維持するため、章の構造をサポートしていないドキュメントタイプ（PDFなど）の場合、:attr:`Document.chapter_count` は1であり、ページはタプル *（0、pno）* を使用しても読み込むことができます。パフォーマンスの改善に関するコメントについては、この [#f3]_ の注釈を参照してください。

en: New in v1.16.10
ja: バージョン 1.16.10 での新機能

en: PDF only: Provide a new copy of a page after finishing and updating all pending changes.
ja: PDF のみ：保留中のすべての変更を終了および更新した後、ページの新しいコピーを提供します。

en: page object.
ja: ページオブジェクト。

en: a new copy of the same page. All pending updates (e.g. to annotations or widgets) will be finalized and a fresh copy of the page will be loaded.
ja: 同じページの新しいコピー。すべての保留中の更新（注釈やウィジェットなど）が確定し、ページの新しいコピーが読み込まれます。

en: In a typical use case, a page :ref:`Pixmap` should be taken after annotations / widgets have been added or changed. To force all those changes being reflected in the page structure, this method re-instates a fresh copy while keeping the object hierarchy "document -> page -> annotations/widgets" intact.
ja: 典型的なユースケースでは、注釈やウィジェットが追加または変更された後にページの :ref:`Pixmap` を取得する必要があります。これらの変更がページ構造に反映されるようにするために、このメソッドは "document -> page -> annotations/widgets" のオブジェクト階層を保持したまま、新しいコピーを再設定します。

en: New in v1.17.7
ja: バージョン 1.17.7 での新機能

en: PDF only: Return the unrotated page rectangle -- **without loading the page** (via :meth:`Document.load_page`). This is meant for internal purpose requiring best possible performance.
ja: PDF のみ：ページを読み込まずに（:meth:`Document.load_page` を介さずに）、回転を無視してページの長方形を返します。これは、最高のパフォーマンスを必要とする内部目的のために使用されます。

en: 0-based page number.
ja: 0から始まるページ番号。

en: :ref:`Rect` of the page like :meth:`Page.rect`, but ignoring any rotation.
ja: :meth:`Page.rect` のようなページの :ref:`Rect` ですが、回転を無視します。

en: PDF only: Return the :data:`xref` of the page -- **without loading the page** (via :meth:`Document.load_page`). This is meant for internal purpose requiring best possible performance.
ja: PDF のみ： **ページを読み込まずに** （:meth:`Document.load_page` を介さずに）、ページの :data:`xref` を返します。これは、最高のパフォーマンスを必要とする内部目的のために使用されます。

en: :data:`xref` of the page like :attr:`Page.xref`.
ja: :attr:`Page.xref` のようなページの :data:`xref` 。

en: New in v1.16.4
ja: バージョン 1.16.4 での新機能

en: A generator for a range of pages. Parameters have the same meaning as in the built-in function *range()*. Intended for expressions of the form *"for page in doc.pages(start, stop, step): ..."*.
ja: 一連のページのためのジェネレーター。パラメーターの意味は組み込みの *range()* 関数と同じです。 *"for page in doc.pages(start, stop, step): …"* の形式の式に使用することを意図しています。

en: start iteration with this page number. Default is zero, allowed values are `-∞ < start < page_count`. While this is negative, :attr:`page_count` is added **before** starting the iteration.
ja: このページ番号から反復を開始します。デフォルトはゼロで、許容値は `-∞ < start < page_count` です。負の値の間は反復を開始する **前に** :attr:`page_count` が追加されます。

en: stop iteration at this page number. Default is :attr:`page_count`, possible are `-∞ < stop <= page_count`. Larger values are **silently replaced** by the default. Negative values will cyclically emit the pages in reversed order. As with the built-in *range()*, this is the first page **not** returned.
ja: このページ番号で反復を停止します。デフォルトは :attr:`page_count` で、可能な値は `-∞ < stop <= page_count` です。大きな値はデフォルトで **静かに置き換えられます** 。負の値は逆順でページを循環的に生成します。組み込みの *range()* 関数と同様に、これは **返されない** 最初のページです。

en: stepping value. Defaults are 1 if start < stop and -1 if start > stop. Zero is not allowed.
ja: ステップ値。start < stop の場合はデフォルトで1、start > stop の場合は-1です。ゼロは許可されていません。

en: a generator iterator over the document's pages. Some examples:
ja: ドキュメントのページに対するジェネレーターイテレーターです。いくつかの例:

en: "doc.pages()" emits all pages.
ja: "doc.pages()" はすべてのページを生成します。

en: "doc.pages(4, 9, 2)" emits pages 4, 6, 8.
ja: "doc.pages(4, 9, 2)" はページ4、6、8を生成します。

en: "doc.pages(0, None, 2)" emits all pages with even numbers.
ja: "doc.pages(0, None, 2)" はすべての偶数ページを生成します。

en: "doc.pages(-2)" emits the last two pages.
ja: "doc.pages(-2)" は最後の2ページを生成します。

en: "doc.pages(-1, -1)" emits all pages in reversed order.
ja: "doc.pages(-1, -1)" は逆の順序ですべてのページを生成します。

en: "doc.pages(-1, -10)" always emits 10 pages in reversed order, starting with the last page -- **repeatedly** if the document has less than 10 pages. So for a 4-page document the following page numbers are emitted: 3, 2, 1, 0, 3, 2, 1, 0, 3, 2, 1, 0, 3.
ja: "doc.pages(-1, -10)" は常に逆の順序で10ページを生成し、最後のページから始まり、ドキュメントが10ページ未満の場合は **繰り返し** 生成します。したがって、4ページのドキュメントの場合、次のページ番号が生成されます: 3、2、1、0、3、2、1、0、3、2、1、0、3。

en: Create a PDF version of the current document and write it to memory. **All document types** are supported. The parameters have the same meaning as in :meth:`insert_pdf`. In essence, you can restrict the conversion to a page subset, specify page rotation, and revert page sequence.
ja: 現在のドキュメントのPDFバージョンを作成し、メモリに書き込みます。**すべてのドキュメントタイプ** がサポートされています。パラメータは :meth:`insert_pdf` と同じ意味を持ちます。 基本的に、ページのサブセットに変換を制限し、ページの回転を指定し、ページの順序を逆にすることができます。

en: first page to copy (0-based). Default is first page.
ja: コピーする最初のページ（0ベース）。デフォルトは最初のページです。

en: last page to copy (0-based). Default is last page.
ja: コピーする最後のページ（0ベース）。デフォルトは最後のページです。

en: rotation angle. Default is 0 (no rotation). Should be *n * 90* with an integer n (not checked).
ja: 回転角度。デフォルトは0度（回転なし）です。整数n（チェックされていない）で *n * 90* である必要があります。

en: a Python *bytes* object containing a PDF file image. It is created by internally using `tobytes(garbage=4, deflate=True)`. See :meth:`tobytes`. You can output it directly to disk or open it as a PDF. Here are some examples::
ja: PDFファイルイメージを含むPythonの *bytes* オブジェクト。内部的に `tobytes(garbage=4, deflate=True)` を使用して作成されます。:meth:`tobytes` を参照してください。これを直接ディスクに出力するか、PDFとして開くことができます。以下にいくつかの例を示します::

en: The method uses the same logic as the *mutool convert* CLI. This works very well in most cases -- however, beware of the following limitations.
ja: このメソッドは、*mutool convert* CLIと同じロジックを使用しています。これはほとんどの場合非常にうまく機能しますが、以下の制限に注意してください。

en: Image files: perfect, no issues detected. However, image transparency is ignored. If you need that (like for a watermark), use :meth:`Page.insert_image` instead. Otherwise, this method is recommended for its much better performance.
ja: 画像ファイル: 完璧で、問題は検出されません。ただし、画像の透明度は無視されます。透明度が必要な場合（ウォーターマークなど）、代わりに :meth:`Page.insert_image` を使用してください。それ以外の場合、このメソッドははるかに優れたパフォーマンスのために推奨されます。

en: XPS: appearance very good. Links work fine, outlines (bookmarks) are lost, but can easily be recovered [#f2]_.
ja: XPS: 外観は非常に良好です。リンクは正常に機能し、アウトライン（ブックマーク）は失われますが、簡単に回復できます [#f2]_。

en: EPUB, CBZ, FB2: similar to XPS.
ja: EPUB、CBZ、FB2: XPSと類似しています。

en: SVG: medium. Roughly comparable to `svglib <https://github.com/deeplook/svglib>`_.
ja: SVG: 中程度です。おおよそ `svglib <https://github.com/deeplook/svglib>`_ と比較できます。

en: Creates a table of contents (TOC) out of the document's outline chain.
ja: ドキュメントのアウトラインチェーンから目次（TOC）を作成します。

en: Indicates whether a simple or a detailed TOC is required. If *False*, each item of the list also contains a dictionary with :ref:`linkDest` details for each outline entry.
ja: 簡単なTOCまたは詳細なTOCが必要かを示す値です。*False* の場合、リストの各アイテムにはアウトラインエントリごとの :ref:`linkDest` の詳細を含む辞書も含まれます。

en: a list of lists. Each entry has the form *[lvl, title, page, dest]*. Its entries have the following meanings:
ja: リストのリスト。各エントリは次の形式を持っています: *[lvl, title, page, dest]* 。そのエントリは次の意味を持っています:

en: *lvl* -- hierarchy level (positive *int*). The first entry is always 1. Entries in a row are either **equal**, **increase** by 1, or **decrease** by any number.
ja: *lvl* – 階層レベル（正の整数）。最初のエントリは常に1です。行内のエントリは **等しい** か、1ずつ **増加** または任意の数で **減少** します。

en: *title* -- title (*str*)
ja: *title* – タイトル（*str*）

en: *dest* -- (*dict*) included only if *simple=False*. Contains details of the TOC item as follows:
ja: *dest* – (*dict*) *simple=False* の場合のみ含まれます。TOCアイテムの詳細が以下のように含まれます:

en: kind: destination kind, see :ref:`linkDest Kinds`.
ja: kind: 宛先の種類、:ref:`linkDest Kinds` を参照。

en: file: filename if kind is :data:`LINK_GOTOR` or :data:`LINK_LAUNCH`.
ja: file: `kind` が :data:`LINK_GOTOR` または :data:`LINK_LAUNCH` の場合のファイル名。

en: page: target page, 0-based, :data:`LINK_GOTOR` or :data:`LINK_GOTO` only.
ja: page: ターゲットページ、0ベース、:data:`LINK_GOTOR` または :data:`LINK_GOTO` の場合のみ。

en: to: position on target page (:ref:`Point`).
ja: to: ターゲットページ上の位置 (:ref:`Point`)。

en: zoom: (float) zoom factor on target page.
ja: zoom: ターゲットページ上のズームファクター（float）。

en: xref: :data:`xref` of the item (0 if no PDF).
ja: xref: アイテムの :data:`xref` （PDFがない場合は0）。

en: color: item color in PDF RGB format `(red, green, blue)`, or omitted (always omitted if no PDF).
ja: color: PDF RGB形式 `(red, green, blue)` のアイテムカラー、または省略（PDFがない場合は常に省略）。

en: bold: true if bold item text or omitted. PDF only.
ja: bold: アイテムテキストが太字の場合、または省略。PDFのみ。

en: italic: true if italic item text, or omitted. PDF only.
ja: italic: アイテムテキストがイタリックの場合、または省略。PDFのみ。

en: collapse: true if sub-items are folded, or omitted. PDF only.
ja: collapse: サブアイテムが折りたたまれている場合、または省略。PDFのみ。

en: PDF only: Return the PDF dictionary keys of the :data:`dictionary` object provided by its xref number.
ja: PDFのみ: xref番号で提供される :data:`dictionary` オブジェクトのPDF辞書キーを返します。

en: the :data:`xref`. *(Changed in v1.18.10)* Use `-1` to access the special dictionary "PDF trailer".
ja: :data:`xref` 。 *(v1.18.10で変更)* "PDF trailer" としてアクセスするには `-1` を使用します。

en: a tuple of dictionary keys present in object :data:`xref`. Examples:
ja: :data:`xref` オブジェクトに存在する辞書キーのタプル。例:

en: PDF only: Return type and value of a PDF dictionary key of a :data:`dictionary` object given by its xref.
ja: PDFのみ: xrefによって提供される :data:`dictionary` オブジェクトのPDF辞書キーの戻り値の型と値を返します。

en: the :data:`xref`. *Changed in v1.18.10:* Use `-1` to access the special dictionary "PDF trailer".
ja: :data:`xref` 。*v1.18.10で変更:* 特別な辞書 "PDF trailer"  にアクセスするには `-1` を使用します。

en: the desired PDF key. Must **exactly** match (case-sensitive) one of the keys contained in :meth:`Document.xref_get_keys`.
ja: 望ましいPDFキー。:meth:`Document.xref_get_keys` に含まれるキーのいずれかと厳密に一致する必要があります（大文字と小文字を区別します）。

en: A tuple (type, value) of strings, where type is one of "xref", "array", "dict", "int", "float", "null", "bool", "name", "string" or "unknown" (should not occur). Independent of "type", the value of the key is **always** formatted as a string -- see the following example -- and (almost always) a faithful reflection of what is stored in the PDF. In most cases, the format of the value string also gives a clue about the key type:
ja: 文字列のタプル（type、value）、ここでtypeは次のいずれかです: "xref"、"array"、"dict"、"int"、"float"、"null"、"bool"、"name"、"string" または "unknown"（発生しないはず）。"type" に関係なく、キーの値は **常に** 文字列としてフォーマットされます – 以下の例を参照 – そして（ほとんどの場合）PDFに格納されている内容の忠実な反映です。ほとんどの場合、値文字列のフォーマットもキーのタイプについてのヒントを提供します:

en: A "name" always starts with a "/" slash.
ja: "name" は常に "/" スラッシュで始まります。

en: An "xref" always ends with " 0 R".
ja: "xref" は常に " 0 R" で終わります。

en: An "array" is always enclosed in "[...]" brackets.
ja: "array" は常に "[...]" 角括弧で囲まれています。

en: A "dict" is always enclosed in "<<...>>" brackets.
ja: "dict" は常に "<<...>>" 角括弧で囲まれています。

en: A "bool", resp. "null" always equal either "true", "false", resp. "null".
ja: "bool" または "null" は常に "true"、"false" または "null" のいずれかです。

en: "float" and "int" are represented by their string format -- and are thus not always distinguishable.
ja: "float" と "int" は文字列形式で表され、したがって常に区別できるわけではありません。

en: A "string" is converted to UTF-8 and may therefore deviate from what is stored in the PDF. For example, the PDF key "Author" may have a value of "<FEFF004A006F0072006A00200058002E0020004D0063004B00690065>" in the file, but the method will return `('string', 'Jorj X. McKie')`.
ja: "string" はUTF-8に変換され、したがってPDFに格納されている内容と異なる場合があります。たとえば、PDFキー "Author" はファイル内で "FEFF004A006F0072006A00200058002E0020004D0063004B00690065" という値を持つかもしれませんが、このメソッドは  `('string', 'Jorj X. McKie')` を返します。

en: New in v1.18.7, changed in v 1.18.13
ja: バージョン1.18.7で新規追加、バージョン1.18.13で変更されました。

en: Changed in v1.19.4: remove a key "physically" if set to "null".
ja: バージョン1.19.4で変更: "null" に設定された場合、キーを "物理的に" 削除します。

en: PDF only: Set (add, update, delete) the value of a PDF key for the :data:`dictionary` object given by its xref.
ja: PDFのみ: xrefによって提供される :data:`dictionary` オブジェクトのPDFキーの値を設定（追加、更新、削除）します。

en: This is an expert function: if you do not know what you are doing, there is a high risk to render (parts of) the PDF unusable. Please do consult :ref:`AdobeManual` about object specification formats (page 18) and the structure of special dictionary types like page objects.
ja: これはエキスパート向けの機能です。何をしているのかわからない場合、PDFの（一部の）使用不能の高いリスクがあります。PDFオブジェクト仕様フォーマット（ページ18）やページオブジェクトなどの特別な辞書タイプの構造については :ref:`AdobeManual` を参照してください。

en: the :data:`xref`. *Changed in v1.18.13:* To update the PDF trailer, specify -1.
ja: :data:`xref` 。バージョン1.18.13で変更: PDFトレーラーを更新する場合、-1を指定します。

en: the desired PDF key (without leading "/"). Must not be empty. Any valid PDF key -- whether already present in the object (which will be overwritten) -- or new. It is possible to use PDF path notation like `"Resources/ExtGState"` -- which sets the value for key `"/ExtGState"` as a sub-object of `"/Resources"`.
ja: 望ましいPDFキー（先頭の "/" なし）。空であってはいけません。既にオブジェクト内に存在するかどうかに関係なく、新しいPDFキーでも構いません。PDFパス表記 （`"Resources/ExtGState"` のような）を使用して、`"/Resources"` のサブオブジェクトとしてキー `"/ExtGState"` の値を設定することも可能です。

en: the value for the key. It must be a non-empty string and, depending on the desired PDF object type, the following rules must be observed. There is some syntax checking, but **no type checking** and no checking if it makes sense PDF-wise, i.e. **no semantics checking**. Upper / lower case is important!
ja: キーの値。空でない文字列である必要があり、望ましいPDFオブジェクトのタイプに応じて以下のルールを守る必要があります。一部の構文チェックは行われますが、型チェックやPDFとして意味があるかどうかのチェックは行われません。大文字と小文字の区別が重要です！

en: **xref** -- must be provided as `"nnn 0 R"` with a valid :data:`xref` number nnn of the PDF. The suffix "`0 R`" is required to be recognizable as an xref by PDF applications.
ja: **xref** – 有効なPDFのxref番号nnnを持つ `"nnn 0 R"` として提供される必要があります。サフィックス "`0 R`" はPDFアプリケーションによって :data:`xref` として認識されるため必要です。

en: **array** -- a string like `"[a b c d e f]"`. The brackets are required. Array items must be separated by at least one space (not commas like in Python). An empty array `"[]"` is possible and *equivalent* to removing the key. Array items may be any PDF objects, like dictionaries, xrefs, other arrays, etc. Like in Python, array items may be of different types.
ja: **array** – `"[a b c d e f]"` のような文字列。角括弧が必要です。配列の要素は少なくとも1つのスペースで区切られている必要があります（Pythonのようなカンマではありません）。空の配列 `"[]"` も可能で、キーを削除することと *同等* です。配列のアイテムは、辞書、xref、他の配列など、PDFオブジェクトである必要があります。Pythonと同様に、配列のアイテムは異なるタイプである場合があります。

en: **dict** -- a string like `"<< ... >>"`. The brackets are required and must enclose a valid PDF dictionary definition. The empty dictionary `"<<>>"` is possible and *equivalent* to removing the key.
ja: **dict** – `"<< ... >>"` のような文字列。角括弧が必要で、有効なPDF辞書定義を囲む必要があります。空の辞書 `"<<>>"` も可能で、キーを削除することと *同等* です。

en: **int** -- an integer formatted **as a string**.
ja: **int** – **文字列として** フォーマットされた整数。

en: **float** -- a float formatted **as a string**. Scientific notation (with exponents) is **not allowed by PDF**.
ja: **float**  – 文字列としてフォーマットされた浮動小数点数。科学的表記法（指数を含む）は **PDFでは許可されていません** 。

en: **null** -- the string `"null"`. This is the PDF equivalent to Python's `None` and causes the key to be ignored -- however not necessarily removed, resp. removed on saves with garbage collection. *Changed in v1.19.4:* If the key is no path hierarchy (i.e. contains no slash "/"), then it will be completely removed.
ja: **null** – 文字列 `"null"`。これはPythonの `None` に相当し、キーを無視させますが、必ずしも削除されるわけではありません。ガベージコレクションを伴う保存時に削除される場合があります。*バージョン1.19.4で変更:* キーがパス階層でない場合（つまりスラッシュ "/" を含まない場合）、それは完全に削除されます。

en: **bool** -- one of the strings `"true"` or `"false"`.
ja: **bool** – `"true"` または `"false"` のいずれかの文字列。

en: **name** -- a valid PDF name with a leading slash like this: `"/PageLayout"`. See page 16 of the :ref:`AdobeManual`.
ja: **name** – `"/PageLayout"` のように先頭にスラッシュを持つ有効なPDF名。:ref:`AdobeManual` のページ16を参照してください。

en: **string** -- a valid PDF string. **All PDF strings must be enclosed by brackets**. Denote the empty string as `"()"`. Depending on its content, the possible brackets are
ja: **string** – 有効なPDF文字列。 **すべてのPDF文字列は角括弧で囲まれている必要があります** 。空の文字列は `"()"` として表記されます。内容に応じて、可能な角括弧は次の通りです。

en: "(...)" for ASCII-only text. Reserved PDF characters must be backslash-escaped and non-ASCII characters must be provided as 3-digit backslash-escaped octals -- including leading zeros. Example: 12 = 0x0C must be encoded as `\014`.
ja: "(…)"：ASCIIのテキストの場合。予約されたPDF文字はバックスラッシュでエスケープし、非ASCII文字は先頭にゼロパディングされた3桁のバックスラッシュエスケープの8進数で提供する必要があります。例: 12 = 0x0C は `\014` としてエンコードする必要があります。

en: "<...>" for hex-encoded text. Every character must be represented by two hex-digits (lower or upper case).
ja: "<…>"：16進数でエンコードされたテキストの場合。各文字は2桁の16進数で表されなければなりません（大文字または小文字）。

en: If in doubt, we **strongly recommend** to use :meth:`get_pdf_str`! This function automatically generates the right brackets, escapes, and overall format. It will for example do conversions like these:
ja: 疑念がある場合は、:meth:`get_pdf_str` の使用を**強くお勧めします**！この関数は自動的に適切な角括弧、エスケープ、および全体のフォーマットを生成します。たとえば、次のような変換を行います。

en: Creates a pixmap from page *pno* (zero-based). Invokes :meth:`Page.get_pixmap`.
ja: *pno* （ゼロベース）のページからピクスマップを作成します。:meth:`Page.get_pixmap` を呼び出します。

en: All parameters except `pno` are *keyword-only.*
ja: `pno` 以外のすべてのパラメーターは *キーワード専用* です。

en: page number, 0-based in `-∞ < pno < page_count`.
ja: pno (int) – ページ番号、ゼロベース、`-∞ < pno < page_count`。

en: New in v1.16.13
ja: バージョン1.16.13で新規追加

en: Changed in v1.18.11
ja: バージョン1.18.11で変更

en: PDF only: Return a list of all XObjects referenced by a page.
ja: PDFのみ: ページによって参照されるすべてのXObjectのリストを返します。

en: page number, 0-based, `-∞ < pno < page_count`.
ja: ページ番号、ゼロベース、`-∞ < pno < page_count`。

en: a list of (non-image) XObjects. These objects typically represent pages *embedded* (not copied) from other PDFs. For example, :meth:`Page.show_pdf_page` will create this type of object. An item of this list has the following layout: `(xref, name, invoker, bbox)`, where
ja: （画像でない）XObjectのリスト。これらのオブジェクトは通常、他のPDFから **埋め込まれた** （コピーされていない）ページを表します。例えば、:meth:`Page.show_pdf_page` はこのタイプのオブジェクトを作成します。このリストのアイテムは以下のレイアウトを持っています：`(xref, name, invoker, bbox)`、ここで

en: **xref** (*int*) is the XObject's :data:`xref`.
ja: **xref** (*int*) はXObjectの :data:`xref` です。

en: **name** (*str*) is the symbolic name to reference the XObject.
ja: **name** (*str*) はXObjectを参照するための象徴的な名前です。

en: **invoker** (*int*) the :data:`xref` of the invoking XObject or zero if the page directly invokes it.
ja: **invoker** (*int*) は、ページがそれを直接呼び出す場合はゼロ、それ以外の場合は呼び出し元XObjectの :data:`xref` です。

en: **bbox** (:ref:`Rect`) the boundary box of the XObject's location on the page **in untransformed coordinates**. To get actual, non-rotated page coordinates, multiply with the page's transformation matrix :attr:`Page.transformation_matrix`. *Changed in v.18.11:* the bbox is now formatted as :ref:`Rect`.
ja: **bbox** (:ref:`Rect`) はXObjectのページ上の位置の境界ボックスで、**変換されていない座標で** 表されます。実際の、回転していないページ座標を取得するには、ページの変換行列 :attr:`Page.transformation_matrix` を掛けてください。*バージョン1.18.11で変更:* **bbox** は今や :ref:`Rect` としてフォーマットされています。

en: PDF only: Return a list of all images (directly or indirectly) referenced by the page.
ja: PDFのみ: ページによって参照されるすべての画像（直接または間接的に）のリストを返します。

en: whether to also include the referencer's :data:`xref` (which is zero if this is the page).
ja: このページがそのページ自体の場合、参照元の :data:`xref` も含めるかどうか（これがページの場合はゼロ）。

en: a list of images **referenced** by this page. Each item looks like
ja: このページで **参照されている** 画像のリスト。各アイテムは以下のようになります：

en: Where
ja: ここで

en: **xref** (*int*) is the image object number
ja: **xref** (*int*) は画像オブジェクトの番号です

en: **smask** (*int*) is the object number of its soft-mask image
ja: **smask** (*int*) はそのソフトマスク画像のオブジェクト番号です

en: **width** and **height** (*ints*) are the image dimensions
ja: **width** と **height** （*int*）は画像の寸法です

en: **bpc** (*int*) denotes the number of bits per component (normally 8)
ja: **bpc** (*int*) はコンポーネントごとのビット数を示します（通常は8）

en: **colorspace** (*str*) a string naming the colorspace (like **DeviceRGB**)
ja: **colorspace** (*str*) は色空間の名前を示す文字列です（ **DeviceRGB** など）

en: **alt. colorspace** (*str*) is any alternate colorspace depending on the value of **colorspace**
ja: **alt. colorspace** (*str*) は **colorspace** の値に依存する代替の色空間です

en: **name** (*str*) is the symbolic name by which the image is referenced
ja: **name** (*str*) は画像が参照される際の象徴的な名前です

en: **filter** (*str*) is the decode filter of the image (:ref:`AdobeManual`, pp. 22).
ja: **filter** (*str*) は画像のデコードフィルタです（:ref:`AdobeManual`、pp. 22）。

en: **referencer** (*int*) the :data:`xref` of the referencer. Zero if directly referenced by the page. Only present if *full=True*.
ja: **referencer** (*int*) は参照元の :data:`xref` です。直接ページから参照されている場合はゼロ。 *full=True* の場合のみ存在します

en: In general, this is not the list of images that are **actually displayed**. This method only parses several PDF objects to collect references to embedded images. It does not analyse the page's :data:`contents`, where all the actual image display commands are defined. To get this information, please use :meth:`Page.get_image_info`. Also have a look at the discussion in section :ref:`textpagedict`.
ja: 一般的に、これは **実際に表示されている** 画像のリストではありません。このメソッドは埋め込まれた画像への参照を収集するためにいくつかのPDFオブジェクトのみを解析します。実際の画像表示コマンドが定義されているページの内容は解析しません。この情報を取得するには、:meth:`Page.get_image_info` を使用してください。また、:ref:`textpagedict` のセクションでの議論もご覧ください。

en: PDF only: Return a list of all fonts (directly or indirectly) referenced by the page.
ja: PDFのみ: ページによって参照されるすべてのフォント（直接または間接的に）のリストを返します。

en: whether to also include the referencer's :data:`xref`. If *True*, the returned items are one entry longer. Use this option if you need to know, whether the page directly references the font. In this case the last entry is 0. If the font is referenced by an `/XObject` of the page, you will find its :data:`xref` here.
ja: 参照元の :data:`xref` も含めるかどうか。*True* の場合、返されるアイテムは1つ多くなります。ページがフォントを直接参照しているかどうかを知る必要がある場合は、このオプションを使用します。この場合、最後のエントリは0です。フォントがページの `/XObject` によって参照される場合、その :data:`xref` をここで見つけることができます。

en: a list of fonts referenced by this page. Each entry looks like
ja: このページで参照されているフォントのリスト。各エントリは以下のようになります：

en: where
ja: ここで

en: **xref** (*int*) is the font object number (may be zero if the PDF uses one of the builtin fonts directly)
ja: **xref** (*int*) はフォントオブジェクト番号です（PDFが組み込みフォントを直接使用している場合、ゼロになることがあります）

en: **ext** (*str*) font file extension (e.g. "ttf", see :ref:`FontExtensions`)
ja: **ext** (*str*) フォントファイルの拡張子（例: "ttf"、:ref:`FontExtensions` を参照）

en: **type** (*str*) is the font type (like "Type1" or "TrueType" etc.)
ja: **type** (*str*) フォントの種類（"Type1"や"TrueType"など）

en: **basefont** (*str*) is the base font name,
ja: **basefont** (*str*) ベースフォント名

en: **name** (*str*) is the symbolic name, by which the font is referenced
ja: **name** (*str*) フォントが参照される象徴的な名前

en: **encoding** (*str*) the font's character encoding if different from its built-in encoding (:ref:`AdobeManual`, p. 254):
ja: **encoding** (*str*) フォントの文字エンコーディング。組み込みエンコーディングと異なる場合（:ref:`AdobeManual`、p. 254を参照）：

en: **referencer** (*int* optional) the :data:`xref` of the referencer. Zero if directly referenced by the page, otherwise the xref of an XObject. Only present if *full=True*.
ja: **referencer** (*int*、オプション) 参照元のxref。ページから直接参照されている場合は0、それ以外の場合はXObjectの :data:`xref` です。 *full=True* の場合のみ存在します。

en: Example::
ja: 例::

en: This list has no duplicate entries: the combination of :data:`xref`, *name* and *referencer* is unique.
ja: このリストには重複するエントリはありません：:data:`xref` 、*name* 、および *referencer* の組み合わせは一意です。

en: In general, this is a superset of the fonts actually in use by this page. The PDF creator may e.g. have specified some global list, of which each page only makes partial use.
ja: 一般的に、これはこのページで実際に使用されているフォントのスーパーセットです。PDF作成者は、各ページが部分的にしか使用しない、グローバルリストを指定したかもしれません。

en: Extracts the text of a page given its page number *pno* (zero-based). Invokes :meth:`Page.get_text`.
ja: ページ番号 *pno* （0から始まる）を指定して、ページのテキストを抽出します。:meth:`Page.get_text` を呼び出します。

en: page number, 0-based, any value `-∞ < pno < page_count`.
ja: ページ番号、0から始まる、任意の値 `-∞ < pno < page_count`。

en: For other parameter refer to the page method.
ja: その他のパラメータについては、ページのメソッドを参照してください。

en: Re-paginate ("reflow") the document based on the given page dimension and fontsize. This only affects some document types like e-books and HTML. Ignored if not supported. Supported documents have *True* in property :attr:`is_reflowable`.
ja: 与えられたページの寸法とフォントサイズに基づいて、ドキュメントを再ページ割り（"リフロー"）します。これは電子書籍やHTMLなどの一部のドキュメントタイプにのみ影響します。サポートされていない場合は無視されます。サポートされているドキュメントには :attr:`is_reflowable` プロパティで *True* が設定されています。

en: desired page size. Must be finite, not empty and start at point (0, 0).
ja: 望ましいページサイズ。有限で、空でなく、ポイント（0, 0）で始まる必要があります。

en: use it together with *height* as alternative to *rect*.
ja: *rect* との代替として、*height* と一緒に使用します。

en: use it together with *width* as alternative to *rect*.
ja: *rect* との代替として、*width* と一緒に使用します。

en: the desired default fontsize.
ja: 望ましいデフォルトのフォントサイズ。

en: PDF only: Keeps only those pages of the document whose numbers occur in the list. Empty sequences or elements outside `range(doc.page_count)` will cause a *ValueError*. For more details see remarks at the bottom or this chapter.
ja: PDFのみ：ドキュメントのページ番号がリストに含まれるページのみ保持します。空のシーケンスまたは範囲外の要素 `range(doc.page_count)` は *ValueError* を引き起こします。詳細については、この章の最後の注釈を参照してください。

en: The sequence (see :ref:`SequenceTypes`) of page numbers (zero-based) to be included. Pages not in the sequence will be deleted (from memory) and become unavailable until the document is reopened. **Page numbers can occur multiple times and in any order:** the resulting document will reflect the sequence exactly as specified.
ja: (:ref:`SequenceTypes`) – ページ番号（0から始まる）のシーケンス（PyMuPDFで引数として使用する場合はPythonシーケンスを使用）を含めるためのもの。シーケンス内に含まれていないページは（メモリから）削除され、ドキュメントが再オープンされるまで利用できなくなります。**ページ番号は複数回発生し、任意の順序で発生できます：** 結果のドキュメントは指定された正確なシーケンスを反映します。

en: Page numbers in the sequence need not be unique nor be in any particular order. This makes the method a versatile utility to e.g. select only the even or the odd pages or meeting some other criteria and so forth.
ja: シーケンス内のページ番号は一意である必要も、特定の順序である必要もありません。これにより、この方法は、例えば偶数のページだけを選択したり、奇数のページだけを選択したり、その他の基準を満たしたりするなど、多目的に使用できます。

en: On a technical level, the method will always create a new :data:`pagetree`.
ja: 技術的なレベルでは、この方法は常に新しい :data:`pagetree` を作成します。

en: When dealing with only a few pages, methods :meth:`copy_page`, :meth:`move_page`, :meth:`delete_page` are easier to use. In fact, they are also **much faster** -- by at least one order of magnitude when the document has many pages.
ja: 数ページしか扱わない場合、methods :meth:`copy_page` 、:meth:`move_page`、:meth:`delete_page` を使用する方が簡単です。実際、これらの方法は、文書に多くのページがある場合でも、少なくとも1桁のオーダーで **高速です** 。

en: PDF only: Sets or updates the metadata of the document as specified in *m*, a Python dictionary.
ja: PDFのみ： *m* で指定されたPythonの辞書と同じキーを持つ辞書を設定または更新します。

en: A dictionary with the same keys as *metadata* (see below). All keys are optional. A PDF's format and encryption method cannot be set or changed and will be ignored. If any value should not contain data, do not specify its key or set the value to `None`. If you use *{}* all metadata information will be cleared to the string *"none"*. If you want to selectively change only some values, modify a copy of *doc.metadata* and use it as the argument. Arbitrary unicode values are possible if specified as UTF-8-encoded.
ja: *metadata* （以下参照）と同じキーを持つ辞書。すべてのキーはオプションです。PDFのフォーマットと暗号化方法は設定または変更できないため、無視されます。データを含めないべき値がある場合、そのキーを指定しないか、値を `None` に設定しないでください。*{}* を使用すると、すべてのメタデータ情報が文字列 *"none"* にクリアされます。一部の値のみを選択的に変更したい場合は、*doc.metadata* のコピーを変更して引数として使用してください。UTF-8でエンコードされた場合、任意のUnicode値が指定可能です。

en: *(Changed in v1.18.4)* Empty values or "none" are no longer written, but completely omitted.
ja: *（v1.18.4で変更）* 空の値または "none" は書き込まれなくなり、完全に省略されます。

en: PDF only: Get the document XML metadata.
ja: PDFのみ：ドキュメントのXMLメタデータを取得します。

en: XML metadata of the document. Empty string if not present or not a PDF.
ja: ドキュメントのXMLメタデータ。存在しない場合やPDFでない場合は空の文字列。

en: PDF only: Sets or updates XML metadata of the document.
ja: PDFのみ：ドキュメントのXMLメタデータを設定または更新します。

en: the new XML metadata. Should be XML syntax, however no checking is done by this method and any string is accepted.
ja: xml（str）–新しいXMLメタデータ。XML構文である必要がありますが、このメソッドではチェックされず、任意の文字列が受け入れられます。

en: New in v1.22.2
ja: v1.22.2で新登場

en: PDF only: Set the `/PageLayout`.
ja: PDFのみ：`/PageLayout` を設定します。

en: one of the strings "SinglePage", "OneColumn", "TwoColumnLeft", "TwoColumnRight", "TwoPageLeft", "TwoPageRight". Lower case is supported.
ja: 以下の文字列のいずれか、"SinglePage"、"OneColumn"、"TwoColumnLeft"、"TwoColumnRight"、"TwoPageLeft"、"TwoPageRight"。小文字もサポートされています。

en: PDF only: Set the `/PageMode`.
ja: PDFのみ：`/PageMode` を設定します。

en: one of the strings "UseNone", "UseOutlines", "UseThumbs", "FullScreen", "UseOC", "UseAttachments". Lower case is supported.
ja: 以下の文字列のいずれか、"UseNone"、"UseOutlines"、"UseThumbs"、"FullScreen"、"UseOC"、"UseAttachments"。小文字もサポートされています。

en: PDF only: Set the `/MarkInfo` values.
ja: PDFのみ：`/MarkInfo` の値を設定します。

en: a dictionary like this one: `{"Marked": False, "UserProperties": False, "Suspects": False}`. This dictionary contains information about the usage of Tagged PDF conventions. For details please see the `PDF specifications <https://opensource.adobe.com/dc-acrobat-sdk-docs/standards/pdfstandards/pdf/PDF32000_2008.pdf>`_.
ja: 次のような辞書：`{"Marked": False, "UserProperties": False, "Suspects": False}`。この辞書にはタグ付きPDF規則の使用に関する情報が含まれています。詳細については `PDF仕様 <https://opensource.adobe.com/dc-acrobat-sdk-docs/standards/pdfstandards/pdf/PDF32000_2008.pdf>`_ を参照してください。

en: PDF only: Replaces the **complete current outline** tree (table of contents) with the one provided as the argument. After successful execution, the new outline tree can be accessed as usual via :meth:`Document.get_toc` or via :attr:`Document.outline`. Like with other output-oriented methods, changes become permanent only via :meth:`save` (incremental save supported). Internally, this method consists of the following two steps. For a demonstration see example below.
ja: PDFのみ：提供された引数で **現在のアウトラインツリー（目次）全体** を置き換えます。成功した実行後、新しいアウトラインツリーは通常通り D :meth:`Document.get_toc` または :attr:`Document.outline` を使用してアクセスできます。他の出力指向のメソッドと同様に、変更は :meth:`save` （増分保存対応）を介してのみ永続的になります。内部的には、このメソッドは次の2つのステップで構成されています。デモンストレーションについては以下の例を参照してください。

en: Step 1 deletes all existing bookmarks.
ja: ステップ1：すべての既存のブックマークを削除します。

en: Step 2 creates a new TOC from the entries contained in *toc*.
ja: ステップ2：*toc* に含まれるエントリを使用して新しいTOCを作成します。

en: A list / tuple with **all bookmark entries** that should form the new table of contents. Output variants of :meth:`get_toc` are acceptable. To completely remove the table of contents specify an empty sequence or None. Each item must be a list with the following format.
ja: 新しい目次を形成するための **すべてのブックマークエントリ** を含むリスト/タプル。:meth:`get_toc` の出力バリエーションが許容されます。目次を完全に削除するには、空のシーケンスまたはNoneを指定してください。各アイテムは、次の形式である必要があります。

en: [lvl, title, page [, dest]] where
ja: [lvl, title, page [, dest]] ここで

en: **lvl** is the hierarchy level (int > 0) of the item, which **must be 1** for the first item and at most 1 larger than the previous one.
ja: **lvl** はアイテムの階層レベル（int > 0）で、最初のアイテムの場合は1で、前のアイテムより最大1大きくする必要があります。

en: **title** (str) is the title to be displayed. It is assumed to be UTF-8-encoded (relevant for multibyte code points only).
ja: **title** （str）は表示されるタイトルです。UTF-8でエンコードされていると仮定されています（マルチバイトコードポイントの場合に関連します）。

en: **page** (int) is the target page number **(attention: 1-based)**. Must be in valid range if positive. Set it to -1 if there is no target, or the target is external.
ja: **page**（int）は対象のページ番号です **（注意：1から始まります）** 。正の場合、有効な範囲内になければなりません。対象がない場合、または対象が外部の場合は-1に設定します。

en: **dest** (optional) is a dictionary or a number. If a number, it will be interpreted as the desired height (in points) this entry should point to on the page. Use a dictionary (like the one given as output by `get_toc(False)`) for a detailed control of the bookmark's properties, see :meth:`Document.get_toc` for a description.
ja: **dest** （オプション）は辞書または数値です。数値の場合、このエントリがページ上で指し示すべき目標の高さ（ポイント単位）と解釈されます。詳細なブックマークのプロパティを制御するには（`get_toc(False)` によって出力されるものと同様の辞書を使用してください）、:meth:`Document.get_toc` の説明を参照してください。

en: *(new in v1.16.9)* controls the hierarchy level beyond which outline entries should initially show up collapsed. The default 1 will hence only display level 1, higher levels must be unfolded using the PDF viewer. To unfold everything, specify either a large integer, 0 or None.
ja: *（v1.16.9で新規追加）* アウトラインエントリが初めて折りたたまれて表示される階層レベルを制御します。デフォルトの1はレベル1のみを表示し、より高いレベルはPDFビューアを使用して展開する必要があります。すべてを展開するには、大きな整数、0、またはNoneを指定してください。

en: the number of inserted, resp. deleted items.
ja: 挿入されたアイテム、または削除されたアイテムの数。

en: PDF only: Return the :data:`xref` of the outline item. This is mainly used for internal purposes.
ja: PDFのみ：アウトラインアイテムの :data:`xref` を返します。これは主に内部用途で使用されます。

en: arg int idx: index of the item in list :meth:`Document.get_toc`.
ja: 引数 int idx: :meth:`Document.get_toc` リスト内のアイテムのインデックス。

en: Changed in v1.18.14: no longer remove the item's text, but show it grayed-out.
ja: v1.18.14で変更: アイテムのテキストを削除しなくなり、灰色で表示されます。

en: PDF only: Remove this TOC item. This is a high-speed method, which **disables** the respective item, but leaves the overall TOC structure intact. Physically, the item still exists in the TOC tree, but is shown grayed-out and will no longer point to any destination.
ja: PDFのみ: この目次アイテムを削除します。これは高速なメソッドで、該当するアイテムを **無効にします** が、全体の目次構造はそのままです。物理的には、アイテムはまだ目次ツリーに存在しますが、灰色で表示され、もはやどの宛先も指し示しません。

en: This also implies that you can reassign the item to a new destination using :meth:`Document.set_toc_item`, when required.
ja: これはまた、必要な場合に:meth:`Document.set_toc_item` を使用してアイテムを新しい宛先に再割り当てできることを意味します。

en: the index of the item in list :meth:`Document.get_toc`.
ja: :meth:`Document.get_toc` のリスト内のアイテムのインデックス。

en: Changed in v1.18.6
ja: v1.18.6で変更

en: PDF only: Changes the TOC item identified by its index. Change the item **title**, **destination**, **appearance** (color, bold, italic) or collapsing sub-items -- or to remove the item altogether.
ja: PDFのみ: インデックスによって識別されるTOCアイテムを変更します。アイテムの **タイトル** 、**宛先** 、 **外観** （色、太字、イタリック）を変更したり、サブアイテムを折りたたんだり、アイテムを完全に削除したりするために使用します。

en: Use this method if you need specific changes for selected entries only and want to avoid replacing the complete TOC. This is beneficial especially when dealing with large table of contents.
ja: 選択したエントリに対して特定の変更が必要で、完全なTOCを置き換えたくない場合にこのメソッドを使用します。大きな目次を扱う場合に特に便利です。

en: the index of the entry in the list created by :meth:`Document.get_toc`.
ja: :meth:`Document.get_toc` によって作成されたリスト内のエントリのインデックス。

en: the new destination. A dictionary like the last entry of an item in `doc.get_toc(False)`. Using this as a template is recommended. When given, **all other parameters are ignored** -- except title.
ja: 新しい宛先。`doc.get_toc(False)` のアイテムの最後のエントリのような辞書を使用することが推奨されます。指定された場合、他の **すべてのパラメータは無視されます** - タイトル以外。

en: the link kind, see :ref:`linkDest Kinds`. If :data:`LINK_NONE`, then all remaining parameter will be ignored, and the TOC item will be removed -- same as :meth:`Document.del_toc_item`. If None, then only the title is modified and the remaining parameters are ignored. All other values will lead to making a new destination dictionary using the subsequent arguments.
ja: リンクの種類、:ref:`linkDest Kinds` を参照してください。:data:`LINK_NONE` の場合、残りのパラメータはすべて無視され、TOCアイテムは削除されます - :meth:`Document.del_toc_item` と同じです。Noneの場合、タイトルのみが変更され、残りのパラメータは無視されます。それ以外の値は、後続の引数を使用して新しい宛先辞書を作成します。

en: the 1-based page number, i.e. a value 1 <= pno <= doc.page_count. Required for LINK_GOTO.
ja: 1から始まるページ番号、つまり1 <= pno <= doc.page_count。LINK_GOTOの場合に必要です。

en: the URL text. Required for LINK_URI.
ja: URLのテキスト。LINK_URIの場合に必要です。

en: the desired new title. None if no change.
ja: 新しいタイトル。変更しない場合はNone。

en: (optional) points to a coordinate on the target page. Relevant for LINK_GOTO. If omitted, a point near the page's top is chosen.
ja: （オプション）対象ページ上の座標を指定します。LINK_GOTOの場合に関連します。省略された場合、ページの上部近くのポイントが選択されます。

en: required for LINK_GOTOR and LINK_LAUNCH.
ja: LINK_GOTORおよびLINK_LAUNCHに必要です。

en: use this zoom factor when showing the target page.
ja: 対象ページを表示する際にこのズームファクターを使用します。

en: **Example use:** Change the TOC of the SWIG manual to achieve this:
ja: **使用例:** SWIGマニュアルのTOCを変更して、次のことを達成します：

en: Collapse everything below top level and show the chapter on Python support in red, bold and italic::
ja: トップレベル以下をすべて折りたたみ、Pythonサポートの章を赤色で太字かつイタリックで表示::

en: In the previous example, we have changed only 42 of the 1240 TOC items of the file.
ja: 前の例では、ファイルの1240のTOCアイテムのうち、わずか42のみを変更しました。

en: New in v1.16.0
ja: v1.16.0で新規追加

en: Check whether the document can be saved incrementally. Use it to choose the right option without encountering exceptions.
ja: ドキュメントを増分保存できるかどうかを確認します。例外を発生させずに正しいオプションを選択するために使用します。

en: New in v1.16.14
ja: v1.16.14で新規追加

en: PDF only: Remove potentially sensitive data from the PDF. This function is inspired by the similar "Sanitize" function in Adobe Acrobat products. The process is configurable by a number of options.
ja: PDFのみ：PDFから潜在的に機密性の高いデータを削除します。この関数はAdobe Acrobat製品の類似の「Sanitize」機能にインスパイアを受けたものです。プロセスはさまざまなオプションで設定可能です。

en: Search for 'FileAttachment' annotations and remove the file content.
ja: 'FileAttachment' 注釈を検索してファイルコンテンツを削除します。

en: Remove any comments from page painting sources. If this option is set to *False*, then this is also done for *hidden_text* and *redactions*.
ja: ページ描画ソースからコメントを削除します。このオプションが *False* に設定されている場合、*hidden_text* と *redactions* に対しても同様の処理が行われます。

en: Remove embedded files.
ja: 埋め込みファイルを削除します。

en: Remove OCRed text and invisible text [#f7]_.
ja: OCRedテキストと不可視テキストを削除します [#f7]_。

en: Remove JavaScript sources.
ja: JavaScriptソースを削除します。

en: Remove PDF standard metadata.
ja: PDF標準のメタデータを削除します。

en: Apply redaction annotations.
ja: レダクション注釈を適用します。

en: how to handle images if applying redactions. One of 0 (ignore), 1 (blank out overlaps) or 2 (remove).
ja: レダクションを適用する場合の画像の処理方法。0（無視）、1（オーバーラップをブランク化）、または2（削除）のいずれかです。

en: Remove all links.
ja: すべてのリンクを削除します。

en: Reset all form fields to their defaults.
ja: すべてのフォームフィールドをデフォルトにリセットします。

en: Remove all responses from all annotations.
ja: すべての注釈からすべての応答を削除します。

en: Remove thumbnail images from pages.
ja: ページからサムネイル画像を削除します。

en: Remove XML metadata.
ja: XMLメタデータを削除します。

en: Changed in v1.18.7
ja: v1.18.7で変更

en: Changed in v1.19.0
ja: v1.19.0で変更

en: PDF only: Saves the document in its **current state**.
ja: PDFのみ：ドキュメントの **現在の状態** を保存します。

en: The file path, `pathlib.Path` or file object to save to. A file object must have been created before via `open(...)` or `io.BytesIO()`. Choosing `io.BytesIO()` is similar to :meth:`Document.tobytes` below, which equals the `getvalue()` output of an internally created `io.BytesIO()`.
ja: 保存先のファイルパス、`pathlib.Path` 、またはファイルオブジェクト。ファイルオブジェクトは `open(...)` または `io.BytesIO()` を介して事前に作成されている必要があります。`io.BytesIO()` を選択することは、以下の :meth:`Document.tobytes` と同等で、内部で作成された `io.BytesIO()` の `getvalue()` 出力に等しいです。

en: Do garbage collection. Positive values exclude "incremental".
ja: ガベージコレクションを実行します。正の値は「増分」を除外します。

en: 0 = none
ja: 0 = なし

en: 1 = remove unused (unreferenced) objects.
ja: 1 = 未使用（参照されていない）オブジェクトを削除します。

en: 2 = in addition to 1, compact the :data:`xref` table.
ja: 2 = 1に加えて、:data:`xref` テーブルを最適化します。

en: 3 = in addition to 2, merge duplicate objects.
ja: 3 = 2に加えて、重複したオブジェクトを統合します。

en: 4 = in addition to 3, check :data:`stream` objects for duplication. This may be slow because such data are typically large.
ja: 4 = 3に加えて、ストリームオブジェクトの重複をチェックします。これは、そのようなデータが通常大きいため、遅い場合があります。

en: Clean and sanitize content streams [#f1]_. Corresponds to "mutool clean -sc".
ja: コンテンツストリームをクリーンアップおよびサニタイズします [#f1]_。これは「mutool clean -sc」に対応します。

en: Deflate (compress) uncompressed streams.
ja: 未圧縮のストリームをデフレート（圧縮）します。

en: *(new in v1.18.3)* Deflate (compress) uncompressed image streams [#f4]_.
ja: *（v1.18.3で新規追加）* 未圧縮の画像ストリームをデフレート（圧縮）します [#f4]_。

en: *(new in v1.18.3)* Deflate (compress) uncompressed fontfile streams [#f4]_.
ja: （v1.18.3で新規追加）未圧縮のフォントファイルストリームをデフレート（圧縮）します [#f4]_。

en: Only save changes to the PDF. Excludes "garbage" and "linear". Can only be used if *outfile* is a string or a `pathlib.Path` and equal to :attr:`Document.name`. Cannot be used for files that are decrypted or repaired and also in some other cases. To be sure, check :meth:`Document.can_save_incrementally`. If this is false, saving to a new file is required.
ja: PDFへの変更を保存します。 "garbage" および "linear" を除外します。*outfile* が文字列または `pathlib.Path` であり、:attr:`Document.name` に等しい場合にのみ使用できます。復号化または修復されたファイルおよび一部の他の場合には使用できません。確実にするために、:meth:`Document.can_save_incrementally` を確認してください。これがFalseの場合、新しいファイルに保存する必要があります。

en: convert binary data to ASCII.
ja: バイナリデータをASCIIに変換します。

en: Decompress objects. Generates versions that can be better read by some other programs and will lead to larger files.
ja: オブジェクトを展開します。他のプログラムにより読みやすいバージョンを生成し、ファイルサイズが大きくなります。

en: 1 = images
ja: 1 = 画像

en: 2 = fonts
ja: 2 = フォント

en: 255 = all
ja: 255 = すべて

en: Save a linearised version of the document. This option creates a file format for improved performance for Internet access. Excludes "incremental".
ja: ドキュメントの線形バージョンを保存します。このオプションは、インターネットアクセスのパフォーマンス向上のためのファイル形式を作成します。 "増分" を除外します。

en: Prettify the document source for better readability. PDF objects will be reformatted to look like the default output of :meth:`Document.xref_object`.
ja: ドキュメントソースを見やすく整形します。PDFオブジェクトは、:meth:`Document.xref_object` のデフォルト出力のように再フォーマットされます。

en: Suppress the update of the file's `/ID` field. If the file happens to have no such field at all, also suppress creation of a new one. Default is `False`, so every save will lead to an updated file identification.
ja: ファイルの `/ID` フィールドの更新を抑制します。 ファイルにそのようなフィールドがまったくない場合、新しいフィールドの作成も抑制します。デフォルトは `False` で、各保存でファイル識別情報が更新されます。

en: *(new in v1.16.0)* Set the desired permission levels. See :ref:`PermissionCodes` for possible values. Default is granting all.
ja: （v1.16.0で新規追加）希望の権限レベルを設定します。可能な値については :ref:`PermissionCodes` を参照してください。デフォルトはすべてを許可します。

en: *(new in v1.16.0)* set the desired encryption method. See :ref:`EncryptionMethods` for possible values.
ja: *（v1.16.0で新規追加）* 希望の暗号化メソッドを設定します。可能な値については :ref:`EncryptionMethods` を参照してください。

en: *(new in v1.16.0)* set the document's owner password. *(Changed in v1.18.3)* If not provided, the user password is taken if provided. The string length must not exceed 40 characters.
ja: *（v1.16.0で新規追加）* ドキュメントの所有者パスワードを設定します。 (v1.18.3で変更) 指定しない場合、ユーザーパスワードが提供された場合にユーザーパスワードが使用されます。文字列の長さは40文字を超えてはいけません。

en: *(new in v1.16.0)* set the document's user password. The string length must not exceed 40 characters.
ja: （v1.16.0で新規追加）ドキュメントのユーザーパスワードを設定します。文字列の長さは40文字を超えてはいけません。

en: The method does not check, whether a file of that name already exists, will hence not ask for confirmation, and overwrite the file. It is your responsibility as a programmer to handle this.
ja: このメソッドは、その名前のファイルがすでに存在するかどうかをチェックしません。したがって、確認を求めずにファイルを上書きします。これについては、プログラマーとしての責任があります。

en: New in v1.18.11
ja: v1.18.11で新規追加

en: PDF only: The same as :meth:`Document.save` but with the changed defaults `deflate=True, garbage=3`.
ja: PDFのみ：:meth:`Document.save` と同じですが、デフォルト値が `deflate=True, garbage=3` に変更されています。

en: PDF only: saves the document incrementally. This is a convenience abbreviation for *doc.save(doc.name, incremental=True, encryption=PDF_ENCRYPT_KEEP)*.
ja: PDFのみ：ドキュメントを増分的に保存します。これは、 *doc.save(doc.name, incremental=True, encryption=PDF_ENCRYPT_KEEP)* の簡略表記です。

en: Saving incrementally may be required if the document contains verified signatures which would be invalidated by saving to a new file.
ja: 増分保存が必要な場合、ドキュメントに確認済みの署名が含まれている場合、新しいファイルに保存することによって無効になる可能性があります。

en: PDF only: Writes the **current content of the document** to a bytes object instead of to a file. Obviously, you should be wary about memory requirements. The meanings of the parameters exactly equal those in :meth:`save`. Chapter :ref:`FAQ` contains an example for using this method as a pre-processor to `pdfrw <https://pypi.python.org/pypi/pdfrw/0.3>`_.
ja: PDFのみ： **ドキュメントの現在のコンテンツ** をファイルではなくバイトオブジェクトに書き込みます。明らかに、メモリ要件に注意する必要があります。パラメータの意味は :meth:`save` とまったく同じです。チャプター :ref:`FAQ` には、このメソッドを `pdfrw <https://pypi.python.org/pypi/pdfrw/0.3>`_ の前処理として使用する例が含まれています。

en: *(Changed in v1.16.0)* for extended encryption support.
ja: *(v1.16.0で変更)* 拡張暗号サポート用。

en: a bytes object containing the complete document.
ja: ドキュメント全体を含むbytesオブジェクト。

en: Search for "text" on page number "pno". Works exactly like the corresponding :meth:`Page.search_for`. Any integer `-∞ < pno < page_count` is acceptable.
ja: "pno" ページ上で  "text" を検索します。対応する :meth:`Page.search_for` とまったく同じ方法で機能します。整数 `-∞ < pno < page_count` ならどのような値でも受け入れられます。

en: Changed in v1.19.3 - as a fix to issue `#537 <https://github.com/pymupdf/PyMuPDF/issues/537>`_, form fields are always excluded.
ja: v1.19.3で変更 - 問題＃ `#537 <https://github.com/pymupdf/PyMuPDF/issues/537>`_ の修正として、フォームフィールドは常に除外されます。

en: PDF only: Copy the page range **[from_page, to_page]** (including both) of PDF document *docsrc* into the current one. Inserts will start with page number *start_at*. Value -1 indicates default values. All pages thus copied will be rotated as specified. Links and annotations can be excluded in the target, see below. All page numbers are 0-based.
ja: PDFのみ：PDFドキュメント *docsrc* のページ範囲 **[from_page、to_page]** （両方を含む）を現在のドキュメントにコピーします。挿入はページ番号 *start_at* から開始します。値-1はデフォルト値を示します。したがって、コピーされるすべてのページは指定されたように回転します。リンクと注釈は対象から除外することができます（以下参照）。すべてのページ番号は0から始まります。

en: An opened PDF *Document* which must not be the current document. However, it may refer to the same underlying file.
ja: 現在のドキュメントではない、開かれたPDF *ドキュメント* 。ただし、同じ基盤ファイルを参照する場合があります。

en: First page number in *docsrc*. Default is zero.
ja: *docsrc* 内の最初のページ番号。デフォルトはゼロです。

en: Last page number in *docsrc* to copy. Defaults to last page.
ja: コピーする *docsrc* 内の最後のページ番号。デフォルトは最終ページです。

en: First copied page, will become page number *start_at* in the target. Default -1 appends the page range to the end. If zero, the page range will be inserted before current first page.
ja: コピーされる最初のページ、対象のページ番号 *start_at* になります。デフォルト-1はページ範囲を末尾に追加します。ゼロの場合、ページ範囲は現在の最初のページの前に挿入されます。

en: All copied pages will be rotated by the provided value (degrees, integer multiple of 90).
ja: コピーされるすべてのページは、指定された値（度数、90の整数倍）で回転します。

en: Choose whether (internal and external) links should be included in the copy. Default is *True*. Internal links to outside the copied page range are **always excluded**.
ja: (内部および外部) リンクをコピーに含めるかどうかを選択します。デフォルトは *True* です。コピー対象外のコピー範囲外の内部リンクは **常に除外されます** 。

en: *(new in v1.16.1)* choose whether annotations should be included in the copy. *(Fixed in v1.19.3)* Form fields can never be copied.
ja: *(v1.16.1で新規追加)* 注釈をコピーに含めるかどうかを選択します。 *(v1.19.3で修正)* フォームフィールドはコピーできません。

en: *(new in v1.17.7)* specify an interval size greater zero to see progress messages on `sys.stdout`. After each interval, a message like `Inserted 30 of 47 pages.` will be printed.
ja: *(v1.17.7で新規追加)* `sys.stdout` で進捗メッセージを表示するための大きなゼロより大きい間隔を指定します。各間隔後、`Inserted 30 of 47 pages.` のようなメッセージが印刷されます。

en: *(new in v1.18.0)* controls whether the list of already copied objects should be **dropped** after this method, default *True*. Set it to 0 except for the last one of multiple insertions from the same source PDF. This saves target file size and speeds up execution considerably.
ja: *(v1.18.0で新規追加)* このメソッドの後にすでにコピーされたオブジェクトのリストを **削除する** かどうかを制御します。デフォルトは *True* です。同じソースPDFからの複数の挿入の最後以外は、0に設定します。これにより、対象ファイルのサイズが節約され、実行が大幅に高速化されます。

en: If *from_page > to_page*, pages will be **copied in reverse order**. If *0 <= from_page == to_page*, then one page will be copied.
ja: *from_page > to_page* の場合、ページは **逆の順序でコピーされます** 。*0 <= from_page == to_page* の場合、1ページがコピーされます。

en: *docsrc* TOC entries **will not be copied**. It is easy however, to recover a table of contents for the resulting document. Look at the examples below and at program `join.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/join-documents/join.py>`_ in the *examples* directory: it can join PDF documents and at the same time piece together respective parts of the tables of contents.
ja: *docsrc* のTOCエントリは **コピーされません** 。ただし、結果のドキュメントの目次を復元することは簡単です。以下の例と、*examples* ディレクトリのプログラム `join.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/join-documents/join.py>`_ を参照してください：これはPDFドキュメントを結合し、同時に対応する目次の部分を組み立てることができます。

en: New in v1.22.0
ja: v1.22.0で新規追加

en: PDF only: Add an arbitrary supported document to the current PDF. Opens "infile" as a document, converts it to a PDF and then invokes :meth:`Document.insert_pdf`. Parameters are the same as for that method. Among other things, this features an easy way to append images as full pages to an output PDF.
ja: PDFのみ：任意のサポートされているドキュメントを現在のPDFに追加します。 "infile" をドキュメントとして開き、PDFに変換し、:meth:`Document.insert_pdf` を呼び出します。パラメータはそのメソッドと同じです。他のことの中で、これには画像を出力PDFに完全なページとして追加する簡単な方法が含まれています。

en: the input document to insert. May be a filename specification as is valid for creating a :ref:`Document` or a :ref:`Pixmap`.
ja: 挿入する入力ドキュメント。:ref:`Document` を作成する際に有効なファイル名の指定または :ref:`Pixmap` である可能性があります。

en: PDF only: Insert an empty page.
ja: PDFのみ：空のページを挿入します。

en: page number in front of which the new page should be inserted. Must be in *1 < pno <= page_count*. Special values -1 and *doc.page_count* insert **after** the last page.
ja: 新しいページを挿入する前のページ番号。*1 < pno <= page_count* である必要があります。特別な値-1および *doc.page_count* は最後のページの後に挿入します。

en: page width.
ja: ページの幅。

en: page height.
ja: ページの高さ。

en: the created page object.
ja: 作成されたページオブジェクト。

en: PDF only: Insert a new page and insert some text. Convenience function which combines :meth:`Document.new_page` and (parts of) :meth:`Page.insert_text`.
ja: PDFのみ：新しいページを挿入し、テキストを挿入します。:meth:`Document.new_page` と :meth:`Page.insert_text` の一部を組み合わせた便利な関数です。

en: page number (0-based) **in front of which** to insert. Must be in `range(-1, doc.page_count + 1)`. Special values -1 and `doc.page_count` insert **after** the last page.
ja: **挿入する前** のページ番号（0ベース）を指定します。範囲 `range(-1, doc.page_count + 1)` 内である必要があります。特別な値-1および `doc.page_count` は最後のページの **後** に挿入します。

en: Changed in v1.14.12
ja: v1.14.12で変更

en: This is now a positional parameter
ja: これは今ポジションパラメータです

en: For the other parameters, please consult the aforementioned methods.
ja: その他のパラメータについては、前述のメソッドをご参照ください。

en: the result of :meth:`Page.insert_text` (number of successfully inserted lines).
ja: :meth:`Page.insert_text` の結果（正常に挿入された行数）。

en: PDF only: Delete a page given by its 0-based number in `-∞ < pno < page_count - 1`.
ja: PDFのみ：0ベースの番号で指定されたページを削除します。`-∞ < pno < page_count - 1` です。

en: Changed in v1.18.14: support Python's `del` statement.
ja: v1.18.14で変更：Pythonの `del` 文をサポート。

en: the page to be deleted. Negative number count backwards from the end of the document (like with indices). Default is the last page.
ja: 削除するページ。負の数は文書の末尾から逆に数えます（インデックスと同様）。デフォルトは最後のページです。

en: Changed in v1.18.13: more flexibility specifying pages to delete.
ja: v1.18.13 で変更されました: 削除するページを指定する柔軟性が向上しました。

en: PDF only: Delete multiple pages given as 0-based numbers.
ja: PDF のみ: 0 ベースの番号として指定された複数のページを削除します。

en: **Format 1:** Use keywords. Represents the old format. A contiguous range of pages is removed.
ja: **フォーマット 1:** キーワードを使用します。古いフォーマットを表します。連続したページ範囲が削除されます。

en: "from_page": first page to delete. Zero if omitted.
ja: "from_page": 削除する最初のページ。省略された場合はゼロです。

en: "to_page": last page to delete. Last page in document if omitted. Must not be less then "from_page".
ja: "to_page": 削除する最後のページ。省略された場合はドキュメント内の最後のページです。"from_page" より小さくしてはいけません。

en: **Format 2:** Two page numbers as positional parameters. Handled like Format 1.
ja: **フォーマット 2:** 位置パラメータとしての2つのページ番号。フォーマット 1 と同様に処理されます。

en: **Format 3:** One positional integer parameter. Equivalent to :meth:`Page.delete_page`.
ja: **フォーマット 3:** 1 つの位置パラメータの整数。:meth:`Page.delete_page` に相当します。

en: **Format 4:** One positional parameter of type *list*, *tuple* or *range()* of page numbers. The items of this sequence may be in any order and may contain duplicates.
ja: **フォーマット 4:** ページ番号のリスト、*タプル*、または *range()* の1つの位置パラメータ。このシーケンスのアイテムは任意の順序であり、重複していてもかまいません。

en: **Format 5:** *(New in v1.18.14)* Using the Python `del` statement and index / slice notation is now possible.
ja: **フォーマット 5:** *(v1.18.14 で新規)* Python の `del` ステートメントとインデックス / スライス表記を使用することができます。

en: *(Changed in v1.14.17, optimized in v1.17.7)* In an effort to maintain a valid PDF structure, this method and :meth:`delete_page` will also deactivate items in the table of contents which point to deleted pages. "Deactivation" here means, that the bookmark will point to nowhere and the title will be shown grayed-out by supporting PDF viewers. The overall TOC structure is left intact.
ja: *(v1.14.17 で変更, v1.17.7 で最適化)* 有効な PDF 構造を維持するために、このメソッドと :meth:`delete_page` は、削除されたページを指す目次のアイテムも無効化します。ここでの "無効化" とは、ブックマークがどこを指しているのか分からなくなり、サポートされている PDF ビューアによってタイトルがグレーアウト表示されることを意味します。全体の目次構造は維持されます。

en: It will also remove any **links on remaining pages** which point to a deleted one. This action may have an extended response time for documents with many pages.
ja: また、削除されたページを指す **残りのページ上のリンク** も削除されます。これにより、多くのページを持つドキュメントでは拡張された応答時間が発生する可能性があります。

en: Following examples will all delete pages 500 through 519:
ja: 以下の例はすべて、ページ500から519を削除します:

en: For the :ref:`AdobeManual` the above takes about 0.6 seconds, because the remaining 1290 pages must be cleaned from invalid links.
ja: :ref:`AdobeManual` では、上記の操作に約0.6秒かかります。なぜなら、残りの1290ページから無効なリンクを削除する必要があるからです。

en: In general, the performance of this method is dependent on the number of remaining pages -- **not** on the number of deleted pages: in the above example, **deleting all pages except** those 20, will need much less time.
ja: 一般的に、このメソッドのパフォーマンスは残りのページの数に依存します - 削除されたページの数には依存 **しません** 。上記の例では、20個のページ **以外のすべてのページを削除する** 場合、はるかに少ない時間がかかります。

en: PDF only: Copy a page reference within the document.
ja: PDF のみ: ドキュメント内でページの参照をコピーします。

en: the page to be copied. Must be in range `0 <= pno < page_count`.
ja: コピーするページ。範囲は `0 <= pno < page_count` である必要があります。

en: the page number in front of which to copy. The default inserts **after** the last page.
ja: コピーする位置の前のページ番号。デフォルトでは最後のページの **後** に挿入されます。

en: Only a new **reference** to the page object will be created -- not a new page object, all copied pages will have identical attribute values, including the :attr:`Page.xref`. This implies that any changes to one of these copies will appear on all of them.
ja: ページオブジェクトへの新しい **参照** のみが作成されます - 新しいページオブジェクトは作成されません。すべてのコピーされたページは、:attr:`Page.xref` を含む属性値が同じになります。これは、これらのコピーの1つに対する変更がすべてのコピーに反映されることを意味します。

en: New in v1.14.17
ja: v1.14.17 で新規

en: PDF only: Make a full copy (duplicate) of a page.
ja: PDF のみ: ページの完全なコピー（複製）を作成します。

en: the page to be duplicated. Must be in range `0 <= pno < page_count`.
ja: 複製するページ。範囲は `0 <= pno < page_count` である必要があります。

en: In contrast to :meth:`copy_page`, this method creates a new page object (with a new :data:`xref`), which can be changed independently from the original.
ja: :meth:`copy_page` とは異なり、このメソッドは新しいページオブジェクト（新しい :data:`xref` を持つ）を作成します。これは元のページから独立して変更できます。

en: Any Popup and "IRT" ("in response to") annotations are **not copied** to avoid potentially incorrect situations.
ja: ポップアップと "IRT"（"応答先"）注釈は、潜在的に誤った状況を回避するために **コピーされません** 。

en: PDF only: Move (copy and then delete original) a page within the document.
ja: PDF のみ: ドキュメント内でページを移動します（コピーしてから元のページを削除）。

en: the page to be moved. Must be in range `0 <= pno < page_count`.
ja: 移動するページ。範囲は `0 <= pno < page_count` である必要があります。

en: the page number in front of which to insert the moved page. The default moves **after** the last page.
ja: 移動したページの前に挿入するページ番号。デフォルトでは最後のページの **後** に移動します。

en: New in v1.17.4
ja: v1.17.4 で新規

en: PDF only: Get or set the */NeedAppearances* property of Form PDFs. Quote: *"(Optional) A flag specifying whether to construct appearance streams and appearance dictionaries for all widget annotations in the document ... Default value: false."* This may help controlling the behavior of some readers / viewers.
ja: PDF のみ: Form PDF の */NeedAppearances* プロパティを取得または設定します。引用: *"（オプション）ドキュメント内のすべてのウィジェット注釈の外観ストリームと外観辞書を構築するかどうかを指定するフラグ...デフォルト値: false"* 。これは一部のリーダー/ビューアの動作を制御するのに役立つかもしれません。

en: set the property to this value. If omitted or `None`, inquire the current value.
ja: プロパティをこの値に設定します。省略された場合または `None` の場合、現在の値を問い合わせます。

en: None: not a Form PDF, or property not defined.
ja: None: フォーム PDF ではないか、プロパティが定義されていない。

en: True / False: the value of the property (either just set or existing for inquiries). Has no effect if no Form PDF.
ja: True / False: プロパティの値（設定されたばかりまたは問い合わせ用に存在する）。フォーム PDF がない場合は影響しません。

en: PDF only: Return whether the document contains signature fields. This is an optional PDF property: if not present (return value -1), no conclusions can be drawn -- the PDF creator may just not have bothered using it.
ja: PDF のみ: ドキュメントに署名フィールドが含まれているかどうかを返します。これはオプションの PDF プロパティです。存在しない場合（返り値 -1）、結論を導くことはできません - PDF の作成者は単にそれを使用しなかった可能性があります。

en: -1: not a Form PDF / no signature fields recorded / no *SigFlags* found.
ja: -1: フォーム PDF でない / 署名フィールドが記録されていない / *SigFlags* が見つからない。

en: 1: at least one signature field exists.
ja: 1: 少なくとも1つの署名フィールドが存在します。

en: 3:  contains signatures that may be invalidated if the file is saved (written) in a way that alters its previous contents, as opposed to an incremental update.
ja: 3: ファイルが前の内容を変更する方法で保存（書き込み）されると、署名が無効になる可能性のある署名が含まれています。これは増分更新とは対照的です。

en: Changed in v1.14.16: The sequence of positional parameters "name" and "buffer" has been changed to comply with the call pattern of other functions.
ja: v1.14.16 で変更されました: 位置パラメータ "name" と "buffer" の順序が他の関数の呼び出しパターンに従うように変更されました。

en: PDF only: Embed a new file. All string parameters except the name may be unicode (in previous versions, only ASCII worked correctly). File contents will be compressed (where beneficial).
ja: PDF のみ: 新しいファイルを埋め込みます。名前以外のすべての文字列パラメータは Unicode である場合があります（以前のバージョンでは ASCII しか正しく動作しませんでした）。ファイルの内容は（有益な場合に）圧縮されます。

en: entry identifier, **must not already exist**.
ja: エントリの識別子、**すでに存在しない必要** があります。

en: file contents.
ja: ファイルの内容。

en: *(Changed in v1.14.13)* *io.BytesIO* is now also supported.
ja: *(v1.14.13 で変更)* *io.BytesIO* もサポートされるようになりました。

en: optional filename. Documentation only, will be set to *name* if `None`.
ja: オプションのファイル名。ドキュメンテーション専用で、`None` の場合は *name* に設定されます。

en: optional unicode filename. Documentation only, will be set to *filename* if `None`.
ja: オプションのUnicodeファイル名。ドキュメンテーション専用で、`None` の場合は *filename* に設定されます。

en: optional description. Documentation only, will be set to *name* if `None`.
ja: オプションの説明。ドキュメンテーション専用で、`None` の場合は *name* に設定されます。

en: *(Changed in v1.18.13)* The method now returns the :data:`xref` of the inserted file. In addition, the file object now will be automatically given the PDF keys `/CreationDate` and `/ModDate` based on the current date-time.
ja: *(v1.18.13 で変更)* このメソッドは挿入されたファイルの :data:`xref` も返すようになりました。さらに、ファイルオブジェクトには現在の日時に基づいて自動的に PDF キー `/CreationDate` および `/ModDate` が設定されるようになりました。

en: Changed in v1.14.16: This is now a method. In previous versions, this was a property.
ja: v1.14.16 で変更されました: これは現在のメソッドです。以前のバージョンではプロパティでした。

en: PDF only: Return the number of embedded files.
ja: PDF のみ: 埋め込まれたファイルの数を返します。

en: PDF only: Retrieve the content of embedded file by its entry number or name. If the document is not a PDF, or entry cannot be found, an exception is raised.
ja: PDF のみ: エントリ番号または名前によって埋め込まれたファイルの内容を取得します。ドキュメントが PDF でない場合、またはエントリが見つからない場合、例外が発生します。

en: index or name of entry. An integer must be in `range(embfile_count())`.
ja: エントリのインデックスまたは名前。整数は範囲内である必要があります `range(embfile_count())`。

en: Changed in v1.14.16: Items can now be deleted by index, too.
ja: v1.14.16 で変更されました: インデックスによってアイテムを削除できるようになりました。

en: PDF only: Remove an entry from `/EmbeddedFiles`. As always, physical deletion of the embedded file content (and file space regain) will occur only when the document is saved to a new file with a suitable garbage option.
ja: PDF のみ: `/EmbeddedFiles` からエントリを削除します。いつものように、適切なガベージオプションを使用して新しいファイルに保存すると、埋め込まれたファイルの内容の物理的な削除（およびファイルスペースの回復）が行われます。

en: index or name of entry.
ja: エントリのインデックスまたは名前。

en: When specifying an entry name, this function will only **delete the first item** with that name. Be aware that PDFs not created with PyMuPDF may contain duplicate names. So you may want to take appropriate precautions.
ja: エントリ名を指定する場合、この関数はその名前を持つ **最初のアイテムのみを削除します** 。PyMuPDF で作成された PDF 以外の PDF には重複する名前が含まれている可能性があるため、適切な注意を払う必要があるかもしれません。

en: Changed in v1.18.13
ja: v1.18.13 で変更されました

en: PDF only: Retrieve information of an embedded file given by its number or by its name.
ja: PDF のみ: 埋め込まれたファイルの情報を取得します。エントリ番号または名前によって指定されたファイルの情報を取得します。

en: a dictionary with the following keys:
ja: 以下のキーを持つ辞書:

en: *name* -- (*str*) name under which this entry is stored
ja: *name* – (*str*) このエントリが格納されている名前

en: *filename* -- (*str*) filename
ja: *filename* – (*str*) ファイル名

en: *ufilename* -- (*unicode*) filename
ja: *ufilename* – (*unicode*) Unicode ファイル名

en: *desc* -- (*str*) description
ja: *desc* – (*str*) 説明

en: *size* -- (*int*) original file size
ja: *size* – (*int*) 元のファイルサイズ

en: *length* -- (*int*) compressed file length
ja: *length* – (*int*) 圧縮ファイルの長さ

en: *creationDate* -- *(New in v1.18.13)* (*str*) date-time of item creation in PDF format
ja: *creationDate* – *(v1.18.13 で新規)* (*str*) PDF 形式のアイテム作成の日時

en: *modDate* -- *(New in v1.18.13)* (*str*) date-time of last change in PDF format
ja: *modDate* – *(v1.18.13 で新規)* (*str*) PDF 形式の最終変更の日時

en: *collection* -- *(New in v1.18.13)* (*int*) :data:`xref` of the associated PDF portfolio item if any, else zero.
ja: *collection* – *(v1.18.13 で新規)* (*int*) 関連する PDF ポートフォリオアイテムの :data:`xref`（あれば）、それ以外はゼロ。

en: *checksum* -- *(New in v1.18.13)* (*str*) a hashcode of the stored file content as a hexadecimal string. Should be MD5 according to PDF specifications, but be prepared to see other hashing algorithms.
ja: *checksum* – *(v1.18.13 で新規)* (*str*) 16進数の文字列として格納されたファイルコンテンツのハッシュコード。PDF 仕様に従えば MD5 であるべきですが、他のハッシュアルゴリズムも見る可能性があるので、準備しておいてください。

en: New in v1.14.16
ja: v1.14.16 で新規

en: PDF only: Return a list of embedded file names. The sequence of the names equals the physical sequence in the document.
ja: PDF のみ: 埋め込まれたファイルの名前のリストを返します。名前のシーケンスはドキュメント内の物理的なシーケンスと同じです。

en: PDF only: Change an embedded file given its entry number or name. All parameters are optional. Letting them default leads to a no-operation.
ja: PDF のみ: エントリ番号または名前によって指定された埋め込まれたファイルを変更します。すべてのパラメータはオプションです。デフォルトで設定すると、操作は行われません。

en: the new file content.  *(Changed in v1.14.13)* *io.BytesIO* is now also supported.
ja: 新しいファイルの内容。*(v1.14.13 で変更)* *io.BytesIO* もサポートされるようになりました。

en: the new file content.
ja: 新しいファイルの内容。

en: the new filename.
ja: 新しいファイル名。

en: the new unicode filename.
ja: 新しいUnicodeファイル名。

en: the new description.
ja: 新しい説明。

en: *(Changed in v1.18.13)*  The method now returns the :data:`xref` of the file object.
ja: *(v1.18.13 で変更)* このメソッドはファイルオブジェクトの :data:`xref` も返すようになりました。

en: xref of the file object. Automatically, its `/ModDate` PDF key will be updated with the current date-time.
ja: ファイルオブジェクトのxref。自動的に、`/ModDate` PDF キーが現在の日時で更新されます。

en: Release objects and space allocations associated with the document. If created from a file, also closes *filename* (releasing control to the OS). Explicitly closing a document is equivalent to deleting it, `del doc`, or assigning it to something else like `doc = None`.
ja: 文書に関連付けられたオブジェクトとスペースの割り当てを解放します。ファイルから作成された場合、ファイル名も閉じられ（OS に制御を解放）ます。文書を明示的に閉じることは、それを削除すること、`del doc` 、または `doc = None` のように別のものに割り当てることと同等です。

en: Changed in v1.18.10
ja: v1.18.10 で変更

en: PDF only: Return the definition source of a PDF object.
ja: PDF のみ: PDF オブジェクトの定義ソースを返します。

en: whether to generate a compact output with no line breaks or spaces.
ja: 改行やスペースのないコンパクトな出力を生成するかどうか。

en: whether to ASCII-encode binary data.
ja: バイナリデータを ASCII エンコードするかどうか。

en: The object definition source.
ja: オブジェクトの定義ソース。

en: PDF only: Return the :data:`xref` number of the PDF catalog (or root) object. Use that number with :meth:`Document.xref_object` to see its source.
ja: PDF のみ: PDF カタログ（またはルート）オブジェクトの :data:`xref` 番号を返します。これを :meth:`Document.xref_object` で使用してそのソースを表示できます。

en: PDF only: Return the trailer source of the PDF,  which is usually located at the PDF file's end. This is :meth:`Document.xref_object` with an *xref* argument of -1.
ja: PDF のみ: PDF のトレーラーソースを返します。通常、これは PDF ファイルの末尾にあります。これは :meth:`Document.xref_object` で *xref* 引数が -1 の場合です。

en: PDF only: Return the **decompressed** contents of the :data:`xref` stream object.
ja: PDF のみ: :data:`xref` ストリームオブジェクトの **解凍された** コンテンツを返します。

en: :data:`xref` number.
ja: :data:`xref` 番号。

en: the (decompressed) stream of the object.
ja: （解凍された）オブジェクトのストリーム。

en: PDF only: Return the **unmodified** (esp. **not decompressed**) contents of the :data:`xref` stream object. Otherwise equal to :meth:`Document.xref_stream`.
ja: PDF のみ: :data:`xref` ストリームオブジェクトの**変更前**（特に **解凍されていない**）コンテンツを返します。それ以外の点では :meth:`Document.xref_stream` と同等です。

en: the (original, unmodified) stream of the object.
ja: （元の、変更前の）オブジェクトのストリーム。

en: PDF only: Replace object definition of :data:`xref` with the provided string. The xref may also be new, in which case this instruction completes the object definition. If a page object is also given, its links and annotations will be reloaded afterwards.
ja: PDF のみ: :data:`xref` のオブジェクト定義を提供された文字列で置き換えます。xref が新しい場合、この命令はオブジェクト定義を完成させます。ページオブジェクトも指定された場合、そのリンクと注釈が後で再ロードされ、リンクと/または注釈に関連する変更が反映されます。

en: a string containing a valid PDF object definition.
ja: 有効な PDF オブジェクト定義を含む文字列。

en: a page object. If provided, indicates, that annotations of this page should be refreshed (reloaded) to reflect changes incurred with links and / or annotations.
ja: ページオブジェクト。指定された場合、このページの注釈が変更を反映するために再ロードされることを示します。

en: zero if successful, otherwise an exception will be raised.
ja: 成功した場合はゼロ、それ以外の場合は例外が発生します。

en: New in v.1.16.8
ja: v1.16.8 で新規

en: Changed in v1.19.2: added parameter "compress"
ja: v1.19.2 で変更: パラメータ "compress" を追加

en: Changed in v1.19.6: deprecated parameter "new". Now confirms that the object is a PDF dictionary object.
ja: v1.19.6 で変更: パラメータ "new" を非推奨にし、無視します。オブジェクトが PDF 辞書オブジェクトであることを確認するようになりました。

en: Replace the stream of an object identified by *xref*, which must be a PDF dictionary. If the object is no :data:`stream`, it will be turned into one. The function automatically performs a compress operation ("deflate") where beneficial.
ja: xref で識別されるオブジェクトのストリームを置き換えます。*xref* は PDF 辞書である必要があります。オブジェクトがストリームでない場合、それをストリームに変換します。この関数は、有益な場合には自動的に圧縮操作（"deflate"）を実行します。

en: the new content of the stream.
ja: ストリームの新しい内容。

en: *(Changed in v1.14.13:)* *io.BytesIO* objects are now also supported.
ja: *(v1.14.13 で変更:)* *io.BytesIO* オブジェクトもサポートされるようになりました。

en: *deprecated* and ignored. Will be removed some time after v1.20.0.
ja: *非推奨* で無視されます。v1.20.0 以降のある時点で削除されます。

en: whether to compress the inserted stream. If `True` (default), the stream will be inserted using `/FlateDecode` compression (if beneficial), otherwise the stream will inserted as is.
ja: 挿入されるストリームを圧縮するかどうか。`True` の場合（デフォルト）、ストリームは `/FlateDecode` 圧縮を使用して挿入されます（有益な場合）、それ以外の場合はストリームはそのまま挿入されます。

en: The method is primarily (but not exclusively) intended to manipulate streams containing PDF operator syntax (see pp. 643 of the :ref:`AdobeManual`) as it is the case for e.g. page content streams.
ja: このメソッドは主に（しかし排他的ではなく）PDFオペレータ構文を含むストリームを操作することを意図しています（:ref:`AdobeManual` の pp. 643 参照）。例えばページのコンテンツストリームのようにです。

en: If you update a contents stream, consider using save parameter *clean=True* to ensure consistency between PDF operator source and the object structure.
ja: コンテンツストリームを更新する場合、PDFオペレータのソースとオブジェクト構造の間の整合性を確保するために save パラメータを *clean=True* で使用することを検討してください。

en: Example: Let us assume that you no longer want a certain image appear on a page. This can be achieved by deleting the respective reference in its contents source(s) -- and indeed: the image will be gone after reloading the page. But the page's :data:`resources` object would still show the image as being referenced by the page. This save option will clean up any such mismatches.
ja: 例: ある画像をページに表示させたくないと仮定しましょう。これは、そのコンテンツソース内の該当する参照を削除することによって実現できます - そして実際には、ページを再読み込みした後、画像は消えてしまいます。ただし、ページの :data:`resources` は、まだその画像がページによって参照されていると表示されます。この保存オプションは、そのような不一致をクリーンアップします。

en: New in v1.19.5
ja: v1.19.5 で新規

en: PDF Only: Make *target* xref an exact copy of *source*. If *source* is a :data:`stream`, then these data are also copied.
ja: PDF のみ: *ターゲット* の xref をソースの正確なコピーにします。*ソース* が :data:`stream` の場合、これらのデータもコピーされます。

en: the source :data:`xref`. It must be an existing **dictionary** object.
ja: ソースの :data:`xref`。既存の **辞書** オブジェクトである必要があります。

en: an optional list of top-level keys in *target*, that should not be removed in preparation of the copy process.
ja: *ターゲット* 内のトップレベルのキーを削除する準備段階で削除しない、オプションのキーリスト。

en: This method has much in common with Python's *dict* method `copy()`.
ja: このメソッドは、Python の *dict* メソッド `copy()` と多くの共通点があります。

en: Both xref numbers must represent existing dictionaries.
ja: 両方の xref 番号は既存の辞書を表す必要があります。

en: Before data is copied from *source*, all *target* dictionary keys are deleted. You can specify exceptions from this in the *keep* list. If *source* however has a same-named key, its value will still replace the target.
ja: データがソースからコピーされる前に、すべての *ターゲット* 辞書のキーが削除されます。この削除からの例外を *keep* リストで指定できます。ただし、*ソース* に同じ名前のキーがある場合、その値はターゲットに置き換えられます。

en: If *source* is a :data:`stream` object, then these data will also be copied over, and *target* will be converted to a stream object.
ja: *ソース* がストリームオブジェクトの場合、これらのデータもコピーされ、*ターゲット* はストリームオブジェクトに変換されます。

en: A typical use case is to replace or remove an existing image without using redaction annotations. Example scripts can be seen `here <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/examples/replace-image>`_.
ja: 典型的な使用例は、赤塗り注釈を使用せずに既存の画像を置き換えたり削除したりすることです。例のスクリプトは `こちら <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/examples/replace-image>`_ で確認できます。

en: PDF Only: Extract data and meta information of an image stored in the document. The output can directly be used to be stored as an image file, as input for PIL, :ref:`Pixmap` creation, etc. This method avoids using pixmaps wherever possible to present the image in its original format (e.g. as JPEG).
ja: PDF のみ: 文書に格納された画像のデータとメタ情報を抽出します。出力は、画像ファイルとして保存するための直接的な使用、PIL、:ref:`Pixmap` の作成などに使用できます。このメソッドは、できる限りピクマップを使用せず、画像をその元の形式（例：JPEG として）で表示することを目的としています。

en: :data:`xref` of an image object. If this is not in `range(1, doc.xref_length())`, or the object is no image or other errors occur, `None` is returned and no exception is raised.
ja: 画像オブジェクトの :data:`xref`。これが  `range(1, doc.xref_length())` の範囲外であるか、オブジェクトが画像でないか、その他のエラーが発生した場合、 `None` が返され、例外は発生しません。

en: a dictionary with the following keys
ja: 以下のキーを持つ辞書

en: *ext* (*str*) image type (e.g. *'jpeg'*), usable as image file extension
ja: *ext* (*str*) 画像タイプ（例：*'jpeg'*）、画像ファイルの拡張子として使用可能

en: *smask* (*int*) :data:`xref` number of a stencil (/SMask) image or zero
ja: *smask* (*int*) ステンシル（/SMask）画像の :data:`xref` 番号またはゼロ

en: *width* (*int*) image width
ja: *width* (*int*) 画像の幅

en: *height* (*int*) image height
ja: *height* (*int*) 画像の高さ

en: *colorspace* (*int*) the image's *colorspace.n* number.
ja: *colorspace* (*int*) 画像のカラースペースの数

en: *cs-name* (*str*) the image's *colorspace.name*.
ja: *cs-name* (*str*) 画像のカラースペースの名前

en: *xres* (*int*) resolution in x direction. Please also see :data:`resolution`.
ja: *xres* (*int*) x 方向の解像度。:data:`resolution` も参照してください。

en: *yres* (*int*) resolution in y direction. Please also see :data:`resolution`.
ja: *yres* (*int*) y 方向の解像度。:data:`resolution` も参照してください。

en: *image* (*bytes*) image data, usable as image file content
ja: *image* (*bytes*) 画像データ、画像ファイルのコンテンツとして使用可能

en: There is a functional overlap with *pix = fitz.Pixmap(doc, xref)*, followed by a *pix.tobytes()*. Main differences are that extract_image, **(1)** does not always deliver PNG image formats, **(2)** is **very** much faster with non-PNG images, **(3)** usually results in much less disk storage for extracted images, **(4)** returns `None` in error cases (generates no exception). Look at the following example images within the same PDF.
ja: *pix = fitz.Pixmap(doc, xref)* *に続いてpix.tobytes()* という機能的な重複があります。主な違いは、extract_imageは、**(1)** 必ずしもPNG画像形式を提供しない、 **(2)** PNG以外の画像では非常に高速である、 **(3)** 抽出された画像のディスクストレージが通常ははるかに少ない、 **(4)** エラーケースでは `None` を返す（例外を生成しない）という点です。同じPDF内の以下の例の画像を見てみましょう。

en: xref 1268 is a PNG -- Comparable execution time and identical output::
ja: xref 1268 は PNG 形式です - 比較可能な実行時間と同じ出力::

en: xref 1186 is a JPEG -- :meth:`Document.extract_image` is **many times faster** and produces a **much smaller** output (2.48 MB vs. 0.35 MB)::
ja: xref 1186 は JPEG です - :meth:`Document.extract_image` は **何倍も速く**、はるかに小さい出力を生成します（2.48 MB に対して 0.35 MB）::

en: Changed in v1.19.4: return a dictionary if `named == True`.
ja: v1.19.4 で変更: `named == True` の場合、辞書を返します。

en: PDF Only: Return an embedded font file's data and appropriate file extension. This can be used to store the font as an external file. The method does not throw exceptions (other than via checking for PDF and valid :data:`xref`).
ja: PDF のみ: 埋め込まれたフォントファイルのデータと適切なファイル拡張子を返します。これを使用してフォントを外部ファイルとして保存することができます。このメソッドは例外をスローしません（PDF および有効な :data:`xref` のチェックを除く）。

en: PDF object number of the font to extract.
ja: 抽出するフォントの PDF オブジェクト番号。

en: only return font information, not the buffer. To be used for information-only purposes, avoids allocation of large buffer areas.
ja: フォント情報のみを返し、バッファの割り当てを回避するために使用します。

en: If true, a dictionary with the following keys is returned: 'name' (font base name), 'ext' (font file extension), 'type' (font type), 'content' (font file content).
ja: `True` の場合、次のキーを持つ辞書が返されます： 'name'（フォントのベース名）、 'ext'（フォントファイルの拡張子）、 'type'（フォントのタイプ）、 'content'（フォントファイルの内容）。

en: a tuple `(basename, ext, type, content)`, where *ext* is a 3-byte suggested file extension (*str*), *basename* is the font's name (*str*), *type* is the font's type (e.g. "Type1") and *content* is a bytes object containing the font file's content (or *b""*). For possible extension values and their meaning see :ref:`FontExtensions`. Return details on error:
ja: `(basename, ext, type, content)` のタプルで、ext は3バイトの推奨ファイル拡張子（*str*）で、*basename* はフォントの名前（*str*）で、*type* はフォントのタイプ（例：「Type1」）で、*content* はフォントファイルの内容を含むバイトオブジェクトです（または *b""* ）。可能な拡張子の値とその意味については :ref:`FontExtensions` を参照してください。エラー時の返り値の詳細:

en: `("", "", "", b"")` -- invalid xref or xref is not a (valid) font object.
ja: `("", "", "", b"")` – 無効な xref または xref が（有効な）フォントオブジェクトではない場合。

en: `(basename, "n/a", "Type1", b"")` -- *basename* is not embedded and thus cannot be extracted. This is the case for e.g. the :ref:`Base-14-Fonts` and Type 3 fonts.
ja: `(basename, "n/a", "Type1", b"")` – *basename* は埋め込まれておらず、したがって抽出できません。これは、例えば :ref:`Base-14-Fonts` フォントや Type 3 フォントの場合に該当します。

en: Example:
ja: 例:

en: The basename is returned unchanged from the PDF. So it may contain characters (such as blanks) which may disqualify it as a filename for your operating system. Take appropriate action.
ja: *ベースネーム* は PDF から変更されずに返されます。そのため、それには (空白などの) ファイル名として使用できない文字が含まれている可能性があります。適切な措置を取ってください。

en: The returned *basename* in general is **not** the original file name, but it probably has some similarity.
ja: 通常、返される *ベースネーム* は元のファイル名ではなく、いくつかの類似性があるかもしれません。

en: If parameter `named == True`, a dictionary with the following keys is returned: `{'name': 'T1', 'ext': 'n/a', 'type': 'Type3', 'content': b''}`.
ja: `named == True` の場合、次のキーを持つ辞書が返されます: `{'name': 'T1', 'ext': 'n/a', 'type': 'Type3', 'content': b''}`。

en: PDF only: Return the :data:`xref` of the document's XML metadata.
ja: PDF のみ: ドキュメントの XML メタデータの :data:`xref` を返します。

en: PDF only: Check whether there are links, resp. annotations anywhere in the document.
ja: PDF のみ: ドキュメント内にリンクまたは注釈が存在するかどうかを確認します。

en: *True* / *False*. As opposed to fields, which are also stored in a central place of a PDF document, the existence of links / annotations can only be detected by parsing each page. These methods are tuned to do this efficiently and will immediately return, if the answer is *True* for a page. For PDFs with many thousand pages however, an answer may take some time [#f6]_ if no link, resp. no annotation is found.
ja: *True* / *False* 。フィールドとは異なり、リンクや注釈の存在は PDF ドキュメントの中心的な場所に格納されているわけではなく、各ページを解析してのみ検出できます。これらのメソッドは効率的に実行するように調整されており、ページに対して *True* の回答がある場合、すぐに返されます。ただし、多くのページを持つ PDF の場合、リンクや注釈が見つからない場合、回答に時間がかかることがあります [#f6]_。

en: New in v1.18.7, changed in v1.18.9
ja: v1.18.7 で新規追加、v1.18.9 で変更

en: PDF only: Investigate eligible fonts for their use by text in the document. If a font is supported and a size reduction is possible, that font is replaced by a version with a character subset.
ja: PDF のみ: ドキュメント内のテキストによる使用を検討するための適格なフォントを調査します。サポートされているフォントで、サイズの削減が可能な場合、そのフォントは文字のサブセットを含むバージョンで置換されます。

en: Use this method immediately before saving the document. The following features and restrictions apply for the time being:
ja: このメソッドは、ドキュメントを保存する直前に使用します。現時点では、以下の機能と制限が適用されます:

en: Package `fontTools <https://pypi.org/project/fonttools/>`_ **must be installed**. It is required for creating the font subsets. If not installed, the method raises an `ImportError` exception.
ja: `fontTools <https://pypi.org/project/fonttools/>`_ パッケージが **インストールされている必要があります**。フォントサブセットの作成に必要です。インストールされていない場合、メソッドは `ImportError` 例外を発生させます。

en: Supported font types only include embedded OTF, TTF and WOFF that are **not already subsets**.
ja: サポートされているフォントタイプには、埋め込まれた OTF、TTF、および WOFF のみが含まれ、**すでにサブセットであるものは含まれません** 。

en: **Changed in v1.18.9:** A subset font directly replaces its original -- text remains untouched and **is not rewritten.** It thus should retain all its properties, like spacing, hiddenness, control by Optional Content, etc.
ja: **v1.18.9** で変更: サブセットフォントはその元のフォントを直接置換します - テキストは変更されず、**書き直されません**。したがって、スペーシング、非表示、オプションのコンテンツによる制御など、すべてのプロパティが保持されるはずです。

en: The greatest benefit can be achieved when creating new PDFs using large fonts like is typical for Asian scripts. In these cases, the set of actually used unicodes mostly is small compared to the number of glyphs in the font. Using this feature can easily reduce the embedded font binary by two orders of magnitude -- from several megabytes to a low two-digit kilobyte amount.
ja: 最大の利点は、アジアの文字に典型的な大きなフォントを使用して新しい PDF を作成する場合に得られます。このような場合、実際に使用されているユニコードのセットは、フォント内のグリフの数と比較して非常に小さいことが多いです。この機能を使用すると、埋め込まれたフォントのバイナリサイズを容易に2桁のキロバイト単位にまで削減できます - 数メガバイトから低二桁キロバイトの量にまで。

en: New in v1.19.0
ja: v1.19.0 で新規追加

en: PDF only: Enable journalling. Use this before you start logging operations.
ja: PDF のみ: ジャーナリングを有効にします。ログ操作を開始する前にこれを使用します。

en: PDF only: Start journalling an *"operation"* identified by a string "name". Updates will fail for a journal-enabled PDF, if no operation has been started.
ja: PDF のみ: 文字列 "name" で識別される *"操作"* のジャーナリングを開始します。ジャーナリングが有効な PDF に対しては、操作が開始されていない場合、更新が失敗します。

en: PDF only: Stop the current operation. The updates between start and stop of an operation belong to the same unit of work and will be undone / redone together.
ja: PDF のみ: 現在の操作を停止します。操作の開始から終了までの間の更新は、同じユニットの作業に属し、一緒に元に戻される / やり直されます。

en: PDF only: Return the numbers of the current operation and the total operation count.
ja: PDF のみ: 現在の操作番号と総操作数を返します。

en: a tuple `(step, steps)` containing the current operation number and the total number of operations in the journal. If **step** is 0, we are at the top of the journal. If **step** equals **steps**, we are at the bottom. Updating the PDF with anything other than undo or redo will automatically remove all journal entries after the current one and the new update will become the new last entry in the journal. The updates corresponding to the removed journal entries will be permanently lost.
ja: ジャーナル内の現在の操作番号と総操作数を含むタプル `(step, steps)` が返されます。**step** が 0 の場合、ジャーナルの先頭にいることを示します。**step** が **steps** と等しい場合、ジャーナルの末尾にいることを示します。undo または redo 以外の何かで PDF を更新すると、現在のエントリ以降のすべてのジャーナルエントリが自動的に削除され、新しい更新がジャーナルの新しい最後のエントリになります。削除されたジャーナルエントリに対応する更新は永久に失われます。

en: PDF only: Return the name of operation number *step.*
ja: PDF のみ: 操作番号 *step* の操作名を返します。

en: PDF only: Show whether forward ("redo") and / or backward ("undo") executions are possible from the current journal position.
ja: PDF のみ: 現在のジャーナル位置から前方（"やり直し"）および後方（"元に戻す"）の実行が可能かどうかを表示します。

en: a dictionary `{"undo": bool, "redo": bool}`. The respective method is available if its value is `True`.
ja: `{"undo": bool, "redo": bool}` 形式の辞書。各メソッドはその値が `True` の場合に利用可能です。

en: PDF only: Revert (undo) the current step in the journal. This moves towards the journal's top.
ja: PDF のみ: ジャーナル内の現在のステップを元に戻します（元に戻す）。これにより、ジャーナルの先頭に向かって移動します。

en: PDF only: Re-apply (redo) the current step in the journal. This moves towards the journal's bottom.
ja: PDF のみ：現在のステップをジャーナルのボトムに戻して再適用します。

en: PDF only: Save the journal to a file.
ja: PDF のみ：ジャーナルをファイルに保存します。

en: either a filename as string or a file object opened as "wb" (or an `io.BytesIO()` object).
ja: 文字列としてのファイル名または "wb" で開かれたファイルオブジェクト (または `io.BytesIO()` オブジェクト)。

en: PDF only: Load journal from a file. Enables journalling for the document. If journalling is already enabled, an exception is raised.
ja: PDF のみ：ファイルからジャーナルを読み込みます。ドキュメントのジャーナリングを有効にします。既にジャーナリングが有効になっている場合、例外が発生します。

en: the filename (str) of the journal or a file object opened as "rb" (or an `io.BytesIO()` object).
ja: ジャーナルのファイル名 (str) または "rb" で開かれたファイルオブジェクト (または `io.BytesIO()` オブジェクト)。

en: PDF only: Saves a "snapshot" of the document. This is a PDF document with a special, incremental-save format compatible with journalling -- therefore no save options are available. Saving a snapshot is not possible for new documents.
ja: PDF のみ：ドキュメントの「スナップショット」を保存します。これは、ジャーナリングと互換性のある特別なインクリメンタルセーブ形式を持つ PDF ドキュメントです。そのため、セーブオプションは利用できません。新しいドキュメントにはスナップショットを保存することはできません。

en: This is a normal PDF document with no usage restrictions whatsoever. If it is not being changed in any way, it can be used together with its journal to undo / redo operations or continue updating.
ja: これは通常の PDF ドキュメントで、制限はありません。何も変更されていない場合、そのスナップショットはジャーナルと共に操作を元に戻したり、やり直したり、更新を続けたりするために使用できます。

en: Contains the first :ref:`Outline` entry of the document (or `None`). Can be used as a starting point to walk through all outline items. Accessing this property for encrypted, not authenticated documents will raise an *AttributeError*.
ja: ドキュメントの最初のアウトラインエントリを含みます (または `None`)。すべてのアウトラインアイテムを歩く出発点として使用できます。暗号化された、認証されていないドキュメントに対してこのプロパティにアクセスすると、*AttributeError* が発生します。

en: type
ja: タイプ

en: *False* if document is still open. If closed, most other attributes and methods will have been deleted / disabled. In addition, :ref:`Page` objects referring to this document (i.e. created with :meth:`Document.load_page`) and their dependent objects will no longer be usable. For reference purposes, :attr:`Document.name` still exists and will contain the filename of the original document (if applicable).
ja: もし文書がまだ開いている場合は *False* です。閉じた場合、他のほとんどの属性やメソッドが削除されたり無効になります。また、この文書を参照する :ref:`Page` オブジェクト（すなわち :meth:`Document.load_page` で作成されたもの）とそれに依存するオブジェクトは利用できなくなります。参照用に、:attr:`Document.name` はまだ存在し、元の文書のファイル名が含まれます（該当する場合）。

en: *True* if this is a PDF document and contains unsaved changes, else *False*.
ja: これがPDFドキュメントであり、保存されていない変更が含まれている場合は *True* 、それ以外は *False* です。

en: *True* if this is a PDF document, else *False*.
ja: これがPDFドキュメントである場合は *True* 、それ以外は *False* です。

en: *False* if this is not a PDF or has no form fields, otherwise the number of root form fields (fields with no ancestors).
ja: これがPDFでないか、フォームフィールドが含まれていない場合は *False* であり、それ以外の場合はルートフォームフィールド（祖先のないフィールド）の数です。

en: *(Changed in v1.16.4)* Returns the total number of (root) form fields.
ja: *（v1.16.4で変更）* （ルート）フォームフィールドの合計数を返します。

en: *True* if document has a variable page layout (like e-books or HTML). In this case you can set the desired page dimensions during document creation (open) or via method :meth:`layout`.
ja: 文書が可変ページレイアウト（電子書籍やHTMLのような）を持つ場合は *True* です。この場合、文書の作成（オープン）時または :meth:`layout` メソッドを使用して所望のページ寸法を設定できます。

en: New in v1.18.2
ja: v1.18.2で新しく追加されました。

en: *True* if PDF has been repaired during open (because of major structure issues). Always *False* for non-PDF documents. If true, more details have been stored in `TOOLS.mupdf_warnings()`, and :meth:`Document.can_save_incrementally` will return *False*.
ja: PDFがオープン時に修復された場合は *True* です（主要な構造上の問題のため）。非PDF文書の場合は常に *False* です。*True* の場合、詳細は `TOOLS.mupdf_warnings()` に保存され、:meth:`Document.can_save_incrementally` は *False* を返します。

en: *True* if PDF is in linearized format. *False* for non-PDF documents.
ja: PDFが直線化形式である場合は *True* です。非PDF文書の場合はFalseです。

en: A dictionary indicating the `/MarkInfo` value. If not specified, the empty dictionary is returned. If not a PDF, `None` is returned.
ja: `/MarkInfo` の値を示す辞書です。指定されていない場合、空の辞書が返されます。PDFでない場合は `None` が返されます。

en: A string containing the `/PageMode` value. If not specified, the default "UseNone" is returned. If not a PDF, `None` is returned.
ja: `/PageMode` の値を含む文字列です。指定されていない場合、デフォルトの「UseNone」が返されます。PDFでない場合、`None` が返されます。

en: A string containing the `/PageLayout` value. If not specified, the default "SinglePage" is returned. If not a PDF, `None` is returned.
ja: `/PageLayout` の値を含む文字列です。指定されていない場合、デフォルトの「SinglePage」が返されます。PDFでない場合、`None` が返されます。

en: An integer counting the number of versions present in the document. Zero if not a PDF, otherwise the number of incremental saves plus one.
ja: ドキュメント内に存在するバージョンの数をカウントする整数です。PDFでない場合、ゼロです。それ以外の場合、増分保存の数に1を加えたものです。

en: Indicates whether the document is password-protected against access. This indicator remains unchanged -- **even after the document has been authenticated**. Precludes incremental saves if true.
ja: ドキュメントがアクセス制限のあるパスワードで保護されているかどうかを示します。この指示は、**ドキュメントが認証された後も** 変更されません。 `True` の場合、増分保存が不可能です。

en: This indicator initially equals :attr:`Document.needs_pass`. After successful authentication, it is set to *False* to reflect the situation.
ja: この指示は、最初に :attr:`Document.needs_pass` と等しいです。認証が成功した後、状況を反映するために *False* に設定されます。

en: Contains the permissions to access the document. This is an integer containing bool values in respective bit positions. For example, if *doc.permissions & fitz.PDF_PERM_MODIFY > 0*, you may change the document. See :ref:`PermissionCodes` for details.
ja: アクセス許可を示します。これは、対応するビット位置にbool値を含む整数です。例えば、*doc.permissions & fitz.PDF_PERM_MODIFY > 0*  の場合、ドキュメントを変更できます。詳細については、:ref:`PermissionCodes` を参照してください。

en: Contains the document's meta data as a Python dictionary or `None` (if *is_encrypted=True* and *needPass=True*). Keys are *format*, *encryption*, *title*, *author*, *subject*, *keywords*, *creator*, *producer*, *creationDate*, *modDate*, *trapped*. All item values are strings or `None`.
ja: 文書のメタデータをPythonの辞書形式で含んでいます。ただし、*is_encrypted=True* かつ *needPass=True* の場合は `None` です。キーは *format*、*encryption*、*title*、*author*、*subject*、*keywords*、*creator*、*producer*、*creationDate*、*modDate*、*trapped* です。すべてのアイテムの値は文字列または `None` です。

en: Except *format* and *encryption*, for PDF documents, the key names correspond in an obvious way to the PDF keys */Creator*, */Producer*, */CreationDate*, */ModDate*, */Title*, */Author*, */Subject*, */Trapped* and */Keywords* respectively.
ja: *format* と *encryption* を除いて、PDF 文書の場合、キー名は明らかな方法で PDF キー */Creator*、*/Producer*、*/CreationDate*、*/ModDate*、*/Title*、*/Author*、*/Subject*、*/Trapped*、*/Keywords* に対応しています。

en: *format* contains the document format (e.g. 'PDF-1.6', 'XPS', 'EPUB').
ja: *format* には文書のフォーマット（例： 'PDF-1.6'、'XPS'、'EPUB'）が含まれます。

en: *encryption* either contains `None` (no encryption), or a string naming an encryption method (e.g. *'Standard V4 R4 128-bit RC4'*). Note that an encryption method may be specified **even if** *needs_pass=False*. In such cases not all permissions will probably have been granted. Check :attr:`Document.permissions` for details.
ja: *encryption* には `None` （暗号化なし）または暗号化メソッドを示す文字列（例： *'Standard V4 R4 128-bit RC4'*） が含まれます。 *needs_pass=False* の場合でも暗号化メソッドが指定される場合があります。その場合、すべての権限が付与されていない可能性があります。詳細は :attr:`Document.permissions` を確認してください。

en: If the date fields contain valid data (which need not be the case at all!), they are strings in the PDF-specific timestamp format "D:<TS><TZ>", where
ja: 日付フィールドに有効なデータが含まれている場合（必ずしもそうである必要はありません！）、それらは PDF 固有のタイムスタンプ形式 "D:<TS><TZ>" の文字列です。

en: <TS> is the 12 character ISO timestamp *YYYYMMDDhhmmss* (*YYYY* - year, *MM* - month, *DD* - day, *hh* - hour, *mm* - minute, *ss* - second), and
ja: <TS> は 12 文字の ISO タイムスタンプ YYYYMMDDhhmmss（*YYYY* - 年、*MM* - 月、*DD* - 日、*hh* - 時、*mm* - 分、*ss* - 秒）であり、

en: <TZ> is a time zone value (time interval relative to GMT) containing a sign ('+' or '-'), the hour (*hh*), and the minute (*'mm'*, note the apostrophes!).
ja: <TZ> は GMT に対する時刻間隔を示す符号（'+' または '-'）、時間（*hh*）、および分（*'mm'*、アポストロフィに注意！）を含むタイムゾーン値です。

en: A Paraguayan value might hence look like *D:20150415131602-04'00'*, which corresponds to the timestamp April 15, 2015, at 1:16:02 pm local time Asuncion.
ja: したがって、パラグアイの値は *D:20150415131602-04'00'* となり、これは Asuncion の現地時間で 2015 年 4 月 15 日午後 1 時 16 分 02 秒を表します。

en: Contains the *filename* or *filetype* value with which *Document* was created.
ja: *Document* が作成された *ファイル名* または *ファイルタイプ* の値を含みます。

en: Contains the number of pages of the document. May return 0 for documents with no pages. Function `len(doc)` will also deliver this result.
ja: 文書のページ数を含みます。ページがない文書の場合は 0 を返す場合があります。`len(doc)` 関数もこの結果を返します。

en: New in v1.17.0
ja: v1.17.0 で新たに追加されました

en: Contains the number of chapters in the document. Always at least 1. Relevant only for document types with chapter support (EPUB currently). Other documents will return 1.
ja: 文書の章の数を含みます。常に少なくとも 1 です。章のサポートがある文書タイプ（現在は EPUB のみ）にのみ関連します。その他の文書は 1 を返します。

en: Contains (chapter, pno) of the document's last page. Relevant only for document types with chapter support (EPUB currently). Other documents will return `(0, page_count - 1)` and `(0, -1)` if it has no pages.
ja: 文書の最後のページの（章、pno）を含みます。章のサポートがある文書タイプ（現在は EPUB のみ）にのみ関連します。その他の文書は `(0, page_count - 1)` と `(0, -1)` を返します。

en: A list of form field font names defined in the */AcroForm* object. `None` if not a PDF.
ja: */AcroForm* オブジェクトで定義されたフォームフィールドのフォント名のリストです。PDF でない場合は `None` です。

en: For methods that change the structure of a PDF (:meth:`insert_pdf`, :meth:`select`, :meth:`copy_page`, :meth:`delete_page` and others), be aware that objects or properties in your program may have been invalidated or orphaned. Examples are :ref:`Page` objects and their children (links, annotations, widgets), variables holding old page counts, tables of content and the like. Remember to keep such variables up to date or delete orphaned objects. Also refer to :ref:`ReferenialIntegrity`.
ja: PDFの構造を変更するメソッド (:meth:`insert_pdf`、:meth:`select`、:meth:`copy_page`、:meth:`delete_page` など）を使用する場合、プログラム内のオブジェクトやプロパティが無効化されたり孤立したりする可能性があることに注意してください。これには :ref:`Page` オブジェクトとその子要素（リンク、注釈、ウィジェット）、古いページ数を保持する変数、目次などが含まれます。このような変数を最新の情報に保つか、孤立したオブジェクトを削除することを忘れないでください。:ref:`ReferenialIntegrity` も参照してください。

en: :meth:`set_metadata` Example
ja: :meth:`set_metadata` の例

en: Clear metadata information. If you do this out of privacy / data protection concerns, make sure you save the document as a new file with *garbage > 0*. Only then the old */Info* object will also be physically removed from the file. In this case, you may also want to clear any XML metadata inserted by several PDF editors:
ja: メタデータ情報をクリアします。プライバシー/データ保護の理由からこれを行う場合は、*ガベージ > 0* でドキュメントを新しいファイルとして保存してから古い */Info* オブジェクトもファイルから物理的に削除されることを確認してください。この場合、いくつかのPDFエディタによって挿入されたXMLメタデータもクリアすることを検討するかもしれません。

en: :meth:`set_toc` Demonstration
ja: :meth:`set_toc` のデモンストレーション

en: This shows how to modify or add a table of contents. Also have a look at `import.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/import-toc/import.py>`_ and `export.py <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/examples/export-toc/export.py>`_ in the examples directory.
ja: これは、目次を変更または追加する方法を示しています。また、examplesディレクトリにある `import.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/import-toc/import.py>`_ と `export.py <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/examples/export-toc/export.py>`_ も参照してみてください。

en: :meth:`insert_pdf` Examples
ja: :meth:`insert_pdf` の例

en: **(1) Concatenate two documents including their TOCs:**
ja: **（1）2つの文書を連結して、それぞれの目次を含める：**

en: Obviously, similar ways can be found in more general situations. Just make sure that hierarchy levels in a row do not increase by more than one. Inserting dummy bookmarks before and after *toc2* segments would heal such cases. A ready-to-use GUI (wxPython) solution can be found in script `join.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/join-documents/join.py>`_ of the examples directory.
ja: 明らかに、より一般的な状況についても同様の方法が見つかるでしょう。連続するヒエラルキーレベルが1以上増加しないように注意してください。 **toc2** セグメントの前後にダミーのブックマークを挿入することで、そのような場合を修正できます。すぐに使用できるGUI（wxPython）の解決策は、examplesディレクトリのスクリプト `join.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/join-documents/join.py>`_  で見つけることができます。

en: **(2) More examples:**
ja: **（2）その他の例：**

en: Other Examples
ja: 他の例

en: **Extract all page-referenced images of a PDF into separate PNG files**::
ja: **PDF内のすべてのページ参照画像を個別のPNGファイルに抽出します**::

en: **Rotate all pages of a PDF:**
ja: **PDFのすべてのページを回転させます：**

en: Footnotes
ja: 脚注

en: Content streams describe what (e.g. text or images) appears where and how on a page. PDF uses a specialized mini language similar to PostScript to do this (pp. 643 in :ref:`AdobeManual`), which gets interpreted when a page is loaded.
ja: コンテンツストリームは、ページ上に何が表示され、どのように表示されるかを説明します。PDFは、ページが読み込まれると解釈される、PostScriptに似た専門のミニ言語を使用しています（:ref:`AdobeManual` のpp. 643）。

en: However, you **can** use :meth:`Document.get_toc` and :meth:`Page.get_links` (which are available for all document types) and copy this information over to the output PDF. See demo `convert.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/convert-document/convert.py>`_.
ja: ただし、:meth:`Document.get_toc` と :meth:`Page.get_links` （すべてのドキュメントタイプで利用可能）を使用して、この情報を出力PDFにコピーできます。デモ `convert.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/convert-document/convert.py>`_ を参照してください。

en: For applicable (EPUB) document types, loading a page via its absolute number may result in layouting a large part of the document, before the page can be accessed. To avoid this performance impact, prefer chapter-based access. Use convenience methods and attributes :meth:`Document.next_location`, :meth:`Document.prev_location` and :attr:`Document.last_location` for maintaining a high level of coding efficiency.
ja: 該当する（EPUB）ドキュメントタイプの場合、絶対番号でページを読み込むと、ページにアクセスする前にドキュメントの大部分のレイアウトが発生する場合があります。このパフォーマンスへの影響を避けるために、章ベースのアクセスを優先します。:meth:`Document.prev_location`、:attr:`Document.last_location`、:attr:`Document.last_location` といった便利なメソッドや属性を使用して、高いコーディング効率を維持してください。

en: These parameters cause separate handling of stream categories: use it together with `expand` to restrict decompression to streams other than images / fontfiles.
ja: これらのパラメータはストリームカテゴリの別々の処理を引き起こします：これらを `expand` と一緒に使用して、画像やフォントファイル以外のストリームの解凍を制限できます。

en: Examples for "Form XObjects" are created by :meth:`Page.show_pdf_page`.
ja: 「Form XObjects」の例は、:meth:`Page.show_pdf_page` によって作成されます。

en: For a *False* the **complete document** must be scanned. Both methods **do not load pages,** but only scan object definitions. This makes them at least 10 times faster than application-level loops (where total response time roughly equals the time for loading all pages). For the :ref:`AdobeManual` (756 pages) and the Pandas documentation (over 3070 pages) -- both have no annotations -- the method needs about 11 ms for the answer *False*. So response times will probably become significant only well beyond this order of magnitude.
ja: *False* の場合、完全なドキュメントをスキャンする必要があります。ただし、これらのメソッドは **ページを読み込まず**、オブジェクト定義のみをスキャンします。これにより、アプリケーションレベルのループよりも少なくとも10倍高速になります（合計応答時間はすべてのページを読み込む時間とほぼ同じです）。:ref:`AdobeManual`（756ページ）とPandasのドキュメンテーション（3070ページ以上）の両方に注釈がない場合、このメソッドは *False* の回答に約11ミリ秒かかります。したがって、応答時間はおそらくこのオーダーオブマグニチュードをはるかに超えた範囲で初めて重要になる可能性があります。

en: This only works under certain conditions. For example, if there is normal text covered by some image on top of it, then this is undetectable and the respective text is **not** removed. Similar is true for white text on white background, and so on.
ja: これは特定の条件下でのみ機能します。たとえば、上に何らかの画像が覆っている通常のテキストがある場合、これは検出不可能で、該当するテキストは削除 **されません**。同様に、白い背景の白いテキストなども同様です。

en: This documentation covers all versions up to |version|.
ja: このドキュメントは |version| までのすべてのバージョンを対象としています。
