PyMuPDF 1.23.0rc1 - en to ja translation catalogue (260 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: Functions
ja: 関数

en: The following are miscellaneous functions and attributes on a fairly low-level technical detail.
ja: 以下は、PDFに関する低レベルな技術的詳細に関するさまざまな関数と属性です。

en: Some functions provide detail access to PDF structures. Others are stripped-down, high performance versions of other functions which provide more information.
ja: 一部の関数は、PDF構造への詳細なアクセスを提供します。他の関数の高性能バージョンで、より多くの情報を提供する関数から派生しています。

en: Yet others are handy, general-purpose utilities.
ja: また、その他にも便利な汎用ユーティリティが含まれています。

en: **Function**
ja: **関数**

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

en: PDF only: bbox of the appearance object
ja: PDFのみ：外観オブジェクトのバウンディングボックス

en: PDF only: the matrix of the appearance object
ja: PDFのみ：外観オブジェクトの行列

en: check whether contents wrapping is present
ja: コンテンツの折り返しが存在するかどうかを確認します

en: list of glyph names defined in **Adobe Glyph List**
ja: **Adobe Glyph List** で定義されたグリフ名のリスト

en: list of unicodes defined in **Adobe Glyph List**
ja: **Adobe Glyph List** で定義されたUnicodeのリスト

en: PDF only: clean the annot's :data:`contents` object
ja: PDFのみ：アノテーションの :data:`contents` オブジェクトをクリーンアップ

en: PDF only: set the bbox of the appearance object
ja: PDFのみ：外観オブジェクトのバウンディングボックスを設定

en: PDF only: set the matrix of the appearance object
ja: PDFのみ：外観オブジェクトの行列を設定

en: return header string for *get_text* methods
ja: *get_text* メソッド用のヘッダー文字列を返す

en: return trailer string for *get_text* methods
ja: *get_text* メソッド用のトレーラー文字列を返す

en: PDF only: remove XML metadata
ja: PDFのみ：XMLメタデータを削除

en: PDF only: return a list of glyph widths of a font
ja: PDFのみ：フォントのグリフ幅のリストを返す

en: PDF only: create and return a new :data:`xref` entry
ja: PDFのみ：新しい :data:`xref` エントリを作成して返す

en: PDF only: check whether an :data:`xref` is a stream object
ja: PDFのみ：:data:`xref` がストリームオブジェクトであるかどうかを確認

en: PDF only: return XML metadata :data:`xref` number
ja: PDFのみ：XMLメタデータの :data:`xref` 番号を返す

en: PDF only: return length of :data:`xref` table
ja: PDFのみ：:data:`xref` テーブルの長さを返す

en: return the (standard) empty / invalid rectangle
ja: 標準の空の/無効な矩形を返す

en: return the (standard) empty / invalid quad
ja: 標準の空の/無効な四角形を返す

en: return the current timestamp in PDF format
ja: 現在のタイムスタンプをPDF形式で返す

en: return PDF-compatible string
ja: PDF互換の文字列を返す

en: return string length for a given font & :data:`fontsize`
ja: 指定したフォントと :data:`fontsize` の文字列長を返す

en: return unicode from a glyph name
ja: グリフ名からUnicodeを返す

en: return a dictionary of basic image properties
ja: 基本的な画像プロパティの辞書を返します。

en: return the (only existing) infinite rectangle
ja: （唯一存在する）無限の矩形を返します。

en: return the (only existing) infinite quad
ja: （唯一存在する）無限のクワッドを返します。

en: split rectangle in sub-rectangles
ja: 矩形をサブ矩形に分割します。

en: PDF only: clean the page's :data:`contents` objects
ja: PDF のみ：ページの :data:`contents` オブジェクトをクリーンアップします

en: list of rectangles that envelop text, drawing or image objects
ja: テキスト、描画、または画像オブジェクトを囲む矩形のリストです。

en: PDF only: return a list of content :data:`xref` numbers
ja: PDF のみ：コンテンツ :data:`xref` 番号のリストを返します。

en: create the page's display list
ja: ページの表示リストを作成します。

en: extract text blocks as a Python list
ja: テキスト ブロックを Python リストとして抽出します。

en: extract text words as a Python list
ja: テキストワードを Python リストとして抽出します。

en: low-level text information
ja: 低レベルのテキスト情報です。

en: PDF only: get complete, concatenated /Contents source
ja: PDF のみ：完全な連結 /Contents ソースを取得します。

en: run a page through a device
ja: ページをデバイスを介して実行します。

en: PDF only: set page's :data:`contents` to some :data:`xref`
ja: PDF のみ：ページの :data:`contents` を特定の :data:`xref` に設定します。

en: wrap contents with stacking commands
ja: スタッキング コマンドでコンテンツをラップします。

en: create CSS source for a font in package pymupdf_fonts
ja: パッケージ pymupdf_fonts のフォント用の CSS ソースを作成します。

en: return rectangle for a known paper format
ja: 既知の用紙形式の矩形を返します。

en: return width, height for a known paper format
ja: 既知の用紙形式の幅と高さを返します。

en: dictionary of pre-defined paper formats
ja: 事前定義の用紙形式の辞書です。

en: matrix to map a line to the x-axis
ja: 直線を x 軸にマップする行列です。

en: compute the quad of a char ("rawdict")
ja: 文字のクワッドを計算します（"rawdict"）。

en: compute the quad of a subset of line spans
ja: ラインスパンのサブセットのクワッドを計算します

en: compute the quad of a span ("dict", "rawdict")
ja: スパンのクワッドを計算する ("dict", "rawdict")

en: compute the quad of a subset of span characters
ja: 行スパンのサブセットのクワッドを計算します。

en: return PDF RGB color tuple from an sRGB integer
ja: sRGB 整数から PDF RGB カラー タプルを返します。

en: return (R, G, B) color tuple from an sRGB integer
ja: sRGB 整数から (R、G、B) カラー タプルを返します。

en: return glyph name from a unicode
ja: Unicode からグリフ名を返します。

en: locates the language support of the Tesseract-OCR installation
ja: Tesseract-OCR インストールの言語サポートを特定します。

en: dictionary of available supplement fonts
ja: 利用可能な補足フォントの辞書です。

en: a copy of `os.environ["TESSDATA_PREFIX"]`
ja: os.environ["TESSDATA_PREFIX"] のコピーです

en: dictionary of almost 500 RGB colors in PDF format.
ja: PDF 形式のほぼ 500 以上の RGB カラーの辞書です。

en: Convenience function to return width and height of a known paper format code. These values are given in pixels for the standard resolution 72 pixels = 1 inch.
ja: 既知の用紙フォーマットの幅と高さを返す便利な関数です。これらの値は、標準解像度 72 ピクセル = 1 インチのピクセル単位で指定されます。

en: Currently defined formats include **'A0'** through **'A10'**, **'B0'** through **'B10'**, **'C0'** through **'C10'**, **'Card-4x6'**, **'Card-5x7'**, **'Commercial'**, **'Executive'**, **'Invoice'**, **'Ledger'**, **'Legal'**, **'Legal-13'**, **'Letter'**, **'Monarch'** and **'Tabloid-Extra'**, each in either portrait or landscape format.
ja: 現在の定義されたフォーマットには、**‘A0’** から **‘A10’**、**‘B0’** から **‘B10’**、**‘C0’** から **‘C10’**、**‘Card-4x6’**、**‘Card-5x7’**、**‘Commercial’**、**‘Executive’**、**‘Invoice’**、**‘Ledger’**、**‘Legal’**、**‘Legal-13’**、**‘Letter’**、**‘Monarch’**、**‘Tabloid-Extra’** が含まれており、各フォーマットは縦向きまたは横向きで提供されています。

en: A format name must be supplied as a string (case **in** \sensitive), optionally suffixed with "-L" (landscape) or "-P" (portrait). No suffix defaults to portrait.
ja: フォーマット名は、文字列として指定する必要があります（大文字小文字を区別しない）。オプションで " -L"（横向き）または " -P"（縦向き）でサフィックスを付けることができます。サフィックスが指定されていない場合、デフォルトは縦向きです。

en: any format name from above in upper or lower case, like *"A4"* or *"letter-l"*.
ja: 上記のいずれかのフォーマット名を大文字または小文字で指定します。たとえば、*"A4"* または *"letter-l"* のように指定します。

en: *(width, height)* of the paper format. For an unknown format *(-1, -1)* is returned. Examples: *fitz.paper_size("A4")* returns *(595, 842)* and *fitz.paper_size("letter-l")* delivers *(792, 612)*.
ja: 用紙フォーマットの *(幅、高さ)*。不明なフォーマットの場合、(-1、-1) が返されます。例：*fitz.paper_size("A4")* は (595、842) を返し、*fitz.paper_size("letter-l")* は *(792、612)* を返します。

en: Convenience function to return a :ref:`Rect` for a known paper format.
ja: 既知の紙のフォーマットに対応する :ref:`Rect` を返す便益関数です。

en: any format name supported by :meth:`paper_size`.
ja: :meth:`paper_size` でサポートされている任意のフォーマット名。

en: *New in v1.17.4*
ja: *バージョン1.17.4で新たに追加*

en: Convenience function returning a PDF color triple (red, green, blue) for a given sRGB color integer as it occurs in :meth:`Page.get_text` dictionaries "dict" and "rawdict".
ja: :meth:`Page.get_text`  の辞書 "dict" および "rawdict" に存在する与えられた sRGB カラー整数に対して、PDF カラーのトリプル（赤、緑、青）を返す便益関数です。

en: an integer of format RRGGBB, where each color component is an integer in range(255).
ja: 各カラーコンポーネントが範囲[0, 255]の整数である RRGGBB 形式の整数。

en: a tuple (red, green, blue) with float items in interval *0 <= item <= 1* representing the same color. Example `sRGB_to_pdf(0xff0000) = (1, 0, 0)` (red).
ja: *0 <= item <= 1* の間の浮動小数点数アイテムを持つタプル（赤、緑、青）で、同じカラーを表します。例：`sRGB_to_pdf(0xff0000) = (1, 0, 0)` （赤）。

en: Convenience function returning a color (red, green, blue) for a given *sRGB* color integer.
ja: 与えられた *sRGB* カラー整数に対して、カラー（赤、緑、青）を返す便益関数です。

en: a tuple (red, green, blue) with integer items in `range(256)` representing the same color. Example `sRGB_to_pdf(0xff0000) = (255, 0, 0)` (red).
ja: 整数アイテムが `range(256)` の範囲にある、同じ色を表すタプル（赤、緑、青）。例： `sRGB_to_pdf(0xff0000) = (255, 0, 0)` （赤）

en: *New in v1.18.0*
ja: *バージョン1.18.0で新たに追加*

en: Return the unicode number of a glyph name based on the **Adobe Glyph List**.
ja: **Adobe Glyph List** に基づくグリフ名のUnicode番号を返す関数です。

en: the name of some glyph. The function is based on the `Adobe Glyph List <https://github.com/adobe-type-tools/agl-aglfn/blob/master/glyphlist.txt>`_.
ja: グリフの名前。この関数は `Adobe Glyph List <https://github.com/adobe-type-tools/agl-aglfn/blob/master/glyphlist.txt>`_ に基づいています。

en: the unicode. Invalid *name* entries return `0xfffd (65533)`.
ja: Unicode番号。無効な *name* のエントリは `0xfffd (65533)` を返します。

en: A similar functionality is provided by package `fontTools <https://pypi.org/project/fonttools/>`_ in its *agl* sub-package.
ja: 同様の機能は、`fontTools <https://pypi.org/project/fonttools/>`_ パッケージの *agl* サブパッケージで提供されています。

en: Return the glyph name of a unicode number, based on the **Adobe Glyph List**.
ja: 以下は、**Adobe Glyph List** に基づいた、Unicode番号に基づいたグリフ名を返す関数です。

en: the unicode given by e.g. `ord("ß")`. The function is based on the `Adobe Glyph List <https://github.com/adobe-type-tools/agl-aglfn/blob/master/glyphlist.txt>`_.
ja: Unicode番号、例：`ord("ß")` によって与えられます。この関数は `Adobe Glyph List <https://github.com/adobe-type-tools/agl-aglfn/blob/master/glyphlist.txt>`_ に基づいています。

en: the glyph name. E.g. `fitz.unicode_to_glyph_name(ord("Ä"))` returns `'Adieresis'`.
ja: グリフ名、例：`fitz.unicode_to_glyph_name(ord("Ä"))` は `'Adieresis'` を返します。

en: A similar functionality is provided by package `fontTools <https://pypi.org/project/fonttools/>`_: in its *agl* sub-package.
ja: 類似の機能は、`fontTools <https://pypi.org/project/fonttools/>`_ パッケージの *agl* サブパッケージで提供されています。

en: Return a list of glyph names defined in the **Adobe Glyph List**.
ja: **Adobe Glyph List** で定義されたグリフ名のリストを返します。

en: list of strings.
ja: 文字列のリスト。

en: Return a list of unicodes for there exists a glyph name in the **Adobe Glyph List**.
ja: **Adobe Glyph List** にグリフ名が存在するUnicodeのリストを返します。

en: list of integers.
ja: 整数のリスト。

en: *New in v1.21.0*
ja: *新機能 v1.21.0*

en: **Utility function for use with "Story" applications.**
ja: **"Story" アプリケーションで使用するためのユーティリティ関数。**

en: Create CSS `@font-face` items for the given fontcode in pymupdf-fonts. Creates a CSS font-family for all fonts starting with string "fontcode".
ja: 指定された "fontcode" に対して CSS `@font-face` アイテムを作成します。文字列 "fontcode" で始まるすべてのフォント用に CSS font-family を作成します。

en: The font naming convention in package pymupdf-fonts is "fontcode<sf>", where the suffix "sf" is one of "" (empty), "it"/"i", "bo"/"b" or "bi". These suffixes thus represent the regular, italic, bold or bold-italic variants of that font.
ja: パッケージ pymupdf-fonts でのフォントの命名規則は "fontcode<sf>" で、サフィックス "sf" は（空白）、"it"、"i"、"bo"、"b"、"bi" のいずれかです。したがって、これらのサフィックスは、フォントの通常の、イタリックの、太字の、太字イタリックのバリアントを表します。

en: For example, font code "notos" refers to fonts
ja: 例えば、フォントコード "notos" は以下のフォントに対応します。

en: The function creates (up to) four CSS `@font-face` definitions and collectively assigns the `font-family` name "notos" to them (or the "name" value if provided). Associated font buffers are placed / added to the provided archive.
ja: この関数は（最大で）4つの CSS `@font-face` 定義を作成し、それらに `font-family` 名 "notos"（または指定された "name" の値）を割り当てます。関連するフォントバッファは提供されたアーカイブに配置されます/追加されます。

en: To use the font in the Python API for :ref:`Story`, execute `.set_font(fontcode)` (or "name" if given). The correct font weight or style will automatically be selected as required.
ja: :ref:`Story` の Python API でフォントを使用するには、`.set_font(fontcode)`（または指定した場合は "name"）を実行します。必要に応じて正しいフォントウェイトまたはスタイルが自動的に選択されます。

en: For example to replace the "sans-serif" HTML standard (i.e. Helvetica) with the above "notos", execute the following. Whenever "sans-serif" is used (whether explicitly or implicitly), the Noto Sans fonts will be selected.
ja: たとえば、上記の "notos" で "sans-serif" HTML 標準（Helvetica）を置き換えるには、次のように実行します。"sans-serif" が使用される場合（明示的にまたは暗黙的に）、Noto Sans フォントが選択されます。

en: Expects and returns the CSS source, with the new CSS definitions appended.
ja: CSS ソースが期待されており、新しい CSS 定義が追加されています。

en: one of the font codes present in package `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_ (usually) representing the regular version of the font family.
ja: `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_ パッケージに存在するフォントファミリーの通常バージョンを表す、フォントコード。

en: any already existing CSS source, or `None`. The function will append its new definitions to this. This is the string that **must be used** as `user_css` when creating the :ref:`Story`.
ja: 既存の CSS ソース、または `None`。新しい定義はこれに追加されます。これは :ref:`Story` を作成する際に `user_css` として **使用する必要がある** 文字列です。

en: :ref:`Archive`, **mandatory**. All font binaries (i.e. up to four) found for "fontcode" will be added to the archive. This is the archive that **must be used** as `archive` when creating the :ref:`Story`.
ja: :ref:`Archive`、**必須** です。"fontcode" に対して見つかるすべてのフォントバイナリ（最大で4つ）がアーカイブに追加されます。これは :ref:`Story` を作成する際に :ref:`Archive` として**使用する必要があります** 。

en: the name under which the "fontcode" fonts should be found. If omitted, "fontcode" will be used.
ja: "fontcode" フォントが見つかる名前。省略した場合、"fontcode" が使用されます。

en: Modified CSS, with appended `@font-face` statements for each font variant of fontcode. Fontbuffers associated with "fontcode" will have been added to 'archive'. The function will automatically find up to 4 font variants. All pymupdf-fonts (that are no special purpose like math or music, etc.) have regular, bold, italic and bold-italic variants. To see currently available font codes check `fitz.fitz_fontdescriptors.keys()`. This will show something like `dict_keys(['cascadia', 'cascadiai', 'cascadiab', 'cascadiabi', 'figbo', 'figo', 'figbi', 'figit', 'fimbo', 'fimo', 'spacembo', 'spacembi', 'spacemit', 'spacemo', 'math', 'music', 'symbol1', 'symbol2', 'notosbo', 'notosbi', 'notosit', 'notos', 'ubuntu', 'ubuntubo', 'ubuntubi', 'ubuntuit', 'ubuntm', 'ubuntmbo', 'ubuntmbi', 'ubuntmit'])`.
ja: 変更された CSS。"fontcode" の各フォントバリアントに対して追加された `@font-face` ステートメントを含みます。関連する pymupdf-fonts のフォントバッファが 'archive' に追加されます。関数は最大で 4 つのフォントバリアントを自動的に見つけます。現在利用可能なフォントコードを確認するには、`fitz.fitz_fontdescriptors.keys()` を使用します。これにより、`dict_keys(['cascadia', 'cascadiai', 'cascadiab', 'cascadiabi', 'figbo', 'figo', 'figbi', 'figit', 'fimbo', 'fimo', 'spacembo', 'spacembi', 'spacemit', 'spacemo', 'math', 'music', 'symbol1', 'symbol2', 'notosbo', 'notosbi', 'notosit', 'notos', 'ubuntu', 'ubuntubo', 'ubuntubi', 'ubuntuit', 'ubuntm', 'ubuntmbo', 'ubuntmbi', 'ubuntmit'])` のようなものが表示されます。

en: Here is a complete snippet for using the "Noto Sans" font instead of "Helvetica"::
ja: 以下は "Helvetica" の代わりに "Noto Sans" フォントを使用する完全なスニペットです::

en: the rectangle to split.
ja: 分割する矩形。

en: the desired number of columns.
ja: 列の数。

en: the desired number of rows.
ja: 行の数。

en: a list of :ref:`Rect` objects of equal size, whose union equals *rect*. Here is the layout of a 3x4 table created by `cell = fitz.make_table(rect, cols=4, rows=3)`:
ja: 等しいサイズの :ref:`Rect` オブジェクトのリストで、それらの合併は元の *rect* と同じです。たとえば、`cell = fitz.make_table(rect, cols=4, rows=3)` によって作成された 3x4 のテーブルのレイアウトは次のようになります：

en: New in version 1.16.2)*
ja: *バージョン1.16.2で新たに導入されました。*

