PyMuPDF 1.23.0rc1 - en to ja translation catalogue (139 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: TextPage
ja: TextPage (テキストページ)

en: This class represents text and images shown on a document page. All :ref:`MuPDF document types<Supported_File_Types>` are supported.
ja: このクラスは、文書ページに表示されるテキストと画像を表します。すべての :ref:`MuPDF document types<Supported_File_Types>` がサポートされています。

en: The usual ways to create a textpage are :meth:`DisplayList.get_textpage` and :meth:`Page.get_textpage`. Because there is a limited set of methods in this class, there exist wrappers in :ref:`Page` which are handier to use. The last column of this table shows these corresponding :ref:`Page` methods.
ja: テキストページを作成する通常の方法は、:meth:`DisplayList.get_textpage` および :meth:`Page.get_textpage` です。このクラスにはメソッドのセットが制限されているため、:ref:`Page` 内にはより使いやすいラッパーが存在します。この表の最後の列には、対応する :ref:`Page` メソッドが示されています。

en: For a description of what this class is all about, see Appendix 2.
ja: このクラスに関する詳細な説明については、付録2を参照してください。

en: **Method**
ja: **メソッド**

en: **Description**
ja: **説明**

en: page get_text or search method
ja: page get_textまたはsearchメソッド

en: extract plain text
ja: プレーンテキストを抽出します

en: synonym of previous
ja: 前述の同義語

en: plain text grouped in blocks
ja: ブロックにグループ化されたプレーンテキスト

en: all words with their bbox
ja: すべての単語とそのバウンディングボックス

en: page content in HTML format
ja: HTML形式のページコンテンツ

en: page content in XHTML format
ja: XHTML形式のページコンテンツ

en: page text in XML format
ja: XML形式のページテキスト

en: page content in *dict* format
ja: *辞書* 形式のページコンテンツ

en: page content in JSON format
ja: JSON形式のページコンテンツ

en: Search for a string in the page
ja: ページ内の文字列を検索します

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

en: Return a string of the page's complete text. The text is UTF-8 unicode and in the same sequence as specified at the time of document creation.
ja: ページの完全なテキストの文字列を返します。テキストはUTF-8ユニコードで、文書作成時に指定された順序と同じです。

en: Textpage content as a list of text lines grouped by block. Each list items looks like this::
ja: テキストページの内容を、ブロックごとにグループ化されたテキスト行のリストとして返します。各リストアイテムは次のようになります::

en: The first four entries are the block's bbox coordinates, *block_type* is 1 for an image block, 0 for text. *block_no* is the block sequence number. Multiple text lines are joined via line breaks.
ja: 最初の4つのエントリはブロックのbbox座標で、*ブblock_type* は画像ブロックの場合は1、テキストの場合は0です。*block_no* はブロックのシーケンス番号です。複数のテキスト行は改行で結合されます。

en: For an image block, its bbox and a text line with some image meta information is included -- **not the image content**.
ja: 画像ブロックの場合、そのbboxと画像メタ情報を含むテキスト行が含まれますが、**画像の内容は含まれません**。

en: This is a high-speed method with just enough information to output plain text in desired reading sequence.
ja: これは、必要な読み取り順序でプレーンテキストを出力するのに十分な情報を持つ高速なメソッドです。

en: Textpage content as a list of single words with bbox information. An item of this list looks like this::
ja: テキストページの内容を、bbox情報を持つ単語のリストとして返します。このリストのアイテムは次のようになります::

en: Textpage content as a string in HTML format. This version contains complete formatting and positioning information. Images are included (encoded as base64 strings). You need an HTML package to interpret the output in Python. Your internet browser should be able to adequately display this information, but see :ref:`HTMLQuality`.
ja: HTML形式の文字列としてのテキストページの内容を返します。このバージョンには完全なフォーマットと位置情報が含まれています。画像も含まれており（base64文字列としてエンコードされています）、Pythonで出力を解釈するためにはHTMLパッケージが必要です。インターネットブラウザはこの情報を適切に表示できるはずですが、:ref:`HTMLQuality` を参照してください。

en: Textpage content as a Python dictionary. Provides same information detail as HTML. See below for the structure.
ja: TextPageの内容をPythonの辞書として取得します。HTMLと同じ情報の詳細を提供します。構造については以下を参照してください。

en: Textpage content as a JSON string. Created by `json.dumps(TextPage.extractDICT())`. It is included for backlevel compatibility. You will probably use this method ever only for outputting the result to some file. The  method detects binary image data and converts them to base64 encoded strings.
ja: TextPageの内容をJSON形式の文字列として取得します。`json.dumps(TextPage.extractDICT())` によって作成されます。これは過去の互換性のために含まれています。おそらく、結果をファイルに出力する際にのみこのメソッドを使用するでしょう。このメソッドはバイナリ画像データを検出し、それらをBase64エンコードされた文字列に変換します。

en: Textpage content as a string in XHTML format. Text information detail is comparable with :meth:`extractTEXT`, but also contains images (base64 encoded). This method makes no attempt to re-create the original visual appearance.
ja: TextPageの内容をXHTML形式の文字列として取得します。テキスト情報の詳細は :meth:`extractTEXT` と比較できますが、画像も含まれます（Base64エンコードされています）。このメソッドは元の視覚的な外観を再作成しようとしません。

en: Textpage content as a string in XML format. This contains complete formatting information about every single character on the page: font, size, line, paragraph, location, color, etc. Contains no images. You need an XML package to interpret the output in Python.
ja: TextPageの内容をXML形式の文字列として取得します。これにはページ上の各文字に関する完全なフォーマット情報が含まれています：フォント、サイズ、行、段落、位置、色など。画像は含まれていません。Pythonで出力を解釈するにはXMLパッケージが必要です。

en: Textpage content as a Python dictionary -- technically similar to :meth:`extractDICT`, and it contains that information as a subset (including any images). It provides additional detail down to each character, which makes using XML obsolete in many cases. See below for the structure.
ja: TextPageの内容をPythonの辞書として取得します。技術的には :meth:`extractDICT` と類似しており、その情報をサブセットとして含みます（画像も含まれます）。詳細については以下を参照してください。

en: Textpage content as a JSON string. Created by `json.dumps(TextPage.extractRAWDICT())`. You will probably use this method ever only for outputting the result to some file. The  method detects binary image data and converts them to base64 encoded strings.
ja: TextPageの内容をJSON形式の文字列として取得します。`json.dumps(TextPage.extractRAWDICT())` によって作成されます。おそらく、結果をファイルに出力する際にのみこのメソッドを使用するでしょう。このメソッドはバイナリ画像データを検出し、それらをBase64エンコードされた文字列に変換します。

en: Changed in v1.18.2
ja: 変更内容 v1.18.2

en: Search for *string* and return a list of found locations.
ja: *文字列* を検索し、見つかった位置のリストを返します。

en: the string to search for. Upper and lower cases will all match if needle consists of ASCII letters only -- it does not yet work for "Ä" versus "ä", etc.
ja: 検索対象の文字列。ASCII文字だけで構成されている場合、大文字と小文字はすべて一致します。これはまだ、例えば  "Ä" と "ä" のような場合には機能しません。

en: return quadrilaterals instead of rectangles.
ja: 長方形の代わりに四辺形を返すかどうか。

en: a list of :ref:`Rect` or :ref:`Quad` objects, each surrounding a found *needle* occurrence. As the search string may contain spaces, its parts may be found on different lines. In this case, more than one rectangle (resp. quadrilateral) are returned. **(Changed in v1.18.2)** The method **now supports dehyphenation**, so it will find e.g. "method", even if it was hyphenated in two parts "meth-" and "od" across two lines. The two returned rectangles will contain "meth" (no hyphen) and "od".
ja: 見つかった *needle* の出現箇所を囲む :ref:`Rect` または :ref:`Quad` オブジェクトのリスト。検索文字列にはスペースが含まれる可能性があるため、その部分が異なる行に存在することがあります。この場合、複数の長方形（または四辺形）が返されます **（v1.18.2 で変更）** 。このメソッドは **今ではハイフネーションに対応しており** 、例えば "method" が "meth-" と "od" という2つの部分に分かれている場合でも、"meth"（ハイフンなし）と "od" の2つの長方形が含まれます。

en: **Overview of changes in v1.18.2:**
ja: **v1.18.2 での変更内容の概要：**

en: The `hit_max` parameter has been removed: all hits are always returned.
ja: `hit_max` パラメータが削除され、すべてのヒットが常に返されます。

en: The `rect` parameter of the :ref:`TextPage` is now respected: only text inside this area is examined. Only characters with fully contained bboxes are considered. The wrapper method :meth:`Page.search_for` correspondingly supports a *clip* parameter.
ja: :ref:`TextPage` の `rect` パラメータが尊重され、この領域内のテキストのみが検査されます。完全に含まれる bboxes を持つ文字のみが考慮されます。:meth:`Page.search_for` のラッパーメソッドも対応するクリップパラメータをサポートしています。

en: **Hyphenated words** are now found.
ja: **ハイフネーションされた単語** も見つかります。

en: **Overlapping rectangles** in the same line are now automatically joined. We assume that such separations are an artifact created by multiple marked content groups, containing parts of the same search needle.
ja: 同じ行内の **重複する長方形** は自動的に結合されます。このような分割は、同じ検索対象の一部を含む複数のマークコンテンツグループによって作成されたアーティファクトと仮定されます。

en: Example Quad versus Rect: when searching for needle "pymupdf", then the corresponding entry will either be the blue rectangle, or, if *quads* was specified, the quad *Quad(ul, ur, ll, lr)*.
ja: 例：Quad 対 Rect：needle "pymupdf" を検索する場合、対応するエントリは青い長方形であるか、*quads* が指定された場合は四辺形 *Quad(ul, ur, ll, lr)* になります。

en: The rectangle associated with the text page. This either equals the rectangle of the creating page or the `clip` parameter of :meth:`Page.get_textpage` and text extraction / searching methods.
ja: テキストページに関連付けられた矩形。これは、作成ページの矩形または :meth:`Page.get_textpage` およびテキスト抽出/検索メソッドの `clip` パラメーターと一致する場合があります。

en: The output of text searching and most text extractions **is restricted to this rectangle**. (X)HTML and XML output will however always extract the full page.
ja: テキスト検索およびほとんどのテキスト抽出の出力は **この矩形に制限されます**。ただし、(X)HTMLおよびXMLの出力は常にフルページを抽出します。

en: Structure of Dictionary Outputs
ja: 辞書出力の構造

en: Methods :meth:`TextPage.extractDICT`, :meth:`TextPage.extractJSON`, :meth:`TextPage.extractRAWDICT`, and :meth:`TextPage.extractRAWJSON` return dictionaries, containing the page's text and image content. The dictionary structures of all four methods are almost equal. They strive to map the text page's information hierarchy of blocks, lines, spans and characters as precisely as possible, by representing each of these by its own sub-dictionary:
ja: :meth:`TextPage.extractDICT`、:meth:`TextPage.extractJSON` 、:meth:`TextPage.extractRAWDICT` 、:meth:`TextPage.extractRAWJSON` は、ページのテキストおよび画像コンテンツを含む辞書を返します。これらの4つのメソッドの辞書構造はほぼ同じです。これらは、ブロック、行、スパン、文字の情報階層をテキストページにできるだけ正確にマップし、各要素を独自のサブ辞書で表現することを目指しています。

en: A **page** consists of a list of **block dictionaries**.
ja: **ページ** は **ブロック辞書** のリストから構成されます。

en: A (text) **block** consists of a list of **line dictionaries**.
ja: (テキスト) **ブロック** は、**行辞書** のリストから構成されます。

en: A **line** consists of a list of **span dictionaries**.
ja: **行** は、**スパン辞書** のリストから構成されます。

en: A **span** either consists of the text itself or, for the RAW variants, a list of **character dictionaries**.
ja: **スパン** は、テキスト自体またはRAWバリアントの場合、**文字辞書** のリストから構成されます。

en: RAW variants: a **character** is a dictionary of its origin, bbox and unicode.
ja: RAWバリアント：**文字** はその起源、bbox、およびUnicodeの辞書です。

en: All PyMuPDF geometry objects herein (points, rectangles, matrices) are represented by there **"like"** formats: a :data:`rect_like` *tuple* is used instead of a :ref:`Rect`, etc. The reasons for this are performance and memory considerations:
ja: ここでのすべてのPyMuPDFジオメトリオブジェクト（ポイント、矩形、行列）は、:data:`rect_like` *タプル* の形式で :ref:`Rect` などの代わりに使用されます。これは、パフォーマンスとメモリの考慮事項からです。

en: This code is written in C, where Python tuples can easily be generated. The geometry objects on the other hand are defined in Python source only. A conversion of each Python tuple into its corresponding geometry object would add significant -- and largely unnecessary -- execution time.
ja: このコードはCで書かれており、Pythonタプルは簡単に生成できます。一方、ジオメトリオブジェクトはPythonソースでのみ定義されています。 各Pythonタプルを対応するジオメトリオブジェクトに変換することは、実行時間を大幅に（かつ不必要に）増加させるでしょう。

en: A 4-tuple needs about 168 bytes, the corresponding :ref:`Rect` 472 bytes - almost three times the size. A "dict" dictionary for a text-heavy page contains 300+ bbox objects -- which thus require about 50 KB storage as 4-tuples versus 140 KB as :ref:`Rect` objects. A "rawdict" output for such a page will however contain **4 to 5 thousand** bboxes, so in this case we talk about 750 KB versus 2 MB.
ja: 4つのタプルは約168バイト、対応する :ref:`Rect` は472バイトです - サイズのほぼ3倍です。テキストが豊富なページの「dict」辞書には300以上のbboxオブジェクトが含まれているため、これらは4タプルとして約50 KBのストレージを必要としますが、:ref:`Rect` オブジェクトでは約140 KBです。このようなページの「rawdict」出力は、**4,000から5,000** のbboxを含む場合がありますので、この場合は750 KB対2 MBとなります。

en: Please also note, that only **bboxes** (= :data:`rect_like` 4-tuples) are returned, whereas a :ref:`TextPage` actually has the **full position information** -- in :ref:`Quad` format. The reason for this decision is again a memory consideration: a :data:`quad_like` needs 488 bytes (3 times the size of a :data:`rect_like`). Given the mentioned amounts of generated bboxes, returning :data:`quad_like` information would have a significant impact.
ja: また、注意してください。 **bboxes** （rect_like 4タプル）のみが返され、:ref:`TextPage` には **完全な位置情報** が含まれていることです - Quad形式で。これはメモリの考慮事項です。:data:`quad_like` には488バイト（:data:`rect_like` の3倍のサイズ）が必要です。言及した数の生成されたbboxを考えると、:data:`quad_like` 情報を返すことは重大な影響を与えるでしょう。

en: In the vast majority of cases, we are dealing with **horizontal text only**, where bboxes provide entirely sufficient information.
ja: ほとんどの場合、**水平テキストのみ** を扱っており、bboxは十分な情報を提供します。

en: In addition, **the full quad information is not lost**: it can be recovered as needed for lines, spans, and characters by using the appropriate function from the following list:
ja: さらに、**フルクワッド情報は失われていません**。必要に応じて、以下のリストから適切な関数を使用して行、スパン、および文字のクワッド情報を回復できます：

en: :meth:`recover_quad` -- the quad of a complete span
ja: :meth:`recover_quad` – 完全なスパンのクワッド

en: :meth:`recover_span_quad` -- the quad of a character subset of a span
ja: :meth:`recover_span_quad` – スパンの一部の文字のクワッド

en: :meth:`recover_line_quad` -- the quad of a line
ja: :meth:`recover_line_quad` – 行のクワッド

en: :meth:`recover_char_quad` -- the quad of a character
ja: :meth:`recover_char_quad` – 文字のクワッド

en: As mentioned, using these functions is ever only needed, if the text is **not written horizontally** -- `line["dir"] != (1, 0)` -- and you need the quad for text marker annotations (:meth:`Page.add_highlight_annot` and friends).
ja: 前述のように、これらの関数を使用する必要があるのは、テキストが **水平に書かれていない** 場合 - `line["dir"] != (1, 0)` - およびテキストマーカーアノテーション（:meth:`Page.add_highlight_annot` など）でクワッドが必要な場合のみです。

en: Page Dictionary
ja: ページ辞書

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

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

en: width of the `clip` rectangle *(float)*
ja: `clip` 矩形の幅 *(float)*

en: height of the `clip` rectangle *(float)*
ja: `clip` 矩形の高さ *(float)*

en: *list* of block dictionaries
ja: ブロック辞書の *list*

en: Block Dictionaries
ja: ブロック辞書

en: Block dictionaries come in two different formats for **image blocks** and for **text blocks**.
ja: ブロック辞書は、**画像ブロック** と **テキストブロック** の2つの異なるフォーマットで提供されます。

en: *(Changed in v1.18.0)* -- new dict key *number*, the block number.
ja: *(v1.18.0で変更)* - 新しいdictキー *number* 、ブロック番号。

en: *(Changed in v1.18.11)* -- new dict key *transform*, the image transformation matrix for image blocks.
ja: *(v1.18.11で変更)* - 新しいdictキー *transform* 、画像ブロックの画像変換行列。

en: *(Changed in v1.18.11)* -- new dict key *size*, the size of the image in bytes for image blocks.
ja: *(v1.18.11で変更)* - 新しいdictキー *size* 、画像ブロックのバイト単位の画像サイズ。

en: **Image block:**
ja: **画像ブロック：**

en: 1 = image *(int)*
ja: 1 = 画像 *(int)*

en: image bbox on page (:data:`rect_like`)
ja: ページ上の画像の境界ボックス（:data:`rect_like`）

en: block count *(int)*
ja: ブロック数 *(int)*

en: image type *(str)*, as file extension, see below
ja: 画像の種類 *(str)*、ファイル拡張子として、以下参照

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

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

en: colorspace component count *(int)*
ja: カラースペースのコンポーネント数 *(int)*

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

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

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

en: matrix transforming image rect to bbox (:data:`matrix_like`)
ja: 画像矩形を境界ボックスに変換する行列（:data:`matrix_like`）

en: size of the image in bytes *(int)*
ja: 画像のサイズ（バイト単位）*(int)*

en: image content *(bytes)*
ja: 画像コンテンツ *(bytes)*

en: Possible values of the "ext" key are "bmp", "gif", "jpeg", "jpx" (JPEG 2000), "jxr" (JPEG XR), "png", "pnm", and "tiff".
ja: "ext"キーの可能な値は、"bmp"、"gif"、"jpeg"、"jpx"（JPEG 2000）、"jxr"（JPEG XR）、"png"、"pnm"、および "tiff" です。

en: An image block is generated for **all and every image occurrence** on the page. Hence there may be duplicates, if an image is shown at different locations.
ja: ページ上の **すべての画像** が画像ブロックとして生成されます。したがって、画像が異なる場所で表示される場合、重複が発生する可能性があります。

en: :ref:`TextPage` and corresponding method :meth:`Page.get_text` are **available for all document types**. Only for PDF documents, methods :meth:`Document.get_page_images` / :meth:`Page.get_images` offer some overlapping functionality as far as image lists are concerned. But both lists **may or may not** contain the same items. Any differences are most probably caused by one of the following:
ja: :ref:`TextPage` および対応するメソッド :meth:`Page.get_text` は **すべてのドキュメントタイプ** で利用可能です。PDFドキュメントの場合、:meth:`Document.get_page_images` / :meth:`Page.get_images` は画像リストに関する機能が一部重複しています。ただし、これらのリストは同じアイテムを **含むかどうかは必ずしも保証されません**。違いがある場合、その原因はおそらく次のいずれかです。

en: "Inline" images (see page 214 of the :ref:`AdobeManual`) of a PDF page are contained in a textpage, but **do not appear** in :meth:`Page.get_images`.
ja: PDFページの「インライン」画像（:ref:`AdobeManual` のページ214を参照）はテキストページに含まれていますが、:meth:`Page.get_images` には **表示されません**。

en: Annotations may also contain images -- these will **not appear** in :meth:`Page.get_images`.
ja: アノテーションにも画像が含まれることがあります。これらは :meth:`Page.get_images` には **表示されません**。

en: Image blocks in a textpage are generated for **every** image location -- whether or not there are any duplicates. This is in contrast to :meth:`Page.get_images`, which will list each image only once (per reference name).
ja: テキストページの画像ブロックは、画像の場所 **ごとに** 生成されます。重複があるかどうかに関係なくです。これは、:meth:`Page.get_images` では各画像が1回だけリストされる（参照名ごとに）のとは対照的です。

en: Images mentioned in the page's :data:`object` definition will **always** appear in :meth:`Page.get_images` [#f1]_. But it may happen, that there is no "display" command in the page's :data:`contents` (erroneously or on purpose). In this case the image will **not appear** in the textpage.
ja: ページの :data:`object` 定義で言及されている画像は、常に :meth:`Page.get_images` に表示されます [#f1]_。ただし、ページの :data:`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: **Text block:**
ja: **テキストブロック：**

en: 0 = text *(int)*
ja: 0 = テキスト *(int)*

en: block rectangle, :data:`rect_like`
ja: ブロックの矩形、:data:`rect_like`

en: *list* of text line dictionaries
ja: テキスト行の辞書の *list*

en: line rectangle, :data:`rect_like`
ja: 行の矩形、:data:`rect_like`

en: writing mode *(int)*: 0 = horizontal, 1 = vertical
ja: 書き込みモード *(int)*：0 = 水平、1 = 垂直

en: writing direction, :data:`point_like`
ja: 書き込み方向、:data:`point_like`

en: *list* of span dictionaries
ja: スパン辞書の *list*

en: Spans contain the actual text. A line contains **more than one span only**, if it contains text with different font properties.
ja: スパンには実際のテキストが含まれています。フォントのプロパティが異なるテキストを含む場合を除き、1行には複数のスパンが含まれます。

en: Changed in version 1.14.17 Spans now also have a *bbox* key (again).
ja: バージョン1.14.17で変更されました：スパンには *bbox* キーが含まれています（再び）。

en: Changed in version 1.17.6 Spans now also have an *origin* key.
ja: バージョン1.17.6で変更されました：スパンには *origin* キーも含まれています。

en: span rectangle, :data:`rect_like`
ja: スパンの矩形、:data:`rect_like`

en: the first character's origin, :data:`point_like`
ja: 最初の文字の原点、:data:`point_like`

en: font name *(str)*
ja: フォント名  *（str）*

en: ascender of the font *(float)*
ja: フォントのアセンダー *（float）*

en: descender of the font *(float)*
ja: フォントのディセンダー *（float）*

en: font size *(float)*
ja: フォントサイズ *（float）*

en: font characteristics *(int)*
ja: フォントの特性 *（int）*

en: text color in sRGB format *(int)*
ja: sRGB形式のテキストカラー *（int）*

en: (only for :meth:`extractDICT`) text *(str)*
ja: （:meth:`extractDICT` のみ）テキスト *（str）*

en: (only for :meth:`extractRAWDICT`) *list* of character dictionaries
ja: （:meth:`extractRAWDICT` のみ）文字の辞書の*list*

en: *(New in version 1.16.0):* *"color"* is the text color encoded in sRGB (int) format, e.g. 0xFF0000 for red. There are functions for converting this integer back to formats (r, g, b) (PDF with float values from 0 to 1) :meth:`sRGB_to_pdf`, or (R, G, B), :meth:`sRGB_to_rgb` (with integer values from 0 to 255).
ja: *バージョン1.16.0で新しく追加された項目：*. *「color」* はsRGB（int）形式でエンコードされたテキストカラーで、例えば赤の場合は0xFF0000です。この整数をフォーマット（r、g、b）（PDFでは0から1の範囲の浮動小数点値） :meth:`sRGB_to_pdf` または（R、G、B）、:meth:`sRGB_to_rgb` （整数値で0から255の範囲）に変換するための関数があります。

en: *(New in v1.18.5):* *"ascender"* and *"descender"* are font properties, provided relative to :data:`fontsize` 1. Note that descender is a negative value. The following picture shows the relationship to other values and properties.
ja: *バージョン1.18.5で新しく追加された項目：* *「ascender」* と *「descender」* は、フォントのプロパティで、 :data:`fontsize` 1に対して提供されます。ディセンダーは負の値であることに注意してください。以下の画像は、他の値やプロパティとの関係を示しています。

en: These numbers may be used to compute the minimum height of a character (or span) -- as opposed to the standard height provided in the "bbox" values (which actually represents the **line height**). The following code recalculates the span bbox to have a height of **fontsize** exactly fitting the text inside:
ja: これらの数字は、文字（またはスパン）の最小の高さを計算するために使用できます。これは、実際には行の高さを表す「bbox」値ではなく、フォントサイズに完全に合わせるための高さを表します。次のコードは、スパンのbboxを、内部のテキストに完全に合わせる高さが **フォントサイズ** となるように再計算します：

en: The above calculation may deliver a **larger** height! This may e.g. happen for OCRed documents, where the risk of all sorts of text artifacts is high. MuPDF tries to come up with a reasonable bbox height, independently from the :data:`fontsize` found in the PDF. So please ensure that the height of `span["bbox"]` is **larger** than `span["size"]`.
ja: 上記の計算は、**より大きな** 高さをもたらす可能性があります。これは、OCRedドキュメントなどで発生する可能性があります。MuPDFは、PDFに存在する :data:`fontsize` から独立して、適切なbboxの高さを見つけ出そうとします。したがって、`span["bbox"]` の高さが `span["size"]` よりも大きいことを確認してください。

en: You may request PyMuPDF to do all of the above automatically by executing `fitz.TOOLS.set_small_glyph_heights(True)`. This sets a global parameter so that all subsequent text searches and text extractions are based on reduced glyph heights, where meaningful.
ja: PyMuPDFに対して、`fitz.TOOLS.set_small_glyph_heights(True)` を実行して、上記のすべてを自動的に実行するように依頼することができます。これは、すべての後続のテキスト検索とテキスト抽出が、縮小されたグリフの高さを基に行われるようにするためのグローバルパラメータを設定します。

en: The following shows the original span rectangle in red and the rectangle with re-computed height in blue.
ja: 以下は、元のspanの矩形を赤で、再計算された高さを持つ矩形を青で示しています。

en: *"flags"* is an integer, which represents font properties except for the first bit 0. They are to be interpreted like this:
ja: *"flags"* は、フォントのプロパティを表す整数で、最初のビット 0 を除いて次のように解釈されます：

en: bit 0: superscripted (2\ :sup:`0`) -- not a font property, detected by MuPDF code.
ja: bit 0: superscripted (2\ :sup:`0`)  - フォントのプロパティではなく、MuPDFコードによって検出されます。

en: bit 1: italic (2\ :sup:`1`)
ja: ビット 1: イタリック(2\ :sup:`1`)

en: bit 2: serifed (2\ :sup:`2`)
ja: ビット 2: セリフ付き (2\ :sup:`2`)

en: bit 3: monospaced (2\ :sup:`3`)
ja: ビット 3: モノスペース (2\ :sup:`3`)

en: bit 4: bold (2\ :sup:`4`)
ja: ビット 4: ボールド (2\ :sup:`4`)

en: Test these characteristics like so:
ja: これらの特性は、次のようにテストできます：

en: Bits 1 thru 4 are font properties, i.e. encoded in the font program. Please note, that this information is not necessarily correct or complete: fonts quite often contain wrong data here.
ja: ビット1からビット4までがフォントのプロパティであり、つまりフォントプログラムにエンコードされています。 ただし、この情報は必ずしも正確または完全ではないことに注意してください。フォントにはしばしば誤ったデータが含まれていることがあります。

en: Character Dictionary for :meth:`extractRAWDICT`
ja: 文字のディクショナリ、:meth:`extractRAWDICT`

en: character's left baseline point, :data:`point_like`
ja: 文字の左ベースラインポイント、:data:`point_like`

en: character rectangle, :data:`rect_like`
ja: 文字の矩形、:data:`rect_like`

en: the character (unicode)
ja: 文字（ユニコード）

en: This image shows the relationship between a character's bbox and its quad: |textpagechar|
ja: この画像は、文字のbboxとそのquadの関係を示しています：|textpagechar|

en: Footnotes
ja: 脚注

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