PyMuPDF 1.23.0rc1 - en to ja translation catalogue (132 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: Font
ja: Font (フォント)

en: New in v1.16.18
ja: 新機能：v1.16.18

en: This class represents a font as defined in MuPDF (*fz_font_s* structure). It is required for the new class :ref:`TextWriter` and the new :meth:`Page.write_text`. Currently, it has no connection to how fonts are used in methods :meth:`Page.insert_text` or :meth:`Page.insert_textbox`, respectively.
ja: このクラスは、MuPDFで定義されたフォント（fz_font_s構造体）を表します。これは、新しいクラス :ref:`TextWriter` と新しい :meth:`Page.write_text` に必要であり、現在、:meth:`Page.insert_text` または :meth:`Page.insert_textbox` メソッドでフォントがどのように使用されているかとは関係ありません。

en: A Font object also contains useful general information, like the font bbox, the number of defined glyphs, glyph names or the bbox of a single glyph.
ja: Fontオブジェクトには、フォントbbox、定義済みグリフの数、グリフ名、単一グリフのbboxなど、有用な一般情報も含まれています。

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

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

en: Width of a character
ja: 文字の幅

en: Glyph rectangle
ja: グリフの矩形

en: Get unicode from glyph name
ja: グリフ名からUnicodeを取得

en: Return glyph id of unicode
ja: UnicodeのグリフIDを返す

en: Compute string length
ja: 文字列の長さを計算

en: Tuple of char widths of a string
ja: 文字列の文字幅のタプル

en: Get glyph name of a unicode
ja: Unicodeのグリフ名を取得

en: Array of supported unicodes
ja: サポートされているUnicodeの配列

en: Font ascender
ja: フォントのアセンダ

en: Font descender
ja: フォントのディセンダ

en: Font rectangle
ja: フォントの矩形

en: Copy of the font's binary image
ja: フォントのバイナリイメージのコピー

en: Collection of font properties
ja: フォントのプロパティのコレクション

en: Number of supported glyphs
ja: サポートされているグリフの数

en: Name of font
ja: フォントの名前

en: Font usable with :ref:`TextWriter`
ja: :ref:`TextWriter` で使用可能なフォント

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

en: Font constructor. The large number of parameters are used to locate font, which most closely resembles the requirements. Not all parameters are ever required -- see the below pseudo code explaining the logic how the parameters are evaluated.
ja: フォントコンストラクタ。多くのパラメータは、要件に最も近いフォントを特定するために使用されます。必ずしもすべてのパラメータが必要とされるわけではありません - パラメータが評価されるロジックを説明する以下の疑似コードを参照してください。

en: Parameters
ja: パラメータ

en: one of the :ref:`Base-14-Fonts` or CJK fontnames. Also possible are a select few other names like (watch the correct spelling): "Arial", "Times", "Times Roman".
ja: :ref:`Base-14-Fonts` またはCJKフォントの名前のいずれか。また、"Arial"、"Times"、"Times Roman"などの選択的な名前も可能です。

en: *(Changed in v1.17.5)*
ja: (v1.17.5で変更)

en: If you have installed `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_, there are also new "reserved" fontnames available, which are listed in :attr:`fitz_fonts` and in the table further down.
ja: `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_ をインストールしている場合、:attr:`fitz_fonts` と下の表でリストされている新しい「予約済み」フォント名も利用可能です。

en: the filename of a fontfile somewhere on your system [#f1]_.
ja: システムのどこかにあるフォントファイルのファイル名 [#f1]_。

en: a fontfile loaded in memory [#f1]_.
ja: メモリ内にロードされたフォントファイル [#f1]_。

en: the number of a UCDN script. Currently supported in PyMuPDF are numbers 24, and 32 through 35.
ja: UCDN（Unicode Character Database Number）のスクリプト番号です。現在、PyMuPDFでサポートされている番号は、24、および32から35です。

en: one of the values "zh-Hant" (traditional Chinese), "zh-Hans" (simplified Chinese), "ja" (Japanese) and "ko" (Korean). Otherwise, all ISO 639 codes from the subsets 1, 2, 3 and 5 are also possible, but are currently documentary only.
ja: UCDNスクリプトの番号。現在、PyMuPDFでサポートされているのは24、および32から35の数値です

en: an alternative selector for one of the CJK fonts.
ja: CJKフォントの選択のための代替セレクタ。

en: look for a bold font.
ja: 太字のフォントを探します。

en: look for an italic font.
ja: イタリック体のフォントを探します。

en: look for a serifed font.
ja: セリフ付きのフォントを探します。

en: Returns
ja: 戻り値

en: a MuPDF font if successful. This is the overall sequence of checks to determine an appropriate font:
ja: 成功した場合はMuPDFフォント。適切なフォントを特定するための全体のチェックのシーケンスは次のとおりです。

en: Argument
ja: 引数

en: Action
ja: アクション

en: Create font from file, exception if failure.
ja: ファイルからフォントを作成し、失敗した場合は例外をスローします。

en: Create font from buffer, exception if failure.
ja: バッファからフォントを作成し、失敗した場合は例外をスローします。

en: Create universal font, always succeeds.
ja: ユニバーサルフォントを作成し、常に成功します。

en: Create a Base-14 font, universal font, or font provided by `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_. See table below.
ja: ベース14フォント、ユニバーサルフォント、または `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_ で提供されるフォントを作成します。下の表を参照してください。

en: With the usual reserved names "helv", "tiro", etc., you will create fonts with the expected names "Helvetica", "Times-Roman" and so on. **However**, and in contrast to :meth:`Page.insert_font` and friends,
ja: 通常の予約済みの名前「helv」、「tiro」などを使用すると、期待どおりの名前「Helvetica」、「Times-Roman」などのフォントが作成されます。**ただし** 、:meth:`Page.insert_font` などとは異なり、

en: a font file will **always** be embedded in your PDF,
ja: フォントファイルはPDFに **常に** 埋め込まれます。

en: Greek and Cyrillic characters are supported without needing the *encoding* parameter.
ja: ギリシャ文字およびキリル文字は *エンコーディング* パラメータを必要とせずにサポートされます。

en: Using *ordering >= 0*, or fontnames "cjk", "china-t", "china-s", "japan" or "korea" will **always create the same "universal"** font **"Droid Sans Fallback Regular"**. This font supports **all Chinese, Japanese, Korean and Latin characters**, including Greek and Cyrillic. This is a sans-serif font.
ja: ordering >= 0を使用するか、フォント名「cjk」、「china-t」、「china-s」、「japan」、「korea」を使用すると、**常に同じ「汎用」** フォント **「Droid Sans Fallback Regular」が作成されます**。このフォントは、**中国語、日本語、韓国語、ラテン文字、ギリシャ文字、キリル文字を含むすべての文字をサポートしています**。これはサンセリフのフォントです。

en: Actually, you would rarely ever need another sans-serif font than **"Droid Sans Fallback Regular"**. **Except** that this font file is relatively large and adds about 1.65 MB (compressed) to your PDF file size. If you do not need CJK support, stick with specifying "helv", "tiro" etc., and you will get away with about 35 KB compressed.
ja: 実際、通常、「Droid Sans Fallback Regular」以外のサンセリフのフォントはほとんど必要ありません。ただし、このフォントファイルは比較的大きく、PDFファイルサイズを約1.65 MB（圧縮）増加させます。CJKのサポートが必要でない場合は、「helv」、「tiro」などを指定し、約35 KB（圧縮）で済むでしょう。

en: If you **know** you have a mixture of CJK and Latin text, consider just using `Font("cjk")` because this supports everything and also significantly (by a factor of up to three) speeds up execution: MuPDF will always find any character in this single font and never needs to check fallbacks.
ja: CJKとラテン文字の混合テキストがあることを **知っている** 場合は、単に `Font("cjk")` を使用して、すべてをサポートし、実行を大幅に高速化します（最大3倍）。MuPDFは常にこの単一のフォントで任意の文字を見つけることができ、フォールバックをチェックする必要はありません。

en: But if you do use some other font, you will still automatically be able to also write CJK characters: MuPDF detects this situation and silently falls back to the universal font (which will then of course also be embedded in your PDF).
ja: ただし、他のフォントを使用する場合、CJK文字を書き込むことも自動的にできるようになります。MuPDFはこの状況を検出し、静かにユニバーサルフォントにフォールバックします（その場合、当然、PDFにも埋め込まれます）。

en: *(New in v1.17.5)* Optionally, some new "reserved" fontname codes become available if you install `pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_, `pip install pymupdf-fonts`. **"Fira Mono"** is a mono-spaced sans font set and **FiraGO** is another non-serifed "universal" font set which supports all Latin (including Cyrillic and Greek) plus Thai, Arabian, Hewbrew and Devanagari -- but none of the CJK languages. The size of a FiraGO font is only a quarter of the "Droid Sans Fallback" size (compressed 400 KB vs. 1.65 MB) -- **and** it provides the weights bold, italic, bold-italic -- which the universal font doesn't.
ja: *（v1.17.5で新登場）* オプションで、`pymupdf-fonts <https://pypi.org/project/pymupdf-fonts/>`_ をインストールすると、いくつかの新しい「予約済み」フォント名コードが利用可能になります。 **"Fira Mono"** は等幅のサンセリフフォントセットで、**FiraGO** はラテン文字（キリル文字とギリシャ文字を含む）およびタイ語、アラビア語、ヘブライ語、デーバナガリ語をサポートする別のサンセリフの「ユニバーサル」フォントセットですが、CJK言語はサポートしていません。 FiraGOフォントのサイズは「Droid Sans Fallback」のサイズの1/4だけです（圧縮400 KB対1.65 MB） **そして** 、ユニバーサルフォントにはない太字、イタリック、太字イタリックのウェイトを提供しています。

en: **"Space Mono"** is another nice and small mono-spaced font from Google Fonts, which supports Latin Extended characters and comes with all 4 important weights.
ja: **"Space Mono"** はGoogleフォントからのもう1つの素敵で小さな等幅フォントで、ラテン拡張文字をサポートし、すべての4つの重要なウェイトが含まれています。

en: The following table maps a fontname code to the corresponding font. For the current content of the package please see its documentation:
ja: 次の表は、フォント名コードを対応するフォントにマッピングしています。パッケージの現在の内容については、そのドキュメンテーションを参照してください：

en: Code
ja: コード

en: Fontname
ja: フォント名

en: New in
ja: バージョン

en: Comment
ja: コメント

en: FiraGO Regular
ja: FiraGO レギュラー

en: narrower than Helvetica
ja: Helveticaよりも狭い

en: FiraGO Bold
ja: FiraGO ボールド

en: FiraGO Italic
ja: FiraGO イタリック

en: FiraGO Bold Italic
ja: FiraGO ボールドイタリック

en: Fira Mono Regular
ja: Fira Mono レギュラー

en: Fira Mono Bold
ja: Fira Mono ボールド

en: Space Mono Regular
ja: Space Mono レギュラー

en: Space Mono Bold
ja: Space Mono ボールド

en: Space Mono Italic
ja: Space Mono イタリック

en: Space Mono Bold-Italic
ja: Space Mono ボールドイタリック

en: Noto Sans Math Regular
ja: Noto Sans Math レギュラー

en: math symbols
ja: 数学記号

en: Noto Music Regular
ja: Noto Music レギュラー

en: musical symbols
ja: 音楽記号

en: Noto Sans Symbols Regular
ja: Noto Sans Symbols レギュラー

en: replacement for "symb"
ja: "symb"の代替

en: Noto Sans Symbols2 Regular
ja: Noto Sans Symbols2 レギュラー

en: extended symbol set
ja: 拡張記号セット

en: Noto Sans Regular
ja: Noto Sans レギュラー

en: alternative to Helvetica
ja: Helveticaの代替

en: Noto Sans Italic
ja: Noto Sans イタリック

en: Noto Sans Bold
ja: Noto Sans ボールド

en: Noto Sans BoldItalic
ja: Noto Sans ボールドイタリック

en: Check whether the unicode *chr* exists in the font or (option) some fallback font. May be used to check whether any "TOFU" symbols will appear on output.
ja: 指定した Unicode 文字 *chr* がフォント内または（オプションで）フォールバックフォント内に存在するかどうかを確認します。これは、「TOFU（豆腐）」と呼ばれる記号が出力に表示されるかどうかを確認するために使用できます。

en: the unicode of the character (i.e. *ord()*).
ja: 文字の Unicode 値（すなわち、*ord()* 関数の結果）。

en: the language -- currently unused.
ja: 言語（現在は未使用）。

en: the UCDN script number.
ja: UCDN（Unicode Common Locale Data Repository）スクリプト番号。

en: *(new in v1.17.5)* perform an extended search in fallback fonts or restrict to current font (default).
ja: *（v1.17.5 で新たに追加）* フォールバックフォントでの拡張検索を実行するか、現在のフォントに制限するかを指定します（デフォルト）。

en: *(changed in 1.17.7)* the glyph number. Zero indicates no glyph found.
ja: *（v1.17.7 で変更）* グリフ番号。ゼロはグリフが見つからないことを示します。

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

en: Return an array of unicodes supported by this font.
ja: このフォントがサポートする Unicode の配列を返します。

en: an *array.array* [#f2]_ of length at most :attr:`Font.glyph_count`. I.e. *chr()* of every item in this array has a glyph in the font without using fallbacks. This is an example display of the supported glyphs:
ja: :attr:`Font.glyph_count` 以上の長さを持つ array.array [#f2]_。つまり、この配列内の各アイテムの *chr()* は、フォールバックを使用せずにフォント内にグリフを持っていることを示します。以下はサポートされるグリフの例示です：

en: This method only returns meaningful data for fonts having a CMAP (character map, charmap, the `/ToUnicode` PDF key). Otherwise, this array will have length 1 and contain zero only.
ja: このメソッドは、CMAP（文字マップ、charmap、`/ToUnicode` PDF キー）を持つフォントに対してのみ意味のあるデータを返します。それ以外の場合、この配列は長さ1で、ゼロのみを含みます。

en: Calculate the "width" of the character's glyph (visual representation).
ja: 文字のグリフ（視覚的な表現）の「幅」を計算します。

en: the unicode number of the character. Use *ord()*, not the character itself. Again, this should normally work even if a character is not supported by that font, because fallback fonts will be checked where necessary.
ja: 文字のUnicode番号。文字自体ではなく、*ord（）* を使用します。文字がそのフォントでサポートされていない場合でも、必要に応じてフォールバックフォントがチェックされるため、通常は機能するはずです。

en: write mode, 0 = horizontal, 1 = vertical.
ja: 書き込みモード、0 = 横方向、1 = 縦方向。

en: The other parameters are not in use currently.
ja: その他のパラメータは現在使用されていません。

en: a float representing the glyph's width relative to **fontsize 1**.
ja: **フォントサイズ** 1に対するグリフの幅を表す浮動小数点数。

en: Return the unicode value for a given glyph name. Use it in conjunction with `chr()` if you want to output e.g. a certain symbol.
ja: 指定されたグリフ名のUnicode値を返します。特定のシンボルを出力したい場合は、`chr()` と組み合わせて使用します。

en: The name of the glyph.
ja: グリフの名前。

en: The unicode integer, or 65533 = 0xFFFD if the name is unknown. Examples: `font.glyph_name_to_unicode("Sigma") = 931`, `font.glyph_name_to_unicode("sigma") = 963`. Refer to the `Adobe Glyph List <https://github.com/adobe-type-tools/agl-aglfn/blob/master/glyphlist.txt>`_ publication for a list of glyph names and their unicode numbers. Example:
ja: Unicode整数、または名前が不明な場合は65533 = 0xFFFDです。例：`font.glyph_name_to_unicode("Sigma") = 931`、`font.glyph_name_to_unicode("sigma") = 963` 。Adobe Glyph Listの出版物を参照して、グリフ名とUnicode番号のリストを確認してください。例：

en: The glyph rectangle relative to :data:`fontsize` 1.
ja: :data:`fontsize` 1に対するグリフの矩形領域。

en: *ord()* of the character.
ja: 文字の *ord()* 。

en: a :ref:`Rect`.
ja: :ref:`Rect`。

en: Show the name of the character's glyph.
ja: 文字のグリフの名前を表示します。

en: the unicode number of the character. Use *ord()*, not the character itself.
ja: 文字のunicode番号。文字自体ではなく *ord()* を使用します。

en: a string representing the glyph's name. E.g. `font.glyph_name(ord("#")) = "numbersign"`. For an invalid code ".notfound" is returned.
ja: グリフの名前を表す文字列。例：`font.glyph_name(ord("#")) = "numbersign"` 。無効なコードの場合、".notfound" が返されます。

en: *(Changed in v1.18.0)* This method and :meth:`Font.glyph_name_to_unicode` no longer depend on a font and instead retrieve information from the **Adobe Glyph List**. Also available as `fitz.unicode_to_glyph_name()` and resp. `fitz.glyph_name_to_unicode()`.
ja: *(1.18.0で変更)* このメソッドと:meth:`Font.glyph_name_to_unicode` はもはやフォントに依存せず、**Adobe Glyph List** から情報を取得します。`fitz.unicode_to_glyph_name()` とresp. `fitz.glyph_name_to_unicode()` としても利用可能です。

en: Calculate the length in points of a unicode string.
ja: Unicode文字列の長さをポイント単位で計算します。

en: There is a functional overlap with :meth:`get_text_length` for Base-14 fonts only.
ja: Base-14フォントに対しては、:meth:`get_text_length` と機能が重複しています。

en: a text string, UTF-8 encoded.
ja: テキスト文字列、UTF-8エンコード。

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

en: the length of the string in points when stored in the PDF. If a character is not contained in the font, it will automatically be looked up in a fallback font.
ja: PDFに格納された文字列のポイント単位の長さ。文字がフォントに含まれていない場合、自動的にフォールバックフォントで検索されます。

en: This method was originally implemented in Python, based on calling :meth:`Font.glyph_advance`. For performance reasons, it has been rewritten in C for v1.18.14. To compute the width of a single character, you can now use either of the following without performance penalty:
ja: このメソッドは元々Pythonで実装され、:meth:`Font.glyph_advance` を呼び出すことに基づいていました。性能の理由から、v1.18.14向けにCで書き直されました。単一の文字の幅を計算するには、以下のいずれかを使用でき、パフォーマンスに差異はありません：

en: For multi-character strings, the method offers a huge performance advantage compared to the previous implementation: instead of about 0.5 microseconds for each character, only 12.5 nanoseconds are required for the second and subsequent ones.
ja: 複数文字の文字列に対して、このメソッドは以前の実装と比べて非常に高速で、各文字ごとに約0.5マイクロ秒かかる代わりに、2番目以降の文字には12.5ナノ秒しか必要ありません。

en: *New in v1.18.14*
ja: *v1.18.14で新たに導入*

en: Sequence of character lengths in points of a unicode string.
ja: Unicode文字列の文字の長さ（ポイント単位）のシーケンス。

en: the lengths in points of the characters of a string when stored in the PDF. It works like :meth:`Font.text_length` broken down to single characters. This is a high speed method, used e.g. in :meth:`TextWriter.fill_textbox`. The following is true (allowing rounding errors): `font.text_length(text) == sum(font.char_lengths(text))`.
ja: PDFに保存される文字列の各文字の長さ（ポイント単位）。これは、:meth:`Font.text_length` を各文字に分解したようなものです。高速なメソッドであり、例えば:meth:`TextWriter.fill_textbox` で使用されています。以下が成り立ちます（丸め誤差を許容する）：`font.text_length(text) == sum(font.char_lengths(text))`。

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

en: Copy of the binary font file content.
ja: バイナリフォントファイルのコンテンツのコピー。

en: A dictionary with various font properties, each represented as bools. Example for Helvetica::
ja: Helveticaの例など、さまざまなフォントプロパティを持つ辞書で、それぞれがブール値として表されています。

en: Name of the font. May be "" or "(null)".
ja: フォントの名前。空文字列であることもあります。

en: The font bbox. This is the maximum of its glyph bboxes.
ja: フォントのbbox。これは、そのグリフのbboxの最大値です。

en: The number of glyphs defined in the font.
ja: グリフ数。

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

en: The ascender value of the font, see `here <https://en.wikipedia.org/wiki/Ascender_(typography)>`_ for details. Please note that there is a difference to the strict definition: our value includes everything above the baseline -- not just the height difference between upper case "A" and and lower case "a".
ja: フォントのアセンダー値。詳細についてはこちらを参照してください。ただし、厳密な定義とは異なり、私たちの値にはベースラインを上回るすべてが含まれます。単に大文字の「A」と小文字の「a」の高さの違いだけでなく、ベースラインを上回るすべてが含まれます。

en: The descender value of the font, see `here <https://en.wikipedia.org/wiki/Descender>`_ for details. This value always is negative and is the portion that some glyphs descend below the base line, for example "g" or "y". As a consequence, the value `ascender - descender` is the total height, that every glyph of the font fits into. This is true at least for most fonts -- as always, there are exceptions, especially for calligraphic fonts, etc.
ja: フォントのディセンダー値。詳細についてはこちらを参照してください。この値は常に負であり、一部のグリフがベースライン以下に降りる部分、例えば「g」や「y」です。したがって、`アセンダー - ディセンダー` の値は、フォントのすべてのグリフが収まる総高さです。これはほとんどのフォントに当てはまりますが、いくつかの例外があります。特にカリグラフィーフォントなどです。

en: Indicates whether this font can be used with :ref:`TextWriter`.
ja: このフォントを :ref:`TextWriter` で使用できるかどうかを示します。

en: Footnotes
ja: 脚注

en: MuPDF does not support all fontfiles with this feature and will raise exceptions like *"mupdf: FT_New_Memory_Face((null)): unknown file format"*, if it encounters issues. The :ref:`TextWriter` methods check :attr:`Font.is_writable`.
ja: MuPDFはこの機能を持つすべてのフォントファイルをサポートしておらず、問題が発生すると *「mupdf: FT_New_Memory_Face((null)): unknown file format」* といった例外を発生させます。:ref:`TextWriter` のメソッドは :attr:`Font.is_writable` をチェックします。

en: The built-in module *array* has been chosen for its speed and its compact representation of values.
ja: 組み込みの *array* モジュールは、その速度と値のコンパクトな表現のために選択されました。