en: Return a matrix which maps the line from p1 to p2 to the x-axis such that p1 will become (0,0) and p2 a point with the same distance to (0,0).
ja: p1からp2への直線をx軸にマッピングする行列を返します。その際、p1は(0,0)になり、p2は(0,0)から同じ距離に配置されるように変換されます。

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

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

en: a matrix which combines a rotation and a translation::
ja: 回転と平行移動を組み合わせた行列::

en: A dictionary of pre-defines paper formats. Used as basis for :meth:`paper_size`.
ja: あらかじめ定義された用紙フォーマットの辞書。:meth:`paper_size` の基盤として使用されます。

en: New in v1.17.5
ja: バージョン1.17.5で新たに導入されました

en: A dictionary of usable fonts from repository `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_. Items are keyed by their reserved fontname and provide information like this::
ja: `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_ リポジトリから使用可能なフォントの辞書。アイテムは予約されたフォント名でキー付けされ、以下のような情報を提供します::

en: If `pymupdf-fonts` is not installed, the dictionary is empty.
ja: `pymupdf-fonts` がインストールされていない場合、この辞書は空です。

en: The dictionary keys can be used to define a :ref:`Font` via e.g. `font = fitz.Font("fimo")` -- just like you can do it with the builtin fonts "Helvetica" and friends.
ja: 辞書のキーは、例えば `font = fitz.Font("fimo")` のように使用してフォントを定義できます。これは、組み込みのフォント "Helvetica" やその他のフォントと同様に行うことができます。

