PyMuPDF 1.23.0rc1 - en to ja translation catalogue (648 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: Page
ja: Page (ページ)

en: Class representing a document page. A page object is created by :meth:`Document.load_page` or, equivalently, via indexing the document like `doc[n]` - it has no independent constructor.
ja: ドキュメントページを表すクラス。ページオブジェクトは:meth:`Document.load_page` またはドキュメントをインデックスで参照することで作成されます（例：`doc[n]` ） - 独立したコンストラクタはありません。

en: There is a parent-child relationship between a document and its pages. If the document is closed or deleted, all page objects (and their respective children, too) in existence will become unusable ("orphaned"): If a page property or method is being used, an exception is raised.
ja: ドキュメントとそのページとの親子関係があります。ドキュメントが閉じられるか削除されると、存在するすべてのページオブジェクト（およびそれに関連する子供たちも）が使用できなくなります（「孤児」になります）。ページのプロパティまたはメソッドを使用している場合、例外が発生します。

en: Several page methods have a :ref:`Document` counterpart for convenience. At the end of this chapter you will find a synopsis.
ja: 便宜のために、いくつかのページメソッドには :ref:`Document` の対応するメソッドがあります。この章の最後に概要があります。

en: Modifying Pages
ja: ページの修正

en: Changing page properties and adding or changing page content is available for PDF documents only.
ja: ページのプロパティを変更し、ページの内容を追加または変更することは、PDFドキュメントのみで使用可能です。

en: In a nutshell, this is what you can do with PyMuPDF:
ja: 要するに、PyMuPDFでできることは次のとおりです：

en: Modify page rotation and the visible part ("cropbox") of the page.
ja: ページの回転とページの可視部分（「クロップボックス」）の変更。

en: Insert images, other PDF pages, text and simple geometrical objects.
ja: 画像、他のPDFページ、テキスト、単純な幾何学的オブジェクトの挿入。

en: Add annotations and form fields.
ja: アノテーションとフォームフィールドの追加。

en: Methods require coordinates (points, rectangles) to put content in desired places. Please be aware that since v1.17.0 these coordinates **must always** be provided relative to the **unrotated** page. The reverse is also true: except :attr:`Page.rect`, resp. :meth:`Page.bound` (both *reflect* when the page is rotated), all coordinates returned by methods and attributes pertain to the unrotated page.
ja: メソッドには、コンテンツを所望の場所に配置するために座標（ポイント、矩形）が必要です。v1.17.0以降、これらの座標は常に **回転していない** ページに対して提供する **必要があります**。逆もまた真実です：:attr:`Page.rect`, resp. :meth:`Page.bound` を除いて（ページが回転したときを *反映* しています）、メソッドと属性が返すすべての座標は回転していないページに関連しています。

en: So the returned value of e.g. :meth:`Page.get_image_bbox` will not change if you do a :meth:`Page.set_rotation`. The same is true for coordinates returned by :meth:`Page.get_text`, annotation rectangles, and so on. If you want to find out, where an object is located in **rotated coordinates**, multiply the coordinates with :attr:`Page.rotation_matrix`. There also is its inverse, :attr:`Page.derotation_matrix`, which you can use when interfacing with other readers, which may behave differently in this respect.
ja: したがって、:meth:`Page.get_image_bbox` などのメソッドの返される値は、Page.set_rotation()を実行しても変更されません。同じことが :meth:`Page.get_text`、アノテーションの矩形などから返される座標にも当てはまります。オブジェクトが **回転した座標** でどこにあるかを調べたい場合は、座標を:attr:`Page.rotation_matrix` で乗算します。:attr:`Page.derotation_matrix` とその逆行列もあり、他のリーダーと連携する際に使用できます。この点で異なる動作をするかもしれません。

en: If you add or update annotations, links or form fields on the page and immediately afterwards need to work with them (i.e. **without leaving the page**), you should reload the page using :meth:`Document.reload_page` before referring to these new or updated items.
ja: ページに注釈、リンク、またはフォームフィールドを追加または更新し、直後にこれらの新しいまたは更新されたアイテムを操作する必要がある場合（つまり **ページを離れずに**）、:meth:`Document.reload_page` を使用してページを再読み込みする必要があります。

en: Reloading the page is generally recommended -- although not strictly required in all cases. However, some annotation and widget types have extended features in PyMuPDF compared to MuPDF. More of these extensions may also be added in the future.
ja: 一般的にはページを再読み込みすることをお勧めしますが、すべてのケースで厳密に必要とされるわけではありません。ただし、PyMuPDFの注釈とウィジェットの種類の一部は、MuPDFと比較して拡張機能を持っています。今後もこれらの拡張機能が増えるかもしれません

en: Releoading the page ensures all your changes have been fully applied to PDF structures, so you can safely create Pixmaps or successfully iterate over annotations, links and form fields.
ja: ページを再読み込むことで、変更がPDF構造に完全に適用され、Pixa画像を作成したり、アノテーション、リンク、フォームフィールドを正常にイテレートしたりできるようになります。

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

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

en: PDF only: add a caret annotation
ja: PDFのみ：キャレットアノテーションを追加します

en: PDF only: add a circle annotation
ja: PDFのみ：円注釈を追加します

en: PDF only: add a file attachment annotation
ja: PDFのみ：ファイル添付アノテーションを追加します

en: PDF only: add a text annotation
ja: PDFのみ：テキストアノテーションを追加します

en: PDF only: add a "highlight" annotation
ja: PDFのみ：「ハイライト」アノテーションを追加します

en: PDF only: add an ink annotation
ja: PDFのみ：インク注釈を追加します

en: PDF only: add a line annotation
ja: PDFのみ：線アノテーションを追加します

en: PDF only: add a polygon annotation
ja: PDFのみ：多角形アノテーションを追加します

en: PDF only: add a multi-line annotation
ja: PDFのみ：多線アノテーションを追加します

en: PDF only: add a rectangle annotation
ja: PDFのみ：四角アノテーション釈を追加します

en: PDF only: add a redaction annotation
ja: PDFのみ：黒塗りアノテーションを追加します

en: PDF only: add a "squiggly" annotation
ja: PDFのみ：「波線」アノテーションを追加します

en: PDF only: add a "rubber stamp" annotation
ja: PDFのみ：「スタンプ」アノテーションを追加します

en: PDF only: add a "strike-out" annotation
ja: PDFのみ：「取り消し線」アノテーションを追加します

en: PDF only: add a comment
ja: PDFのみ：コメントを追加します

en: PDF only: add an "underline" annotation
ja: PDFのみ：「下線」アノテーションを追加します

en: PDF only: add a PDF Form field
ja: PDFのみ：PDFフォームフィールドを追加します

en: PDF only: a list of annotation (and widget) names
ja: PDFのみ：アノテーション（およびウィジェット）の名前のリスト

en: PDF only: a list of annotation (and widget) xrefs
ja: PDFのみ：アノテーション（およびウィジェット）のxrefのリスト

en: return a generator over the annots on the page
ja: ページ上のアノテーションのジェネレーターを返します

en: PDF only: process the redactions of the page
ja: PDFのみ：ページの塗りつぶしを処理します

en: rectangle of the page
ja: ページの矩形

en: PDF only: delete an annotation
ja: PDFのみ：アノテーションを削除します

en: PDF only: delete an image
ja: PDFのみ：画像を削除します

en: PDF only: delete a link
ja: PDFのみ：リンクを削除します

en: PDF only: delete a widget / field
ja: PDFのみ：ウィジェット/フィールドを削除します

en: PDF only: draw a cubic Bezier curve
ja: PDFのみ：三次ベジエ曲線を描画します

en: PDF only: draw a circle
ja: PDFのみ：円を描画します

en: PDF only: draw a special Bezier curve
ja: PDFのみ：特別なベジエ曲線を描画します

en: PDF only: draw a line
ja: PDFのみ：直線を描画します

en: PDF only: draw an oval / ellipse
ja: PDFのみ：楕円を描画します

en: PDF only: connect a point sequence
ja: PDFのみ：点のシーケンスを接続します

en: PDF only: draw a quad
ja: PDF のみ: クアッドを描く

en: PDF only: draw a rectangle
ja: PDFのみ：四角形を描画します

en: PDF only: draw a circular sector
ja: PDFのみ：円セクタを描画します

en: PDF only: draw a squiggly line
ja: PDFのみ：波線を描画します

en: PDF only: draw a zig-zagged line
ja: PDFのみ：ジグザグ線を描画します

en: locate tables on the page
ja: ページ上のテーブルを検出します

en: get vector graphics on page
ja: ページ上のベクトルグラフィックを取得します

en: PDF only: get list of referenced fonts
ja: PDFのみ：参照されたフォントのリストを取得

en: PDF only: get bbox and matrix of embedded image
ja: PDFのみ：埋め込まれた画像のバウンディングボックスと行列を取得

en: get list of meta information for all used images
ja: 使用されるすべての画像のメタ情報のリストを取得

en: PDF only: improved version of :meth:`Page.get_image_bbox`
ja: PDFのみ： :meth:`Page.get_image_bbox` の改良バージョンを取得

en: PDF only: get list of referenced images
ja: PDFのみ：参照された画像のリストを取得

en: PDF only: return the label of the page
ja: PDFのみ：ページのラベルを返す

en: get all links
ja: すべてのリンクを取得

en: create a page image in raster format
ja: ラスターフォーマットのページイメージを作成

en: create a page image in SVG format
ja: SVGフォーマットのページイメージを作成

en: extract the page's text
ja: ページのテキストを抽出

en: extract text contained in a rectangle
ja: 特定の矩形に含まれるテキストを抽出

en: create a TextPage with OCR for the page
ja: ページのOCR付きのTextPageを作成

en: create a TextPage for the page
ja: ページのTextPageを作成

en: PDF only: get list of referenced xobjects
ja: PDFのみ：参照されたxobjectのリストを取得

en: PDF only: insert a font for use by the page
ja: PDFのみ：ページで使用するフォントを挿入

en: PDF only: insert an image
ja: PDFのみ：画像を挿入

en: PDF only: insert a link
ja: PDFのみ：リンクを挿入

en: PDF only: insert text
ja: PDFのみ：テキストを挿入

en: PDF only: insert a text box
ja: PDFのみ：テキストボックスを挿入

en: return a generator of the links on the page
ja: ページ上のリンクのジェネレータを返す

en: PDF only: load a specific annotation
ja: PDFのみ：特定のアノテーションを読み込む

en: PDF only: load a specific field
ja: PDFのみ：特定のフィールドを読み込む

en: return the first link on a page
ja: ページ上の最初のリンクを返す

en: PDF only: create a new :ref:`Shape`
ja: PDFのみ：新しい :ref:`Shape` を作成

en: PDF only: replace an image
ja: PDFのみ：画像を置換

en: search for a string
ja: 文字列を検索

en: PDF only: modify `/ArtBox`
ja: PDFのみ： `/ArtBox` を変更

en: PDF only: modify `/BleedBox`
ja: PDFのみ：/BleedBoxを変更

en: PDF only: modify the :data:`cropbox` (visible page)
ja: PDFのみ： :data:`cropbox` （可視ページ）を変更

en: PDF only: modify `/MediaBox`
ja: PDFのみ：/MediaBoxを変更

en: PDF only: set page rotation
ja: PDFのみ：ページの回転を設定

en: PDF only: modify `/TrimBox`
ja: PDFのみ：`/TrimBox` を変更

en: PDF only: display PDF page image
ja: PDFのみ：PDFページ画像を表示

en: PDF only: modify a link
ja: PDFのみ：リンクを変更

en: return a generator over the fields on the page
ja: ページ上のフィールドのジェネレータを返す

en: write one or more :ref:`Textwriter` objects
ja: 1つ以上の :ref:`Textwriter` オブジェクトを書き込む

en: displacement of the :data:`cropbox`
ja: :data:`cropbox` の位置

en: the page's :data:`cropbox`
ja: ページの :data:`cropbox`

en: the page's `/ArtBox`
ja: ページの `/ArtBox`

en: the page's `/BleedBox`
ja: ページの `/BleedBox`

en: the page's `/TrimBox`
ja: ページの `/TrimBox`

en: PDF only: get coordinates in unrotated page space
ja: PDFのみ：回転されていないページ空間内の座標を取得

en: first :ref:`Annot` on the page
ja: ページ上の最初の :ref:`Annot`

en: first :ref:`Link` on the page
ja: ページ上の最初の :ref:`Link`

en: first widget (form field) on the page
ja: ページ上の最初のウィジェット（フォームフィールド）

en: bottom-right point of :data:`mediabox`
ja: :data:`mediabox` の右下のポイント

en: the page's :data:`mediabox`
ja: ページの :data:`mediabox`

en: page number
ja: ページ番号

en: owning document object
ja: 所属するドキュメントオブジェクト

en: PDF only: get coordinates in rotated page space
ja: PDFのみ：回転したページ空間内の座標を取得

en: PDF only: page rotation
ja: PDFのみ：ページの回転

en: PDF only: translate between PDF and MuPDF space
ja: PDFのみ：PDFとMuPDFのスペース間を変換

en: PDF only: page :data:`xref`
ja: PDFのみ：ページの :data:`xref`

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

en: Determine the rectangle of the page. Same as property :attr:`Page.rect` below. For PDF documents this **usually** also coincides with :data:`mediabox` and :data:`cropbox`, but not always. For example, if the page is rotated, then this is reflected by this method -- the :attr:`Page.cropbox` however will not change.
ja: ページの長方形を決定します。下記の :attr:`Page.rect` プロパティと同じです。PDF文書の場合、通常は :data:`mediabox` と :data:`cropbox` と一致しますが、常にそうとは限りません。たとえば、ページが回転している場合、このメソッドに反映されますが、:attr:`Page.cropbox` は変更されません。

en: Return type
ja: 戻り値の型

en: New in v1.16.0
ja: v1.16.0で新たに追加された

en: PDF only: Add a caret icon. A caret annotation is a visual symbol normally used to indicate the presence of text edits on the page.
ja: PDFのみ: ケアットアイコンを追加します。ケアットアノテーションは通常、ページ上でテキストの編集が存在することを示すために使用される視覚的なシンボルです

en: Parameters
ja: パラメータ

en: the top left point of a 20 x 20 rectangle containing the MuPDF-provided icon.
ja: point (point_like) – MuPDFが提供するアイコンを含む20 x 20の長方形の左上のポイント。

en: Returns
ja: 戻り値

en: the created annotation. Stroke color blue = (0, 0, 1), no fill color support.
ja: 作成されたアノテーション。ストロークの色は青=(0, 0, 1)で、塗りつぶしの色はサポートされていません。

en: PDF only: Add a comment icon ("sticky note") with accompanying text. Only the icon is visible, the accompanying text is hidden and can be visualized by many PDF viewers by hovering the mouse over the symbol.
ja: PDFのみ: コメントアイコン（「付箋」）を追加し、それに関連するテキストを含めます。アイコンのみが表示され、関連するテキストは非表示で、多くのPDFビューアではアイコンの上にマウスを重ねることで可視化できます。

en: the top left point of a 20 x 20 rectangle containing the MuPDF-provided "note" icon.
ja: 提供されたMuPDFアイコンが含まれる20 x 20の矩形の左上の点。

en: the commentary text. This will be shown on double clicking or hovering over the icon. May contain any Latin characters.
ja: コメントテキスト。これはダブルクリックまたはアイコンの上にカーソルを合わせることで表示されます。ラテン文字を含むことができます。

en: *(new in v1.16.0)* choose one of "Note" (default), "Comment", "Help", "Insert", "Key", "NewParagraph", "Paragraph" as the visual symbol for the embodied text [#f4]_.
ja: *（v1.16.0で新規追加）* テキストを表す視覚的なシンボルとして、「Note」（デフォルト）

en: the created annotation. Stroke color yellow = (1, 1, 0), no fill color support.
ja: 作成された注釈。ストロークカラーは黄色（1, 1, 0）、塗りつぶしカラーのサポートはありません。

en: Changed in v1.19.6: add border color parameter
ja: v1.19.6で変更：境界色パラメータを追加

en: PDF only: Add text in a given rectangle.
ja: PDFのみ: 指定された矩形にテキストを追加します。

en: the rectangle into which the text should be inserted. Text is automatically wrapped to a new line at box width. Lines not fitting into the box will be invisible.
ja: テキストを挿入する矩形。テキストはボックスの幅で自動的に改行されます。ボックスに収まらない行は見えません。

en: the text. *(New in v1.17.0)* May contain any mixture of Latin, Greek, Cyrillic, Chinese, Japanese and Korean characters. The respective required font is automatically determined.
ja: テキスト。*（v1.17.0で新規追加）* ラテン文字、ギリシャ文字、キリル文字、中国語、日本語、韓国語の文字を任意の組み合わせで含めることができます。必要なフォントは自動的に決定されます。

en: the :data:`fontsize`. Default is 12.
ja: :data:`fontsize`。デフォルトは12です。

en: the font name. Default is "Helv". Accepted alternatives are "Cour", "TiRo", "ZaDb" and "Symb". The name may be abbreviated to the first two characters, like "Co" for "Cour". Lower case is also accepted. *(Changed in v1.16.0)* Bold or italic variants of the fonts are **no longer accepted**. A user-contributed script provides a circumvention for this restriction -- see section *Using Buttons and JavaScript* in chapter :ref:`FAQ`. *(New in v1.17.0)* The actual font to use is now determined on a by-character level, and all required fonts (or sub-fonts) are automatically included. Therefore, you should rarely ever need to care about this parameter and let it default (except you insist on a serifed font for your non-CJK text parts).
ja: フォント名。デフォルトは「Helv」です。受け入れられる代替案は「Cour」、「TiRo」、「ZaDb」、「Symb」です。名前は、最初の2文字まで省略することができます。「Co」のように、小文字も受け入れられます。*（v1.16.0で変更）* フォントの太字または斜体のバリアントはもはや受け入れられません。この制限を回避するユーザー投稿のスクリプトが提供されており、:ref:`FAQ` の章で「ボタンとJavaScriptの使用」を参照してください。（v1.17.0で新規追加）使用する実際のフォントは、文字ごとに決定され、必要なすべてのフォント（またはサブフォント）が自動的に含まれます。したがって、このパラメータについて心配する必要はほとんどありません。デフォルトにしておくべきです（CJK以外のテキスト部分にセリフフォントを希望する場合を除く）。

en: *(new in v1.16.0)* the text color. Default is black.
ja: *（v1.16.0で新規追加）* テキストの色。デフォルトは黒です。

en: *(new in v1.16.0)* the fill color. Default is white.
ja: *（v1.16.0で新規追加）* 塗りつぶしの色。デフォルトは白です。

en: the text color. Default is black.
ja: テキストの色。デフォルトは黒です。

en: *(new in v1.19.6)* the border color. Default is `None`.
ja: *（v1.19.6で新規追加）* 境界色。デフォルトは `None` です。

en: *(new in v1.17.0)* text alignment, one of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, TEXT_ALIGN_RIGHT - justify is **not supported**.
ja: *（v1.17.0で新規追加）* テキストの配置、TEXT_ALIGN_LEFT、TEXT_ALIGN_CENTER、TEXT_ALIGN_RIGHTのいずれか。ジャスティファイは **サポートされていません**。

en: the text orientation. Accepted values are 0, 90, 270, invalid entries are set to zero.
ja: テキストの向き。受け入れられる値は0、90、270で、無効なエントリはゼロに設定されます。

en: the created annotation. Color properties **can only be changed** using special parameters of :meth:`Annot.update`. There, you can also set a border color different from the text color.
ja: 作成された注釈。色のプロパティは、:meth:`Annot.update` の特別なパラメータを使用して **のみ変更できます**。そこでは、テキストの色とは異なる境界色を設定することもできます。

en: PDF only: Add a file attachment annotation with a "PushPin" icon at the specified location.
ja: PDFのみ: 指定された場所に「PushPin」アイコンを持つファイル添付注釈を追加します。

en: the top-left point of a 18x18 rectangle containing the MuPDF-provided "PushPin" icon.
ja: ムPDFで提供される「PushPin」アイコンを含む18x18の四角形の左上のポイント。

en: the data to be stored (actual file content, any data, etc.).
ja: 格納するデータ（実際のファイルコンテンツ、任意のデータなど）。

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

en: the filename to associate with the data.
ja: データに関連付けるファイル名。

en: the optional PDF unicode version of filename. Defaults to filename.
ja: ファイルのPDF Unicodeバージョンのオプション。デフォルトはファイル名です。

en: an optional description of the file. Defaults to filename.
ja: ファイルのオプションの説明。デフォルトはファイル名です。

en: *(new in v1.16.0)* choose one of "PushPin" (default), "Graph", "Paperclip", "Tag" as the visual symbol for the attached data [#f4]_.
ja: v1.16.0で新しく追加された）添付データの視覚的なシンボルとして、次のいずれかを選択します。"PushPin"（デフォルト）、"Graph"、"Paperclip"、"Tag" [#f4]_。

en: the created annotation.  Stroke color yellow = (1, 1, 0), no fill color support.
ja: 作成された注釈。線の色は黄色（1, 1, 0）、塗りつぶしのサポートはありません。

en: PDF only: Add a "freehand" scribble annotation.
ja: PDFのみ: "freehand"の落書き注釈を追加します。

en: a list of one or more lists, each containing :data:`point_like` items. Each item in these sublists is interpreted as a :ref:`Point` through which a connecting line is drawn. Separate sublists thus represent separate drawing lines.
ja: 1つまたは複数のリストからなり、それぞれが :data:`point_like` アイテムを含むリストの1つです。これらのサブリスト内の各アイテムは、接続された線が描画される :ref:`Point` として解釈されます。したがって、個々のサブリストは別々の描画ラインを表します。

en: the created annotation in default appearance black =(0, 0, 0),line width 1. No fill color support.
ja: 作成された注釈はデフォルトの外観で黒色（0, 0, 0）で、線の幅は1です。塗りつぶしのサポートはありません。

en: PDF only: Add a line annotation.
ja: PDFのみ: 直線注釈を追加します。

en: the starting point of the line.
ja: 直線の開始点。

en: the end point of the line.
ja: 直線の終点。

en: the created annotation. It is drawn with line (stroke) color red = (1, 0, 0) and line width 1. No fill color support. The **annot rectangle** is automatically created to contain both points, each one surrounded by a circle of radius 3 * line width to make room for any line end symbols.
ja: 作成された注釈。線（ストローク）の色は赤色（1, 0, 0）で、線の幅は1です。塗りつぶしのサポートはありません。**アノテーションの四角形** は、各点を囲む半径 3 * 線幅の円で作成され、各点の周りにシンボルの線の終わりのためのスペースを確保します。

en: PDF only: Add a rectangle, resp. circle annotation.
ja: PDFのみ: 長方形、または円の注釈を追加します。

en: the rectangle in which the circle or rectangle is drawn, must be finite and not empty. If the rectangle is not equal-sided, an ellipse is drawn.
ja: 円または長方形が描かれる矩形。有限で空でない必要があります。矩形が正方形でない場合、楕円が描画されます。

en: the created annotation. It is drawn with line (stroke) color red = (1, 0, 0), line width 1, fill color is supported.
ja: 作成された注釈。線（ストローク）の色は赤色（1、0、0）、線の幅は1で、塗りつぶしのサポートがあります

en: New in v1.16.11
ja: 新機能 v1.16.11

en: PDF only: Add a redaction annotation. A redaction annotation identifies content to be removed from the document. Adding such an annotation is the first of two steps. It makes visible what will be removed in the subsequent step, :meth:`Page.apply_redactions`.
ja: PDFのみ：赤字注釈を追加します。赤字注釈は、文書から削除するコンテンツを識別します。この注釈を追加することは、2つのステップの最初です。それは、後続のステップである :meth:`Page.apply_redactions` で削除されるコンテンツを可視化します。

en: specifies the (rectangular) area to be removed which is always equal to the annotation rectangle. This may be a :data:`rect_like` or :data:`quad_like` object. If a quad is specified, then the enveloping rectangle is taken.
ja: 常に注釈の矩形と等しい削除する領域を指定します。これはrect_likeまたはquad_likeオブジェクトである必要があります。四角形が指定された場合、包括的な矩形が取られます。

en: *(New in v1.16.12)* text to be placed in the rectangle after applying the redaction (and thus removing old content).
ja: *(v1.16.12で新機能)* 赤字を適用した後に矩形に配置するテキスト（従って古いコンテンツを削除します）。

en: *(New in v1.16.12)* the font to use when *text* is given, otherwise ignored. The same rules apply as for :meth:`Page.insert_textbox` -- which is the method :meth:`Page.apply_redactions` internally invokes. The replacement text will be **vertically centered**, if this is one of the CJK or :ref:`Base-14-Fonts`.
ja: （新機能 v1.16.12）テキストが指定された場合に使用するフォントで、それ以外の場合は無視されます。 :meth:`Page.insert_textbox` に適用されるルールと同じです。:meth:`Page.apply_redactions` が内部的に呼び出すメソッドです。置換テキストは、CJKフォントまたは P :ref:`Base-14-Fonts` の場合、垂直方向に中央揃えになります。

en: For an **existing** font of the page, use its reference name as *fontname* (this is *item[4]* of its entry in :meth:`Page.get_fonts`).
ja: ページの **既存** のフォントの場合、参照名を *fontname* として使用してください（これは :meth:`Page.get_fonts` のエントリの *item[4]* です）。

en: For a **new, non-builtin** font, proceed as follows::
ja: **新しいビルトインでない** フォントの場合、次の手順を実行します::

en: *(New in v1.16.12)* the :data:`fontsize` to use for the replacing text. If the text is too large to fit, several insertion attempts will be made, gradually reducing the :data:`fontsize` to no less than 4. If then the text will still not fit, no text insertion will take place at all.
ja: *(新機能 v1.16.12)* 置換テキストに使用する :data:`fontsize` です。テキストが収まりきらない場合、:data:`fontsize` を徐々に4未満にならないまで縮小し、テキストがまだ収まらない場合はテキストの挿入は行われません。

en: *(New in v1.16.12)* the horizontal alignment for the replacing text. See :meth:`insert_textbox` for available values. The vertical alignment is (approximately) centered if a PDF built-in font is used (CJK or :ref:`Base-14-Fonts`).
ja: *(新機能 v1.16.12)* 置換テキストの水平方向の配置を指定します。使用可能な値については :meth:`insert_textbox` を参照してください。PDF組み込みフォント（CJKまたは :ref:`Base-14-Fonts`）が使用されている場合、垂直方向の配置は（おおよそ）中央になります。

en: *(New in v1.16.12)* the fill color of the rectangle **after applying** the redaction. The default is *white = (1, 1, 1)*, which is also taken if *None* is specified. *(Changed in v1.16.13)* To suppress a fill color altogether, specify *False*. In this cases the rectangle remains transparent.
ja: *(新機能 v1.16.12)* レッドアクションを **適用した後** の矩形の塗りつぶし色です。デフォルトは *white = (1, 1, 1)* で、*None* が指定された場合もこれが適用されます。 *(新機能 v1.16.13)* 塗りつぶし色を抑制するには、*False* を指定します。この場合、矩形は透明のままです。

en: *(New in v1.16.12)* the color of the replacing text. Default is *black = (0, 0, 0)*.
ja: *(新機能 v1.16.12)* 置換テキストの色です。デフォルトは *black = (0, 0, 0)* です。

en: *(new in v1.17.2)* add two diagonal lines to the annotation rectangle.
ja: *(新機能 v1.17.2)* アノテーションの矩形に2つの対角線を追加します。

en: the created annotation. *(Changed in v1.17.2)* Its standard appearance looks like a red rectangle (no fill color), optionally showing two diagonal lines. Colors, line width, dashing, opacity and blend mode can now be set and applied via :meth:`Annot.update` like with other annotations.
ja: 作成されたアノテーション。 *(新機能 v1.17.2)* その標準の外観は赤い矩形（塗りつぶし色なし）のようです。オプションで2つの対角線を表示できます。色、線の幅、破線、不透明度、ブレンドモードは、他の注釈と同様に :meth:`Annot.update` を介して設定および適用できます。

en: PDF only: Add an annotation consisting of lines which connect the given points. A **Polygon's** first and last points are automatically connected, which does not happen for a **PolyLine**. The **rectangle** is automatically created as the smallest rectangle containing the points, each one surrounded by a circle of radius 3 (= 3 * line width). The following shows a 'PolyLine' that has been modified with colors and line ends.
ja: PDFのみ：指定されたポイントを接続する線から成る注釈を追加します。多角形 **（Polygon）** の最初と最後のポイントは自動的に接続されますが、**PolyLine** ではそれが発生しません。各ポイントは半径3の円で囲まれた最小の **四角形** として自動的に作成されます（半径3 = 3 * 線の幅）。以下は、色や線端を変更した「PolyLine」の例を示しています。

en: a list of :data:`point_like` objects.
ja: points（list）– :data:`point_like` オブジェクトのリスト。

en: the created annotation. It is drawn with line color black, line width 1 no fill color but fill color support. Use methods of :ref:`Annot` to make any changes to achieve something like this:
ja: 作成されたアノテーションです。線の色は黒で描画され、線の幅は1で、塗りつぶし色はサポートされています。このような外見を実現するために、:ref:`Annot` のメソッドを使用して変更を加えることができます。

en: PDF only: These annotations are normally used for **marking text** which has previously been somehow located (for example via :meth:`Page.search_for`). But this is not required: you are free to "mark" just anything.
ja: PDFのみ: これらのアノテーションは通常、以前に何らかの方法で見つかったテキスト（たとえば、:meth:`Page.search_for` を使用して）をマーキングするために使用されます。ただし、これは必須ではありません：何でも「マーク」することができます。

en: Standard (stroke only -- no fill color support) colors are chosen per annotation type: **yellow** for highlighting, **red** for striking out, **green** for underlining, and **magenta** for wavy underlining.
ja: 通常、アノテーションの種類ごとに標準の（ストロークのみで、塗りつぶし色はサポートされていません）色が選択されます。ハイライト用に **黄色**、取り消し線用に **赤色**、下線用に **緑色**、波線下線用に **マゼンタ色** です。

en: All these four methods convert the arguments into a list of :ref:`Quad` objects. The **annotation** rectangle is then calculated to envelop all these quadrilaterals.
ja: これらの四つのメソッドは、引数を :ref:`Quad` オブジェクトのリストに変換します。その後、アノテーション の矩形は、これらの四角形を包含するように計算されます。

en: :meth:`search_for` delivers a list of either :ref:`Rect` or :ref:`Quad` objects. Such a list can be directly used as an argument for these annotation types and will deliver **one common annotation** for all occurrences of the search string::
ja: :meth:`search_for` は :ref:`Rect` または:ref:`Quad` オブジェクトのリストを返します。このようなリストは、これらのアノテーションタイプの引数として直接使用でき、検索文字列のすべての出現に対して **共通のアノテーション** を提供します::

en: Obviously, text marker annotations need to know what is the top, the bottom, the left, and the right side of the area(s) to be marked. If the arguments are quads, this information is given by the sequence of the quad points. In contrast, a rectangle delivers much less information -- this is illustrated by the fact, that 4! = 24 different quads can be constructed with the four corners of a rectangle.
ja: 明らかに、テキストマーカーアノテーションは、マークされる領域の上部、下部、左部、右部が何であるかを知る必要があります。引数がquadsの場合、この情報は四角形のポイントのシーケンスによって提供されます。対照的に、矩形ははるかに少ない情報を提供します - これは、四角形の四つの角を使用して24の異なる四角形が構築できるという事実によって示されています。

en: Therefore, we **strongly recommend** to use the `quads` option for text searches, to ensure correct annotations. A similar consideration applies to marking **text spans** extracted with the "dict" / "rawdict" options of :meth:`Page.get_text`. For more details on how to compute quadrilaterals in this case, see section "How to Mark Non-horizontal Text" of :ref:`FAQ`.
ja: したがって、正しいアノテーションを確保するために、テキスト検索に `quads` オプションを使用することを **強くお勧めします**。同様の考慮事項は、:meth:`Page.get_text` の「dict」/「rawdict」オプションで抽出された **テキストスパン** をマークする場合にも適用されます。この場合の四角形の計算方法の詳細については、:ref:`FAQ` の「非水平テキストのマーキング方法」セクションを参照してください。

en: *(Changed in v1.14.20)* the location(s) -- rectangle(s) or quad(s) -- to be marked. A list or tuple must consist of :data:`rect_like` or :data:`quad_like` items (or even a mixture of either). Every item must be finite, convex and not empty (as applicable). *(Changed in v1.16.14)* **Set this parameter to** *None* if you want to use the following arguments. And vice versa: if not *None*, the remaining parameters must be *None*.
ja: *(v1.14.20で変更)* マーキングする位置、つまり矩形または四角形。リストまたはタプルは、:data:`rect_like` または :data:`quad_like` のアイテム（またはその混合）で構成されている必要があります。各アイテムは、適用可能な限り有限で凸面で空でなければなりません *（v1.16.14で変更）* 。このパラメータを *None* に設定すると、次の引数を使用できるようになります。逆もまたしかり：Noneでない場合、残りのパラメータは *None* でなければなりません。

en: *(New in v1.16.14)* start text marking at this point. Defaults to the top-left point of *clip*. Must be provided if `quads` is *None*.
ja: *(v1.16.14で新規)* このポイントでテキストマーキングを開始します。*clip* の左上のポイントがデフォルトです。`quads` が *None* の場合、提供する必要があります。

en: *(New in v1.16.14)* stop text marking at this point. Defaults to the bottom-right point of *clip*. Must be used if `quads` is *None*.
ja: *(v1.16.14で新規)* このポイントでテキストマーキングを停止します。*clip* の右下のポイントがデフォルトです。quadsが *None* の場合、使用する必要があります。

en: *(New in v1.16.14)* only consider text lines intersecting this area. Defaults to the page rectangle. Only use if `start` and `stop` are provided.
ja: *(v1.16.14で新規)* この領域と交差するテキスト行のみを考慮します。ページの矩形がデフォルトです。`start` および `stop` が提供されている場合にのみ使用してください。

en: :ref:`Annot` or *(changed in v1.16.14)* *None*
ja: :ref:`Annot` または *(v1.16.14で変更)* *None*

en: the created annotation. *(Changed in v1.16.14)* If *quads* is an empty list, **no annotation** is created.
ja: 作成された注釈。 *(v1.16.14で変更)* *quads* が空のリストの場合、**アノテーションは作成されません**。

en: Starting with v1.16.14 you can use parameters *start*, *stop* and *clip* to highlight consecutive lines between the points *start* and *stop*. Make use of *clip* to further reduce the selected line bboxes and thus deal with e.g. multi-column pages. The following multi-line highlight on a page with three text columns was created by specifying the two red points and setting clip accordingly.
ja: v1.16.14以降、開始、停止、および *clip* というパラメータを使用して、*start* と *stop* の間の連続した行をハイライトできます。*clip* を使用して、選択した行のbboxをさらに縮小し、たとえば多列のページを扱うことができます。次の多行のハイライトは、2つの赤いポイントを指定し、それに応じてクリップを設定することによって、3つのテキスト列を持つページに作成されました。

en: New in version 1.23.0
ja: 新機能バージョン1.23.0

en: Find tables on the page and return an object with related information. Typically, only very few of the many arguments ever need to be specified -- they mainly are tools to react to corner case situations.
ja: ページ上のテーブルを検出し、関連情報を持つオブジェクトを返します。通常、指定する必要がある引数は非常に少数であり、主に特殊な状況に対応するためのツールです。

en: specify a region to consider within the page rectangle. Default is the full page.
ja: ページの長方形内で考慮する領域を指定します。デフォルトはページ全体です。

en: floats containing the y-coordinates of rows. If provided, there will be no attempt to identify additional table rows.
ja: 行のy座標を含む浮動小数点数のリスト。指定した場合、追加のテーブル行を識別しないようにします。

en: floats containing the x-coordinates of columns. If provided, there will be no attempt to identify additional table columns.
ja: 列のx座標を含む浮動小数点数のリスト。指定した場合、追加のテーブル列を識別しないようにします。

en: request a search algorithm. The "lines" default looks for vector drawings. If "text" is specified, text positions are used to generate "virtual" column boundaries. Use `min_words_vertical` to request the number of words for considering their x-coordinate.
ja: 検索アルゴリズムを指定します。デフォルトでは「lines」はベクトル描画を探します。指定された場合、「text」ではテキストの位置を使用して「仮想」列境界を生成します。x座標を考慮するための単語数を指定するには、`min_words_vertical`を使用します。

en: request a search algorithm. The "lines" default looks for vector drawings. If "text" is specified, text positions are used to generate "virtual" row boundaries. The "text" choices are recommended when dealing with pages without any vector graphics -- like when this is an OCRed page.
ja: 検索アルゴリズムを指定します。デフォルトでは「lines」はベクトル描画を探します。指定された場合、「text」ではテキストの位置を使用して「仮想」行境界を生成します。「text」の選択肢は、ベクトルグラフィックが含まれていないページと取り扱う場合に推奨されます。

en: relevant for vertical strategy option "text": at least this many words must coincide to establish a virtual column boundary.
ja: 垂直戦略オプション「text」に関連します。少なくともこの数の単語が一致する必要があり、仮想の列境界を確立します。

en: relevant for horizontal strategy option "text": at least this many words must coincide to establish a virtual row boundary.
ja: 水平戦略オプション「text」に関連します。少なくともこの数の単語が一致する必要があり、仮想の行境界を確立します。

en: The remaining parameters are limits for merging different objects. For instance: Two horizontal lines with the same x-coordinates and a vertical distance less than 3 will be merged ("snapped") to one line.
ja: 残りのパラメーターは、異なるオブジェクトを統合するための制限です。例えば、x座標が同じで垂直距離が3未満の2つの水平線は1つの線に「スナップ」されます。

en: a `TableFinder` object that has the following significant attributes:
ja: `TableFinder` オブジェクトには、次の重要な属性があります：

en: **cells:** a list of **all bboxes** on the page, that have been identified as table cells (across all tables). Each cell is a tuple `(x0, y0, x1, y1)` of coordinates or `None`.
ja: **cells:** ページ上でテーブルのセルとして識別されたすべてのバウンディングボックスのリスト（すべてのテーブルを対象にします）。各セルは座標のタプル (x0, y0, x1, y1) または `None` です。

en: **tables:** a list of `Table` objects. This is `[]` if the page has no tables. Please note that while single tables can be found as items of this list, the `TableFinder` object itself is also a sequence of it tables. This means that if `tabs` is a `TableFinder` object, then table number "n" is delivered by `tabs.tables[n]` as well as by the shorter `tabs[n]`.
ja: **tables:** Table オブジェクトのリスト。ページにテーブルが含まれていない場合、これは `[]` になります。単一のテーブルはこのリストのアイテムとして見つけることができますが、`TableFinder` オブジェクト自体もそのテーブルのシーケンスです。つまり、`tabs` が `TableFinder` オブジェクトである場合、テーブル番号 "n" は `tabs.tables[n]` およびより短い `tabs[n]` によって提供されます。

en: The `Table` object has the following attributes:
ja: `Table` オブジェクトには次の属性があります：

en: **bbox:** the bounding box of the table as a tuple `(x0, y0, x1, y1)`.
ja: **bbox:** テーブルのバウンディングボックス（タプル）`(x0, y0, x1, y1)`。

en: **cells:** bounding boxes of the table's cells (list of tuples). A cell may also be `None`.
ja: **cells:** テーブルのセルのバウンディングボックス（タプル）のリスト。セルは `None` である場合もあります。

en: **extract():** this method returns the text content of each table cell as a list of list of strings.
ja: **extract():** このメソッドは、各テーブルセルのテキストコンテンツを文字列のリストのリストとして返します。

en: **to_pandas():** this method returns the table as a `pandas <https://pypi.org/project/pandas/>`_ `DataFrame <https://pandas.pydata.org/docs/reference/frame.html>`_.
ja: **to_pandas():** このメソッドは、テーブルを `pandas <https://pypi.org/project/pandas/>`_ `DataFrame <https://pandas.pydata.org/docs/reference/frame.html>`_ として返します。

en: **header:** a `TableHeader` object containing header information of the table.
ja: **header:** テーブルのヘッダー情報を含む `TableHeader` オブジェクト。

en: **col_count:** an integer containing the number of table columns.
ja: **col_count:** テーブルの列数を含む整数。

en: **row_count:** an integer containing the number of table rows.
ja: **row_count:**  テーブルの行数を含む整数。

en: **rows:** a list of `TableRow` objects containing two attributes: *bbox* is the boundary box of the row, and *cells* is a list of table cells contained in this row.
ja: **rows:** `TableRow` オブジェクトのリストで、*bbox* は行の境界ボックスで、*cells* はこの行に含まれるテーブルセルのリストです。

en: The `TableHeader` object has the following attributes:
ja: `TableHeader` オブジェクトには次の属性があります：

en: **bbox:** the bounding box of the header.
ja: **bbox:** ヘッダーのバウンディングボックス。

en: **cells:** a list of bounding boxes containing the name of the respective column.
ja: **cells:** 各列の名前を含むバウンディングボックスのリスト。

en: **names:** a list of strings containing the text of each of the cell bboxes. They represent the column names -- which can be used when exporting the table to pandas DataFrames or CSV, etc.
ja: **names:** 各セルのバウンディングボックス内のテキストを含む文字列のリスト。これらは列の名前を表します。これらはテーブルを pandas DataFrame または CSV などにエクスポートする際に使用できます。

en: **external:** a bool indicating whether the header bbox is outside the table body (`True`) or not. Table headers are never identified by the `TableFinder` logic. Therefore, if *external* is true, then the header cells are not part of any cell identified by `TableFinder`. If `external == False`, then the first table row is the header.
ja: **external:** ヘッダーのバウンディングボックスがテーブル本体の外部にあるかどうかを示すブール値（`True` の場合、外部）。テーブルのヘッダーは TableFinder のロジックによって識別されないため、*external* が True の場合、ヘッダーセルは `TableFinder` によって識別された任意のセルの一部ではありません。`external == False` の場合、最初のテーブル行がヘッダーです。

en: Please have a look at these `Jupyter notebooks <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/table-analysis>`_, which cover standard situations like multiple tables on one page or joining table fragments across multiple pages.
ja: これらの `Jupyter notebooks <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/table-analysis>`_ をご覧ください。これらのノートブックでは、1つのページに複数のテーブルがある場合や、複数のページにまたがるテーブル断片を結合するなど、標準的な状況がカバーされています。

en: PDF only: Add a "rubber stamp" like annotation to e.g. indicate the document's intended use ("DRAFT", "CONFIDENTIAL", etc.).
ja: PDF専用: "ドラフト"、"機密"などの文書の意図した使用を示すための「スタンプ」のような注釈を追加します。

en: rectangle where to place the annotation.
ja: アノテーションを配置する矩形領域。

en: id number of the stamp text. For available stamps see :ref:`StampIcons`.
ja: スタンプテキストのID番号。使用可能なスタンプについては :ref:`StampIcons` を参照してください。

en: The stamp's text and its border line will automatically be sized and be put horizontally and vertically centered in the given rectangle. :attr:`Annot.rect` is automatically calculated to fit the given **width** and will usually be smaller than this parameter.
ja: スタンプのテキストとその境界線は、自動的にサイズ変更され、指定された矩形内で水平および垂直方向に中央に配置されます。:attr:`Annot.rect` は指定された **幅** に合わせて自動的に計算され、通常はこのパラメータよりも小さくなります。

en: The font chosen is "Times Bold" and the text will be upper case.
ja: 選択されるフォントは「Times Bold」で、テキストは大文字になります。

en: The appearance can be changed using :meth:`Annot.set_opacity` and by setting the "stroke" color (no "fill" color supported).
ja: 外観は :meth:`Annot.set_opacity` を使用して変更でき、"stroke" 色を設定することができます（「fill」色はサポートされていません）。

en: This can be used to create watermark images: on a temporary PDF page create a stamp annotation with a low opacity value, make a pixmap from it with *alpha=True* (and potentially also rotate it), discard the temporary PDF page and use the pixmap with :meth:`insert_image` for your target PDF.
ja: これは透かし画像を作成するために使用できます。一時的なPDFページ上に低い不透明度のスタンプ注釈を作成し、*alpha=True* でそれからピクスマップを作成し（おそらく回転させることもあります）、一時的なPDFページを破棄し、ターゲットのPDFに挿入するためにピクスマップを :meth:`insert_image` で使用します。

en: PDF only: Add a PDF Form field ("widget") to a page. This also **turns the PDF into a Form PDF**. Because of the large amount of different options available for widgets, we have developed a new class :ref:`Widget`, which contains the possible PDF field attributes. It must be used for both, form field creation and updates.
ja: PDFのみ：ページにPDFフォームフィールド（ウィジェット）を追加します。これにより、PDFがフォームPDFに変換されます。ウィジェットにはさまざまなオプションがあるため、フォームフィールドの作成と更新の両方に使用する必要があるため、可能なPDFフィールド属性を含む新しいクラス :ref:`Widget` を開発しました。

en: a :ref:`Widget` object which must have been created upfront.
ja: 事前に作成されている必要がある :ref:`Widget` オブジェクト。

en: a widget annotation.
ja: ウィジェットアノテーション。

en: Changed in v1.16.6: The removal will now include any bound 'Popup' or response annotations and related objects.
ja: v1.16.6 で変更: 削除操作には、現在は関連する 'Popup' や応答アノテーションおよび関連するオブジェクトも含まれます。

en: PDF only: Delete annotation from the page and return the next one.
ja: PDFのみ：ページから注釈を削除し、次の注釈を返します。

en: the annotation to be deleted.
ja: 削除するアノテーション。

en: the annotation following the deleted one. Please remember that physical removal requires saving to a new file with garbage > 0.
ja: 削除された注釈の後に続く注釈。物理的な削除には、ガベージ> 0で新しいファイルに保存する必要があることを覚えておいてください。

en: New in v1.18.4
ja: v1.18.4で変更

en: PDF only: Delete field from the page and return the next one.
ja: PDFのみ：ページからフィールドを削除し、次のフィールドを返します。

en: the widget to be deleted.
ja: 削除するウィジェット。

en: the widget following the deleted one. Please remember that physical removal requires saving to a new file with garbage > 0.
ja: 削除されたウィジェットの後に続くウィジェット。物理的な削除には、ガベージ> 0で新しいファイルに保存する必要があることを覚えておいてください。

en: Changed in v1.16.12: The previous *mark* parameter is gone. Instead, the respective rectangles are filled with the individual *fill* color of each redaction annotation. If a *text* was given in the annotation, then :meth:`insert_textbox` is invoked to insert it, using parameters provided with the redaction.
ja: v1.16.12で変更：以前の *mark* パラメータは削除されました。代わりに、各赤字注釈の個々の塗りつぶし色で各赤字領域が塗りつぶされます。アノテーションで *text* が指定された場合、そのテキストを挿入するために、redactionで提供されたパラメータを使用して :meth:`insert_textbox` が呼び出されます。

en: Changed in v1.18.0: added option for handling images that overlap redaction areas.
ja: v1.18.0で変更：赤字領域と重なる画像を処理するためのオプションが追加されました。

en: PDF only: Remove all **text content** contained in any redaction rectangle.
ja: PDFのみ：赤塗りの矩形に含まれるすべての **テキストコンテンツ** を削除します。

en: **This method applies and then deletes all redactions from the page.**
ja: **このメソッドは、ページからすべての赤塗りを適用して削除します。**

en: How to redact overlapping images. The default (2) blanks out overlapping pixels. *PDF_REDACT_IMAGE_NONE* (0) ignores, and *PDF_REDACT_IMAGE_REMOVE* (1) completely removes all overlapping images.
ja: 重なる画像の赤字領域の処理方法。デフォルト（2）では重なるピクセルを消去します

en: *True* if at least one redaction annotation has been processed, *False* otherwise.
ja: 少なくとも1つの赤字注釈が処理された場合は *True*、それ以外の場合は *False*。

en: Text contained in a redaction rectangle will be **physically** removed from the page (assuming :meth:`Document.save` with a suitable garbage option) and will no longer appear in e.g. text extractions or anywhere else. All redaction annotations will also be removed. Other annotations are unaffected.
ja: 赤塗りの四角に含まれるテキストは、**物理的に** ページから削除されます（適切なゴミオプションを使用したDocument.save()の場合）、テキスト抽出などの場所にはもはや表示されません。また、すべての赤塗りの注釈も削除されます。他の注釈には影響しません。

en: All overlapping links will be removed. If the rectangle of the link was covering text, then only the overlapping part of the text is being removed. Similar applies to images covered by link rectangles.
ja: 重なっているすべてのリンクは削除されます。リンクの四角がテキストを覆っている場合、テキストの重なる部分のみが削除されます。画像もリンクの四角によってカバーされている場合、同様のことが適用されます。

en: *(Changed in v1.18.0)* The overlapping parts of **images** will be blanked-out for default option `PDF_REDACT_IMAGE_PIXELS`. Option 0 does not touch any images and 1 will remove any image with an overlap. Please be aware that there is a bug for option *PDF_REDACT_IMAGE_PIXELS = 2*: transparent images will be incorrectly handled!
ja: *（v1.18.0で変更）* デフォルトオプション `PDF_REDACT_IMAGE_PIXELS` の場合、**画像** の重なる部分はブランクにされます。オプション0は画像には影響せず、オプション1は重なる画像を完全に削除します。ただし、オプション *PDF_REDACT_IMAGE_PIXELS = 2* にはバグがあることに注意してください：透明な画像が誤って処理されます！

en: For option `images=PDF_REDACT_IMAGE_REMOVE` only this page's **references to the images** are removed - not necessarily the images themselves. Images are completely removed from the file only, if no longer referenced at all (assuming suitable garbage collection options).
ja: `images=PDF_REDACT_IMAGE_REMOVE` のオプションの場合、このページの **画像への参照** のみが削除されます。適切なゴミ収集オプションがあると、画像はファイルから完全に削除されます。

en: For option `images=PDF_REDACT_IMAGE_PIXELS` a new image of format PNG is created, which the page will use in place of the original one. The original image is not deleted or replaced as part of this process, so other pages may still show the original. In addition, the new, modified PNG image currently is **stored uncompressed**. Do keep these aspects in mind when choosing the right garbage collection method and compression options during save.
ja: `images=PDF_REDACT_IMAGE_PIXELS` のオプションでは、新しいPNG形式の画像が作成され、ページは元の画像の代わりにそれを使用します。このプロセスの一環として、元の画像は削除されず、他のページでは引き続き元の画像が表示される可能性があります。さらに、新しい変更されたPNG画像は現在 **圧縮されていない状態で保存されています** 。保存時に適切なゴミ収集メソッドと圧縮オプションを選択する際に、これらの側面を考慮してください。

en: **Text removal** is done by character: A character is removed if its bbox has a **non-empty overlap** with a redaction rectangle *(changed in MuPDF v1.17)*. Depending on the font properties and / or the chosen line height, deletion may occur for undesired text parts. Using :meth:`Tools.set_small_glyph_heights` with a *True* argument before text search may help to prevent this.
ja: **テキストの削除** は文字ごとに行われます：文字のbboxが赤塗りの四角と非空の重なりを持つ場合、文字が削除されます（MuPDF v1.17で変更）。フォントの特性や選択した行の高さに応じて、望ましくないテキスト部分が削除される場合があります。テキスト検索前に :meth:`Tools.set_small_glyph_heights` を *True* 引数で使用して、これを防ぐのに役立つ場合があります。

en: Redactions are a simple way to replace single words in a PDF, or to just physically remove them. Locate the word "secret" using some text extraction or search method and insert a redaction using "xxxxxx" as replacement text for each occurrence.
ja: 赤塗りは、PDF内の単語を置き換えるための簡単な方法であり、単語を物理的に削除するためのものです。テキスト抽出または検索方法を使用して単語「秘密」を見つけ、それぞれの出現ごとに代替テキスト「xxxxxx」を使用して赤塗りを挿入します。

en: Be wary if the replacement is longer than the original -- this may lead to an awkward appearance, line breaks or no new text at all.
ja: 注意が必要です。代替テキストが元のテキストよりも長い場合、見栄えが悪くなったり、改行が発生したり、新しいテキストがまったく表示されなくなる可能性があるためです。

en: For a number of reasons, the new text may not exactly be positioned on the same line like the old one -- especially true if the replacement font was not one of CJK or :ref:`Base-14-Fonts`.
ja: いくつかの理由から、新しいテキストは古いテキストとまったく同じ行に配置されないことがあります。特に、代替フォントがCJKまたはPDF :ref:`Base-14-Fonts` の場合には特に当てはまります。

en: PDF only: Delete the specified link from the page. The parameter must be an **original item** of :meth:`get_links()` (see below). The reason for this is the dictionary's *"xref"* key, which identifies the PDF object to be deleted.
ja: PDFのみ：ページから指定したリンクを削除します。パラメータは :meth:`get_links()` の元のアイテムである必要があります（以下参照）。これは辞書の *「xref」* キーがPDFオブジェクトを識別するための理由です。

en: the link to be deleted.
ja: 削除するリンクです。

en: PDF only: Insert a new link on this page. The parameter must be a dictionary of format as provided by :meth:`get_links()` (see below).
ja: PDFのみ：このページに新しいリンクを挿入します。パラメータは :meth:`get_links()` で提供される形式の辞書である必要があります（以下参照）。

en: the link to be inserted.
ja: 挿入するリンクです。

en: PDF only: Modify the specified link. The parameter must be a (modified) **original item** of :meth:`get_links()` (see below). The reason for this is the dictionary's *"xref"* key, which identifies the PDF object to be changed.
ja: PDFのみ：指定されたリンクを変更します。パラメータは :meth:`get_links()` （以下参照）の **元のアイテム** である必要があります（変更された場合）。これは辞書の *「xref」* キーがPDFオブジェクトを識別するための理由です。

en: the link to be modified.
ja: 変更するリンクです。

en: If updating / inserting a URI link (`"kind": LINK_URI`), please make sure to start the value for the `"uri"` key with a disambiguating string like `"http://"`, `"https://"`, `"file://"`, `"ftp://"`, `"mailto:"`, etc. Otherwise -- depending on your browser or other "consumer" software -- unexpected default assumptions may lead to unwanted behaviours.
ja: URIリンク（`"kind": LINK_URI`）を更新/挿入する場合は、"uri"キーの値を必ず `「http://」`、`「https://」`、`「file://」` 、`「ftp://」`、「mailto：」などの区別可能な文字列で始めるようにしてください。そうしないと、ブラウザや他の「コンシューマ」ソフトウェアによって、予期しないデフォルトの仮定が不要な動作につながる可能性があります。

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

en: PDF only: Return the label for the page.
ja: PDFのみ：ページのラベルを返します。

en: the label string like "vii" for Roman numbering or "" if not defined.
ja: ローマ数字の「vii」などのラベル文字列、または定義されていない場合は ""。

en: Retrieves **all** links of a page.
ja: ページの **すべて** のリンクを取得します。

en: A list of dictionaries. For a description of the dictionary entries see below. Always use this or the :meth:`Page.links` method if you intend to make changes to the links of a page.
ja: 辞書のリスト。辞書エントリの説明については以下を参照してください。ページのリンクを変更する意図がある場合は、:meth:`Page.links` メソッドまたはこれを常に使用してください。

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

en: Return a generator over the page's links. The results equal the entries of :meth:`Page.get_links`.
ja: ページのリンクをイテレーターとして返します。結果は:meth:`Page.get_links` のエントリと同じです。

en: a sequence of integers to down-select to one or more link kinds. Default is all links. Example: *kinds=(fitz.LINK_GOTO,)* will only return internal links.
ja: 1つ以上のリンク種別をダウン選択するための整数のシーケンス。デフォルトはすべてのリンクです。例：*kinds=(fitz.LINK_GOTO,)* は内部リンクのみを返します。

en: an entry of :meth:`Page.get_links()` for each iteration.
ja: 各イテレーションごとの :meth:`Page.get_links()` のエントリ。

en: Return a generator over the page's annotations.
ja: ページの注釈をイテレーターとして返します。

en: a sequence of integers to down-select to one or more annotation types. Default is all annotations. Example: `types=(fitz.PDF_ANNOT_FREETEXT, fitz.PDF_ANNOT_TEXT)` will only return 'FreeText' and 'Text' annotations.
ja: 1つ以上の注釈タイプをダウン選択するための整数のシーケンス。デフォルトはすべての注釈です。例：`types=(fitz.PDF_ANNOT_FREETEXT, fitz.PDF_ANNOT_TEXT)` は「FreeText」および「Text」注釈のみを返します。

en: an :ref:`Annot` for each iteration.
ja: 各イテレーションごとの :ref:`Annot`。

en: You **cannot safely update annotations** from within this generator. This is because most annotation updates require reloading the page via `page = doc.reload_page(page)`. To circumvent this restriction, make a list of annotations xref numbers first and then iterate over these numbers::
ja: このジェネレータ内から **アノテーションを安全に更新することはできません**。これは、ほとんどの注釈の更新にはpage = doc.reload_page(page)を介してページを再読み込みする必要があるためです。この制限を回避するために、まず注釈のxref番号のリストを作成し、その後これらの番号を繰り返し処理します::

en: Return a generator over the page's form fields.
ja: フォームフィールドのジェネレーターを返します。

en: a sequence of integers to down-select to one or more widget types. Default is all form fields. Example: `types=(fitz.PDF_WIDGET_TYPE_TEXT,)` will only return 'Text' fields.
ja: 1つ以上のウィジェットタイプに選択を絞り込むための整数のシーケンス。デフォルトではすべてのフォームフィールドが対象です。例: `types=(fitz.PDF_WIDGET_TYPE_TEXT,)` を指定すると 'Text' フィールドのみが返されます。

en: a :ref:`Widget` for each iteration.
ja: 各イテレーションでの :ref:`Widget`

en: New in v1.16.18
ja: v1.16.18 で追加された新機能です。

en: PDF only: Write the text of one or more :ref:`Textwriter` objects to the page.
ja: PDF のみ: 1つ以上の :ref:`Textwriter`  オブジェクトのテキストをページに書き込みます。

en: where to place the text. If omitted, the rectangle union of the text writers is used.
ja: テキストを配置する場所。省略した場合、テキストライターの矩形の合併が使用されます。

en: a non-empty tuple / list of :ref:`TextWriter` objects or a single :ref:`TextWriter`.
ja: 1つ以上の :ref:`TextWriter` オブジェクトのタプル/リスト、または単一の :ref:`TextWriter` です。

en: set transparency, overwrites resp. value in the text writers.
ja: 透明度を設定し、テキストライターの値を上書きします。

en: set the text color, overwrites  resp. value in the text writers.
ja: テキストの色を設定し、テキストライターの値を上書きします。

en: put the text in foreground or background.
ja: テキストを前景または背景に配置するかどうか。

en: maintain the aspect ratio.
ja: アスペクト比を保持するかどうか。

en: rotate the text by an arbitrary angle.
ja: テキストを任意の角度で回転します。

en: *(new in v1.18.4)* the :data:`xref` of an :data:`OCG` or :data:`OCMD`.
ja: *(v1.18.4 で新たに追加)* :data:`OCG` または :data:`OCMD` の :data:`xref`。

en: Parameters *overlay, keep_proportion, rotate* and *oc* have the same meaning as in :meth:`Page.show_pdf_page`.
ja: *overlay、keep_proportion、rotate、oc* パラメーターは :meth:`Page.show_pdf_page` と同じ意味を持ちます。

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

en: PDF only: Insert text starting at :data:`point_like` *point*. See :meth:`Shape.insert_text`.
ja: PDFのみ: :data:`point_like` *point* からテキストを挿入します。:meth:`Shape.insert_text` を参照してください。

en: PDF only: Insert text into the specified :data:`rect_like` *rect*. See :meth:`Shape.insert_textbox`.
ja: PDF のみ：指定された :data:`rect_like` の *rect* にテキストを挿入します。:meth:`Shape.insert_textbox` を参照してください。

en: PDF only: Draw a line from *p1* to *p2* (:data:`point_like` \s). See :meth:`Shape.draw_line`.
ja: PDF のみ：*p1* から *p2* までの直線を描画します（:data:`point_like` \s）。:meth:`Shape.draw_line` を参照してください。

en: PDF only: Draw a zigzag line from *p1* to *p2* (:data:`point_like` \s). See :meth:`Shape.draw_zigzag`.
ja: PDF のみ：p1 から p2 までのジグザグ線を描画します（:data:`point_like` \s）。:meth:`Shape.draw_zigzag` を参照してください。

en: PDF only: Draw a squiggly (wavy, undulated) line from *p1* to *p2* (:data:`point_like` \s). See :meth:`Shape.draw_squiggle`.
ja: PDF のみ：*p1* から *p2* までの波線（うねり）を描画します（:data:`point_like` \s）。:meth:`Shape.draw_squiggle` を参照してください。

en: PDF only: Draw a circle around *center* (:data:`point_like`) with a radius of *radius*. See :meth:`Shape.draw_circle`.
ja: PDF のみ：*center* を中心に、半径 *radius* の円を描画します:data:`point_like`。:meth:`Shape.draw_circle` を参照してください。

en: PDF only: Draw an oval (ellipse) within the given :data:`rect_like` or :data:`quad_like`. See :meth:`Shape.draw_oval`.
ja: PDF のみ：指定された :data:`rect_like` または :data:`quad_like` 内に楕円を描画します。:meth:`Shape.draw_oval` を参照してください。

en: PDF only: Draw a circular sector, optionally connecting the arc to the circle's center (like a piece of pie). See :meth:`Shape.draw_sector`.
ja: PDFのみ: 円形セクターを描画し、オプションで円の中心とアークを接続します（パイの一部のように）。:meth:`Shape.draw_sector` を参照してください。

en: PDF only: Draw several connected lines defined by a sequence of :data:`point_like` \s. See :meth:`Shape.draw_polyline`.
ja: PDFのみ: 一連の :data:`point_like` \s ポイントによって定義された接続された複数のラインを描画します。:meth:`Shape.draw_polyline` を参照してください。

en: PDF only: Draw a cubic Bézier curve from *p1* to *p4* with the control points *p2* and *p3* (all are :data:`point_like` \s). See :meth:`Shape.draw_bezier`.
ja: PDFのみ: 制御ポイント *p2* および *p3* を使用して、*p1* から *p4* へのキュービックベジエ曲線を描画します（すべてのポイントは :data:`point_like` です）。:meth:`Shape.draw_bezier` を参照してください。

en: PDF only: This is a special case of *draw_bezier()*. See :meth:`Shape.draw_curve`.
ja: PDFのみ: これは *draw_bezier()* の特別なケースです。:meth:`Shape.draw_curve` を参照してください。

en: Changed in v1.22.0: Added parameter *radius*.
ja: v1.22.0で変更：パラメーター *radius* を追加しました。

en: PDF only: Draw a rectangle. See :meth:`Shape.draw_rect`.
ja: PDFのみ: 四角形を描画します。:meth:`Shape.draw_rect` を参照してください。

en: PDF only: Draw a quadrilateral. See :meth:`Shape.draw_quad`.
ja: PDFのみ: 四辺形を描画します。:meth:`Shape.draw_quad` を参照してください。

en: PDF only: Add a new font to be used by text output methods and return its :data:`xref`. If not already present in the file, the font definition will be added. Supported are the built-in :data:`Base14_Fonts` and the CJK fonts via **"reserved"** fontnames. Fonts can also be provided as a file path or a memory area containing the image of a font file.
ja: PDFのみ: テキスト出力メソッドで使用する新しいフォントを追加し、その :data:`xref` を返します。ファイルにまだ存在しない場合、フォントの定義が追加されます。組み込みの :data:`Base14_Fonts` および CJK フォントがサポートされており、**「予約済み」** フォント名を介して使用できます。フォントはファイルパスまたはフォントファイルのイメージを含むメモリ領域として提供することもできます。

en: The name by which this font shall be referenced when outputting text on this page. In general, you have a "free" choice here (but consult the :ref:`AdobeManual`, page 16, section 7.3.5 for a formal description of building legal PDF names). However, if it matches one of the :data:`Base14_Fonts` or one of the CJK fonts, *fontfile* and *fontbuffer* **are ignored**.
ja: このフォントをこのページ上でテキスト出力する際に参照される名前。一般的に、ここで「自由な」選択ができます（ただし、:ref:`AdobeManual`、ページ16、セクション7.3.5を参照して正当なPDF名の形式的な説明を確認してください）。ただし、:data:`Base14_Fonts` またはCJKフォントのいずれかと一致する場合、*fontfile* および *fontbuffer* は **無視されます。**

en: In other words, you cannot insert a font via *fontfile* / *fontbuffer* and also give it a reserved *fontname*.
ja: 言い換えれば、フォントを *fontfile* / *fontbuffer* 経由で挿入し、予約されたフォント名も指定することはできません。

en: A reserved fontname can be specified in any mixture of upper or lower case and still match the right built-in font definition: fontnames "helv", "Helv", "HELV", "Helvetica", etc. all lead to the same font definition "Helvetica". But from a :ref:`Page` perspective, these are **different references**. You can exploit this fact when using different *encoding* variants (Latin, Greek, Cyrillic) of the same font on a page.
ja: 予約されたフォント名は、大文字と小文字の組み合わせで指定でき、それでも適切な組み込みフォントの定義に一致します。フォント名「helv」、「Helv」、「HELV」、「Helvetica」などはすべて同じフォント定義「Helvetica」につながります。ただし、ページの観点からはこれらは **異なる参照** です。同じフォントの異なる *エンコーディング* バリアント（ラテン、ギリシャ、キリル文字など）をページ上で使用する場合、この事実を利用できます。

en: a path to a font file. If used, *fontname* must be **different from all reserved names**.
ja: フォントファイルへのパス。使用する場合、*fontname* は **すべての予約済みの名前と異なる必要があります**。

en: the memory image of a font file. If used, *fontname* must be **different from all reserved names**. This parameter would typically be used with :attr:`Font.buffer` for fonts supported / available via :ref:`Font`.
ja: フォントファイルのメモリイメージ。使用する場合、*fontname* は **すべての予約済みの名前と異なる** 必要があります。通常、このパラメーターは :attr:`Font.buffer` を介してサポート/利用可能な :ref:`Font` に使用されます。

en: applicable for *fontfile* / *fontbuffer* cases only: enforce treatment as a "simple" font, i.e. one that only uses character codes up to 255.
ja: *fontfile* / *fontbuffer* ケースにのみ適用可能：「シンプル」フォントとしての扱いを強制します。つまり、文字コードが255までしか使用しないフォントです。

en: applicable for the "Helvetica", "Courier" and "Times" sets of :data:`Base14_Fonts` only. Select one of the available encodings Latin (0), Cyrillic (2) or Greek (1). Only use the default (0 = Latin) for "Symbol" and "ZapfDingBats".
ja: :data:`Base14_Fonts` の「Helvetica」、「Courier」、「Times」セットにのみ適用可能。利用可能なエンコーディングのうち、ラテン（0）、キリル文字（2）、ギリシャ文字（1）のいずれかを選択します。「Symbol」と「ZapfDingBats」についてはデフォルト（0 = ラテン）のみを使用してください。

en: the :data:`xref` of the installed font.
ja: インストールされたフォントの :data:`xref`。

en: Built-in fonts will not lead to the inclusion of a font file. So the resulting PDF file will remain small. However, your PDF viewer software is responsible for generating an appropriate appearance -- and there **exist** differences on whether or how each one of them does this. This is especially true for the CJK fonts. But also Symbol and ZapfDingbats are incorrectly handled in some cases. Following are the **Font Names** and their correspondingly installed **Base Font** names:
ja: 組み込みフォントはフォントファイルの追加を必要とせず、結果として生成されるPDFファイルは小さく保たれます。ただし、PDFビューアソフトウェアは適切な外観を生成する責任があり、それぞれがこれをどのように行うかには違い **があります**。これは特にCJKフォントに関して当てはまります。しかし、シンボルとZapfDingbatsも一部のケースで正しく扱われていないことがあります。以下は **Font Names** とそれに対応するインストールされた **Base Font** 名です：

en: **Base-14 Fonts** [#f1]_
ja: **ベース14フォント** [1]

en: **Font Name**
ja: **フォント名**

en: **Installed Base Font**
ja: **インストールされたベースフォント**

en: **Comments**
ja: **コメント**

en: normal
ja: 通常

en: italic
ja: 斜体

en: bold
ja: 太字

en: bold-italic
ja: 太字斜体

en: **CJK Fonts** [#f2]_ (China, Japan, Korea)
ja: **CJKフォント** [2] (中国、日本、韓国)

en: simplified Chinese
ja: 簡体字中国語

en: simplified Chinese (serif)
ja: 簡体字中国語（セリフ）

en: traditional Chinese
ja: 繁体字中国語

en: traditional Chinese (serif)
ja: 繁体字中国語（セリフ）

en: PDF only: Put an image inside the given rectangle. The image may already exist in the PDF or be taken from a pixmap, a file, or a memory area.
ja: PDFのみ：指定された矩形内に画像を配置します。画像はすでにPDF内に存在するか、ピクスマップ、ファイル、またはメモリ領域から取得できます。

en: Changed in v1.14.1: By default, the image keeps its aspect ratio.
ja: v1.14.1で変更：デフォルトでは、画像はアスペクト比を保持します

en: Changed in v1.14.13: The image is now always placed **centered** in the rectangle, i.e. the centers of image and rectangle are equal.
ja: v1.14.13で変更：画像は矩形の **中央に** 常に配置されます。つまり、画像と矩形の中心が等しいです。

en: Changed in v1.17.6: Insertion rectangle no longer needs to have a non-empty intersection with the page's :attr:`Page.cropbox` [#f5]_.
ja: v1.17.6で変更：挿入矩形はもはやページの :attr:`Page.cropbox` [#f5]_ と非空の交差を持つ必要はありません。

en: Changed in v1.18.13: Allow providing the image as the xref of an existing one.
ja: v1.18.13で変更：既存の画像のxrefとして画像を提供できるようになりました。

en: where to put the image. Must be finite and not empty.
ja: 画像を配置する場所。有限で空でない必要があります。

en: name of an image file (all formats supported by MuPDF -- see :ref:`ImageFiles`).
ja: 画像ファイルの名前（MuPDFでサポートされているすべての形式 – :ref:`ImageFiles` を参照）。

en: image in memory (all formats supported by MuPDF -- see :ref:`ImageFiles`).
ja: メモリ内の画像（MuPDFでサポートされているすべての形式 – :ref:`ImageFiles` を参照）。

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

en: a pixmap containing the image.
ja: 画像を含むピクスマップ。

en: *(new in version v1.18.1)* image in memory -- to be used as image mask (alpha values) for the base image. When specified, the base image must be provided as a filename or a stream -- and must not be an image that already has a mask.
ja: *(v1.18.1で新機能)* ベース画像の画像マスク（アルファ値）として使用するためのメモリ内の画像。指定する場合、ベース画像はファイル名またはストリームとして提供され、すでにマスクを持っている画像ではない必要があります。

en: *(New in v1.18.13)* the :data:`xref` of an image already present in the PDF. If given, parameters `filename`, `pixmap`, `stream`, `alpha` and `mask` are ignored. The page will simply receive a reference to the existing image.
ja: (v1.18.13で新機能)* PDFに既に存在する画像のxref。指定された場合、`filename`、`pixmap`、`stream`、`alpha`、および `mask` のパラメータは無視されます。ページは単に既存の画像への参照を受け取ります。

en: *(Changed in v1.19.3)* deprecated. No longer needed -- ignored when given.
ja: *(v1.19.3で変更)* 非推奨。指定された場合、無視されます。

en: *(new in version v1.14.11)* rotate the image. Must be an integer multiple of 90 degrees. Positive values rotate anti-clockwise. If you need a rotation by an arbitrary angle, consider converting the image to a PDF (:meth:`Document.convert_to_pdf`) first and then use :meth:`Page.show_pdf_page` instead.
ja: (v1.14.11で新機能)* 画像を回転させます。90度の整数倍である必要があります。正の値は反時計回りに回転します。任意の角度での回転が必要な場合は、まず画像をPDFに変換（:meth:`Document.convert_to_pdf`）し、:meth:`Page.show_pdf_page` を使用することを検討してください。

en: *(new in v1.18.3)* (:data:`xref`) make image visibility dependent on this :data:`OCG` or :data:`OCMD`. Ignored after the first of multiple insertions. The property is stored with the generated PDF image object and therefore controls the image's visibility throughout the PDF.
ja: (v1.18.3で新機能)*（:data:`xref`）画像の表示をこの :data:`OCG`または :data:`OCMD` に依存させます。複数の挿入の最初の後は無視されます。このプロパティは生成されたPDF画像オブジェクトに保存されるため、PDF全体で画像の表示を制御します。

en: *(new in version v1.14.11)* maintain the aspect ratio of the image.
ja: (v1.14.11で新機能)* 画像のアスペクト比を保持します。

en: For a description of *overlay* see :ref:`CommonParms`.
ja: *overlay* の説明については :ref:`CommonParms` を参照してください。

en: *Changed in v1.18.13:* Return xref of stored image.
ja: *v1.18.13で変更：* 格納された画像のxrefを返します。

en: The xref of the embedded image. This can be used as the `xref` argument for very significant performance boosts, if the image is inserted again.
ja: 埋め込まれた画像の `xref` です。この値は、画像を再度挿入する場合のxref引数として使用でき、非常に大幅なパフォーマンス向上に役立ちます。

en: This example puts the same image on every page of a document::
ja: この例では、ドキュメントのすべてのページに同じ画像を配置します：

en: The method detects multiple insertions of the same image (like in above example) and will store its data only on the first execution. This is even true (although less performant), if using the default `xref=0`.
ja: このメソッドは、同じ画像が複数回挿入される場合（上記の例のように）を検出し、データは最初の実行時にのみ保存されます。これは、デフォルトの `xref=0` を使用している場合でも（性能は劣るが）同様です

en: The method cannot detect if the same image had already been part of the file before opening it.
ja: このメソッドは、ファイルを開く前に同じ画像がすでにファイルの一部であるかどうかを検出できません。

en: You can use this method to provide a background or foreground image for the page, like a copyright or a watermark. Please remember, that watermarks require a transparent image if put in foreground ...
ja: このメソッドを使用して、ページの背景または前景画像（著作権表示や透かしのようなもの）を提供できます。ただし、前景に透明な画像が必要な場合は、そのことを覚えておいてください...

en: The image may be inserted uncompressed, e.g. if a *Pixmap* is used or if the image has an alpha channel. Therefore, consider using *deflate=True* when saving the file. In addition, there exist effective ways to control the image size -- even if transparency comes into play. Have a look at `this <https://pymupdf.readthedocs.io/en/latest/faq.html#how-to-add-images-to-a-pdf-page>`_ section of the documentation.
ja: 画像は非圧縮で挿入されることがあります。たとえば、*Pixmap* を使用するか、画像にアルファチャンネルがある場合です。したがって、ファイルを保存する際には *deflate=True* を使用することを検討してください。また、透明性が関与する場合でも、画像サイズを効果的に制御する方法が存在します。ドキュメンテーションの `この <https://pymupdf.readthedocs.io/en/latest/faq.html#how-to-add-images-to-a-pdf-page>`_ セクションをご覧ください。

en: The image is stored in the PDF in its original quality. This may be much better than what you ever need for your display. Consider **decreasing the image size** before insertion -- e.g. by using the pixmap option and then shrinking it or scaling it down (see :ref:`Pixmap` chapter). The PIL method *Image.thumbnail()* can also be used for that purpose. The file size savings can be very significant.
ja: 画像はPDF内でその元の品質で保存されます。これは、ディスプレイに必要なものよりもはるかに優れている場合があります。挿入前に **画像サイズを減少させる** ことを検討してください。たとえば、Pixmapオプションを使用してから縮小または縮小することができます（:ref:`Pixmap` の章を参照）。PILメソッドの *Image.thumbnail()* もそのために使用できます。ファイルサイズの節約は非常に大きい場合があります。

en: Another efficient way to display the same image on multiple pages is another method: :meth:`show_pdf_page`. Consult :meth:`Document.convert_to_pdf` for how to obtain intermediary PDFs usable for that method. Demo script `fitz-logo.py <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/demo/fitz-logo.py>`_ implements a fairly complete approach.
ja: 同じ画像を複数のページで効率的に表示する別の方法は、別のメソッドです：:meth:`show_pdf_page`。そのメソッドで使用可能な中間のPDFを取得する方法については、:meth:`Document.convert_to_pdf` を参照してください。デモスクリプト `fitz-logo.py <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/demo/fitz-logo.py>`_ は、かなり完全なアプローチを実装しています。"

en: New in v1.21.0
ja: v1.21.0で新たに追加

en: Replace the image at xref with another one.
ja: xrefで指定された画像を別の画像で置き換えます。

en: the :data:`xref` of the image.
ja: 画像の :data:`xref`。

en: the filename of the new image.
ja: 新しい画像のファイル名。

en: the :ref:`Pixmap` of the new image.
ja: 新しい画像の :ref:`Pixmap`。

en: the memory area containing the new image.
ja: 新しい画像を含むメモリ領域。

en: Arguments `filename`, `pixmap`, `stream` have the same meaning as in :meth:`Page.insert_image`, especially exactly one of these must be provided.
ja: `filename`、`pixmap`、`stream` の引数は、特に :meth:`Page.insert_image` での意味と同じです。特に、これらのうちの1つだけを指定する必要があります。

en: This is a **global replacement:** the new image will also be shown wherever the old one has been displayed throughout the file.
ja: これは **グローバルな置換** です：新しい画像は、古い画像がファイル全体で表示されていた場所でも表示されます。

en: This method mainly exists for technical purposes. Typical uses include replacing large images by smaller versions, like a lower resolution, graylevel instead of colored, etc., or changing transparency.
ja: このメソッドは主に技術的な目的で存在しています。典型的な使用例には、大きな画像を解像度の低いバージョン、カラーではなくグレースケールなど、より小さなバージョンで置き換えることが含まれます。または透明度を変更することもあります。

en: Delete the image at xref. This is slightly misleading: actually the image is being replaced with a small transparent :ref:`Pixmap` using above :meth:`Page.replace_image`. The visible effect however is equivalent.
ja: 画像のxrefを削除します。これはわずかに誤解を招くかもしれませんが、実際には、画像は上記の :meth:`Page.replace_image` を使用して小さな透明な :ref:`Pixmap` で置き換えられます。しかし、視覚的な効果は同等です。

en: This is a **global replacement:** the image will disappear wherever the old one has been displayed throughout the file.
ja: これは **グローバルな置換です：** 新しい画像は、古い画像がファイル全体で表示されていた場所でも表示されなくなります。

en: If you inspect / extract a page's images by methods like :meth:`Page.get_images`, :meth:`Page.get_image_info` or :meth:`Page.get_text`, the replacing "dummy" image will be detected like so `(45, 47, 1, 1, 8, 'DeviceGray', '', 'Im1', 'FlateDecode')` and also seem to "cover" the same boundary box on the page.
ja: :meth:`Page.get_images`、:meth:`Page.get_image_info`、または :meth:`Page.get_text` などのメソッドを使用してページの画像を調査/抽出する場合、置き換えられた「ダミー」画像は次のように検出されます`(45, 47, 1, 1, 8, 'DeviceGray', '', 'Im1', 'FlateDecode')` 、また同じ境界ボックスをページ上に「覆う」ように見えます。

en: Changed in v1.19.0: added `textpage` parameter
ja: v1.19.0で変更：`textpage` パラメータを追加

en: Changed in v1.19.1: added `sort` parameter
ja: v1.19.1で変更：`sort` パラメータを追加

en: Changed in v1.19.6: added new constants for defining default flags per method.
ja: v1.19.6で変更：各メソッドごとのデフォルトフラグを定義するための新しい定数を追加

en: Retrieves the content of a page in a variety of formats. This is a wrapper for :ref:`TextPage` methods by choosing the output option as follows:
ja: さまざまなフォーマットでページのコンテンツを取得します。これは、出力オプションを以下のように選択することで、:ref:`TextPage` メソッドのラッパーです：

en: "text" -- :meth:`TextPage.extractTEXT`, default
ja: “text” – :meth:`TextPage.extractTEXT`、デフォルト

en: A string indicating the requested format, one of the above. A mixture of upper and lower case is supported.
ja: 要求される形式を示す文字列、上記のいずれか。大文字と小文字の組み合わせがサポートされています

en: Changed in v1.16.3 Values "words" and "blocks" are now also accepted.
ja: v1.16.3で変更された値 “words” と “blocks” も受け入れられるようになりました。

en: *(new in v1.17.7)* restrict extracted text to this rectangle. If None, the full page is taken. Has **no effect** for options "html", "xhtml" and "xml".
ja: *(v1.17.7で新たに追加)* 抽出されたテキストをこの矩形に制限します。Noneの場合、フルページが取得されます。 “html”、“xhtml”、“xml”のオプションには **影響しません**。

en: *(new in v1.16.2)* indicator bits to control whether to include images or how text should be handled with respect to white spaces and :data:`ligatures`. See :ref:`TextPreserve` for available indicators and :ref:`text_extraction_flags` for default settings.
ja: *(v1.16.2で新たに追加)* 画像を含めるか、テキストを空白文字と :data:`ligatures` にどのように処理するかを制御するための指示ビット。使用可能な指示子については:ref:`TextPreserve` を、デフォルト設定についてはText :ref:`text_extraction_flags` を参照してください。

en: (new in v1.19.0) use a previously created :ref:`TextPage`. This reduces execution time **very significantly:** by more than 50% and up to 95%, depending on the extraction option. If specified, the 'flags' and 'clip' arguments are ignored, because they are textpage-only properties. If omitted, a new, temporary textpage will be created.
ja: (v1.19.0で新たに追加) 事前に作成したTextPageを使用します。これにより、実行時間が **非常に大幅に** 削減されます：抽出オプションに応じて50％以上、95％まで削減されます。指定した場合、 'flags' および 'clip' 引数は無視されます。テキストページ専用のプロパティであるためです。省略した場合、新しい一時的なテキストページが作成されます。

en: (new in v1.19.1) sort the output by vertical, then horizontal coordinates. In many cases, this should suffice to generate a "natural" reading order. Has no effect on (X)HTML and XML. Output option **"words"** sorts by `(y1, x0)` of the words' bboxes. Similar is true for "blocks", "dict", "json", "rawdict", "rawjson": they all are sorted by `(y1, x0)` of the resp. block bbox. If specified for "text", then internally "blocks" is used.
ja: (v1.19.1で新たに追加) 出力を垂直方向、水平方向の座標で並べ替えます。多くの場合、これで「自然な」読み取り順序を生成できるはずです。これは(X)HTMLおよびXMLには影響しません。出力オプション “words” は単語のbboxの `(y1, x0)` で並べ替えます。同様のことは “blocks”、 “dict”、 “json”、 “rawdict”、 “rawjson”にも当てはまります。それらはすべて、respです。ブロックbboxの `(y1, x0)` でソートされます。 “text” に対して指定された場合、内部的には “blocks” が使用されます。

en: The page's content as a string, a list or a dictionary. Refer to the corresponding :ref:`TextPage` method for details.
ja: ページの内容を表す文字列、リスト、または辞書。詳細については対応するTextPageメソッドを参照してください。

en: You can use this method as a **document conversion tool** from :ref:`any supported document type<Supported_File_Types>` to one of TEXT, HTML, XHTML or XML documents.
ja: このメソッドを、:ref:`any supported document type<Supported_File_Types>` からTEXT、HTML、XHTML、またはXMLドキュメントのいずれかに変換する **ドキュメント変換ツール** として使用できます。

en: The inclusion of text via the *clip* parameter is decided on a by-character level: **(changed in v1.18.2)** a character becomes part of the output, if its bbox is contained in *clip*. This **deviates** from the algorithm used in redaction annotations: a character will be **removed if its bbox intersects** any redaction annotation.
ja: clipパラメータを使用してテキストを含めるかどうかは、文字単位で決定されます **(v1.18.2で変更)** 。キャラクタのbboxが *clip* に含まれている場合、そのキャラクタは出力の一部となります。これは、赤塗りのアノテーションで使用されるアルゴリズムとは **異なります** ：

en: New in v1.17.7
ja: 新機能 v1.17.7

en: Changed in v1.19.0: add `textpage` parameter
ja: v1.19.0 で変更: `textpage`  パラメータを追加

en: Retrieve the text contained in a rectangle.
ja: 指定された矩形に含まれるテキストを取得します。

en: rect-like.
ja: 矩形のようなもの。

en: a :ref:`TextPage` to use. If omitted, a new, temporary textpage will be created.
ja: 使用する :ref:`TextPage`。省略した場合、新しい一時的なテキストページが作成されます。

en: a string with interspersed linebreaks where necessary. Changed in v1.19.0: It is based on dedicated code. A tyical use is checking the result of :meth:`Page.search_for`:
ja: 必要に応じて改行が挿入された文字列。v1.19.0 で変更: それは専用のコードに基づいています。典型的な使用例は、:meth:`Page.search_for` の結果をチェックすることです

en: New in v1.16.5
ja: v1.16.5 で新機能。

en: Changed in v1.17.7: introduced `clip` parameter.
ja: v1.17.7 で変更: `clip` パラメータが導入されました。

en: Create a :ref:`TextPage` for the page.
ja: ページ用の :ref:`TextPage` を作成します

en: indicator bits controlling the content available for subsequent text extractions and searches -- see the parameter of :meth:`Page.get_text`.
ja: 後続のテキスト抽出と検索で使用可能なコンテンツを制御する指示ビット – :meth:`Page.get_text` のパラメータを参照してください。

en: *(new in v1.17.7)* restrict extracted text to this area.
ja: *(v1.17.7 で新機能)* 抽出されたテキストをこの領域に制限します。

en: New in v.1.19.0
ja: v1.19.0 で新機能

en: Changed in v1.19.1: support full and partial OCRing a page.
ja: v1.19.1 で変更: ページのフルと部分的な OCR をサポート

en: Create a :ref:`TextPage` for the page that includes OCRed text. MuPDF will invoke Tesseract-OCR if this method is used. Otherwise this is a normal :ref:`TextPage` object.
ja: OCRed テキストを含むページの :ref:`TextPage` を作成します。このメソッドを使用すると、MuPDF は Tesseract-OCR を呼び出します。それ以外の場合、これは通常の :ref:`TextPage` オブジェクトです。

en: indicator bits controlling the content available for subsequent test extractions and searches -- see the parameter of :meth:`Page.get_text`.
ja: 後続のテキスト抽出と検索に使用可能なコンテンツを制御する指示ビット – :meth:`Page.get_text` のパラメータを参照してください。

en: the expected language(s). Use "+"-separated values if multiple languages are expected, "eng+spa" for English and Spanish.
ja: 期待される言語。複数の言語が期待される場合は "+" で区切って指定します。たとえば英語とスペイン語の場合は "eng+spa" です。

en: the desired resolution in dots per inch. Influences recognition quality (and execution time).
ja: インチ当たりのドット数で指定された解像度。認識品質（および実行時間）に影響を与えます。

en: whether to OCR the full page, or just the displayed images.
ja: ページ全体を OCR するか、表示された画像のみを OCR するかを指定します。

en: The name of Tesseract's language support folder `tessdata`. If omitted, this information must be present as environment variable `TESSDATA_PREFIX`. Can be determined by function :meth:`get_tessdata`.
ja: Tesseract の言語サポートフォルダ `tessdata` の名前。省略した場合、この情報は環境変数 `TESSDATA_PREFIX` として存在している必要があります。tessdata を取得する関数 :meth:`get_tessdata` によって決定できます。

en: This method does **not** support a clip parameter -- OCR will always happen for the complete page rectangle.
ja: このメソッドは clip パラメータをサポート **していない** ため、OCR は常に完全なページ矩形に対して行われます

en: a :ref:`TextPage`. Execution may be significantly longer than :meth:`Page.get_textpage`.
ja: :ref:`TextPage`。実行時間は :meth:`Page.get_textpage` よりも大幅に長くなる場合があります。

en: For a full page OCR, **all text** will have the font "GlyphlessFont" from Tesseract. In case of partial OCR, normal text will keep its properties, and only text coming from images will have the GlyphlessFont.
ja: フルページの OCR の場合、**すべてのテキスト** は Tesseract の "GlyphlessFont" になります。部分的な OCR の場合、通常のテキストはそのプロパティを保持し、画像から来たテキストのみが GlyphlessFont になります。

en: **OCRed text is only available** to PyMuPDF's text extractions and searches if their `textpage` parameter specifies the output of this method.
ja: OCRed textは、PyMuPDFのテキスト抽出と検索でのみ利用可能であり、その `TextPage` パラメータがこのメソッドの出力を指定している場合にのみ利用できます。

en: `This <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/jupyter-notebooks/partial-ocr.ipynb>`_ Jupyter notebook walks through an example for using OCR textpages.
ja: `このJupyter <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/jupyter-notebooks/partial-ocr.ipynb>`_ ノートブックは、OCRテキストページを使用する例を説明します。

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

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

en: Changed in v1.19.0: add "seqno" key, remove "clippings" key
ja: v1.19.0で変更: “seqno”キーを追加、“clippings”キーを削除

en: Changed in v1.19.1: "color" / "fill" keys now always are either are RGB tuples or `None`. This resolves issues caused by exotic colorspaces.
ja: v1.19.1で変更: “color” / “fill”キーは常にRGBタプルまたはNoneのいずれかであるように変更。これにより、異常なカラースペースに起因する問題が解消されます。

en: Changed in v1.19.2: add an indicator for the *"orientation"* of the area covered by an "re" item.
ja: v1.19.2で変更: "re" アイテムでカバーされる領域の *"orientation"* を示すインジケーターを追加

en: Changed in v1.22.0: add new key `"layer"` which contains the name of the Optional Content Group of the path (or `None`).
ja: v1.22.0で変更: 新しいキー `"layer"` を追加。これにはパスのオプションコンテンツグループの名前が含まれます（またはNone）。

en: Changed in v1.22.0: add parameter `extended` to also return clipping and group paths.
ja: v1.22.0で変更: クリッピングとグループパスも返すようにするためのパラメーター `extended` を追加

en: Return the vector graphics of the page. These are instructions which draw lines, rectangles, quadruples or curves, including properties like colors, transparency, line width and dashing, etc. Alternative terms are "line art" and "drawings".
ja: ページのベクトルグラフィックスを返します。これらは線、四角形、四角形または曲線を描画するための命令で、色、透明度、線の幅、点線などのプロパティを含みます。代替用語は「ラインアート」と「ドローイング」です。

en: a list of dictionaries. Each dictionary item contains one or more single draw commands belonging together: they have the same properties (colors, dashing, etc.). This is called a **"path"** in PDF, so we adopted that name here, but the method **works for all document types**.
ja: 辞書のリスト。各辞書アイテムには、同じプロパティ（色、破線など）を持つ1つ以上の単一の描画コマンドが含まれます。これらはPDFでは **"path"** と呼ばれ、ここではその名前を採用していますが、このメソッドは **すべてのドキュメントタイプに対して機能します**。

en: The path dictionary for fill, stroke and fill-stroke paths has been designed to be compatible with class :ref:`Shape`. There are the following keys:
ja: fill、stroke、fill-strokeパスのパス辞書は、:ref:`Shape` クラスと互換性があるように設計されています。次のキーがあります：

en: Key
ja: キー

en: Value
ja: 値

en: Same as the parameter in :ref:`Shape`.
ja: :ref:`Shape` のパラメーターと同じです。

en: Stroke color (see :ref:`Shape`).
ja: ストロークカラー（:ref:`Shape` を参照）。

en: Dashed line specification (see :ref:`Shape`).
ja: 破線の仕様（:ref:`Shape` を参照）。

en: Fill colors of area overlaps -- same as the parameter in :ref:`Shape`.
ja: 領域のオーバーラップの塗りつぶし色（:ref:`Shape` を参照）。

en: Fill color  (see :ref:`Shape`).
ja: 塗りつぶしカラー（:ref:`Shape` を参照）。

en: List of draw commands: lines, rectangles, quads or curves.
ja: 描画コマンド（直線、四角形、四角形、曲線など）のリスト。

en: Number 3-tuple, use its max value on output with :ref:`Shape`.
ja: 3つの数値からなるタプル。出力時に :ref:`Shape` との最大値を使用します。

en: (new in v1.18.17) fill color transparency (see :ref:`Shape`).
ja: v1.18.17で新しく追加された塗りつぶしカラーの透明度（:ref:`Shape` を参照）。

en: (new in v1.18.17) stroke color transparency  (see :ref:`Shape`).
ja: v1.18.17で新しく追加されたストロークカラーの透明度（:ref:`Shape` を参照）。

en: Page area covered by this path. Information only.
ja: このパスでカバーされるページ領域。情報のみ。

en: (new in v1.22.0) name of applicable Optional Content Group
ja: v1.22.0で新しく追加された適用可能なオプションコンテンツグループの名前

en: (new in v1.22.0) the hierarchy level if `extended=True`
ja: v1.22.0で新しく追加された `extended=True` の場合の階層レベル

en: (new in v1.19.0) command number when building page appearance
ja: v1.19.0で新しく追加されたページ表示を構築する際のコマンド番号

en: (new in v1.18.17) type of this path.
ja: v1.18.17で新しく追加されたパスのタイプ。

en: Stroke line width  (see :ref:`Shape`).
ja: ストロークラインの幅（:ref:`Shape` を参照）。

en: *(Changed in v1.18.17)* Key `"opacity"` has been replaced by the new keys `"fill_opacity"` and `"stroke_opacity"`. This is now compatible with the corresponding parameters of :meth:`Shape.finish`.
ja: *(バージョン1.18.17で変更)* キー  `"opacity"` は新しいキー  `"fill_opacity"` および "stroke_opacity"` に置き換えられました。これは、:meth:`Shape.finish` の対応するパラメーターと互換性があるようになりました。

en: For paths other than groups or clips, key `"type"` takes one of the following values:
ja: グループやクリップ以外のパスに対して、キー `"type"` は次のいずれかの値を取ります：

en: **"f"** -- this is a *fill-only* path. Only key-values relevant for this operation have a meaning, not applicable ones are present with a value of *None*: `"color"`, `"lineCap"`, `"lineJoin"`, `"width"`, `"closePath"`, `"dashes"` and should be ignored.
ja: **"f"**  - これは *fill-only* のパスです。この操作に関連するキーの値のみが意味を持ち、適用されないものは値が *None* で存在します。: `"color"`、`"lineCap"`、"lineJoin"`、`"width"`、`"closePath"`、`"dashes"` は無視すべきです。

en: **"s"** -- this is a *stroke-only* path. Similar to previous, key `"fill"` is present with value *None*.
ja: **"s"** - これは *stroke-only* のパスです。以前と同様に、キー `"fill"` は値が *None* で存在します。

en: **"fs"** -- this is a path performing combined *fill* and *stroke* operations.
ja: **"fs"** - これは *fill* と *stroke* の組み合わせ操作を実行するパスです

en: Each item in `path["items"]` is one of the following:
ja: `path["items"]` の各アイテムは、次のいずれかです：

en: `("l", p1, p2)` - a line from p1 to p2 (:ref:`Point` objects).
ja: `("l", p1, p2)` - p1 から p2 への直線（:ref:`Point` オブジェクト）。

en: `("c", p1, p2, p3, p4)` - cubic Bézier curve **from p1 to p4** (p2 and p3 are the control points). All objects are of type :ref:`Point`.
ja: `("c", p1, p2, p3, p4)` - **p1 から p4 へ** の三次ベジエ曲線（p2 と p3 は制御点です）。すべてのオブジェクトは :ref:`Point` タイプです。

en: `("re", rect, orientation)` - a :ref:`Rect`. *Changed in v1.18.17:* Multiple rectangles within the same path are now detected. *Changed in v1.19.2:* added integer `orientation` which is 1 resp. -1 indicating whether the enclosed area is rotated left (1 = anti-clockwise), or resp. right [#f7]_.
ja: `("re", rect, orientation)` - :ref:`Rect`。*バージョン1.18.17で変更:* 同じパス内の複数の矩形が検出されるようになりました。*バージョン1.19.2で変更:* 整数の orientation が追加され、内包された領域が左に回転（1 = 反時計回り）するか、右に回転するかを示します [#f7]_。

en: `("qu", quad)` - a :ref:`Quad`. *New in v1.18.17, changed in v1.19.2:* 3 or 4 consecutive lines are detected to actually represent a :ref:`Quad`.
ja: `("qu", quad)` - :ref:`Quad`。*バージョン1.18.17で新しく追加され、バージョン1.19.2で変更されました:* 3つまたは4つの連続する線が Quad を実際に表すことが検出されます。

en: Starting with v1.19.2, quads and rectangles are more reliably recognized as such.
ja: バージョン1.19.2から、四角形と四角形は、より信頼性のある方法で認識されるようになりました。

en: Using class :ref:`Shape`, you should be able to recreate the original drawings on a separate (PDF) page with high fidelity under normal, not too sophisticated circumstances. Please see the following comments on restrictions. A coding draft can be found in section "Extractings Drawings" of chapter :ref:`FAQ`.
ja: クラス :ref:`Shape` を使用すると、通常の、あまり洗練されていない状況で、高い忠実度で元の図面を別の（PDF）ページに再作成できるはずです。制約事項に関する以下のコメントをご覧ください。コーディングのドラフトは、:ref:`FAQ` の「図面の抽出」章のセクションにあります。

en: **New in v1.22.0:** Specifying `extended=True` significantly alters the output. Most importantly, new dictionary types are present: "clip" and "group". All paths will now be organized in a hierarchic structure which is encoded by the new integer key "level", the hierarchy level. Each group or clip establishes a new hierarchy, which applies to all subsequent paths having a *larger* level value.
ja: **新機能 v1.22.0:** `extended=True` を指定すると、出力が大幅に変更されます。最も重要な変更点は、新しい辞書タイプ「clip」および「group」が存在することです。すべてのパスは、新しい整数キー「level」でエンコードされる階層構造に整理されます。各グループまたはクリップは、その後に大きなレベル値を持つすべての後続のパスに適用される新しい階層を確立します。

en: Any path with a smaller level value than its predecessor will end the scope of (at least) the preceeding hierarchy level. A "clip" path with the same level as the preceding clip will end the scope of that clip. Same is true for groups. This is best explained by an example::
ja: 前任者よりも小さいレベル値を持つパスは、少なくとも前の階層レベルのスコープを終了します。前のクリップと同じレベルの "clip" パスは、そのクリップのスコープを終了します。同様に、グループも同じです。これは、次の例で最もよく説明されます：

en: The clip in line 0 applies to line including line 7. Group in line 2 applies to lines 3 to 5, clip in line 3 only applies to line 4.
ja: 行0の「clip」は行7を含む行全体に適用されます。行2の「group」は行3から5までの行に適用され、行3の「clip」は行4にのみ適用されます。

en: "stroke" in line 4 is under control of "group" in line 2 and "clip" in line 3 (which in turn is a subset of line 0 clip).
ja: 行4の「stroke」は行2の「group」と行3の「clip」（それ自体が行0の「clip」のサブセットです）の制御下にあります。

en: **"clip"** dictionary. Its values (most importantly "scissor") remain valid / apply as long as following dictionaries have a **larger "level"** value.
ja: **「clip」** 辞書。その値（特に「scissor」）は、後続の辞書が「level」の値が大きい限り、有効で適用されます。

en: Same as in "stroke" or "fill" dictionaries
ja: 「stroke」または「fill」の辞書と同じ

en: the clip rectangle
ja: クリップ矩形

en: "group" dictionary. Its values remain valid (apply) as long as following dictionaries have a **larger "level"** value. Any dictionary with an equal or lower level end this group.
ja: 「group」辞書。その値は、後続の辞書が「level」の値が大きい限り、有効で適用されます。同じレベルまたはそれ以下の辞書がこのグループを終了します。

en: (bool) Whether this group is isolated
ja: （ブール）このグループが孤立しているかどうか

en: (bool) Whether this is a "Knockout Group"
ja: （ブール）これが「Knockout Group」であるかどうか

en: Name of the BlendMode, default is "Normal"
ja: BlendModeの名前、デフォルトは「Normal」

en: Float value in range [0, 1].
ja: 範囲[0、1]内の浮動小数点値

en: Key `"type"` takes one of the following values:
ja: `"type"` キーは、以下のいずれかの値を取ります：

en: **"f"** -- this is a *fill-only* path. Only key-values relevant for this operation have a meaning, irrelevant ones have been added with default values for backward compatibility: `"color"`, `"lineCap"`, `"lineJoin"`, `"width"`, `"closePath"`, `"dashes"` and should be ignored.
ja: **"f"**– これは *fill-only* のパスです。この操作に関連するキーと値だけが意味を持ち、無関係なものは後方互換性を保つためにデフォルトの値が追加されています。したがって、`"color"`、`"lineCap"`、`"lineJoin"`、`"width"`、`"closePath"`、`"dashes"` などは無視されるべきです。

en: **"s"** -- this is a *stroke-only* path. Similar to previous, key `"fill"` is present with value `None`.
ja: **"s"** – これは *stroke-only* のパスです。前述のように、キー "fill" が値 `None` で存在します。

en: Using class :ref:`Shape`, you should be able to recreate the original drawings on a separate (PDF) page with high fidelity under normal, not too sophisticated circumstances. Please see the following comments on restrictions. A coding draft can be found in section "How to Extract Drawings" of chapter :ref:`FAQ`.
ja: :ref:`Shape` クラスを使用すると、通常の、あまり複雑でない状況で、元の図面を高い忠実度で別の（PDF）ページに再作成できるはずです。制約事項に関する以下のコメントを参照してください。コーディングの草案は、FAQの「図面の抽出方法」セクションにあります。

en: The method is based on the output of :meth:`Page.get_cdrawings` -- which is much faster, but requires somewhat more attention processing its output.
ja: このメソッドは、 :meth:`Page.get_cdrawings` の出力に基づいています。これははるかに高速ですが、出力の処理には多少の注意が必要です。

en: New in v1.18.17
ja: 新機能（v1.18.17）

en: Changed in v1.19.0: removed "clippings" key, added "seqno" key.
ja: v1.19.0で変更：「clippings」キーを削除、新たに「seqno」キーを追加。

en: Changed in v1.19.1: always generate RGB color tuples.
ja: v1.19.1で変更：常にRGBカラータプルを生成します。

en: Changed in v1.22.0: added new key `"layer"` which contains the name of the Optional Content Group of the path (or `None`).
ja: v1.22.0で変更：新たに「layer」というキーが追加され、パスのオプションコンテンツグループの名前（またはNone）が含まれます。

en: Changed in v1.22.0  added parameter `extended` to also return clipping paths.
ja: v1.22.0で変更：クリッピングパスを返すためのパラメータ「extended」が追加されました。

en: Extract the vector graphics on the page. Apart from following technical differences, functionally equivalent to :meth:`Page.get_drawings`, but much faster:
ja: ページ上のベクトルグラフィックスを抽出します。技術的な違いを除いて、:meth:`Page.get_drawings` と機能的に同等ですが、はるかに高速です：

en: Every path type only contains the relevant keys, e.g. a stroke path has no `"fill"` color key. See comment in method :meth:`Page.get_drawings`.
ja: 各パスタイプには関連するキーのみ含まれます。たとえば、ストロークパスには `"fill"` カラーキーはありません。 :meth:`Page.get_drawings` メソッドのコメントを参照してください。

en: Coordinates are given as :data:`point_like`, :data:`rect_like` and :data:`quad_like` **tuples** -- not as :ref:`Point`, :ref:`Rect`, :ref:`Quad` objects.
ja: 座は :data:`point_like`、:data:`rect_like`、:data:`quad_like` の **tuples** として与えられます。:ref:`Point`、:ref:`Rect`、:ref:`Quad` オブジェクトとしてではなく。

en: If performance is a concern, consider using this method: Compared to versions earlier than 1.18.17, you should see much shorter response times. We have seen pages that required 2 seconds then, now only need 200 ms with this method.
ja: 性能が懸念される場合、このメソッドを使用することを検討してください。バージョン1.18.17より前と比較して、応答時間が大幅に短縮されるはずです。以前は2秒かかったページが、このメソッドを使用すると200ミリ秒で完了する場合もあります。

en: PDF only: Return a list of fonts referenced by the page. Wrapper for :meth:`Document.get_page_fonts`.
ja: PDFのみ：ページで参照されているフォントのリストを返します。:meth:`Document.get_page_fonts` のラッパーです。

en: PDF only: Return a list of images referenced by the page. Wrapper for :meth:`Document.get_page_images`.
ja: PDFのみ：ページで参照されているイメージのリストを返します。:meth:`Document.get_page_images` のラッパーです。

en: *New in v1.18.11*
ja: *新機能（v1.18.11)*

en: *Changed in v1.18.13:* added image MD5 hashcode computation and :data:`xref` search.
ja: *v1.18.13で変更：* イメージのMD5ハッシュコードの計算と :data:`xref` の検索が追加されました。

en: Return a list of meta information dictionaries for all images shown on the page. This works for all document types. Technically, this is a subset of the dictionary output of :meth:`Page.get_text`: the image binary content and any text on the page are ignored.
ja: ページ上に表示されているすべてのイメージに関するメタ情報辞書のリストを返します。これはすべての文書タイプで機能します。技術的には、これは :meth:`Page.get_text` の辞書出力のサブセットであり、画像のバイナリコンテンツとページ上のテキストは無視されます。

en: *New in v1.18.13:* Compute the MD5 hashcode for each encountered image, which allows identifying image duplicates. This adds the key `"digest"` to the output, whose value is a 16 byte `bytes` object.
ja: *新機能（v1.18.13)*：各イメージのMD5ハッシュコードを計算し、イメージの重複を識別できるようにします。これにより、出力に `"digest"` キーが追加され、その値は16バイトのバイトオブジェクトです。

en: *New in v1.18.13:* **PDF only.** Try to find the :data:`xref` for each image. Implies `hashes=True`. Adds the `"xref"` key to the dictionary. If not found, the value is 0, which means, the image is either "inline" or otherwise undetectable. Please note that this option has an extended response time, because the MD5 hashcode will be computed at least two times for each image with an xref.
ja: *新機能（v1.18.13)*：**PDFのみ。** b各イメージの :data:`xref` を見つけようとします。`hashes=True` を含意します。辞書に `"xref"` キーが追加されます。見つからない場合、値は0で、イメージが「インライン」または他の方法で検出できないことを意味します。このオプションは応答時間が延長されるため、注意が必要です。少なくとも2回のMD5ハッシュコードの計算が各イメージに対して行われます。

en: A list of dictionaries. This includes information for **exactly those** images, that are shown on the page -- including *"inline images"*. In contrast to images included in :meth:`Page.get_text`, image **binary content** is not loaded, which drastically reduces memory usage. The dictionary layout is similar to that of image blocks in `page.get_text("dict")`.
ja: 辞書のリスト。これには、ページに表示されているイメージに関する情報が含まれます。:meth:`Page.get_text` で含まれている画像ブロックとは異なり、画像の **binary content** は読み込まれないため、メモリの使用量が大幅に削減されます。辞書のレイアウトは、ページ.get_text("dict")内のイメージブロックと似ています。

en: **Key**
ja: **キー**

en: **Value**
ja: **値**

en: block number *(int)*
ja: ブロック番号 *(整数)*

en: image bbox on page, :data:`rect_like`
ja: ページ上の画像の境界ボックス、:data:`rect_like`

en: original image width *(int)*
ja: 元の画像の幅 *(整数)*

en: original image height *(int)*
ja: 元の画像の高さ *(整数*

en: colorspace name *(str)*
ja: カラースペース名 *(文字列)*

en: colorspace.n *(int)*
ja: colorspace.n *(整数)*

en: resolution in x-direction *(int)*
ja: x方向の解像度 *(整数)*

en: resolution in y-direction *(int)*
ja: y方向の解像度 *(整数)*

en: bits per component *(int)*
ja: コンポーネントごとのビット数 *(整数)*

en: storage occupied by image *(int)*
ja: 画像が占めるストレージ容量 *(整数)*

en: MD5 hashcode *(bytes)*, if *hashes* is true
ja: MD5ハッシュコード（バイト）、*hashes* がtrueの場合

en: image :data:`xref` or 0, if *xrefs* is true
ja: 画像の :data:`xref` または0、*xrefs* がtrueの場合

en: matrix transforming image rect to bbox, :data:`matrix_like`
ja: 画像の境界ボックスをbboxに変換するための行列、:data:`matrix_like`

en: Multiple occurrences of the same image are always reported. You can detect duplicates by comparing their `digest` values.
ja: 同じ画像の複数の出現は常に報告されます。digestの値を比較して重複を検出できます。

en: PDF only: Return a list of Form XObjects referenced by the page. Wrapper for :meth:`Document.get_page_xobjects`.
ja: PDFのみ：ページで参照されているフォームXObjectのリストを返します。:meth:`Document.get_page_xobjects` のラッパーです。

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

en: PDF only: Return boundary boxes and transformation matrices of an embedded image. This is an improved version of :meth:`Page.get_image_bbox` with the following differences:
ja: PDFのみ：埋め込み画像の境界ボックスと変換行列を返します。これは :meth:`Page.get_image_bbox` の改良バージョンで、次の違いがあります：

en: There is no restriction on **how** the image is invoked (by the page or one of its Form XObjects). The result is always complete and correct.
ja: 画像が **どのように** 呼び出されるかに制限はありません（ページまたはそのフォームXObjectのいずれかによって）。結果は常に完全かつ正確です。

en: The result is a list of :ref:`Rect` or (:ref:`Rect`, :ref:`Matrix`) objects -- depending on *transform*. Each list item represents one location of the image on the page. Multiple occurrences might not be detectable by :meth:`Page.get_image_bbox`.
ja: 結果は :ref:`Rect` または（:ref:`Rect`、:ref:`Matrix`）オブジェクトのリストです（*transform* に応じて異なります）。各リスト項目は、ページ上の画像の1つの場所を表します。:meth:`Page.get_image_bbox` では複数の出現を検出できない場合があります。

en: The method invokes :meth:`Page.get_image_info` with `xrefs=True` and therefore has a noticeably longer response time than :meth:`Page.get_image_bbox`.
ja: このメソッドは、`xrefs=True` で :meth:`Page.get_image_info` を呼び出すため、:meth:`Page.get_image_bbox` よりも明らかに長い応答時間がかかります。

en: an item of the list :meth:`Page.get_images`, or the reference **name** entry of such an item (item[7]), or the image :data:`xref`.
ja: :meth:`Page.get_images` のリストアイテム、そのようなアイテムの参照 **name** エントリ（item[7]）、または画像の :data:`xref`。

en: also return the matrix used to transform the image rectangle to the bbox on the page. If true, then tuples `(bbox, matrix)` are returned.
ja: 画像の矩形をbboxに変換するために使用される行列も返すかどうか。trueの場合、タプル `(bbox, matrix)` が返されます。

en: Boundary boxes and respective transformation matrices for each image occurrence on the page. If the item is not on the page, an empty list `[]` is returned.
ja: ページ上の各画像出現に対する境界ボックスとそれに対応する変換行列。アイテムがページ上にない場合、空のリスト `[]`  が返されます。

en: Changed in v1.18.11: return image transformation matrix
ja: 変更点 v1.18.11：イメージの変換行列を返すようになりました

en: PDF only: Return boundary box and transformation matrix of an embedded image.
ja: PDFのみ：埋め込まれたイメージの境界ボックスと変換行列を返します。

en: an item of the list :meth:`Page.get_images` with *full=True* specified, or the reference **name** entry of such an item, which is item[-3] (or item[7] respectively).
ja: :meth:`Page.get_images` のリストのアイテムで *full=True* が指定されているもの、またはそのようなアイテムの参照名 **name**  エントリ、つまりitem[-3]（またはitem[7]）。

en: *(new in v1.18.11)* also return the matrix used to transform the image rectangle to the bbox on the page. Default is just the bbox. If true, then a tuple `(bbox, matrix)` is returned.
ja: *(v1.18.11で新規)* イメージの矩形をページのbboxに変換するために使用される行列も返すかどうか。デフォルトはbboxのみです。 trueの場合、タプル `(bbox, matrix)` が返されます。

en: :ref:`Rect` or (:ref:`Rect`, :ref:`Matrix`)
ja: :ref:`Rect` または（:ref:`Rect`、:ref:`Matrix`）

en: the boundary box of the image -- optionally also its transformation matrix.
ja: イメージの境界ボックス - オプションでその変換行列も。

en: *(Changed in v1.16.7)* -- If the page in fact does not display this image, an infinite rectangle is returned now. In previous versions, an exception was raised. Formally invalid parameters still raise exceptions.
ja: *(v1.16.7で変更)* –実際にはこのイメージを表示していない場合、無限の矩形が返されるようになりました。以前のバージョンでは、例外が発生しました。形式的に無効なパラメータは引き続き例外を発生させます。

en: *(Changed in v1.17.0)* -- Only images referenced directly by the page are considered. This means that images occurring in embedded PDF pages are ignored and an exception is raised.
ja: *(v1.17.0で変更)* –ページで直接参照されているイメージのみが考慮されます。これは、埋め込まれたPDFページに存在するイメージは無視され、例外が発生します。

en: *(Changed in v1.18.5)* -- Removed the restriction introduced in v1.17.0: any item of the page's image list may be specified.
ja: *(v1.18.5で変更)* –v1.17.0で導入された制限を削除しました：ページのイメージリストの任意のアイテムを指定できます。

en: *(Changed in v1.18.11)* -- Partially re-instated a restriction: only those images are considered, that are either directly referenced by the page or by a Form XObject directly referenced by the page.
ja: *(v1.18.11で変更)* –一部の制限を部分的に再導入しました：ページで直接参照されるイメージまたはページで直接参照されるフォームXObjectによって参照されるイメージのみが考慮されます。

en: *(Changed in v1.18.11)* -- Optionally also return the transformation matrix together with the bbox as the tuple `(bbox, transform)`.
ja: *(v1.18.11で変更)* –オプションでbboxと一緒に変換行列も返すことができます（タプルとして）。

en: Be aware that :meth:`Page.get_images` may contain "dead" entries i.e. images, which the page **does not display**. This is no error, but intended by the PDF creator. No exception will be raised in this case, but an infinite rectangle is returned. You can avoid this from happening by executing :meth:`Page.clean_contents` before this method.
ja: :meth:`Page.get_images` には「不要な」エントリが含まれている場合があることに注意してください。これはPDF作成者によって意図的に設定されたものであり、エラーではありません。この場合、例外は発生しませんが、無限の矩形が返されます。このような状況を回避するには、このメソッドの前に :meth:`Page.clean_contents` を実行することができます。

en: The image's "transformation matrix" is defined as the matrix, for which the expression `bbox / transform == fitz.Rect(0, 0, 1, 1)` is true, lookup details here: :ref:`ImageTransformation`.
ja: イメージの「変換行列」は、`bbox / transform == fitz.Rect(0, 0, 1, 1)` という式が真であるための行列であり、詳細はこちらを参照してください：:ref:`ImageTransformation`。

en: Create an SVG image from the page. Only full page images are currently supported.
ja: ページからSVGイメージを作成します。現在、フルページのイメージのみがサポートされています。

en: a matrix, default is :ref:`Identity`.
ja: 行列、デフォルトは :ref:`Identity` です。

en: *(new in v1.17.5)* -- controls how text is represented. *True* outputs each character as a series of elementary draw commands, which leads to a more precise text display in browsers, but a **very much larger** output for text-oriented pages. Display quality for *False* relies on the presence of the referenced fonts on the current system. For missing fonts, the internet browser will fall back to some default -- leading to unpleasant appearances. Choose *False* if you want to parse the text of the SVG.
ja: *(v1.17.5で新規)* –テキストの表現方法を制御します。Trueは、各文字を基本的な描画コマンドのシリーズとして出力し、ブラウザでより正確なテキスト表示を提供しますが、テキスト指向のページでは非常に大きな出力になります。 *False* の表示品質は、現在のシステム上の参照フォントの存在に依存しています。不足しているフォントの場合、インターネットブラウザはデフォルトにフォールバックし、不快な外観になります。 SVGのテキストを解析する場合は *False* を選択してください。

en: a UTF-8 encoded string that contains the image. Because SVG has XML syntax it can be saved in a text file, the standard extension is `.svg`.
ja: UTF-8エンコードされた文字列で、イメージを含みます。 SVGにはXML構文があるため、テキストファイルに保存でき、標準の拡張子は `.svg` です。

en: In case of a PDF, you can circumvent the "full page image only" restriction by modifying the page's CropBox before using the method.
ja: PDFの場合、メソッドを使用する前に、ページのCropBoxを変更して「フルページイメージのみ」制限を回避できます。

en: Changed in v1.19.2: added support of parameter dpi.
ja: v1.19.2で変更：dpiパラメータのサポートを追加。

en: Create a pixmap from the page. This is probably the most often used method to create a :ref:`Pixmap`.
ja: ページからピクスマップを作成します。おそらく、:ref:`Pixmap` を作成するために最も頻繁に使用されるメソッドでしょう。

en: All parameters are *keyword-only.*
ja: すべてのパラメータは *keyword-only.* です。

en: default is :ref:`Identity`.
ja: デフォルトは :ref:`Identity` です。

en: (new in v1.19.2) desired resolution in x and y direction. If not `None`, the `"matrix"` parameter is ignored.
ja: (v1.19.2で新たに追加) x方向およびy方向の所望の解像度。`None` でない場合、`"matrix"` パラメータは無視されます。

en: The desired colorspace, one of "GRAY", "RGB" or "CMYK" (case insensitive). Or specify a :ref:`Colorspace`, ie. one of the predefined ones: :data:`csGRAY`, :data:`csRGB` or :data:`csCMYK`.
ja: 所望のカラースペース、"GRAY"、"RGB"、または"CMYK"のいずれか（大文字/小文字を区別しない）。または、:ref:`Colorspace` のように、事前定義されたもののいずれかを指定できます：:data:`csGRAY`、:data:`csRGB`、:data:`csCMYK`。

en: restrict rendering to the intersection of this area with the page's rectangle.
ja: ページの矩形とこの領域の交差に描画を制限します。

en: whether to add an alpha channel. Always accept the default *False* if you do not really need transparency. This will save a lot of memory (25% in case of RGB ... and pixmaps are typically **large**!), and also processing time. Also note an **important difference** in how the image will be rendered: with *True* the pixmap's samples area will be pre-cleared with *0x00*. This results in **transparent** areas where the page is empty. With *False* the pixmap's samples will be pre-cleared with *0xff*. This results in **white** where the page has nothing to show.
ja: 透明チャネルを追加するかどうか。本当に透明性が必要でない場合は、常にデフォルトの *False* を受け入れてください。これにより、メモリ（RGBの場合25％…ピクスマップは通常大きいです！）と処理時間が大幅に節約されます。また、画像がレンダリングされる方法についても重要な違いに注意してください： *True*  の場合、ピクスマップのサンプル領域は0x00で事前クリアされます。これにより、ページが空白の場所には透明な領域が表示されます。Falseの場合、ピクスマップのサンプルは *0xff* で事前クリアされます。これにより、ページに表示する内容がない場所には  **white** が表示されます。

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

en: The default alpha value is now *False*.
ja: デフォルトのalpha値は *False* になりました。

en: Generated with *alpha=True*
ja: *alpha=True* で生成されたもの

en: Generated with *alpha=False*
ja: *alpha=False* で生成されたもの

en: *(new in version 1.16.0)* whether to also render annotations or to suppress them. You can create pixmaps for annotations separately.
ja: *(v1.16.0で新たに追加)* アノテーションをレンダリングするか抑制するか。注釈用に個別にピクスマップを作成できます。

en: Pixmap of the page. For fine-controlling the generated image, the by far most important parameter is **matrix**. E.g. you can increase or decrease the image resolution by using **Matrix(xzoom, yzoom)**. If zoom > 1, you will get a higher resolution: zoom=2 will double the number of pixels in that direction and thus generate a 2 times larger image. Non-positive values will flip horizontally, resp. vertically. Similarly, matrices also let you rotate or shear, and you can combine effects via e.g. matrix multiplication. See the :ref:`Matrix` section to learn more.
ja: ページのピクスマップ。生成されたイメージを細かく制御するために、最も重要なパラメータは **matrix** です。たとえば、Matrix(xzoom, yzoom)を使用してイメージの解像度を増減させることができます。zoom > 1の場合、より高い解像度が得られ、zoom=2はその方向のピクセル数を2倍にし、したがって2倍の大きさのイメージを生成します。非正の値は水平または垂直に反転させます。同様に、行列は回転やシアーも可能にし、行列の乗算を介して効果を組み合わせることもできます。詳細については、:ref:`Matrix` セクションをご覧ください。

en: The method will respect any page rotation and will not exceed the intersection of `clip` and :attr:`Page.cropbox`. If you need the page's mediabox (and if this is a different rectangle), you can use a snippet like the following to achieve this::
ja: このメソッドはページの回転を尊重し、`clip` と :attr:`Page.cropbox` の交差を超えません。ページのmediaboxが必要な場合（およびこれが異なる矩形の場合）、次のようなスニペットを使用してこれを実現できます::

en: New in v1.16.10
ja: 新機能 v1.16.10

en: PDF only: return a list of the names of annotations, widgets and links. Technically, these are the */NM* values of every PDF object found in the page's */Annots*  array.
ja: PDFのみ：アノテーション、ウィジェット、およびリンクの名前のリストを返します。技術的には、これらはページの */Annots*  配列で見つかるすべてのPDFオブジェクトの */NM* 値です。

en: New in v1.17.1
ja: 新機能 v1.17.1

en: PDF only: return a list of the :data`xref` numbers of annotations, widgets and links -- technically of all entries found in the page's */Annots*  array.
ja: PDFのみ：アノテーション、ウィジェット、およびリンクの :data:`xref` 番号のリストを返します。技術的には、これらはページの/Annots配列で見つかるすべてのエントリのxrefです。

en: a list of items *(xref, type)* where type is the annotation type. Use the type to tell apart links, fields and annotations, see :ref:`AnnotationTypes`.
ja: xref、タイプがアノテーションのタイプであるアイテム *(xref, type)* のリスト。リンク、フィールド、およびアノテーションを区別するためにタイプを使用します。:ref:`AnnotationTypes` を参照してください。

en: PDF only: return the annotation identified by *ident*. This may be its unique name (PDF `/NM` key), or its :data:`xref`.
ja: PDFのみ：*ident* で識別されるアノテーションを返します。これはその一意の名前（PDF `/NM` キー）またはxrefかもしれません。

en: the annotation name or xref.
ja: アノテーションの名前またはxref。

en: the annotation or *None*.
ja: アノテーションまたは *None*。

en: Methods :meth:`Page.annot_names`, :meth:`Page.annot_xrefs` provide lists of names or xrefs, respectively, from where an item may be picked and loaded via this method.
ja: メソッド :meth:`Page.annot_names`、:meth:`Page.annot_xrefs` は、アイテムが取得およびこのメソッドを介して読み込まれる名前またはxrefのリストを提供します。

en: New in v1.19.6
ja: 新機能 v1.19.6

en: PDF only: return the field identified by *xref*.
ja: PDFのみ：*xref* で識別されるフィールドを返します。

en: the field's xref.
ja: フィールドのxref。

en: the field or *None*.
ja: フィールドまたは *None*。

en: This is similar to the analogous method :meth:`Page.load_annot` -- except that here only the xref is supported as identifier.
ja: これはメソッド :meth:`Page.load_annot` と同様ですが、ここでは識別子としてxrefのみがサポートされています。

en: Return the first link on a page. Synonym of property :attr:`first_link`.
ja: 最初のリンクを返します。プロパティ :attr:`first_link` の同義語です。

en: first link on the page (or *None*).
ja: ページ上の最初のリンク（または *None*）。

en: PDF only: Set the rotation of the page.
ja: PDFのみ：ページの回転を設定します。

en: An integer specifying the required rotation in degrees. Must be an integer multiple of 90. Values will be converted to one of 0, 90, 180, 270.
ja: 度数で指定された必要な回転を表す整数。90の整数倍である必要があります。値は0、90、180、270のいずれかに変換されます。

en: Changed in v1.14.11: Parameter *reuse_xref* has been deprecated. Position the source rectangle centered in target rectangle. Any rotation angle is now supported.
ja: v1.14.11で変更：パラメータreuse_xrefは非推奨となりました。ソースの矩形をターゲットの矩形の中央に配置します。任意の回転角度がサポートされます。

en: Changed in v1.18.3: New parameter `oc`.
ja: v1.18.3で変更：新しいパラメータ `oc` が追加されました。

en: PDF only: Display a page of another PDF as a **vector image** (otherwise similar to :meth:`Page.insert_image`). This is a multi-purpose method. For example, you can use it to
ja: PDFのみ：別のPDFのページをベクトルイメージとして表示します（それ以外は :meth:`Page.insert_image` に類似）。これは多目的なメソッドです。たとえば、次のようなことに使用できます。

en: create "n-up" versions of existing PDF files, combining several input pages into **one output page** (see example `combine.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/combine-pages/combine.py>`_),
ja: 既存のPDFファイルの「n-up」バージョンを作成し、複数の入力ページを1つの出力ページに結合します（例： `combine.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/combine-pages/combine.py>`_ を参照）。

en: create "posterized" PDF files, i.e. every input page is split up in parts which each create a separate output page (see `posterize.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/posterize-document/posterize.py>`_),
ja: 「ポスター化」されたPDFファイルを作成します。つまり、各入力ページは別々の出力ページを作成する部分に分割されます（`posterize.py <https://github.com/pymupdf/PyMuPDF-Utilities/blob/master/examples/posterize-document/posterize.py>`_ を参照）。

en: include PDF-based vector images like company logos, watermarks, etc., see `svg-logo.py <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/examples/svg-logo.py>`_, which puts an SVG-based logo on each page (requires additional packages to deal with SVG-to-PDF conversions).
ja: 企業のロゴ、透かし画像など、PDFベースのベクトル画像を含めます。`svg-logo.py <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/examples/svg-logo.py>`_ は、各ページにSVGベースのロゴを配置します（SVGからPDFへの変換を処理するために追加のパッケージが必要です）。

en: where to place the image on current page. Must be finite and its intersection with the page must not be empty.
ja: 現在のページに画像を配置する場所。有限である必要があり、ページとの交差部分が空でない必要があります。

en: source PDF document containing the page. Must be a different document object, but may be the same file.
ja: ページを含むソースPDFドキュメント。異なるドキュメントオブジェクトである必要がありますが、同じファイルであることもあります。

en: page number (0-based, in `-∞ < pno < docsrc.page_count`) to be shown.
ja: 表示するページ番号（0から始まる、`-∞ < pno < docsrc.page_count`）。指定されたページ。

en: whether to maintain the width-height-ratio (default). If false, all 4 corners are always positioned on the border of the target rectangle -- whatever the rotation value. In general, this will deliver distorted and /or non-rectangular images.
ja: 幅高さ比率を維持するかどうか（デフォルト）。falseの場合、4つの角は常にターゲット矩形の境界に配置されます（回転値に関係なく）。一般的に、これは歪んだおよび/または非四角形の画像を提供します。

en: put image in foreground (default) or background.
ja: 画像を前景（デフォルト）または背景に配置します。

en: *(new in v1.18.3)* (:data:`xref`) make visibility dependent on this :data:`OCG` / :data:`OCMD` (which must be defined in the target PDF) [#f9]_.
ja: *(v1.18.3で新機能)* （:data:`xref`）この :data:`OCG` / :data:`OCMD` （ターゲットPDFで定義されている必要があります）に依存する可視性を作成します [#f9]_。

en: *(new in v1.14.10)* show the source rectangle rotated by some angle. *Changed in v1.14.11:* Any angle is now supported.
ja: *(v1.14.10で新機能)* ソースの矩形を一定の角度で表示します

en: choose which part of the source page to show. Default is the full page, else must be finite and its intersection with the source page must not be empty.
ja: 表示するソースページの一部を選択します。デフォルトはフルページですが、有限である必要があり、ソースページとの交差部分が空でない必要があります。

en: In contrast to method :meth:`Document.insert_pdf`, this method does not copy annotations, widgets or links, so these are not included in the target [#f6]_. But all its **other resources (text, images, fonts, etc.)** will be imported into the current PDF. They will therefore appear in text extractions and in :meth:`get_fonts` and :meth:`get_images` lists -- even if they are not contained in the visible area given by *clip*.
ja: メソッド :meth:`Document.insert_pdf` とは異なり、このメソッドは注釈、ウィジェット、リンクをコピーしないため、これらは対象に含まれません [#f6]_。ただし、その他のすべてのリソース（テキスト、画像、フォントなど）は現在のPDFにインポートされます。したがって、テキストの抽出と :meth:`get_fonts` および :meth:`get_images` リストに表示されます。表示領域に含まれていなくても。

en: Example: Show the same source page, rotated by 90 and by -90 degrees:
ja: 例：同じソースページを90度と-90度回転して表示します。

en: PDF only: Create a new :ref:`Shape` object for the page.
ja: PDFのみ：ページ用の新しい :ref:`Shape`  オブジェクトを作成します。

en: a new :ref:`Shape` to use for compound drawings. See description there.
ja: 複合描画に使用する新しい :ref:`Shape` オブジェクト。詳細はそちらの説明を参照してください。

en: Changed in v1.18.2: added `clip` parameter. Remove `hit_max` parameter. Add default "dehyphenate".
ja: v1.18.2で変更：`clip` パラメータを追加。`hit_max`  パラメータを削除。デフォルトの「デハイフェネート」を追加。

en: Changed in v1.19.0: added `textpage` parameter.
ja: v1.19.0で変更：`textpage`  パラメータを追加。

en: Search for *needle* on a page. Wrapper for :meth:`TextPage.search`.
ja: ページ上で *needle* を検索します。:meth:`TextPage.search` のラッパーです。

en: Text to search for. May contain spaces. Upper / lower case is ignored, but only works for ASCII characters: For example, "COMPÉTENCES" will not be found if needle is "compétences" -- "compÉtences" however will. Similar is true for German umlauts and the like.
ja: 検索対象のテキスト。スペースを含めることができます。大文字/小文字は無視されますが、ASCII文字に対してのみ機能します：たとえば、needleが「COMPÉTENCES」の場合、needleが「compétences」の場合には見つかりません。「compÉtences」の場合は見つかります。同様に、ドイツ語のウムラウトなどにも当てはまります。

en: *(New in v1.18.2)* only search within this area.
ja: *(v1.18.2で新規追加)* この領域内でのみ検索します。

en: Return object type :ref:`Quad` instead of :ref:`Rect`.
ja: 四角形の代わりに :ref:`Quad` オブジェクトのタイプを返します。

en: Control the data extracted by the underlying :ref:`TextPage`. By default, ligatures and white spaces are kept, and hyphenation [#f8]_ is detected.
ja: 基本となる :ref:`TextPage` によって抽出されるデータを制御します。デフォルトでは、リガチャと空白を保持し、ハイフン化 [#f8]_ が検出されます。

en: (new in v1.19.0) use a previously created :ref:`TextPage`. This reduces execution time **significantly.** If specified, the 'flags' and 'clip' arguments are ignored. If omitted, a temporary textpage will be created.
ja: (v1.19.0で新規追加) 以前に作成した :ref:`TextPage` を使用します。これにより、実行時間が大幅に短縮されます。指定した場合、「flags」と「clip」引数は無視されます。省略した場合、一時的なテキストページが作成されます。

en: A list of :ref:`Rect` or  :ref:`Quad` objects, each of which  -- **normally!** -- surrounds one occurrence of *needle*. **However:** if parts of *needle* occur on more than one line, then a separate item is generated for each these parts. So, if `needle = "search string"`, two rectangles may be generated.
ja: :ref:`Rect` または :ref:`Quad` オブジェクトのリストで、通常、needleの一致を1つ囲みます。ただし、needleの一部が複数の行にまたがる場合、それぞれの部分に対して別のアイテムが生成されます。したがって、`needle = "search string"` の場合、2つの四角形が生成される可能性があります。

en: **Changes in v1.18.2:**
ja: **v1.18.2の変更点：**

en: There no longer is a limit on the list length (removal of the `hit_max` parameter).
ja: リストの長さに制限はもうありません（`hit_max` パラメータの削除）。

en: If a word is **hyphenated** at a line break, it will still be found. E.g. the needle "method" will be found even if hyphenated as "meth-od" at a line break, and two rectangles will be returned: one surrounding "meth" (without the hyphen) and another one surrounding "od".
ja: 単語が行の区切りでハイフン化されている場合でも、検出されます。たとえば、needleが行の区切りで「meth-od」としてハイフン化されていても、「method」としてハイフン化されていない部分を囲む1つの四角形と、「od」としてハイフン化されていない部分を囲む別の四角形が返されます。

en: The method supports multi-line text marker annotations: you can use the full returned list as **one single** parameter for creating the annotation.
ja: このメソッドは、複数行のテキストマーカーアノテーションをサポートしており、返されたリスト全体を1つのパラメータとして使用してアノテーションを作成できます。

en: There is a tricky aspect: the search logic regards **contiguous multiple occurrences** of *needle* as one: assuming *needle* is "abc", and the page contains "abc" and "abcabc", then only **two** rectangles will be returned, one for "abc", and a second one for "abcabc".
ja: トリッキーな側面があります。検索ロジックは、連続した複数の *needle* の出現を1つと見なします。つまり、*needle*  が「abc」で、ページに「abc」と「abcabc」が含まれている場合、2つの矩形のみが返され、1つは「abc」に、もう1つは「abcabc」になります。

en: You can always use :meth:`Page.get_textbox` to check what text actually is being surrounded by each rectangle.
ja: 常に :meth:`Page.get_textbox` を使用して、各矩形で実際に囲まれているテキストを確認できます。

en: A feature repeatedly asked for is supporting **regular expressions** when specifying the `"needle"` string: **There is no way to do this.** If you need something in that direction, first extract text in the desired format and then subselect the result by matching with some regex pattern. Here is an example for matching words::
ja: `"needle"` 文字列を指定する際に正規表現をサポートする機能が何度も要求されていますが、これを行う方法はありません。この方向性の何かが必要な場合は、まず希望の形式でテキストを抽出し、それを正規表現パターンと一致させて結果をサブセレクトしてください。単語を一致させる例を以下に示します。

en: The `matches` list will contain the words matching the given pattern. In the same way you can select `span["text"]` from the output of `page.get_text("dict")`.
ja: `matches`  リストには、指定されたパターンに一致する単語が含まれます。同様の方法で、`page.get_text("dict")` の出力から `span["text"]` を選択できます。

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

en: Changed in v1.19.4: remove all other rectangle definitions.
ja: v1.19.4で変更: 他のすべての矩形定義を削除しました。

en: PDF only: Change the physical page dimension by setting :data:`mediabox` in the page's object definition.
ja: PDFのみ: ページのオブジェクト定義内で :data:`mediabox` を設定することにより、物理ページの寸法を変更します。

en: the new :data:`mediabox` value.
ja: 新しい :data:`mediabox` の値。

en: This method also removes the page's other (optional) rectangles (:data:`cropbox`, ArtBox, TrimBox and Bleedbox) to prevent inconsistent situations. This will cause those to assume their default values.
ja: このメソッドは、ページの他の（オプションの）矩形（:data:`cropbox`、ArtBox、TrimBox、Bleedbox）も削除し、一貫性のない状況を防ぐためにそれらをデフォルト値に戻します。

en: For non-empty pages this may have undesired effects, because the location of all content depends on this value and will therefore change position or even disappear.
ja: これにより、非空のページでは望ましくない効果が発生する可能性があるため、すべてのコンテンツの位置がこの値に依存し、したがって位置が変わるか、完全に消える可能性があります。

en: PDF only: change the visible part of the page.
ja: PDFのみ: ページの表示領域を変更します。

en: the new visible area of the page. Note that this **must** be specified in **unrotated coordinates**, not empty, nor infinite and be completely contained in the :attr:`Page.mediabox`.
ja: ページの新しい表示領域。これは回転していない座標で指定する必要があり、空ではなく、無限ではなく、:attr:`Page.mediabox` に完全に含まれている必要があります。

en: After execution **(if the page is not rotated)**, :attr:`Page.rect` will equal this rectangle, but be shifted to the top-left position (0, 0) if necessary. Example session:
ja: 実行後（ページが回転していない場合）、:attr:`Page.rect`  はこの矩形と等しくなりますが、必要に応じて左上の位置（0、0）にシフトされます。以下は例セッションです：

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

en: PDF only: Set the resp. rectangle in the page object. For the meaning of these objects see :ref:`AdobeManual`, page 77. Parameter and restrictions are the same as for :meth:`Page.set_cropbox`.
ja: PDFのみ: ページオブジェクト内の対応する矩形を設定します。これらのオブジェクトの意味については、:ref:`AdobeManual` の77ページを参照してください。パラメータと制約は :meth:`Page.set_cropbox` と同じです。

en: Contains the rotation of the page in degrees (always 0 for non-PDF types).
ja: ページの回転角度を度数で含みます（非PDFタイプでは常に0）。

en: Contains the top-left point of the page's `/CropBox` for a PDF, otherwise *Point(0, 0)*.
ja: PDFの場合、ページの `/CropBox` の左上の点を含みます。それ以外の場合は *Point(0, 0)*。

en: The page's `/CropBox` for a PDF. Always the **unrotated** page rectangle is returned. For a non-PDF this will always equal the page rectangle.
ja: PDFのページの `/CropBox`  です。常に **回転していない** ページの矩形が返されます。非PDFの場合、これは常にページの矩形と等しいです。

en: In PDF, the relationship between `/MediaBox`, `/CropBox` and page rectangle may sometimes be confusing, please do lookup the glossary for :data:`MediaBox`.
ja: PDFでは、`/MediaBox`、`/CropBox`、およびページの矩形の関係は混乱することがあります。:data:`MediaBox` の用語集を参照してください。

en: The page's `/ArtBox`, `/BleedBox`, `/TrimBox`, respectively. If not provided, defaulting to :attr:`Page.cropbox`.
ja: PDFのページの/ArtBox、/BleedBox、/TrimBoxです。指定されていない場合、:attr:`Page.cropbox` にデフォルトで設定されます。

en: Contains the width and height of the page's :attr:`Page.mediabox` for a PDF, otherwise the bottom-right coordinates of :attr:`Page.rect`.
ja: PDFのページの :attr:`Page.mediabox` の幅と高さを含みます。それ以外の場合、:attr:`Page.rect` の右下の座標です。

en: The page's :data:`mediabox` for a PDF, otherwise :attr:`Page.rect`.
ja: PDFのページの :data:`mediabox`、それ以外の場合は :attr:`Page.rect` です。

en: For most PDF documents and for **all other document types**, `page.rect == page.cropbox == page.mediabox` is true. However, for some PDFs the visible page is a true subset of :data:`mediabox`. Also, if the page is rotated, its `Page.rect` may not equal `Page.cropbox`. In these cases the above attributes help to correctly locate page elements.
ja: ほとんどのPDF文書および他のすべてのドキュメントタイプに対して、`page.rect == page.cropbox == page.mediabox` が真です。ただし、一部のPDFでは、表示ページが v の真の部分集合である場合があります。また、ページが回転している場合、`Page.rect` は `Page.cropbox` と等しくないかもしれません。これらの場合、上記の属性はページの要素を正しく位置付けるのに役立ちます。

en: This matrix translates coordinates from the PDF space to the MuPDF space. For example, in PDF `/Rect [x0 y0 x1 y1]` the pair (x0, y0) specifies the **bottom-left** point of the rectangle -- in contrast to MuPDF's system, where (x0, y0) specify top-left. Multiplying the PDF coordinates with this matrix will deliver the (Py-) MuPDF rectangle version. Obviously, the inverse matrix will again yield the PDF rectangle.
ja: この行列は、PDF空間からMuPDF空間への座標の変換に使用されます。たとえば、PDFの `/Rect [x0 y0 x1 y1]` では、ペア(x0、y0)が矩形の左下の点を指定します。これはMuPDFのシステムとは異なり、ここでは(x0、y0)は左上を指定します。PDF座標をこの行列で掛け算すると、（Py-）MuPDF矩形バージョンが得られます。明らかに、逆行列は再びPDF矩形を返します。

en: These matrices may be used for dealing with rotated PDF pages. When adding / inserting anything to a PDF page, the coordinates of the **unrotated** page are always used. These matrices help translating between the two states. Example: if a page is rotated by 90 degrees -- what would then be the coordinates of the top-left Point(0, 0) of an A4 page?
ja: これらの行列は、回転したPDFページの取り扱いに使用できます。PDFページに何かを追加/挿入する際、**回転していない** ページの座標が常に使用されます。これらの行列は、2つの状態間での変換を支援します。例：ページが90度回転した場合、A4ページの左上のPoint(0, 0)の座標は何になりますか？

en: Contains the first :ref:`Link` of a page (or *None*).
ja: ページの最初の :ref:`Link` を含みます（または *None*）。

en: Contains the first :ref:`Annot` of a page (or *None*).
ja: ページの最初の :ref:`Annot` を含みます（または *None*）。

en: Contains the first :ref:`Widget` of a page (or *None*).
ja: ページの最初の :ref:`Widget` を含みます（または *None*）。

en: The page number.
ja: ページ番号。

en: The owning document object.
ja: 所属するドキュメントオブジェクト。

en: Contains the rectangle of the page. Same as result of :meth:`Page.bound()`.
ja: ページの矩形を含みます。:meth:`Page.bound()` の結果と同じです。

en: The page's PDF :data:`xref`. Zero if not a PDF.
ja: ページのPDF :data:`xref`。PDFでない場合はゼロです。

en: Description of *get_links()* Entries
ja: *get_links()* エントリの説明

en: Each entry of the :meth:`Page.get_links` list is a dictionary with the following keys:
ja: :meth:`Page.get_links` リストの各エントリは、以下のキーを持つ辞書です：

en: *kind*:  (required) an integer indicating the kind of link. This is one of *LINK_NONE*, *LINK_GOTO*, *LINK_GOTOR*, *LINK_LAUNCH*, or *LINK_URI*. For values and meaning of these names refer to :ref:`linkDest Kinds`.
ja: *kind*：（必須）リンクの種類を示す整数。*LINK_NONE*、*LINK_GOTO*、*LINK_GOTOR*、*LINK_LAUNCH*、または *LINK_URI* のいずれかです。

en: *from*:  (required) a :ref:`Rect` describing the "hot spot" location on the page's visible representation (where the cursor changes to a hand image, usually).
ja: *from*：（必須）ページの可視な表現上の「ホットスポット」の場所を示す :ref:`Rect` （通常、カーソルが手のイメージに変わる場所です）。

en: *page*:  a 0-based integer indicating the destination page. Required for *LINK_GOTO* and *LINK_GOTOR*, else ignored.
ja: page：宛先ページを示す0ベースの整数。*LINK_GOTO*および *LINK_GOTOR* の場合に必要ですが、それ以外の場合は無視されます。

en: *to*:   either a *fitz.Point*, specifying the destination location on the provided page, default is *fitz.Point(0, 0)*, or a symbolic (indirect) name. If an indirect name is specified, *page = -1* is required and the name must be defined in the PDF in order for this to work. Required for *LINK_GOTO* and *LINK_GOTOR*, else ignored.
ja: *to*：宛先ページ上の宛先場所を指定する *fitz.Point*、デフォルトは *fitz.Point(0, 0)*、またはシンボリック（間接）名です。間接名が指定された場合、*page = -1* が必要で、名前はPDFで定義されている必要があります。*LINK_GOTO* および *LINK_GOTOR* の場合に必要ですが、それ以外の場合は無視されます。

en: *file*: a string specifying the destination file. Required for *LINK_GOTOR* and *LINK_LAUNCH*, else ignored.
ja: file：宛先ファイルを指定する文字列。LINK_GOTORおよびLINK_LAUNCHの場合に必要ですが、それ以外の場合は無視されます。

en: *uri*:  a string specifying the destination internet resource. Required for *LINK_URI*, else ignored. You should make sure to start this string with an unambiguous substring, that classifies the subtype of the URL, like `"http://"`, `"https://"`, `"file://"`, `"ftp://"`, `"mailto:"`, etc. Otherwise your browser will try to interpret the text and come to unwanted / unexpected conclusions about the intended URL type.
ja: *uri*: LINK_URI用に指定された、インターネットリソースの宛先を示す文字列。*LINK_URI* の場合に必要で、それ以外の場合は無視されます。この文字列は、`"http://"`、`"https://"`、`"file://"`、`"ftp://"`、`"mailto:"` など、URLのサブタイプを識別する明確なサブストリングで始めるようにしてください。そうしないと、ブラウザがテキストを解釈し、意図しない/予期しない結論に達する可能性があります。

en: *xref*: an integer specifying the PDF :data:`xref` of the link object. Do not change this entry in any way. Required for link deletion and update, otherwise ignored. For non-PDF documents, this entry contains *-1*. It is also *-1* for **all** entries in the *get_links()* list, if **any** of the links is not supported by MuPDF - see the note below.
ja: *xref*: リンクオブジェクトのPDF :data:`xref` を指定する整数。このエントリを何らかの方法で変更しないでください。リンクの削除と更新に必要で、それ以外の場合は無視されます。非PDFドキュメントの場合、このエントリには *-1* が含まれます。また、MuPDFがサポートしていないリンクがある場合、*get_links()*  リストのすべてのエントリに対しても-1になります。詳細については以下の注釈を参照してください。

en: Notes on Supporting Links
ja: リンクのサポートに関する注記

en: MuPDF's support for links has changed in **v1.10a**. These changes affect link types :data:`LINK_GOTO` and :data:`LINK_GOTOR`.
ja: **v1.10a** 以降、MuPDFのリンクサポートが変更されました。これらの変更は :data:`LINK_GOTO` および :data:`LINK_GOTOR` というリンクタイプに影響を与えます。

en: Reading (pertains to method *get_links()* and the *first_link* property chain)
ja: 読み取り *get_links()* メソッドおよび*first_link* プロパティチェーンに関連）

en: If MuPDF detects a link to another file, it will supply either a *LINK_GOTOR* or a *LINK_LAUNCH* link kind. In case of *LINK_GOTOR* destination details may either be given as page number (eventually including position information), or as an indirect destination.
ja: MuPDFが別のファイルへのリンクを検出する場合、*LINK_GOTOR* または *LINK_LAUNCH* リンクの種類を提供します。*LINK_GOTOR* の場合、宛先の詳細はページ番号（位置情報を含むことがある）または間接的な宛先として指定できます。

en: If an indirect destination is given, then this is indicated by *page = -1*, and *link.dest.dest* will contain this name. The dictionaries in the *get_links()* list will contain this information as the *to* value.
ja: 間接的な宛先が指定された場合、page = -1で示され、*link.dest.dest* にこの名前が含まれます。 *get_links()* リスト内の辞書には、この情報がto値として含まれます。

en: **Internal links are always** of kind *LINK_GOTO*. If an internal link specifies an indirect destination, it **will always be resolved** and the resulting direct destination will be returned. Names are **never returned for internal links**, and undefined destinations will cause the link to be ignored.
ja: 内部リンクは常にLINK_GOTOの種類です。内部リンクが間接的な宛先を指定した場合、常に解決され、結果の直接的な宛先が返されます。内部リンクには名前は返されず、未定義の宛先はリンクが無視される原因になります。

en: Writing
ja: 書き込み

en: PyMuPDF writes (updates, inserts) links by constructing and writing the appropriate PDF object **source**. This makes it possible to specify indirect destinations for *LINK_GOTOR* **and** *LINK_GOTO* link kinds (pre *PDF 1.2* file formats are **not supported**).
ja: PyMuPDFはリンクを構築して適切なPDFオブジェクト **ソース** を書き込むことにより、リンクを書き込み（更新、挿入）します。これにより、 *LINK_GOTOR* および *LINK_GOTO* リンク種別に対して間接的な宛先を指定できます（**PDF 1.2** ファイル形式以前はサポートされていません）。

en: If a *LINK_GOTO* indirect destination specifies an undefined name, this link can later on not be found / read again with MuPDF / PyMuPDF. Other readers however **will** detect it, but flag it as erroneous.
ja: *LINK_GOTO* の間接的な宛先が未定義の名前を指定した場合、このリンクは後でMuPDF / PyMuPDFで再び見つけることはできません。ただし、他のリーダーはそれを検出し、エラーとしてフラグ付けます。

en: Indirect *LINK_GOTOR* destinations can in general of course not be checked for validity and are therefore **always accepted**.
ja: 一般的な注意: 間接的な *LINK_GOTOR* の宛先は一般的に有効性を確認できないため、常に受け入れられます。

en: **Example: How to insert a link pointing to another page in the same document**
ja: **例: 同じドキュメント内の別のページを指すリンクを挿入する方法**

en: Determine the rectangle on the current page, where the link should be placed. This may be the bbox of an image or some text.
ja: リンクを配置する現在のページの矩形を決定します。これは画像または一部のテキストのbboxである場合があります。

en: Determine the target page number ("pno", 0-based) and a :ref:`Point` on it, where the link should be directed to.
ja: ターゲットページ番号（0から始まる）と、リンクを指定するためのそのページ上の :ref:`Point` を決定します。

en: Create a dictionary `d = {"kind": fitz.LINK_GOTO, "page": pno, "from": bbox, "to": point}`.
ja: 辞書d = {"kind": fitz.LINK_GOTO, "page": pno, "from": bbox, "to": point}を作成します。

en: Execute `page.insert_link(d)`.
ja: page.insert_link(d)を実行します。

en: Homologous Methods of :ref:`Document` and :ref:`Page`
ja: :ref:`Document` と :ref:`Page` の同様のメソッドに関する説明です。

en: This is an overview of homologous methods on the :ref:`Document` and on the :ref:`Page` level.
ja: これは、:ref:`Document` と :ref:`Page` レベルでの同様のメソッドの概要です。

en: **Document Level**
ja: **Document Level（ドキュメントレベル）**

en: **Page Level**
ja: **Page Level（ページレベル）**

en: The page number "pno" is a 0-based integer `-∞ < pno < page_count`.
ja: ページ番号「pno」は0から始まる整数であり、`-∞ < pno < page_count` です。

en: Most document methods (left column) exist for convenience reasons, and are just wrappers for: *Document[pno].<page method>*. So they **load and discard the page** on each execution.
ja: 多くのドキュメントメソッド（左側の列）は利便性のために存在し、*Document[pno].<page method>* のラッパーであるだけで、各実行でページを読み込んで破棄します。

en: However, the first two methods work differently. They only need a page's object definition statement - the page itself will **not** be loaded. So e.g. :meth:`Page.get_fonts` is a wrapper the other way round and defined as follows: *page.get_fonts == page.parent.get_page_fonts(page.number)*.
ja: ただし、最初の2つのメソッドは異なる方法で動作します。これらはページのオブジェクト定義ステートメントだけを必要とし、ページ自体は読み込まれません。例えば、:meth:`Page.get_fonts` は逆に定義され、次のようになります: *page.get_fonts == page.parent.get_page_fonts(page.number)*。

en: Footnotes
ja: 脚注

en: If your existing code already uses the installed base name as a font reference (as it was supported by PyMuPDF versions earlier than 1.14), this will continue to work.
ja: 既存のコードがフォントの参照としてインストール済みのベース名を使用している場合（これはPyMuPDFバージョン1.14以前でサポートされていました）、これは引き続き機能します。

en: Not all PDF reader software (including internet browsers and office software) display all of these fonts. And if they do, the difference between the **serifed** and the **non-serifed** version may hardly be noticeable. But serifed and non-serifed versions lead to different installed base fonts, thus providing an option to be displayable with your specific PDF viewer.
ja: PDFリーダーソフトウェア（インターネットブラウザやオフィスソフトウェアを含む）がすべてのこれらのフォントを表示するわけではありません。そして、表示されても、セリフ付きとセリフなしバージョンの違いはほとんど気付かれないかもしれません。ただし、セリフ付きとセリフなしバージョンは異なるインストール済みベースのフォントにリードするため、特定のPDFビューアで表示可能なオプションが提供されます。

en: Not all PDF readers display these fonts at all. Some others do, but use a wrong character spacing, etc.
ja: すべてのPDFリーダーがこれらのフォントを表示するわけではありません。一部の他のソフトウェアは表示するかもしれませんが、文字間隔が間違っているなどの問題が発生する場合があります。

en: You are generally free to choose any of the :ref:`mupdficons` you consider adequate.
ja: 適切と思われるMuPDFの注釈アイコンのいずれを選択することは自由です。

en: The previous algorithm caused images to be **shrunk** to this intersection. Now the image can be anywhere on :attr:`Page.mediabox`, potentially being invisible or only partially visible if the cropbox (representing the visible page part) is smaller.
ja: 以前のアルゴリズムでは、画像がこの交差点に縮小されることがありました。今では画像は　:attr:`Page.mediabox` のどこにでも配置でき、cropbox（表示ページ部分を表す）が小さい場合、画像は見えないか部分的にしか見えない可能性があります。

en: If you need to also see annotations or fields in the target page, you can try and convert the source PDF to another PDF using :meth:`Document.convert_to_pdf`. The underlying MuPDF function of that method will convert these objects to normal page content. Then use :meth:`Page.show_pdf_page` with the converted PDF page.
ja: ターゲットページで注釈やフィールドも表示する必要がある場合、ソースPDFを別のPDFに変換して :meth:`Document.convert_to_pdf` を使用してみることができます。そのメソッドの基本となるMuPDFの機能は、これらのオブジェクトを通常のページコンテンツに変換します。その後、変換されたPDFページを使用して　:meth:`Page.show_pdf_page` を使用します。

en: In PDF, an area enclosed by some lines or curves can have a property called "orientation". This is significant for switching on or off the fill color of that area when there exist multiple area overlaps - see discussion in method :meth:`Shape.finish` using the "non-zero winding number" rule. While orientation of curves, quads, triangles and other shapes enclosed by lines always was detectable, this has been impossible for "re" (rectangle) items in the past. Adding the orientation parameter now delivers the missing information.
ja: PDFにおいて、いくつかの線や曲線で囲まれた領域は、「方向性（orientation）」と呼ばれるプロパティを持つことがあります。これは、複数の領域が重なる場合にその領域の塗りつぶし色をオンまたはオフに切り替える際に重要です。この方向性は「非ゼロの巡回数（non-zero winding number）ルール」を使用した :meth:`Shape.finish` メソッドの議論で詳しく説明されています。曲線、四角形、三角形などの線で囲まれた形状の方向性は常に検出可能でしたが、これまでは「re」（長方形）アイテムに対しては不可能でした。orientationパラメータを追加することで、この不足していた情報を提供できるようになりました。

en: Hyphenation detection simply means that if the last character of a line is "-", it will be assumed to be a continuation character. That character will not be found by text searching with its default flag setting. Please take note, that a MuPDF *line* may not always be what you expect: words separated by overly large gaps (e.g. caused by text justification) may constitute separate MuPDF lines. If then any of these words ends with a hyphen, it will only be found by text searching if hyphenation is switched off.
ja: ハイフネーション検出とは、行の最後の文字が「-」である場合、それが連続文字であると仮定することを意味します。この文字は、デフォルトのフラグ設定を使用してテキスト検索されないでしょう。MuPDFの行が常に期待どおりであるわけではないことに注意してください：文字の間隔が非常に大きい（テキストの正当化によって引き起こされる場合など）、単語が別々のMuPDFの　*line* を構成する可能性があります。その後、これらの単語のいずれかがハイフンで終わる場合、ハイフネーションがオフになっていない限り、テキスト検索でのみ見つかるでしょう。

en: Objects inside the source page, like images, text or drawings, are never aware of whether their owning page now is under OC control inside the target PDF. If source page objects are OC-controlled in the source PDF, then this will not be retained on the target: they will become unconditionally visible.
ja: ソースページ内のオブジェクト、例えば画像、テキスト、または図面などは、所有ページがターゲットPDF内でOC（オプションコンテンツ）制御下にあるかどうかを認識することは決してありません。ソースページのオブジェクトがソースPDF内でOCに制御されている場合、これはターゲットに保持されないため、それらは無条件に表示されます。
