PyMuPDF 1.23.0rc1 - en to ja translation catalogue (93 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: Tools
ja: Tools (ツール)

en: This class is a collection of utility methods and attributes, mainly around memory management. To simplify and speed up its use, it is automatically instantiated under the name *TOOLS* when PyMuPDF is imported.
ja: このクラスは、メモリ管理を中心としたユーティリティメソッドと属性のコレクションです。使用を簡素化し、高速化するために、PyMuPDFがインポートされると、自動的に *TOOLS* という名前でインスタンス化されます。

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

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

en: generate a unique identifier
ja: 一意の識別子を生成します。

en: shrink the storables cache [#f1]_
ja: 格納可能キャッシュを縮小します [#f1]_。

en: return the accumulated MuPDF warnings
ja: 蓄積されたMuPDFの警告を返します。

en: empty MuPDF messages on STDOUT
ja: STDOUTのMuPDFメッセージを空にします。

en: set the anti-aliasing values
ja: アンチエイリアシングの値を設定します。

en: set the prefix of new annotation / link ids
ja: 新しい注釈/リンクIDのプレフィックスを設定します。

en: search and extract using small bbox heights
ja: 小さなbbox高さを使用して検索および抽出します。

en: control suppression of subset fontname tags
ja: サブセットフォント名タグの抑制を制御します。

en: return the anti-aliasing values
ja: アンチエイリアシングの値を返します。

en: disable PyMuPDF-specific code
ja: PyMuPDF固有のコードを無効にします。

en: configuration settings of PyMuPDF
ja: PyMuPDFの設定設定

en: maximum storables cache size
ja: 最大格納可能キャッシュサイズ

en: current storables cache size
ja: 現在の格納可能キャッシュサイズ

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

en: A convenience method returning a unique positive integer which will increase by 1 on every invocation. Example usages include creating unique keys in databases - its creation should be faster than using timestamps by an order of magnitude.
ja: 1回の呼び出しごとに1ずつ増加する一意の正の整数を返す便利なメソッドです。使用例には、データベース内で一意のキーを作成することが含まれます。タイムスタンプを使用するよりも作成が10倍高速であるべきです。

en: MuPDF has dropped support for this in v1.14.0, so we have re-implemented a similar function with the following differences:
ja: MuPDFはv1.14.0でこれをサポートを中止したため、次の違いを持つ類似の関数を再実装しました。

en: It is not part of MuPDF's global context and not threadsafe (not an issue because we do not support threads in PyMuPDF anyway).
ja: これはMuPDFのグローバルコンテキストの一部ではなく、スレッドセーフではありません（とにかくPyMuPDFではスレッドをサポートしていないため、これは問題ではありません）。

en: It is implemented as *int*. This means that the maximum number is *sys.maxsize*. Should this number ever be exceeded, the counter starts over again at 1.
ja: これはintとして実装されています。つまり、最大値は *sys.maxsize* です。この数値がいつか超過される場合、カウンターは1から再開します。

en: Return type
ja: 戻り値:

en: Returns
ja: 返り値:

en: a unique positive integer.
ja: 一意の正の整数。

en: New in v1.18.6
ja: v1.18.6で新登場

en: Set or inquire the prefix for the id of new annotations, fields or links.
ja: 新しい注釈、フィールド、またはリンクのIDのプレフィックスを設定または問い合わせます。

en: Parameters
ja: パラメータ

en: if omitted, the current value is returned, default is "fitz". Annotations, fields / widgets and links technically are subtypes of the same type of object (`/Annot`) in PDF documents. An `/Annot` object may be given a unique identifier within a page. For each of the applicable subtypes, PyMuPDF generates identifiers "stem-Annn", "stem-Wnnn" or "stem-Lnnn" respectively. The number "nnn" is used to enforce the required uniqueness.
ja: 省略された場合、現在の値が返され、デフォルトは  "fitz" です。注釈、フィールド/ウィジェット、およびリンクは技術的にはPDF文書内の同じ種類のオブジェクト（`/Annot`）のサブタイプです。`/Annot` オブジェクトは、ページ内で一意の識別子を持つことができます。適用可能なサブタイプごとに、PyMuPDFはそれぞれ "stem-Annn"、"stem-Wnnn"、または "stem-Lnnn" の識別子を生成します。番号 "nnn" は必要な一意性を強制するために使用されます。

en: the current value.
ja: 現在の値。

en: New in v1.18.5
ja: v1.18.5で新登場

en: Set or inquire reduced bbox heights in text extract and text search methods.
ja: テキスト抽出およびテキスト検索メソッドでのbboxの高さを縮小するかどうかを設定または問い合わせます。

en: if omitted or `None`, the current setting is returned. For other values the *bool()* function is applied to set a global variable. If `True`, :meth:`Page.search_for` and :meth:`Page.get_text` methods return character, span, line or block bboxes that have a height of *font size*. If `False` (standard setting when PyMuPDF is imported), bbox height will be based on font properties and normally equal *line height*.
ja: 省略された場合または `None` の場合、現在の設定が返されます。他の値の場合、*bool()* 関数が適用され、グローバル変数を設定します。`True` の場合、:meth:`Page.search_for` および :meth:`Page.get_text` メソッドは *フォントサイズ* の高さを持つ文字、スパン、行、またはブロックのbboxを返します。`False` の場合（PyMuPDFがインポートされたときの標準設定）、bboxの高さはフォントのプロパティに基づき、通常は *行の高さ* と同じです。

en: *True* or *False*.
ja: *True* または *False*。

en: Text extraction options "xml", "xhtml" and "html", which directly wrap MuPDF code, are not influenced by this.
ja: 直接MuPDFコードをラップするテキスト抽出オプション「xml」、「xhtml」、「html」は、これに影響を受けません。

en: New in v1.18.9
ja: バージョン1.18.9で追加されました

en: Control suppression of subset fontname tags in text extractions.
ja: テキスト抽出におけるサブセットフォント名のタグを抑制する制御を行います。

en: if omitted / `None`, the current setting is returned. Arguments evaluating to `True` or `False` set a global variable. If `True`, options "dict", "json", "rawdict" and "rawjson" will return e.g. `"NOHSJV+Calibri-Light"`, otherwise only `"Calibri-Light"` (the default). The setting remains in effect until changed again.
ja: 省略された場合 `None`、現在の設定が返されます。`True` または `False` の値を評価して、グローバル変数を設定します。`True` の場合、オプション "dict"、"json"、"rawdict"、"rawjson" は例えば `"NOHSJV+Calibri-Light"` のように返され、それ以外の場合はデフォルトの `"Calibri-Light"` のみが返されます。設定は再度変更されるまで有効です。

en: Except mentioned above, no other text extraction variants are influenced by this. This is especially true for the options "xml", "xhtml" and "html", which are based on MuPDF code. They extract the font name `"Calibri-Light"`, or even just the **family** name -- `Calibri` in this example.
ja: 上記に記載されている以外のテキスト抽出バリアントには影響しません。特に、MuPDFコードに基づくオプション "xml"、"xhtml"、"html" には影響しません。これらはフォント名 `"Calibri-Light"`、またはこの例の場合はファミリー名 `Calibri` のみを抽出します。

en: New in v1.18.10
ja: バージョン1.18.10で追加されました

en: Enable / disable PyMuPDF-specific code, that tries to rebuild valid character quads when encountering nonsense in :meth:`Page.get_text` text extractions. This code depends on certain font properties (ascender and descender), which do not exist in rare situations and cause segmentation faults when trying to access them. This method sets a global parameter in PyMuPDF, which suppresses execution of this code.
ja: :meth:`Page.get_text` テキスト抽出で無意味なものを検出した際に、有効な文字の四角形を再構築しようとするPyMuPDF固有のコードの有効化/無効化を行います。このコードは、存在しない場合があるフォントの特性（ascenderおよびdescender）に依存しており、これらの特性にアクセスしようとするとセグメンテーション違反が発生します。このメソッドはPyMuPDF内のグローバルパラメータを設定し、このコードの実行を抑制します。

en: if omitted or `None`, the current setting is returned. For other values the *bool()* function is applied to set a global variable. If `True`, PyMuPDF will not try to access the resp. font properties and use values `ascender=0.8` and `descender=-0.2` instead.
ja: 省略された場合、または `None` 、現在の設定が返されます。他の値の場合、*bool()* 関数が適用され、グローバル変数を設定します。`True` の場合、PyMuPDFは該当するフォントの特性にアクセスしようとせず、代わりに `ascender=0.8` および `descender=-0.2` の値を使用します。

en: Reduce the storables cache by a percentage of its current size.
ja: 現在のサイズを基準に、ストレージキャッシュのサイズを指定した割合で減少させます。

en: the percentage of current size to free. If 100+ the store will be emptied, if zero, nothing will happen. MuPDF's caching strategy is "least recently used", so low-usage elements get deleted first.
ja: 現在のサイズの何パーセントを解放するかを指定します。100以上の場合、ストアは空になります。むしろ、何も変更されません。MuPDFのキャッシング戦略は「最後に使用されたもの」なので、使用頻度の低い要素が最初に削除されます。

en: the new current store size. Depending on the situation, the size reduction may be larger than the requested percentage.
ja: 新しい現在のストアサイズ。状況に応じて、要求された割合よりもサイズが大幅に削減される場合があります。

en: New in version 1.16.14
ja: バージョン1.16.14で新たに追加

en: Return the current anti-aliasing values. These values control the rendering quality of graphics and text elements.
ja: 現在のアンチエイリアシング値を返します。これらの値は、グラフィックスとテキスト要素のレンダリング品質を制御します。

en: A dictionary with the following initial content: `{'graphics': 8, 'text': 8, 'graphics_min_line_width': 0.0}`.
ja: 以下の初期内容を持つ辞書： `{'graphics': 8, 'text': 8, 'graphics_min_line_width': 0.0}`。

en: Set the new number of bits to use for anti-aliasing. The same value is taken currently for graphics and text rendering. This might change in a future MuPDF release.
ja: アンチエイリアシングに使用するビット数を設定します。現在はグラフィックスとテキストのレンダリングに同じ値が使用されます。将来のMuPDFリリースで変更されるかもしれません。

en: an integer ranging between 0 and 8. Value outside this range will be silently changed to valid values. The value will remain in effect throughout the current session or until changed again.
ja: 0から8までの範囲の整数。この範囲外の値は静かに有効な値に変更されます。この値は、現在のセッション全体または再度変更されるまで有効です。

en: New in version 1.16.0
ja: バージョン1.16.0で新たに追加

en: Empty MuPDF warnings message buffer.
ja: MuPDFの警告メッセージバッファを空にします。

en: New in version 1.16.8
ja: バージョン1.16.8で新たに追加

en: Show or set whether MuPDF errors should be displayed.
ja: MuPDFのエラーを表示するかどうかを表示または設定します。

en: if not a bool, the current setting is returned. If true, MuPDF errors will be shown on *sys.stderr*, otherwise suppressed. In any case, messages continue to be stored in the warnings store. Upon import of PyMuPDF this value is *True*.
ja: boolでない場合、現在の設定が返されます。Trueの場合、MuPDFのエラーは *sys.stderr* に表示され、それ以外の場合は抑制されます。いずれの場合も、メッセージは警告ストアに引き続き保存されます。PyMuPDFのインポート時にこの値は *True* です。

en: *True* or *False*
ja: *True* または *False*

en: Return all stored MuPDF messages as a string with interspersed line-breaks.
ja: すべての保存されたMuPDFメッセージを、改行が挿入された文字列として返します。

en: *(new in version 1.16.7)* whether to automatically empty the store.
ja: *（バージョン1.16.7で新たに追加）* ストアを自動的に空にするかどうか。

en: A dictionary containing the actual values used for configuring PyMuPDF and MuPDF. Also refer to the installation chapter. This is an overview of the keys, each of which describes the status of a support aspect.
ja: PyMuPDFとMuPDFを設定するために使用される実際の値を含む辞書です。インストールの章も参照してください。これは各キーを概説したもので、それぞれがサポートの側面のステータスを記述しています。

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

en: **Support included for ...**
ja: **サポートが含まれているのは...**

en: Gray colorspace rendering
ja: グレーカラースペースのレンダリング

en: RGB colorspace rendering
ja: RGBカラースペースのレンダリング

en: CMYK colorspcae rendering
ja: CMYKカラースペースのレンダリング

en: overprint rendering
ja: オーバープリントのレンダリング

en: PDF documents
ja: PDFドキュメント

en: XPS documents
ja: XPSドキュメント

en: SVG documents
ja: SVGドキュメント

en: CBZ documents
ja: CBZドキュメント

en: IMG documents
ja: IMGドキュメント

en: HTML documents
ja: HTMLドキュメント

en: EPUB documents
ja: EPUBドキュメント

en: JPEG2000 images
ja: JPEG2000画像

en: all TOFU fonts
ja: すべてのTOFUフォント

en: CJK font subset (China, Japan, Korea)
ja: CJKフォントのサブセット（中国、日本、韓国）

en: CJK font extensions
ja: CJKフォント拡張

en: CJK font language extensions
ja: CJKフォントの言語拡張

en: TOFU emoji fonts
ja: TOFU絵文字フォント

en: TOFU historic fonts
ja: TOFU歴史的フォント

en: TOFU symbol fonts
ja: TOFUシンボルフォント

en: TOFU SIL fonts
ja: TOFU SILフォント

en: ICC profiles
ja: ICCプロファイル

en: using Python memory management [#f2]_
ja: Pythonメモリ管理を使用 [#f2]_

en: Base-14 fonts (should always be true)
ja: Base-14フォント（常にtrueである必要があります）

en: For an explanation of the term "TOFU" see `this Wikipedia article <https://en.wikipedia.org/wiki/Noto_fonts>`_.::
ja: 「TOFU」の用語の説明については、 `このウィキペディアの記事 <https://en.wikipedia.org/wiki/Noto_fonts>`_ を参照してください。::

en: Maximum storables cache size in bytes. PyMuPDF is generated with a value of 268'435'456 (256 MB, the default value), which you should therefore always see here. If this value is zero, then an "unlimited" growth is permitted.
ja: ストアブルキャッシュの最大サイズ（バイト単位）。 PyMuPDFは、デフォルト値である268'435'456（256 MB）で生成されており、したがって常にここで見るはずです。この値がゼロの場合、増加の「制限なし」が許可されています。

en: Current storables cache size in bytes. This value may change (and will usually increase) with every use of a PyMuPDF function. It will (automatically) decrease only when :attr:`Tools.store_maxize` is going to be exceeded: in this case, MuPDF will evict low-usage objects until the value is again in range.
ja: 現在のストアブルキャッシュのサイズ（バイト単位）。この値は、PyMuPDFの関数を使用するたびに変更される可能性があります（通常は増加します）。この値は、:attr:`Tools.store_maxsize` が超過される場合にのみ（自動的に）減少し、その場合、MuPDFは使用率の低いオブジェクトを削除して、値が再び範囲内に収まるようにします。

en: Example Session
ja: セッションの例

en: Footnotes
ja: 脚注

en: This memory area is internally used by MuPDF, and it serves as a cache for objects that have already been read and interpreted, thus improving performance. The most bulky object types are images and also fonts. When an application starts up the MuPDF library (in our case this happens as part of *import fitz*), it must specify a maximum size for this area. PyMuPDF's uses the default value (256 MB) to limit memory consumption. Use the methods here to control or investigate store usage. For example: even after a document has been closed and all related objects have been deleted, the store usage may still not drop down to zero. So you might want to enforce that before opening another document.
ja: このメモリ領域はMuPDF内部で使用され、既に読み取られ解釈されたオブジェクトのキャッシュとして機能し、パフォーマンスを向上させます。最も重いオブジェクトのタイプは画像およびフォントです。アプリケーションがMuPDFライブラリを起動するとき（私たちの場合、これは *import fitz* の一部として発生します）、この領域の最大サイズを指定する必要があります。 PyMuPDFはメモリ消費を制限するためにデフォルト値（256 MB）を使用します。ここで提供されているメソッドを使用してストアの使用状況を制御または調査できます。たとえば、文書が閉じられ、関連するすべてのオブジェクトが削除された後でも、ストアの使用状況がゼロにならないことがあります。したがって、別の文書を開く前にこれを強制したいかもしれません。

en: By default PyMuPDF and MuPDF use `malloc()`/`free()` for dynamic memory management. One can instead force them to use the Python allocation functions `PyMem_New()`/`PyMem_Del()`, by modifying *fitz/fitz.i* to do `#define JM_MEMORY 1` and rebuilding PyMuPDF.
ja: デフォルトでは、PyMuPDFおよびMuPDFは動的メモリ管理に `malloc()`/`free()` を使用します。代わりに、*fitz/fitz.i* を変更して `#define JM_MEMORY 1` を行い、PyMuPDFを再構築することで、Pythonの割り当て関数 `PyMem_New()`/`PyMem_Del()` を使用するように強制することができます。