en: New in v1.19.4
ja: バージョン1.19.4で新たに導入されました

en: Copy of `os.environ["TESSDATA_PREFIX"]` for convenient checking whether there is integrated Tesseract OCR support.
ja: 便利なチェックに使用される `os.environ["TESSDATA_PREFIX"]` のコピー

en: If this attribute is `None`, Tesseract-OCR is either not installed, or the environment variable is not set to point to Tesseract's language support folder.
ja: この属性が `None` の場合、Tesseract-OCRはインストールされていないか、環境変数がTesseractの言語サポートフォルダを指すように設定されていない可能性があります。

en: This variable is now checked before OCR functions are tried. This prevents verbose messages from MuPDF.
ja: この変数は、OCR関数が試行される前に確認されます。これにより、MuPDFから冗長なメッセージが表示されるのを防ぎます。

en: New in v1.19.6
ja: バージョン1.19.6で新たに導入されました

en: Contains about 500 RGB colors in PDF format with the color name as key. To see what is there, you can obviously look at `fitz.pdfcolor.keys()`.
ja: PDF形式の約500個のRGB色が、色の名前をキーとして含まれています。中身を確認するには、`fitz.pdfcolor.keys()` を見ることができます。

en: Examples:
ja: 例：

en: Convenience function to return the current local timestamp in PDF compatible format, e.g. *D:20170501121525-04'00'* for local datetime May 1, 2017, 12:15:25 in a timezone 4 hours westward of the UTC meridian.
ja: PDF互換の形式で現在のローカルタイムスタンプを返す便利な関数です。例: ローカルの日付と時刻が2017年5月1日12時15分25秒で、UTC子午線の西4時間のタイムゾーンにある場合、*D:20170501121525-04’00’* となります。

en: current local PDF timestamp.
ja: 現在のローカルPDFタイムスタンプ。

en: New in version 1.14.7
ja: バージョン1.14.7で新規追加

en: Calculate the length of text on output with a given **builtin** font, :data:`fontsize` and encoding.
ja: 指定された *組み込み* フォント、:data:`fontsize` 、およびエンコーディングで出力されるテキストの長さを計算します。

en: the text string.
ja: テキスト文字列。

