PyMuPDF 1.23.0rc1 - en to ja translation catalogue (55 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: Operator Algebra for Geometry Objects
ja: 幾何学オブジェクトのためのオペレーター代数

en: Instances of classes :ref:`Point`, :ref:`IRect`, :ref:`Rect`, :ref:`Quad` and :ref:`Matrix` are collectively also called "geometry" objects.
ja: クラス :ref:`Point` 、 :ref:`IRect` 、 :ref:`Rect` 、 :ref:`Quad` 、および :ref:`Matrix` のインスタンスは、集合的に「幾何学オブジェクト」とも呼ばれます。

en: They all are special cases of Python sequences, see :ref:`SequenceTypes` for more background.
ja: これらはすべてPythonシーケンスの特殊なケースであり、詳細については、PyMuPDFでのPythonシーケンスを引数として使用するを参照してください。

en: We have defined operators for these classes that allow dealing with them (almost) like ordinary numbers in terms of addition, subtraction, multiplication, division, and some others.
ja: これらのクラスには、加算、減算、乗算、除算など、通常の数値とほぼ同じように取り扱うための演算子が定義されています。

en: This chapter is a synopsis of what is possible.
ja: この章では、可能な操作の要約を説明します。

en: General Remarks
ja: 一般的な注意事項

en: Operators can be either **binary** (i.e. involving two objects) or **unary**.
ja: 演算子は2つのオブジェクトを含むバイナリ演算子または単項演算子になります。

en: The resulting type of **binary** operations is either a **new object of the left operand's class** or a bool.
ja: バイナリ演算の結果の型は、左オペランドのクラスの新しいオブジェクトまたはbool型です。

en: The result of **unary** operations is either a **new object** of the same class, a bool or a float.
ja: 単項演算の結果は、同じクラスの新しいオブジェクト、bool型、またはfloat型のいずれかです。

en: The binary operators *+, -, *, /* are defined for all classes. They *roughly* do what you would expect -- **except, that the second operand ...**
ja: バイナリ演算子 ``+`` 、``-`` 、``*`` 、 ``/`` はすべてのクラスで定義されています。これらはおおよその期待通りの動作をしますが、2番目のオペランドは...（省略されました）。

en: may always be a number which then performs the operation on every component of the first one,
ja: 第2のオペランドは常に数値であり、それにより最初のオペランドのすべての要素に対して操作を行います。

en: may always be a numeric sequence of the same length (2, 4 or 6) -- we call such sequences :data:`point_like`, :data:`rect_like`, :data:`quad_like` or :data:`matrix_like`, respectively.
ja: 第2のオペランドは常に同じ長さの数値のシーケンスであることができます（2つ、4つ、または6つ） - それぞれ :data:`point_like` 、 :data:`rect_like` 、 :data:`quad_like` 、または :data:`matrix_like` と呼びます。

en: Rectangles support additional binary operations: **intersection** (operator *"&"*), **union** (operator *"|"*) and **containment** checking.
ja: 矩形は追加のバイナリ演算をサポートしています：交差（演算子“&”）、結合（演算子“|”）、および包含チェック。

en: Binary operators fully support in-place operations, so expressions like `a /= b` are valid if b is numeric or "a_like".
ja: バイナリ演算子は、すべての場所で完全にサポートされているため、``b`` が数値または「a_like」の場合、 ``a /= b`` のような式が有効です

en: Unary Operations
ja: 単項演算

en: Oper.
ja: 演算

en: Result
ja: 結果

en: is false exactly if all components of OBJ are zero
ja: OBJのすべての成分がゼロの場合にのみfalse

en: the rectangle area -- equal to norm(OBJ) for the other types
ja: 他のタイプに対してnorm(OBJ)と等しい長方形の面積

en: square root of the component squares (Euclidean norm)
ja: 成分の二乗の平方根（ユークリッドノルム）

en: new copy of OBJ
ja: OBJの新しいコピー

en: new copy of OBJ with negated components
ja: 成分が反転されたOBJの新しいコピー

en: inverse of matrix "m", or the null matrix if not invertible
ja: 行列 "m" の逆行列、または逆行列が存在しない場合は零行列

en: Binary Operations
ja: 二項演算

en: For every geometry object "a" and every number "b", the operations "a ° b" and "a °= b" are always defined for the operators *+, -, *, /*. The respective operation is simply executed for each component of "a". If the **second operand is not a number**, then the following is defined:
ja: あらゆるジオメトリオブジェクト"a"とあらゆる数値 "b" に対して、演算子 ``+``, ``-`` , ``*`` , ``/`` については常に  "a ° b" と "a °= b" の操作が定義されています。それぞれの操作は、"a" の各成分に対して単純に実行されます。もし第二オペランドが数値でない場合、次のように定義されます：

en: component-wise execution, "b" must be "a-like".
ja: 成分ごとの実行。"b" は "a" と同様の要素数である必要があります。

en: "a" can be a point, rectangle or matrix, but "m" must be :data:`matrix_like`. *"a/m"* is treated as *"a*~m"* (see note below for non-invertible matrices). If "a" is a **point** or a **rectangle**, then *"a.transform(m)"* is executed. If "a" is a matrix, then matrix concatenation takes place.
ja: "a" はポイント、矩形、または行列になりますが、"m" は :data:`matrix_like` でなければなりません。"a/m" は "a*〜m" として処理されます（非逆行列の場合は以下の注記を参照）。"a" がポイントまたは矩形の場合、"a.transform(m)" が実行されます。"a" が行列の場合、行列の連結が行われます。

en: **intersection rectangle:** "a" must be a rectangle and "b" :data:`rect_like`. Delivers the **largest rectangle** contained in both operands.
ja: 共通の長方形: "a" は長方形であり、"b" は :data:`rect_like` 形式である必要があります。両方のオペランドに含まれる最大の長方形を返します。

en: **union rectangle:** "a" must be a rectangle, and "b" may be :data:`point_like` or :data:`rect_like`. Delivers the **smallest rectangle** containing both operands.
ja: 合併した長方形: "a" は長方形であり、"b" は 点のような :data:`point_like` :data:`rect_like` 形式である必要があります。両方のオペランドを含む最小の長方形を返します。

en: if "b" is a number, then `b in tuple(a)` is returned. If "b" is :data:`point_like`, :data:`rect_like` or :data:`quad_like`, then "a" must be a rectangle, and `a.contains(b)` is returned.
ja: もし "b" が数値である場合、 `b in tuple(a)` が返されます。もし "b" が :data:`point_like` 形式、 :data:`rect_like` 形式、または :data:`quad_like` 形式である場合、"a" は長方形である必要があり、`a.contains(b)` が返されます。

en: *True* if *bool(a-b)* is *False* ("b" may be "a-like").
ja: bool(a-b) が `False` であれば `True` を返します（"b"は"a-like"である可能性があります）。

en: Please note an important difference to usual arithmetic:
ja: 以下は通常の算術との重要な違いに注意してください：

en: Matrix multiplication is **not commutative**, i.e. in general we have `m*n != n*m` for two matrices. Also, there are non-zero matrices which have no inverse, for example `m = Matrix(1, 0, 1, 0, 1, 0)`. If you try to divide by any of these, you will receive a `ZeroDivisionError` exception using operator *"/"*, e.g. for the expression `fitz.Identity / m`. But if you formulate `fitz.Identity * ~m`, the result will be `fitz.Matrix()` (the null matrix).
ja: 行列の乗算は可換ではありません。つまり、一般に2つの行列に対して `m*n != n*m` が成り立ちます。また、逆行列を持たないゼロでない行列も存在します。例えば、`m = Matrix(1, 0, 1, 0, 1, 0)` のような行列があります。これらの行列で除算しようとすると、演算子 *"/"* を使用して `fitz.Identity / m` のような式で `ZeroDivisionError` 例外が発生します。しかし、`fitz.Identity * ~m` のように記述すると、結果は `fitz.Matrix()` （零行列）となります。

en: Admittedly, this represents an inconsistency, and we are considering to remove it. For the time being, you can choose to avoid an exception and check whether ~m is the null matrix, or accept a potential *ZeroDivisionError* by using `fitz.Identity / m`.
ja: 認めるところがあるかもしれませんが、これは矛盾を示しており、私たちはこれを取り除くことを検討しています。当面の間は、例外を回避し、`~m` が零行列であるかどうかをチェックするか、`fitz.Identity / m` を使用して `ZeroDivisionError` の可能性を受け入れることができます。

en: With these conventions, all the usual algebra rules apply. For example, arbitrarily using brackets **(among objects of the same class!)** is possible: if r1, r2 are rectangles and m1, m2 are matrices, you can do this `(r1 + r2) * m1 * m2`.
ja: これらの規則に従うと、すべての通常の代数のルールが適用されます。例えば、任意の括弧を使うことができます（同じクラスのオブジェクトの間で！）：もし `r1`, `r2` が長方形であり、`m1`, `m2` が行列であれば、次のようにできます： `(r1 + r2) * m1 * m2` 。

en: For all objects of the same class, `a + b + c == (a + b) + c == a + (b + c)` is true.
ja: 同じクラスのオブジェクトに対して、 `a + b + c == (a + b) + c == a + (b + c)` が成り立ちます。

en: For matrices in addition the following is true: `(m1 + m2) * m3 == m1 * m3 + m2 * m3` (distributivity property).
ja: 行列の加法については、次のような性質が成り立ちます： `(m1 + m2) * m3 == m1 * m3 + m2 * m3` （分配律）。

en: **But the sequence of applying matrices is important:** If r is a rectangle and m1, m2 are matrices, then -- **caution!:**
ja: ただし、行列の適用順序が重要です：もし `r` が長方形であり、 `m1` ,  `m2` が行列である場合、注意してください！次のような場合：

en: Some Examples
ja: いくつかの例

en: Manipulation with numbers
ja: 数値の操作

en: For the usual arithmetic operations, numbers are always allowed as second operand. In addition, you can formulate `"x in OBJ"`, where x is a number. It is implemented as `"x in tuple(OBJ)"`::
ja: 通常の算術演算では、数値は常に第二オペランドとして使用できます。さらに、`"x in OBJ"` のように式を記述することもできます。ここで、xは数値です。これは `"x in tuple(OBJ)"` として実装されています::

en: The following will create the upper left quarter of a document page rectangle::
ja: 以下は、ドキュメントページの四角形の左上の四分の一を作成します::

en: The following will deliver the **middle point of a line** that connects two points **p1** and **p2**::
ja: 以下は、点 `p1` と点 `p2` を結ぶ直線の中点を求めます::

en: Manipulation with "like" Objects
ja: 「Like」オブジェクトを用いた操作

en: The second operand of a binary operation can always be "like" the left operand. "Like" in this context means "a sequence of numbers of the same length". With the above examples::
ja: 2項演算の第2オペランドは常に左オペランドと「like」することができます。「Like」とは、この文脈では「同じ長さの数列」という意味です。上記の例を用いて説明します。

en: To shift a rectangle for 5 pixels to the right, do this::
ja: 長方形を右に5ピクセルシフトさせるには、次のようにします::

en: Points, rectangles and matrices can be *transformed* with matrices. In PyMuPDF, we treat this like a **"multiplication"** (or resp. **"division"**), where the second operand may be "like" a matrix. Division in this context means "multiplication with the inverted matrix"::
ja: 点、長方形、および行列は行列で変換できます。PyMuPDFでは、これを「乗算」（または「除算」とも）として扱います。ここで、第2オペランドは行列と「like」することができます。「除算」とは、この文脈では「逆行列との乗算」を意味します。

en: As a specialty, rectangles support additional binary operations:
ja: 特に、長方形は追加の2項演算をサポートしています：

en: **intersection** -- the common area of rectangle-likes, operator *"&"*
ja: **交差** -- 長方形や類似の長方形の共通領域を示す演算子 *"&"*

en: **inclusion** -- enlarge to include a point-like or rect-like, operator *"|"*
ja: **含有** -- 点状または長方形状を含むように拡大する演算子 *"|"*

en: **containment** check -- whether a point-like or rect-like is inside
ja: **含有確認** 点状または長方形状が内部にあるかどうかを確認します

en: Here is an example for creating the smallest rectangle enclosing given points::
ja: 以下は、与えられた点を囲む最小の長方形を作成する例です::

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