PyMuPDF 1.23.0rc1 - en to ja translation catalogue (86 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: TextWriter
ja: TextWriter (テキストライター)

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

en: This class represents a MuPDF *text* object. The basic idea is to **decouple (1) text preparation, and (2) text output** to PDF pages.
ja: このクラスはMuPDFの *text* オブジェクトを表します。**基本的なアイデアは、（1）テキストの準備と（2）PDFページへのテキストの出力を切り離すことです** 。

en: During **preparation**, a text writer stores any number of text pieces ("spans") together with their positions and individual font information. The **output** of the writer's prepared content may happen multiple times to any PDF page with a compatible page size.
ja: **準備**中、テキストライターはテキストピース（「スパン」）を任意の数保存し、それぞれの位置と個別のフォント情報とともに保存します。ライターの準備されたコンテンツの **出力** は、互換性のあるページサイズを持つ任意のPDFページに複数回行われる可能性があります。

en: A text writer is an elegant alternative to methods :meth:`Page.insert_text` and friends:
ja: テキストライターは、:meth:`Page.insert_text` などと比較して、次の点で優れた代替手段です：

en: **Improved text positioning:** Choose any point where insertion of text should start. Storing text returns the "cursor position" after the *last character* of the span.
ja: **改良されたテキスト配置：** テキストを挿入する開始点を任意に選択できます。テキストの保存はスパンの *最後の文字の後* の「カーソル位置」を返します。

en: **Free font choice:** Each text span has its own font and :data:`fontsize`. This lets you easily switch when composing a larger text.
ja: **自由なフォントの選択：** 各テキストスパンには独自のフォントと :data:`fontsize` があります。大きなテキストを作成する際に簡単に切り替えることができます。

en: **Automatic fallback fonts:** If a character is not supported by the chosen font, alternative fonts are automatically searched. This significantly reduces the risk of seeing unprintable symbols in the output ("TOFUs" -- looking like a small rectangle). PyMuPDF now also comes with the **universal font "Droid Sans Fallback Regular"**, which supports **all Latin** characters (including Cyrillic and Greek), and **all CJK** characters (Chinese, Japanese, Korean).
ja: **自動フォントのフォールバック：** 選択したフォントが文字をサポートしていない場合、代替フォントが自動的に検索されます。これにより、出力で印刷できない記号を見るリスク（「TOFUs」 - 小さな四角形に見える）が大幅に減少します。PyMuPDFはまた、**すべてのラテン**文字（キリル文字とギリシャ文字を含む）および **すべてのCJK**文字（中国語、日本語、韓国語）をサポートする **ユニバーサルフォント「Droid Sans Fallback Regular」** を提供します。

en: **Cyrillic and Greek Support:** The :ref:`Base-14-fonts` have integrated support of Cyrillic and Greek characters **without specifying encoding.** Your text may be a mixture of Latin, Greek and Cyrillic.
ja: キリル文字とギリシャ文字のサポート：PDFベース14フォントには、エンコーディングを指定せずにキリル文字とギリシャ文字の統合サポートがあります。テキストはラテン文字、ギリシャ文字、キリル文字の混合である可能性があります。

en: **Transparency support:** Parameter *opacity* is supported. This offers a handy way to create watermark-style text.
ja: **透明度のサポート：** パラメータの *透明度* がサポートされています。これはウォーターマークスタイルのテキストを作成する便利な方法を提供します。

en: **Justified text:** Supported for any font -- not just simple fonts as in :meth:`Page.insert_textbox`.
ja: **両端揃えのテキスト**： :meth:`Page.insert_textbox` のような単純なフォントだけでなく、すべてのフォントでサポートされています。

en: **Reusability:** A TextWriter object exists independent from PDF pages. It can be written multiple times, either to the same or to other pages, in the same or in different PDFs, choosing different colors or transparency.
ja: **再利用性：** テキストライターオブジェクトはPDFページとは独立して存在します。同じページまたは異なるページ、同じPDFまたは異なるPDFに、異なる色や透明度を選択して複数回書き込むことができます。

en: Using this object entails three steps:
ja: このオブジェクトを使用するには、次の3つのステップが必要です：

en: When **created**, a TextWriter requires a fixed **page rectangle** in relation to which it calculates text positions. A text writer can write to pages of this size only.
ja: **作成** 時に、テキストライターはテキストの位置を計算するために関連する固定 **ページの矩形** を必要とします。テキストライターは、このサイズのページにのみ書き込むことができます。

en: Store text in the TextWriter using methods :meth:`TextWriter.append`, :meth:`TextWriter.appendv` and :meth:`TextWriter.fill_textbox` as often as is desired.
ja: テキストライターを使用してテキストを :meth:`TextWriter.append`、:meth:`TextWriter.appendv`、および :meth:`TextWriter.fill_textbox` メソッドで必要な回数だけ保存します。

en: Output the TextWriter object on some PDF page(s).
ja: TextWriter オブジェクトをいくつかのPDFページに出力します。

en: Starting with version 1.17.0, TextWriters **do support** text rotation via the *morph* parameter of :meth:`TextWriter.write_text`.
ja: バージョン1.17.0から、TextWriterは :meth:`TextWriter.write_text` の *morph* パラメータを介したテキストの回転を **サポートしています** 。

en: There also exists :meth:`Page.write_text` which combines one or more TextWriters and jointly writes them to a given rectangle and with a given rotation angle -- much like :meth:`Page.show_pdf_page`.
ja: また、 :meth:`Page.write_text` も存在し、1つ以上のTextWriterを組み合わせて、指定された矩形と回転角に共同で書き込みます - :meth:`Page.show_pdf_page` のように。

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

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

en: Add text in horizontal write mode
ja: 水平書き込みモードでテキストを追加します。

en: Add text in vertical write mode
ja: 垂直書き込みモードでテキストを追加します。

en: Fill rectangle (horizontal write mode)
ja: 矩形を埋めます（水平書き込みモード）。

en: Output TextWriter to a PDF page
ja: TextWriterをPDFページに出力します。

en: Text color (can be changed)
ja: テキストの色（変更可能です）。

en: Last written character ends here
ja: 最後に書かれた文字がここで終了します。

en: Text opacity (can be changed)
ja: テキストの透明度（変更可能です）。

en: Page rectangle used by this TextWriter
ja: このTextWriterが使用するページの矩形。

en: Area occupied so far
ja: 現在までに占有された領域。

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

en: rectangle internally used for text positioning computations.
ja: テキストの配置計算に内部的に使用される矩形。

en: sets the transparency for the text to store here. Values outside the interval `[0, 1)` will be ignored. A value of e.g. 0.5 means 50% transparency.
ja: ここに保存されるテキストの透明度を設定します。区間 `[0, 1)` 外の値は無視されます。例：0.5の場合、50％の透明度を意味します。

en: the color of the text. All colors are specified as floats *0 <= color <= 1*. A single float represents some gray level, a sequence implies the colorspace via its length.
ja: テキストの色。すべての色は浮動小数点数 *0 <= color <= 1* として指定されます。単一の浮動小数点数は一定の灰色レベルを表し、シーケンスはその長さを介して色空間を示します。

en: *Changed in v1.18.9*
ja: *バージョン1.18.9で変更*

en: *Changed in v1.18.15*
ja: *バージョン1.18.15で変更*

en: Add some new text in horizontal writing.
ja: 水平書き込みで新しいテキストを追加します。

en: start position of the text, the bottom left point of the first character.
ja: テキストの開始位置、最初の文字の左下の点です。

en: a string of arbitrary length. It will be written starting at position "pos".
ja: 任意の長さの文字列。位置「pos」から書き始められます。

en: a :ref:`Font`. If omitted, `fitz.Font("helv")` will be used.
ja: :ref:`Font`。省略された場合、`fitz.Font("helv")` が使用されます。

en: the :data:`fontsize`, a positive number, default 11.
ja: :data:`fontsize`、正の数、デフォルトは11です。

en: *(New in v1.18.9)* whether the text should be written from right to left. Applicable for languages like Arabian or Hebrew. Default is *False*. If *True*, any Latin parts within the text will automatically converted. There are no other consequences, i.e. :attr:`TextWriter.last_point` will still be the rightmost character, and there neither is any alignment taking place. Hence you may want to use :meth:`TextWriter.fill_textbox` instead.
ja: *（バージョン1.18.9で新機能）* テキストを右から左に書くかどうか。アラビア語やヘブライ語などの言語に適用されます。デフォルトは *False* です。*True* の場合、テキスト内のラテン語部分は自動的に変換されます。他に何の影響もないため、:attr:`TextWriter.last_point` は依然として最右の文字ですし、配置も行われません。そのため、代わりに :meth:`TextWriter.fill_textbox` を使用することがあります。

en: *(New in v1.18.15)* look for the character's Small Capital version in the font. If present, take that value instead. Otherwise the original character (this font or the fallback font) will be taken. The fallback font will never return small caps. For example, this snippet::
ja: *（バージョン1.18.15で新機能）* フォント内の文字の小文字バージョンを探します。存在する場合、その値が使用されます。それ以外の場合、元の文字（このフォントまたはフォールバックフォント）が使用されます。フォールバックフォントは小文字バージョンを返しません。たとえば、次のスニペット::

en: will produce this PDF text:
ja: これにより、このPDFテキストが生成されます：

en: Returns
ja: 返り値：

en: :attr:`text_rect` and :attr:`last_point`. *(Changed in v1.18.0:)* Raises an exception for an unsupported font -- checked via :attr:`Font.is_writable`.
ja: :attr:`text_rect` および :attr:`last_point`。 *（v1.18.0 で変更）*：サポートされていないフォントの場合、:attr:`Font.is_writable` を介してチェックされた例外が発生します。

en: Add some new text in vertical, top-to-bottom writing.
ja: 縦書きの新しいテキストを追加します。

en: a string. It will be written starting at position "pos".
ja: 文字列。 "pos" から開始して書き込まれます。

en: the :data:`fontsize`, a positive float, default 11.
ja: :data:`fontsize`、正の浮動小数点数、デフォルトは 11 です。

en: *(New in v1.18.15)* see :meth:`append`.
ja: *（v1.18.15 で新しい）* 詳細は :meth:`append` を参照してください。

en: Changed in 1.17.3: New parameter `pos` to specify where to start writing within rectangle.
ja: 1.17.3で変更：新しいパラメーター `pos` を追加して、矩形内での書き込みを開始する位置を指定できるようにしました。

en: Changed in v1.18.9: Return list of lines which do not fit in rectangle. Support writing right-to-left (e.g. Arabian, Hebrew).
ja: v1.18.9で変更：矩形に収まらない行のリストを返すようにしました。右から左に書くサポートを追加（アラビア語、ヘブライ語など）。

en: Changed in v1.18.15: Prefer small caps if supported by the font.
ja: v1.18.15で変更：フォントがサポートしている場合、小文字のテキストを優先します。

en: Fill a given rectangle with text in horizontal writing mode. This is a convenience method to use as an alternative for :meth:`append`.
ja: 指定された矩形を水平書きモードでテキストで埋めます。これは、:meth:`append` の代替手段として使用する便利な方法です。

en: the area to fill. No part of the text will appear outside of this.
ja: 埋める領域。テキストのいずれの部分もこれの外には表示されません。

en: the text. Can be specified as a (UTF-8) string or a list / tuple of strings. A string will first be converted to a list using *splitlines()*. Every list item will begin on a new line (forced line breaks).
ja: テキスト。UTF-8文字列または文字列のリスト/タプルとして指定できます。文字列は最初に *splitlines()* を使用してリストに変換されます。各リストアイテムは新しい行で始まります（強制的な改行が行われます）。

en: *(new in v1.17.3)* start storing at this point. Default is a point near rectangle top-left.
ja: *（v1.17.3で新規）* このポイントから記憶を開始します。デフォルトは矩形の左上近くのポイントです。

en: the :ref:`Font`, default `fitz.Font("helv")`.
ja: :ref:`Font`、デフォルトは `fitz.Font("helv")`。

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

en: text alignment. Use one of TEXT_ALIGN_LEFT, TEXT_ALIGN_CENTER, TEXT_ALIGN_RIGHT or TEXT_ALIGN_JUSTIFY.
ja: テキストの配置。TEXT_ALIGN_LEFT、TEXT_ALIGN_CENTER、TEXT_ALIGN_RIGHT、またはTEXT_ALIGN_JUSTIFYのいずれかを使用します。

en: *(New in v1.18.9)* whether the text should be written from right to left. Applicable for languages like Arabian or Hebrew. Default is *False*. If *True*, any Latin parts are automatically reverted. You must still set the alignment (if you want right alignment), it does not happen automatically -- the other alignment options remain available as well.
ja: *(v1.18.9で新規）* テキストを右から左に書くかどうか。アラビア語やヘブライ語などの言語に適用可能です。デフォルトは *False* です。*True* の場合、ラテン文字部分は自動的に反転されます。右寄せを希望する場合、引き続き配置を設定する必要があります（他の配置オプションも利用可能）。

en: on text overflow do nothing, warn, or raise an exception. Overflow text will never be written. **Changed in v1.18.9:**
ja: テキストのオーバーフローがある場合、何もしない、警告する、または例外を発生させるかどうか。オーバーフローテキストは書き込まれません。**v1.18.9で変更：**

en: Default is *None*.
ja: デフォルトは *None* です。

en: The list of overflow lines will be returned.
ja: オーバーフローラインのリストが返されます。

en: *New in v1.18.9* -- List of lines that did not fit in the rectangle. Each item is a tuple `(text, length)` containing a string and its length (on the page).
ja: *v1.18.9で新規* -矩形に収まらなかった行のリスト。各アイテムは、文字列とそのページ上の長さ（長さ）を含むタプル `(text, length)` です。

en: Use these methods as often as is required -- there is no technical limit (except memory constraints of your system). You can also mix :meth:`append` and text boxes and have multiple of both. Text positioning is exclusively controlled by the insertion point. Therefore there is no need to adhere to any order. *(Changed in v1.18.0:)* Raise an exception for an unsupported font -- checked via :attr:`Font.is_writable`.
ja: これらのメソッドは必要な回数だけ使用できます。技術的な制限はありません（システムのメモリ制約を除く）。また、:meth:`append` とテキストボックスを混在させ、それぞれ複数持つこともできます。テキストの配置は挿入ポイントによってのみ制御されます。したがって、特定の順序に従う必要はありません。*（v1.18.0で変更）* ：サポートされていないフォントに対して例外を発生させます - :attr:`Font.is_writable` をチェックします。

en: Write the TextWriter text to a page, which is the only mandatory parameter. The other parameters can be used to temporarily override the values used when the TextWriter was created.
ja: TextWriterのテキストをページに書き込みます。これは唯一の必須パラメータで、TextWriterが作成されたときに使用される値を一時的にオーバーライドするために、他のパラメータを使用できます。

en: write to this :ref:`Page`.
ja: この :ref:`Page` に書き込みます。

en: override the value of the TextWriter for this output.
ja: この出力のためにTextWriterの値をオーバーライドします。

en: modify the text appearance by applying a matrix to it. If provided, this must be a sequence *(fixpoint, matrix)* with a point-like *fixpoint* and a matrix-like *matrix*. A typical example is rotating the text around *fixpoint*.
ja: テキストの外観を変更するために、それに行列を適用して修正します。提供される場合、これは *（fixpoint、matrix）* としてシーケンスでなければなりません。point-like *fixpoint* とmatrix-like *matrix* を持っています。典型的な例は、テキストを *fixpoint* の周りで回転させることです。

en: put in foreground (default) or background.
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: The PDF `Tr` operator value. Values: 0 (default), 1, 2, 3 (invisible).
ja: PDF `Tr` 演算子の値。値：0（デフォルト）、1、2、3（不可視）。

en: The area currently occupied.
ja: 現在占有されている領域。

en: The "cursor position" -- a :ref:`Point` -- after the last written character (its bottom-right).
ja: 最後に書かれた文字の後にある「カーソル位置」 - :ref:`Point` 形式。

en: The text opacity (modifiable).
ja: テキストの不透明度（変更可能）。

en: The text color (modifiable).
ja: テキストの色（変更可能）。

en: The page rectangle for which this TextWriter was created. Must not be modified.
ja: このTextWriterが作成されたページの長方形。変更しないでください。

en: To see some demo scripts dealing with TextWriter, have a look at `this <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/textwriter>`_ repository.
ja: TextWriterを扱うデモスクリプトを見るには、`この <https://github.com/pymupdf/PyMuPDF-Utilities/tree/master/textwriter>`_ リポジトリをご覧ください。

en: Opacity and color apply to **all the text** in this object.
ja: 不透明度と色は、このオブジェクト内の **すべてのテキスト** に適用されます。

en: If you need different colors / transparency, you must create a separate TextWriter. Whenever you determine the color should change, simply append the text to the respective TextWriter using the previously returned :attr:`last_point` as position for the new text span.
ja: 異なる色/透明度が必要な場合、別々のTextWriterを作成する必要があります。色が変更されるべきと判断した場合、新しいテキストスパンの位置として前回返された :attr:`last_point` を使用して、対応するTextWriterにテキストを追加するだけです。

en: Appending items or text boxes can occur in arbitrary order: only the position parameter controls where text appears.
ja: アイテムまたはテキストボックスの追加は任意の順序で発生できます：テキストが表示される位置を制御するのは、位置パラメータのみです。

en: Font and :data:`fontsize` can freely vary within the same TextWriter. This can be used to let text with different properties appear on the same displayed line: just specify *pos* accordingly, and e.g. set it to :attr:`last_point` of the previously added item.
ja: 同じTextWriter内でフォントと :data:`fontsize` を自由に変更できます。これは、異なるプロパティを持つテキストが同じ表示される行に表示されるようにするために使用できます。posを適切に指定し、前に追加したアイテムの :attr:`last_point` に設定してください。

en: You can use the *pos* argument of :meth:`TextWriter.fill_textbox` to set the position of the first text character. This allows filling the same textbox with contents from different :ref:`TextWriter` objects, thus allowing for multiple colors, opacities, etc.
ja: :meth:`TextWriter.fill_textbox` の *pos* 引数を使用して、最初のテキスト文字の位置を設定できます。これにより、異なる :ref:`TextWriter` オブジェクトからのコンテンツを含む同じテキストボックスを埋めることができ、複数の色、不透明度などが可能になります。

en: MuPDF does not support all fonts with this feature, e.g. no Type3 fonts. Starting with v1.18.0 this can be checked via the font attribute :attr:`Font.is_writable`. This attribute is also checked when using :ref:`TextWriter` methods.
ja: MuPDFは、この機能を持つすべてのフォントをサポートしているわけではありません。たとえば、Type3フォントはサポートされていません。v1.18.0以降、:attr:`Font.is_writable` 属性を使用して、これを確認できます。この属性は、:ref:`TextWriter` メソッドを使用する際にもチェックされます。