en: the fontname. Must be one of either the :ref:`Base-14-Fonts` or the CJK fonts, identified by their "reserved" fontnames (see table in :meth:`Page.insert_font`).
ja: フォント名。:ref:`Base-14-Fonts` またはCJKフォントのいずれかでなければなりません。これらは「予約済み」フォント名で識別されます（:meth:`Page.insert_font` のテーブルを参照）。

en: the :data:`fontsize`.
ja: :data:`fontsize`。

en: the encoding to use. Besides 0 = Latin, 1 = Greek and 2 = Cyrillic (Russian) are available. Relevant for Base-14 fonts "Helvetica", "Courier" and "Times" and their variants only. Make sure to use the same value as in the corresponding text insertion.
ja: 使用するエンコーディング。0 = ラテン、1 = ギリシャ、2 = キリル文字（ロシア語）が利用可能です。ベース14フォント「Helvetica」、「Courier」、「Times」とそのバリアントにのみ関連します。対応するテキスト挿入で使用する値と同じ値を使用してください。

en: the length in points the string will have (e.g. when used in :meth:`Page.insert_text`).
ja: 文字列が持つポイント単位の長さ（たとえば、:meth:`Page.insert_text` で使用する場合）。

en: This function will only do the calculation -- it won't insert font nor text.
ja: この関数は計算のみを行います - フォントまたはテキストを挿入しません。

en: The :ref:`Font` class offers a similar method, :meth:`Font.text_length`, which supports Base-14 fonts and any font with a character map (CMap, Type 0 fonts).
ja: :ref:`Font` クラスは、Base-14フォントおよび文字マップ（CMap、Type 0フォントをサポートする任意のフォントに対応した似たようなメソッド :meth:`Font.text_length` を提供しています。

en: If you use this function to determine the required rectangle width for the (:ref:`Page` or :ref:`Shape`) *insert_textbox* methods, be aware that they calculate on a **by-character level**. Because of rounding effects, this will mostly lead to a slightly larger number: *sum([fitz.get_text_length(c) for c in text]) > fitz.get_text_length(text)*. So either (1) do the same, or (2) use something like *fitz.get_text_length(text + "'")* for your calculation.
ja: この関数を使用して（:ref:`Page` または :ref:`Shape`）*insert_textbox* メソッドの必要な矩形の幅を決定する場合、**文字単位で** 計算されることに注意してください。丸め効果のため、これはほとんどの場合、やや大きな数になります：*sum([fitz.get_text_length(c) for c in text]) > fitz.get_text_length(text)*。したがって、（1）同じことを行うか、（2）計算に *fitz.get_text_length(text + "’")* のようなものを使用してください。

en: Make a PDF-compatible string: if the text contains code points *ord(c) > 255*, then it will be converted to UTF-16BE with BOM as a hexadecimal character string enclosed in "<>" brackets like *<feff...>*. Otherwise, it will return the string enclosed in (round) brackets, replacing any characters outside the ASCII range with some special code. Also, every "(", ")" or backslash is escaped with a backslash.
ja: PDF互換の文字列を作成します。テキストに含まれる文字のコードポイントが *ord(c) > 255* の場合、それはUTF-16BEに変換され、BOMが含まれた16進数の文字列で "<>" ブラケットで囲まれます。それ以外の場合は、ASCII範囲外の文字を特別なコードで置き換えて、（丸い）カッコで囲まれた文字列が返されます。また、すべての "(", ")", またはバックスラッシュはバックスラッシュでエスケープされます。

en: the object to convert
ja: 変換するオブジェクト

en: PDF-compatible string enclosed in either *()* or *<>*.
ja: *()* または *<>* で囲まれたPDF互換の文字列。

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

en: Changed in v1.19.5: also return natural image orientation extracted from EXIF data if present.
ja: バージョン1.19.5で変更：EXIFデータから抽出した自然な画像の向きも返すように変更されました。

en: Changed in v1.22.5: always return `None` in error cases instead of an empty dictionary.
ja: バージョン1.22.5で変更：エラーケースで空の辞書ではなく、常に `None` を返すように変更されました。

en: Show important properties of an image provided as a memory area. Its main purpose is to avoid using other Python packages just to determine them.
ja: メモリ領域として提供される画像の重要なプロパティを表示します。主な目的は、これらのプロパティを決定するために他のPythonパッケージを使用しないようにすることです。

en: either an image in memory or an **opened** file. An image in memory may be any of the formats `bytes`, `bytearray` or `io.BytesIO`.
ja: メモリ内の画像または **開いた** ファイル。メモリ内の画像は、`bytes`、`bytearray`、または `io.BytesIO` 形式のいずれかです。

en: No exception is ever raised. In case of an error, `None` is returned. Otherwise, there are the following items::
ja: 例外は発生しません。エラーの場合、`None` が返されます。それ以外の場合、以下のアイテムがあります::

en: There is the following relation to **Exif** information encoded in `orientation`, and correspondingly in the `transform` matrix-like (quoted from MuPDF documentation, *ccw* = counter-clockwise):
ja: 以下は、**Exif** 情報にエンコードされた`orientation` と、対応する `transform` マトリックスの関係です（MuPDFドキュメンテーションから引用、*ccw* = 反時計回り）：

en: Undefined
ja: 未定義

en: 0 degree ccw rotation. (Exif = 1)
ja: 0度の反時計回りの回転（Exif = 1）

en: 90 degree ccw rotation. (Exif = 8)
ja: 90度の反時計回りの回転（Exif = 8）

en: 180 degree ccw rotation. (Exif = 3)
ja: 180度の反時計回りの回転（Exif = 3）

en: 270 degree ccw rotation. (Exif = 6)
ja: 270度の反時計回りの回転（Exif = 6）

en: flip on X. (Exif = 2)
ja: X軸で反転（Exif = 2）

en: flip on X, then rotate ccw by 90 degrees. (Exif = 5)
ja: X軸で反転し、さらに90度反時計回りに回転（Exif = 5）

en: flip on X, then rotate ccw by 180 degrees. (Exif = 4)
ja: X軸で反転し、さらに180度反時計回りに回転（Exif = 4）

en: flip on X, then rotate ccw by 270 degrees. (Exif = 7)
ja: X軸で反転し、さらに270度反時計回りに回転（Exif = 7）

en: For some "exotic" images (FAX encodings, RAW formats and the like), this method will not work. You can however still work with such images in PyMuPDF, e.g. by using :meth:`Document.extract_image` or create pixmaps via `Pixmap(doc, xref)`. These methods will automatically convert exotic images to the PNG format before returning results.
ja: 一部の「エキゾチック」な画像（FAXエンコーディング、RAWフォーマットなど）では、この方法は機能しない場合があります。ただし、PyMuPDFでは引き続きこのような画像を使用できます。たとえば、:meth:`Document.extract_image` を使用したり、`Pixmap(doc, xref)` を介してピクマップを作成したりできます。これらのメソッドは、結果を返す前にエキゾチックな画像を自動的にPNG形式に変換します。

en: You can also get the properties of images embedded in a PDF, via their :data:`xref`. In this case make sure to extract the raw stream: `fitz.image_profile(doc.xref_stream_raw(xref))`.
ja: また、PDFに埋め込まれた画像のプロパティをxrefを介して取得することもできます。この場合は生のストリームを抽出してください： `fitz.image_profile(doc.xref_stream_raw(xref))`。

en: Images as returned by the image blocks of :meth:`Page.get_text` using "dict" or "rawdict" options are also supported.
ja: :meth:`Page.get_text` の画像ブロックが「dict」または「rawdict」オプションを使用して返す画像もサポートされています。

en: Return the header string required to make a valid document out of page text outputs.
ja: ページのテキスト出力を有効なドキュメントに変換するために必要なヘッダー文字列を返します。

en: type of document. Use the same as the output parameter of *get_text()*.
ja: ドキュメントの種類。*get_text()* メソッドのoutputパラメータと同じものを使用します。

en: optional arbitrary name to use in output types "json" and "xml".
ja: 出力タイプ "json" および "xml" で使用するオプションの任意の名前。

en: Return the trailer string required to make a valid document out of page text outputs. See :meth:`Page.get_text` for an example.
ja: :meth:`Page.get_text` の例を参照して、ページテキストの出力から有効な文書を作成するために必要なトレーラー文字列を返します。

en: Delete an object containing XML-based metadata from the PDF. (Py-) MuPDF does not support XML-based metadata. Use this if you want to make sure that the conventional metadata dictionary will be used exclusively. Many thirdparty PDF programs insert their own metadata in XML format and thus may override what you store in the conventional dictionary. This method deletes any such reference, and the corresponding PDF object will be deleted during next garbage collection of the file.
ja: PDF内からXMLベースのメタデータを含むオブジェクトを削除します。PyMuPDFではXMLベースのメタデータはサポートされていません。従って、従来のメタデータ辞書が排他的に使用されることを確認したい場合に使用します。多くのサードパーティのPDFプログラムは、独自のXML形式でメタデータを挿入し、従来の辞書に保存されている内容を上書きする可能性があります。このメソッドはそのような参照を削除し、ファイルの次回のガベージコレクション時に対応するPDFオブジェクトが削除されます。

en: Return the XML-based metadata :data:`xref` of the PDF if present -- also refer to :meth:`Document.del_xml_metadata`. You can use it to retrieve the content via :meth:`Document.xref_stream` and then work with it using some XML software.
ja: PDFのXMLベースのメタデータの :data:`xref` を返します。存在する場合は、:meth:`Document.del_xml_metadata` にも言及してください。これを使用して、:meth:`Document.xref_stream` を介してコンテンツを取得し、それをいくつかのXMLソフトウェアを使用して操作できます。

en: :data:`xref` of PDF file level XML metadata -- or 0 if none exists.
ja: PDFファイルレベルのXMLメタデータの :data:`xref`。存在しない場合は0。

en: Run a page through a device.
ja: ページをデバイスを通じて実行します。

en: Device, obtained from one of the :ref:`Device` constructors.
ja: :ref:`Device`。デバイスのコンストラクタから取得します。

en: Transformation to apply to the page. Set it to :ref:`Identity` if no transformation is desired.
ja: ページに適用する変換。変換を行わない場合は :ref:`Identity` に設定します。

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

en: Changed in v1.22.0: optionally also return the OCG name applicable to the boundary box.
ja: v1.22.0 で変更: 境界ボックスに適用される OCG 名もオプションで返すように変更されました。

en: a list of rectangles that envelop text, image or drawing objects. Each item is a tuple `(type, (x0, y0, x1, y1))` where the second tuple consists of rectangle coordinates, and *type* is one of the following values. If `layers=True`, there is a third item containing the OCG name or `None`: `(type, (x0, y0, x1, y1), None)`.
ja: テキスト、画像、または描画オブジェクトを囲む矩形のリスト。各アイテムはタプル `(type, (x0, y0, x1, y1))` で、第2のタプルは矩形の座標を表し、*type* は以下の値のいずれかです。`layers=True` の場合、OCG 名または `None` を含む第3のアイテムがあります: `(type, (x0, y0, x1, y1), None)`。

en: `"fill-text"` -- normal text (painted without character borders)
ja: `"fill-text"` – 通常のテキスト（文字の境界線なしで描画）

en: `"stroke-text"` -- text showing character borders only
ja: `"stroke-text"` – 文字の境界線のみを表示するテキスト

en: `"ignore-text"` -- text that should not be displayed (e.g. as used by OCR text layers)
ja: `"ignore-text"` – 表示されないべきテキスト（OCR テキストレイヤーなどで使用されます）

en: `"fill-path"` -- drawing with fill color (and no border)
ja: `"fill-path"` – 塗りつぶしカラーで描画（境界線なし）

en: `"stroke-path"` -- drawing with border (and no fill color)
ja: `"stroke-path"` – 境界線で描画（塗りつぶしカラーなし）

en: `"fill-image"` -- displays an image
ja: `"fill-image"` – 画像を表示

en: `"fill-shade"` -- display a shading
ja: `"fill-shade"` – シェーディングを表示

en: The item sequence represents the **sequence in which these commands are executed** to build the page's appearance. Therefore, if an item's bbox intersects or contains that of a previous item, then the previous item may be (partially) covered / hidden.
ja: **アイテムのシーケンスは、ページの外観を構築するためにこれらのコマンドが実行される** 順序を表します。したがって、アイテムの bbox が前のアイテムの bbox と交差または包含されている場合、前のアイテムは（部分的に）カバー / 隠される可能性があります。

en: So this list can be used to detect such situations. An item's index in this list equals the value of a `"seqno"` in dictionaries as returned by :meth:`Page.get_drawings` and :meth:`Page.get_texttrace`.
ja: したがって、このリストを使用してそのような状況を検出できます。このリスト内のアイテムのインデックスは、:meth:`Page.get_drawings`  および :meth:`Page.get_texttrace` によって返される辞書の `"seqno"` の値と等しいです。

en: New in v1.18.16
ja: v1.18.16 で新機能

en: Changed in v1.19.0: added key "seqno".
ja: v1.19.0 で変更: キー "seqno" を追加。

en: Changed in v1.19.1: stroke and fill colors now always are either RGB or GRAY
ja: v1.19.1 で変更: ストロークと塗りつぶしのカラーは常に RGB または GRAY です

en: Changed in v1.19.3: span and character bboxes are now also correct if `dir != (1, 0)`.
ja: v1.19.3 で変更: `dir != (1, 0)` の場合、スパンと文字の bbox も正確になりました。

en: Changed in v1.22.0: add new dictionary key "layer".
ja: v1.22.0 で変更: 新しい辞書キー "layer" を追加。

en: Return low-level text information of the page. The method is available for **all** document types. The result is a list of Python dictionaries with the following content::
ja: ページの低レベルなテキスト情報を返します。このメソッドは **すべて** のドキュメントタイプで利用可能です。結果は、以下の内容を持つ Python 辞書のリストです。

en: Information above tagged with "(1)" has the same meaning and value as explained in :ref:`TextPage`.
ja: 「(1)」でタグ付けされた情報は、:ref:`TextPage` で説明された内容と同じ意味と値を持っています。

en: Please note that the font `flags` value will never contain a *superscript* flag bit: the detection of superscripts is done within MuPDF :ref:`TextPage` code -- it is not a property of any font.
ja: フォント `flags` の値には *superscript* フラグビットが含まれないことに注意してください。上付き文字の検出はMuPDF :ref:`TextPage` 内で行われます。これは任意のフォントのプロパティではありません。

en: Also note, that the text *color* is encoded as the usual tuple of floats 0 <= f <= 1 -- not in sRGB format. Depending on `span["type"]`, interpret this as fill color or stroke color.
ja: また、テキストの *color* は通常の浮動小数点数のタプル（0 <= f <= 1）でエンコードされており、sRGB形式ではありません。`span["type"]` に応じて、これを塗りつぶし色またはストローク色として解釈してください。

en: There are 3 text span types:
ja: テキストスパンには3つのタイプがあります：

en: 0: Filled text -- equivalent to PDF text rendering mode 0 (`0 Tr`, the default in PDF), only each character's "inside" is shown.
ja: 0：塗りつぶしテキスト - PDFテキストレンダリングモード0（`0 Tr`、PDFのデフォルト）と同等で、各文字の「内部」のみが表示されます。

en: 1: Stroked text -- equivalent to `1 Tr`, only the character borders are shown.
ja: 1：ストロークテキスト - `1 Tr` に相当し、文字の境界のみが表示されます。

en: 3: Ignored text -- equivalent to `3 Tr` (hidden text).
ja: 3：無視されたテキスト - `3 Tr` に相当し（非表示テキスト）。

en: Line width in this context is important only for processing `span["type"] != 0`: it determines the thickness of the character's border line. This value may not be provided at all with the text data. In this case, a value of 5% of the :data:`fontsize` (`span["size"] * 0,05`) is generated. Often, an "artificial" bold text in PDF is created by `2 Tr`. There is no equivalent span type for this case. Instead, respective text is represented by two consecutive spans -- which are identical in every aspect, except for their types, which are 0, resp 1. It is your responsibility to handle this type of situation - in :meth:`Page.get_text`, MuPDF is doing this for you.
ja: この文脈では、線の幅は `span["type"] != 0` を処理する際にのみ重要であり、文字の境界線の厚さを決定します。この値はテキストデータと一緒に提供されないこともあります。この場合、:data:`fontsize` の5％（`span["size"] * 0.05`）の値が生成されます。PDF内の「人工」の太字テキストは、通常、`2 Tr` によって作成されます。この場合、このケースの等価なスパンタイプは存在しません。代わりに、対応するテキストは2つの連続したスパンによって表されます。これらのスパンはすべての側面が同一であり、タイプ以外は異なります（0、1）。このタイプの状況を処理する責任はあなたにあります。:meth:`Page.get_text` では、MuPDFがこれを代わりに行います。

en: For data compactness, the character's unicode is provided here. Use built-in function `chr()` for the character itself.
ja: データのコンパクトさのために、文字のUnicodeがここで提供されます。文字自体には `chr()` という組み込み関数を使用します。

en: The alpha / opacity value of the span's text, `0 <= opacity <= 1`, 0 is invisible text, 1 (100%) is intransparent. Depending on `span["type"]`, interpret this value as *fill* opacity or, resp. *stroke* opacity.
ja: スパンのテキストのアルファ/不透明度値、`0 <= opacity <= 1`、0は見えないテキスト、1（100％）は不透明です。`span["type"]` に応じて、この値を *fill* の不透明度または *stroke* の不透明度として解釈してください。

en: *(Changed in v1.19.0)* This value is equal or close to `char["bbox"]` of "rawdict". In particular, the bbox **height** value is always computed as if **"small glyph heights"** had been requested.
ja: *（v1.19.0で変更）* この値は「rawdict」の `char["bbox"]` と等しいか、近い値です。特に、bboxの **高さ** の値は常に **「小さなグリフの高さ」** が要求されたかのように計算されます。

en: *(New in v1.19.0)* This is the union of all character bboxes.
ja: *（v1.19.0で新規）* これはすべての文字bboxの合併です。

en: *(New in v1.19.0)* Enumerates the commands that build up the page's appearance. Can be used to find out whether text is effectively hidden by objects, which are painted "later", or *over* some object. So if there is a drawing or image with a higher sequence number, whose bbox overlaps (parts of) this text span, one may assume that such an object hides the resp. text. Different text spans have identical sequence numbers if they were created in one go.
ja: *（v1.19.0で新規）* ページの外観を構築するコマンドを列挙します。テキストが実際には後で「描画」されるオブジェクトによって隠れるか、またはいくつかのオブジェクトの上にかかっているかを判断するのに使用できます。したがって、bboxがこのテキストスパンのbboxと交差または含まれている場合、以前のアイテムが（部分的に）カバー/非表示にされる可能性があります。

en: *(New in v1.22.0)* The name of the Optional Content Group (OCG) if applicable or `None`.
ja: *（v1.22.0で新規）* 該当する場合、Optional Content Group（OCG）の名前、または `None`

en: Here is a list of similarities and differences of `page.get_texttrace()` compared to `page.get_text("rawdict")`:
ja: 以下は、`page.get_texttrace()` と `page.get_text("rawdict")` を比較した類似点と相違点のリストです：

en: The method is up to **twice as fast,** compared to "rawdict" extraction. Depends on the amount of text.
ja: メソッドは、テキストの量に依存しますが、"rawdict" の抽出と比較して最大 **2倍速い** です。

en: The returned data is very **much smaller in size** -- although it provides more information.
ja: 返されるデータは **非常に小さく** 、より多くの情報を提供します。

en: Additional types of text **invisibility can be detected**: opacity = 0 or type > 1 or overlapping bbox of an object with a higher sequence number.
ja: 追加のテキストの **不可視性のタイプを検出できます** ：不透明度 = 0またはタイプ > 1またはシーケンス番号の高いオブジェクトとの境界ボックスが重なる。

en: If MuPDF returns unicode 0xFFFD (65533) for unrecognized characters, you may still be able to deduct desired information from the glyph id.
ja: MuPDFが認識できない文字に対してUnicode 0xFFFD（65533）を返す場合、グリフIDから必要な情報を導き出すことができるかもしれません。

en: The `span["chars"]` **contains no spaces**, **except** the document creator has explicitly coded them. They **will never be generated** like it happens in :meth:`Page.get_text` methods. To provide some help for doing your own computations here, the width of a space character is given. This value is derived from the font where possible. Otherwise the value of a fallback font is taken.
ja: `span["chars"]` には **スペースは含まれません** 。ただし、ドキュメントの作成者が明示的にコード化しない限り、それらは :meth:`Page.get_text` メソッドで発生するように **生成されません**。自分自身の計算を行うのを助けるために、スペース文字の幅が提供されます。この値はフォントから派生しています。それ以外の場合はフォールバックフォントの値が取られます。

en: There is no effort to organize text like it happens for a :ref:`TextPage` (the hierarchy of blocks, lines, spans, and characters). Characters are simply extracted in sequence, one by one, and put in a span. Whenever any of the span's characteristics changes, a new span is started. So you may find characters with different `origin.y` values in the same span (which means they would appear in different lines). You cannot assume, that span characters are sorted in any particular order -- you must make sense of the info yourself, taking `span["dir"]`, `span["wmode"]`, etc. into account.
ja: :ref:`TextPage` のようにテキストを整理する取り組みはありません（ブロック、行、スパン、および文字の階層構造）。文字は単純に順番に抽出され、スパンに配置されます。スパンの特性が変更されるたびに、新しいスパンが開始されます。したがって、同じスパン内で異なる `origin.y` 値を持つ文字を見つけることができます（これは異なる行に表示されることを意味します）。スパンの文字が特定の順序でソートされているとは仮定できません。情報を理解し、`span["dir"]`、`span["wmode"]` などを考慮に入れる必要があります。

en: Ligatures are represented like this:
ja: リガチャは次のように表されます：

en: MuPDF handles the following ligatures: "fi", "ff", "fl", "ft", "st", "ffi", and "ffl" (only the first 3 are mostly ever used). If the page contains e.g. ligature "fi", you will find the following two character items subsequent to each other::
ja: MuPDFは次のリガチャを処理します。 "fi"、 "ff"、 "fl"、 "ft"、 "st"、 "ffi"、および "ffl"（ほとんどは最初の3つが使用されます）。したがって、ページに "fi" のようなリガチャが含まれている場合、次の2つの文字アイテムが連続して表示されます。

en: This means that the bbox of the first ligature character is the area containing the complete, compound glyph. Subsequent ligature components are recognizable by their glyph value -1 and a bbox of width zero.
ja: これにより、最初の合字文字のbboxは、完全な合成グリフを含む領域です。後続の合字コンポーネントは、そのグリフ値が-1で幅がゼロであることで識別できます。

en: You may want to replace those 2 or 3 char tuples by one, that represents the ligature itself. Use the following mapping of ligatures to unicodes:
ja: これらの2つまたは3つの文字のタプルを、合字自体を表す1つに置き換えたい場合があるかもしれません。次のような合字をUnicodeにマッピングします。

en: So you may want to replace the two example tuples above by the following single one: `(0xFB01, glyph, (x, y), (x0, y0, x1, y1))` (there is usually no need to lookup the correct glyph id for 0xFB01 in the resp. font, but you may execute `font.has_glyph(0xFB01)` and use its return value).
ja: したがって、上記の2つの例のタプルを次の単一のタプルで置き換えたい場合があります：`(0xFB01, glyph, (x, y), (x0, y0, x1, y1))`（通常、0xFB01の正しいグリフIDをフォント内で調べる必要はありませんが、`font.has_glyph(0xFB01)` を実行し、その戻り値を使用することができます）。

en: **Changed in v1.21.1:** If applicable, the name of the OCG is shown in `"layer"`.
ja: **v1.21.1** で変更：該当する場合、OCGの名前が `"layer"` に表示されます。

en: Put string pair "q" / "Q" before, resp. after a page's */Contents* object(s) to ensure that any "geometry" changes are **local** only.
ja: ページの */Contents* オブジェクトの前、または後ろに文字列ペア "q" / "Q" を配置して、どんな "geometry" の変更も **ローカル** な変更だけになるようにします。

en: Use this method as an alternative, minimalist version of :meth:`Page.clean_contents`. Its advantage is a small footprint in terms of processing time and impact on the data size of incremental saves. Multiple executions of this method are no problem and have no functional impact: `b"q q contents Q Q"` is treated like `b"q contents Q"`.
ja: このメソッドは、:meth:`Page.clean_contents` の代替として使用します。その利点は、処理時間と増分保存のデータサイズへの影響が少ないことです。このメソッドの複数回実行は問題ありませんし、機能的な影響もありません。例えば、`b"q q contents Q Q"` は `b"q contents Q"` と同様に扱われます。

en: Indicate whether :meth:`Page.wrap_contents` may be required for object insertions in standard PDF geometry. Note that this is a quick, basic check only: a value of *False* may still be a false alarm. But nevertheless executing :meth:`Page.wrap_contents` will have no negative side effects.
ja: :meth:`Page.wrap_contents` が標準のPDFジオメトリにオブジェクトを挿入する際に必要かどうかを示します。ただし、これは迅速で基本的なチェックであることに注意してください。*False* の値でも誤報の可能性があることに留意してください。ただし、:meth:`Page.wrap_contents` を実行しても負の副作用はありません。

en: Deprecated wrapper for :meth:`TextPage.extractBLOCKS`.  Use :meth:`Page.get_text` with the "blocks" option instead.
ja: :meth:`TextPage.extractBLOCKS` の非推奨のラッパーです。代わりにオプション "blocks" を使用して :meth:`Page.get_text` を使用してください。

en: Run a page through a list device and return its display list.
ja: ページをリストデバイスを介して実行し、そのディスプレイリストを返します。

en: the display list of the page.
ja: ページのディスプレイリスト。

en: PDF only: Retrieve a list of :data:`xref` of :data:`contents` objects of a page. May be empty or contain multiple integers. If the page is cleaned (:meth:`Page.clean_contents`), it will be one entry at most. The "source" of each `/Contents` object can be individually read by :meth:`Document.xref_stream` using an item of this list. Method :meth:`Page.read_contents` in contrast walks through this list and concatenates the corresponding sources into one `bytes` object.
ja: PDFのみ：ページの :data:`contents` オブジェクトの :data:`xref` のリストを取得します。空であるか、複数の整数を含むことがあります。ページがクリーンアップされた場合（:meth:`Page.clean_contents`）、最大で1つのエントリになります。各/Contentsオブジェクトの "source" は、このリストのアイテムを使用して :meth:`Document.xref_stream` で個別に読み取ることができます。一方、:meth:`Page.read_contents` メソッドは、このリストを走査し、対応するソースを1つの `bytes` オブジェクトに連結します。

en: PDF only: Let the page's `/Contents` key point to this xref. Any previously used contents objects will be ignored and can be removed via garbage collection.
ja: PDFのみ：ページの `/Contents` キーをこのxrefに設定します。以前に使用されていたコンテンツオブジェクトは無視され、ガベージコレクションを使用して削除できます。

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

en: PDF only: Clean and concatenate all :data:`contents` objects associated with this page. "Cleaning" includes syntactical corrections, standardizations and "pretty printing" of the contents stream. Discrepancies between :data:`contents` and :data:`resources` objects will also be corrected if sanitize is true. See :meth:`Page.get_contents` for more details.
ja: PDFのみ：このページに関連付けられたすべての :data:`contents` ツオブジェクトをクリーンアップして連結します。 "クリーニング"には、構文の修正、標準化、およびコンテンツストリームの "きれいな印刷"が含まれます。 sanitizeがtrueの場合、:data:`contents` と :data:`resources` オブジェクト間の不一致も修正されます。詳細については、:meth:`Page.get_contents` を参照してください。

en: Changed in version 1.16.0 Annotations are no longer implicitly cleaned by this method. Use :meth:`Annot.clean_contents` separately.
ja: バージョン1.16.0以降、注釈はこのメソッドによって暗黙的にクリーンアップされなくなりました。 :meth:`Annot.clean_contents` を別途使用してください。

en: *(new in v1.17.6)* if true, synchronization between resources and their actual use in the contents object is snychronized. For example, if a font is not actually used for any text of the page, then it will be deleted from the `/Resources/Font` object.
ja: *（v1.17.6で新たに）* trueの場合、リソースとコンテンツオブジェクト間の同期が行われます。たとえば、ページのテキストでフォントが実際に使用されていない場合、それは `/Resources/Font`  オブジェクトから削除されます。

en: This is a complex function which may generate large amounts of new data and render old data unused. It is **not recommended** using it together with the **incremental save** option. Also note that the resulting singleton new */Contents* object is **uncompressed**. So you should save to a **new file** using options *"deflate=True, garbage=3"*.
ja: これは大量の新しいデータを生成し、古いデータを使用しないようにする複雑な機能です。**増分保存** オプションと一緒に使用することは **お勧めできません** 。また、結果のシングルトンの新しい */Contents* オブジェクトは **非圧縮です**。したがって、オプション *"deflate=True、garbage=3"* を使用して **新しいファイル** に保存する必要があります。

en: *New in version 1.17.0.* Return the concatenation of all :data:`contents` objects associated with the page -- without cleaning or otherwise modifying them. Use this method whenever you need to parse this source in its entirety without having to bother how many separate contents objects exist.
ja: *v1.17.0で新たに追加。* ページに関連付けられたすべての :data:`contents` オブジェクトの連結を返します。クリーニングや変更などを行わずに、このソース全体を解析する必要がある場合にこのメソッドを使用します。

en: Clean the :data:`contents` streams associated with the annotation. This is the same type of action which :meth:`Page.clean_contents` performs -- just restricted to this annotation.
ja: アノテーションに関連付けられた :data:`contents` ストリームをクリーンアップします。これは、:meth:`Page.clean_contents` が実行するのと同じ種類のアクションですが、この注釈に制限されています。

en: Return a list of character glyphs and their widths for a font that is present in the document. A font must be specified by its PDF cross reference number :data:`xref`. This function is called automatically from :meth:`Page.insert_text` and :meth:`Page.insert_textbox`. So you should rarely need to do this yourself.
ja: ドキュメント内に存在するフォントに対して、文字のグリフと幅のリストを返します。フォントはPDFのクロスリファレンス番号 :data:`xref` で指定する必要があります。この関数は、:meth:`Page.insert_text` および :meth:`Page.insert_textbox` から自動的に呼び出されます。したがって、自分で行う必要があることはほとんどありません。

en: cross reference number of a font embedded in the PDF. To find a font :data:`xref`, use e.g. *doc.get_page_fonts(pno)* of page number *pno* and take the first entry of one of the returned list entries.
ja: ドキュメントに埋め込まれたPDFのクロスリファレンス番号。フォントの :data:`xref` を見つけるには、例えば、ページ番号 *pno* の *doc.get_page_fonts(pno)* を使用し、返されたリストエントリの最初を取得します。

en: limits the number of returned entries. The default of 256 is enforced for all fonts that only support 1-byte characters, so-called "simple fonts" (checked by this method). All :ref:`Base-14-Fonts` are simple fonts.
ja: 返されるエントリの数を制限します。256のデフォルト値は、1バイトの文字のみをサポートする「シンプルフォント」と呼ばれるフォントに対して適用されます（このメソッドで確認されます）。すべてのPDF :ref:`Base-14-Fonts` はシンプルフォントです。

en: a list of *limit* tuples. Each character *c* has an entry  *(g, w)* in this list with an index of *ord(c)*. Entry *g* (integer) of the tuple is the glyph id of the character, and float *w* is its normalized width. The actual width for some :data:`fontsize` can be calculated as *w * fontsize*. For simple fonts, the *g* entry can always be safely ignored. In all other cases *g* is the basis for graphically representing *c*.
ja: *limit* のタプルのリストです。各文字cには、*ord(c)* のインデックスでエントリ *（g、w）* があります。タプルの *g*（整数）エントリは文字のグリフIDで、float *w* はその正規化された幅です。一部のフォントサイズに対する実際の幅は、*w * :data:`fontsize`* として計算できます。シンプルフォントの場合、gエントリは常に安全に無視できます。それ以外の場合、*g* は *c* を視覚的に表現するための基礎です。

en: This function calculates the pixel width of a string called *text*::
ja: この関数は、*text* と呼ばれる文字列のピクセル幅を計算します::

en: New in version 1.14.14
ja: バージョン1.14.14で新規追加

en: PDF only: Check whether the object represented by :data:`xref` is a :data:`stream` type. Return is *False* if not a PDF or if the number is outside the valid xref range.
ja: PDFのみ：:data:`xref` によって表されるオブジェクトが :data:`stream` タイプかどうかを確認します。PDFでない場合や、有効なxref範囲外の場合はFalseを返します。

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

en: *True* if the object definition is followed by data wrapped in keyword pair *stream*, *endstream*.
ja: *stream*、*endstream* のキーワードペアで囲まれたデータに続いてオブジェクト定義がある場合は *True*。

en: Increase the :data:`xref` by one entry and return that number. This can then be used to insert a new object.
ja: :data:`xref` を1つ増やしてその番号を返します。これは新しいオブジェクトを挿入するために使用できます。

en: int :returns: the number of the new :data:`xref` entry. Please note, that only a new entry in the PDF's cross reference table is created. At this point, there will not yet exist a PDF object associated with it. To create an (empty) object with this number use `doc.update_xref(xref, "<<>>")`.
ja: int :returns: 新しい :data:`xref` エントリの数。PDFのクロスリファレンステーブルに新しいエントリのみが作成されます。この段階では、それに関連付けられたPDFオブジェクトはまだ存在しません。この番号で（空の）オブジェクトを作成するには、`doc.update_xref(xref、"<<>>")` を使用します。

en: Return length of :data:`xref` table.
ja: :data:`xref` テーブルの長さを返します。

en: the number of entries in the :data:`xref` table.
ja: :data:`xref` テーブルのエントリ数。

en: Compute the quadrilateral of a text span extracted via options "dict" or "rawdict" of :meth:`Page.get_text`.
ja: :meth:`Page.get_text` のオプション "dict" または "rawdict" で抽出されたテキストスパンの四辺形を計算します。

en: `line["dir"]` of the owning line.  Use `None` for a span from :meth:`Page.get_texttrace`.
ja: 所有する行の `line["dir"]`。:meth:`Page.get_texttrace` からのスパンの場合は `None` を使用します。

en: the span.
ja: スパン。

en: the :ref:`Quad` of the span, usable for text marker annotations ('Highlight', etc.).
ja: スパンの :ref:`Quad`、テキストマーカーアノテーション（'ハイライト' など）で使用できます。

en: Compute the quadrilateral of a text character extracted via option "rawdict" of :meth:`Page.get_text`.
ja: :meth:`Page.get_text` のオプション "rawdict" で抽出されたテキスト文字の四辺形を計算します。

en: `line["dir"]` of the owning line. Use `None` for a span from :meth:`Page.get_texttrace`.
ja: 所有する行の `line["dir"]`。:meth:`Page.get_texttrace` からのスパンの場合は `None` を使用します。

en: the character.
ja: 文字。

en: the :ref:`Quad` of the character, usable for text marker annotations ('Highlight', etc.).
ja: 文字の :ref:`Quad`、テキストマーカーアノテーション（'ハイライト' など）で使用できます。

en: Compute the quadrilateral of a subset of characters of a span extracted via option "rawdict" of :meth:`Page.get_text`.
ja: :meth:`Page.get_text` のオプション "rawdict" で抽出されたスパンの一部の文字の四辺形を計算します。

en: the :ref:`Quad` of the selected characters, usable for text marker annotations ('Highlight', etc.).
ja: 選択された文字の :ref:`Quad` 、テキストマーカーアノテーション（'ハイライト' など）で使用できます。

en: Compute the quadrilateral of a subset of spans of a text line extracted via options "dict" or "rawdict" of :meth:`Page.get_text`.
ja: :meth:`Page.get_text` のオプション "dict" または "rawdict" で抽出されたテキスト行の一部のスパンの四辺形を計算します。

en: the line.
ja: 行。

en: a sub-list of `line["spans"]`. If omitted, the full line quad will be returned.
ja: `line["spans"]` のサブリスト。省略した場合、選択した行の四辺形が返されます。

en: the :ref:`Quad` of the selected line spans, usable for text marker annotations ('Highlight', etc.).
ja: 選択された行のスパンの :ref:`Quad`、テキストマーカーアノテーション（'ハイライト' など）で使用できます。

en: Return the name of Tesseract's language support folder. Use this function if the environment variable `TESSDATA_PREFIX` has not been set.
ja: Tesseractの言語サポートフォルダの名前を返します。環境変数 `TESSDATA_PREFIX` が設定されていない場合にこの関数を使用します

en: `os.getenv("TESSDATA_PREFIX")` if not `None`. Otherwise, if Tesseract-OCR is installed, locate the name of `tessdata`. If no installation is found, return `False`.
ja: `os.getenv("TESSDATA_PREFIX")` が `None` でない場合、またはTesseract-OCRがインストールされている場合は、`tessdata` の名前を見つけます。インストールが見つからない場合、`False` を返します。

en: The folder name can be used as parameter `tessdata` in methods :meth:`Page.get_textpage_ocr`, :meth:`Pixmap.pdfocr_save` and :meth:`Pixmap.pdfocr_tobytes`.
ja: このフォルダの名前は、メソッド :meth:`Page.get_textpage_ocr`、:meth:`Pixmap.pdfocr_save`、および :meth:`Pixmap.pdfocr_tobytes` の `tessdata` パラメータに使用できます。

en: Return the (unique) infinite rectangle `Rect(-2147483648.0, -2147483648.0, 2147483520.0, 2147483520.0)`, resp. the :ref:`IRect` and :ref:`Quad` counterparts. It is the largest possible rectangle: all valid rectangles are contained in it.
ja: (ユニークな) 無限の四角形 `Rect(-2147483648.0、-2147483648.0、2147483520.0、2147483520.0)`、または :ref:`IRect` と :ref:`Quad` の対応するものを返します。これは最大の可能な四角形で、すべての有効な四角形が含まれます。

en: Return the "standard" empty and invalid rectangle `Rect(2147483520.0, 2147483520.0, -2147483648.0, -2147483648.0)` resp. quad. Its top-left and bottom-right point values are reversed compared to the infinite rectangle. It will e.g. be used to indicate empty bboxes in `page.get_text("dict")` dictionaries. There are however infinitely many empty or invalid rectangles.
ja: 「標準」の空白で無効な四角形  `Rect(2147483520.0, 2147483520.0, -2147483648.0, -2147483648.0)` または対応する四角形を返します。その左上と右下のポイント値は、無限の四角形と比較して反転しています。たとえば、`page.get_text("dict")` 辞書内の空の bboxes を示すために使用されます。ただし、無限に多くの空のまたは無効な四角形が存在します。

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