PyMuPDF 1.23.0rc1 - en to ja translation catalogue (111 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: Rect
ja: Rect (矩形)

en: *Rect* represents a rectangle defined by four floating point numbers x0, y0, x1, y1. They are treated as being coordinates of two diagonally opposite points. The first two numbers are regarded as the "top left" corner P\ :sub:`(x0,y0)` and P\ :sub:`(x1,y1)` as the "bottom right" one. However, these two properties need not coincide with their intuitive meanings -- read on.
ja: *Rect* は、4つの浮動小数点数x0、y0、x1、y1によって定義される矩形を表します。これらは対角線上の2つの点の座標と見なされます。最初の2つの数は「左上」のコーナー P\ :sub:`(x0,y0)` とし、 P\ :sub:`(x1,y1)` は「右下」のコーナーとします。ただし、これら2つのプロパティは直感的な意味と一致する必要はありません。以下を読んでください。

en: The following remarks are also valid for :ref:`IRect` objects:
ja: :ref:`IRect` オブジェクトにも以下の注釈は有効です。

en: A rectangle in the sense of (Py-) MuPDF **(and PDF)** always has **borders parallel to the x- resp. y-axis**. A general orthogonal tetragon **is not a rectangle** -- in contrast to the mathematical definition.
ja: (Py-)MuPDF **（およびPDF）** の意味での矩形は常に **x-またはy軸に平行な境界** を持ちます。一般的な直交四角形は **矩形ではなく** 、数学的な定義とは対照的です。

en: The constructing points can be (almost! -- see below) anywhere in the plane -- they need not even be different, and e.g. "top left" need not be the geometrical "north-western" point.
ja: 構築ポイントは平面上のどこにでも配置できます。異なる必要すらなく、たとえば「左上」が幾何学的に「北西」の点である必要はありません。

en: Units are in points, where 72 points is 1 inch.
ja: 単位はポイントで、72ポイントが1インチです。

en: For any given quadruple of numbers, the geometrically "same" rectangle can be defined in four different ways:
ja: 与えられた4つの数値に対して、幾何学的に「同じ」矩形は4つの異なる方法で定義できます。

en: **(Changed in v1.19.0)** Hence some classification:
ja: **(v1.19.0で変更)** したがって、いくつかの分類があります。

en: A rectangle is called **valid** if `x0 <= x1` and `y0 <= y1` (i.e. the bottom right point is "south-eastern" to the top left one), otherwise **invalid**. Of the four alternatives above, **only the first** is valid. Please take into account, that in MuPDF's coordinate system, the y-axis is oriented from **top to bottom**. Invalid rectangles have been called infinite in earlier versions.
ja: 矩形は、 `x0 <= x1`  および  `y0 <= y1` （つまり、右下の点が左上の点の「南東」にある）の場合にのみ **有効** と呼ばれます。したがって、上記の4つの代替案のうち、**最初のものだけ** が有効です。MuPDFの座標系では、y軸は **上から下** に向かっていますので、注意してください。無効な矩形は以前のバージョンでは 無限と呼ばれていました。

en: A rectangle is called **empty** if `x0 >= x1` or `y0 >= y1`. This implies, that **invalid rectangles are also always empty.** And `width` (resp. `height`) is **set to zero** if `x0 > x1` (resp. `y0 > y1`). In previous versions, a rectangle was empty only if one of width or height was zero.
ja: 矩形は、 `x0 >= x1`  または  `y0 >= y1`  の場合に **空** と呼ばれます。これは、**無効な矩形** も常に空であることを意味します。また、 `x0 > x1` （または `y0 > y1` ）の場合、幅（または高さ）は **ゼロに設定** されます。以前のバージョンでは、矩形が空であるのは幅または高さのいずれかがゼロの場合に限られていました。

en: Rectangle coordinates **cannot be outside** the number range from `FZ_MIN_INF_RECT = -2147483648` to `FZ_MAX_INF_RECT = 2147483520`. Both values have been chosen, because they are the smallest / largest 32bit integers that survive C float conversion roundtrips. In previous versions there was no limit for coordinate values.
ja: 矩形の座標は、`FZ_MIN_INF_RECT = -2147483648` から `FZ_MAX_INF_RECT = 2147483520`  までの数値範囲内にある必要があります。これらの値は、C浮動小数点変換のラウンドトリップを生き残る最小/最大の32ビット整数であるため選ばれました。以前のバージョンでは、座標値の制限はありませんでした。

en: There is **exactly one "infinite" rectangle**, defined by `x0 = y0 = FZ_MIN_INF_RECT` and `x1 = y1 = FZ_MAX_INF_RECT`. It contains every other rectangle. It is mainly used for technical purposes -- e.g. when a function call should ignore a formally required rectangle argument. This rectangle is not empty.
ja: **「無限」の矩形は** 、`x0 = y0 = FZ_MIN_INF_RECT` および `x1 = y1 = FZ_MAX_INF_RECT` で定義され、他のすべての矩形を含みます。これは主に技術的な目的で使用されます。たとえば、関数呼び出しで形式的に必要な矩形引数を無視する必要がある場合などです。この矩形は空ではありません。

en: **Rectangles are (semi-) open:** The right and the bottom edges (including the resp. corners) are not considered part of the rectangle. This implies, that only the top-left corner `(x0, y0)` can ever belong to the rectangle - the other three corners never do. An empty rectangle contains no corners at all.
ja: **矩形は（半）開いています**。右側と下側のエッジ（およびそれに含まれるコーナー）は矩形の一部とは見なされません。したがって、矩形に属することができるのは左上のコーナー  `(x0, y0)` のみです。他の3つのコーナーは常に含まれません。空の矩形にはまったくコーナーが含まれていません。

en: Here is an overview of the changes.
ja: 以下は変更の概要です。

en: Notion
ja: 概要

en: Versions < 1.19.0
ja: バージョン < 1.19.0

en: Versions 1.19.*
ja: バージョン 1.19.*

en: empty
ja: 空

en: x0 = x1 or y0 = y1
ja: x0 = x1 または y0 = y1

en: x0 >= x1 or y0 >= y1 -- includes invalid rects
ja: x0 >= x1 または y0 >= y1 – 無効な矩形も含む

en: valid
ja: 有効

en: n/a
ja: なし

en: x0 <= x1 and y0 <= y1
ja: x0 <= x1 かつ y0 <= y1

en: infinite
ja: 無限

en: all rects where x0 > x1 or y1 > y0
ja: x0 > x1 または y1 > y0 のすべての矩形

en: **exactly one infinite rect / irect!**
ja: **無限の矩形 / irectは1つだけです！**

en: coordinate values
ja: 座標値

en: all numbers
ja: すべての数値

en: `FZ_MIN_INF_RECT <= number <= FZ_MAX_INF_RECT`
ja: FZ_MIN_INF_RECT <= 数値 <= FZ_MAX_INF_RECT

en: borders, corners
ja: 境界、コーナー

en: are parts of the rectangle
ja: 矩形の一部です

en: right and bottom corners and edges **are outside**
ja: 右下の角とエッジは **外側にあります**

en: There are new top level functions defining infinite and standard empty rectangles and quads, see :meth:`INFINITE_RECT` and friends.
ja: 新しいトップレベルの関数が追加され、無限と標準の空の四角形および四角形を定義します。:meth:`INFINITE_RECT` などを参照してください。

en: **Methods / Attributes**
ja: **メソッド / 属性**

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

en: checks containment of point_likes and rect_likes
ja: point_likesおよびrect_likesの包含をチェックします。

en: calculate rectangle area
ja: 四角形の面積を計算します。

en: enlarge rectangle to also contain a point
ja: 点も含むように四角形を拡大します。

en: enlarge rectangle to also contain another one
ja: 別の四角形も含むように四角形を拡大します。

en: common part with another rectangle
ja: 別の四角形との共通部分です。

en: checks for non-empty intersections
ja: 非空の交差をチェックします。

en: transform with a point and a matrix
ja: 点と行列を使用して四角形を変形します。

en: the matrix that transforms to another rectangle
ja: 別の四角形に変換する行列です。

en: the Euclidean norm
ja: ユークリッドノルム

en: create smallest :ref:`Irect` containing rectangle
ja: 最小の :ref:`Irect` を含む四角形を作成します。

en: transform rectangle with a matrix
ja: 行列で四角形を変形します。

en: bottom left point, synonym *bl*
ja: 左下の点、シノニム *bl*

en: bottom right point, synonym *br*
ja: 右下の点、シノニム *br*

en: rectangle height
ja: 四角形の高さ

en: equals result of method *round()*
ja: *round()* メソッドの結果と等しい

en: whether rectangle is empty
ja: 四角形が空かどうか

en: whether rectangle is valid
ja: 四角形が有効かどうか

en: whether rectangle is infinite
ja: 四角形が無限かどうか

en: top left point, synonym *tl*
ja: 左上の点、シノニム *tl*

en: top_right point, synonym *tr*
ja: 右上の点、シノニム *tr*

en: :ref:`Quad` made from rectangle corners
ja: 四角形の角から作成される :ref:`Quad`

en: rectangle width
ja: 四角形の幅

en: left corners' x coordinate
ja: 左上のx座標

en: right corners' x -coordinate
ja: 右上のx座標

en: top corners' y coordinate
ja: 上部のy座標

en: bottom corners' y coordinate
ja: 下部のy座標

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

en: Overloaded constructors: *top_left*, *bottom_right* stand for :data:`point_like` objects, "sequence" is a Python sequence type of 4 numbers (see :ref:`SequenceTypes`), "rect" means another :data:`rect_like`, while the other parameters mean coordinates.
ja: オーバーロードされたコンストラクター：*top_left*、*bottom_right* は :data:`point_like` オブジェクトを表し、「sequence」は4つの数値からなるPythonシーケンス型です（:ref:`SequenceTypes` を参照）、rectは別の :data:`rect_like` を意味し、他のパラメーターは座標を意味します。

en: If "rect" is specified, the constructor creates a **new copy** of it.
ja: "rect" が指定されている場合、コンストラクターはそれの **新しいコピー** を作成します。

en: Without parameters, the empty rectangle *Rect(0.0, 0.0, 0.0, 0.0)* is created.
ja: パラメーターなしで、空の長方形 *Rect(0.0, 0.0, 0.0, 0.0)* が作成されます。

en: Creates the smallest containing :ref:`IRect`. This is **not** the same as simply rounding the rectangle's edges: The top left corner is rounded upwards and to the left while the bottom right corner is rounded downwards and to the right.
ja: 最小の :ref:`IRect` を作成します。これは単に長方形のエッジを四捨五入することとは **異なります**。左上のコーナーは上方向および左方向に丸められ、右下のコーナーは下方向および右方向に丸められます。

en: If the rectangle is **empty**, the result is also empty.
ja: もし矩形が空の場合、結果も **空** です。

en: **Possible paradox:** The result may be empty, **even if** the rectangle is **not** empty! In such cases, the result obviously does **not** contain the rectangle. This is because MuPDF's algorithm allows for a small tolerance (1e-3). Example:
ja: **可能性のある逆説:** 矩形が空で **ない** 場合 **でも** 、結果が空になることがあります！このような場合、結果は明らかに矩形を **含みません**。これは、MuPDFのアルゴリズムがわずかな許容差（1e-3）を許容しているためです。例：

en: Transforms the rectangle with a matrix and **replaces the original**. If the rectangle is empty or infinite, this is a no-operation.
ja: 次の条件を満たす場合、行列を使用して長方形を変換し、**元の長方形を置き換えます** ：長方形が空であるか無限である場合、これは操作が行われません。

en: The matrix for the transformation.
ja: m（行列）–変換用の行列。

en: the smallest rectangle that contains the transformed original.
ja: 変換された元の長方形を含む最小の長方形。

en: The intersection (common rectangular area, largest rectangle contained in both) of the current rectangle and *r* is calculated and **replaces the current** rectangle. If either rectangle is empty, the result is also empty. If *r* is infinite, this is a no-operation. If the rectangles are (mathematically) disjoint sets, then the result is invalid. If the result is valid but empty, then the rectangles touch each other in a corner or (part of) a side.
ja: 現在の長方形とrの共通の長方形エリア（両方に含まれる最大の長方形）を計算し、**現在の長方形を置き換えます**。どちらかの長方形が空の場合、結果も空になります。*r* が無限である場合、これは操作が行われません。長方形が（数学的に）交差していない場合、結果は無効になります。結果が有効でも空の場合、長方形は互いに角または一部の側面に接触しています。

en: Second rectangle
ja: 第二の長方形

en: The smallest rectangle containing the current one and *r* is calculated and **replaces the current** one. If either rectangle is infinite, the result is also infinite. If one is empty, the other one will be taken as the result.
ja: 現在の長方形と *r* を含む最小の長方形を計算し、**現在の長方形を置き換えます**。どちらかの長方形が無限の場合、結果も無限になります。1つが空である場合、もう1つが結果として取られます。

en: The smallest rectangle containing the current one and point *p* is calculated and **replaces the current** one. **The infinite rectangle remains unchanged.** To create a rectangle containing a series of points, start with (the empty) *fitz.Rect(p1, p1)* and successively include the remaining points.
ja: 現在の長方形と点 *p* を含む最小の長方形を計算し、**現在の長方形を置き換えます**。無限の長方形は変更されません。一連の点を含む長方形を作成するには、（空の） *fitz.Rect(p1, p1)* から始め、残りの点を順次含めてください。

en: Point to include.
ja: 含めるポイント。

en: Calculate the area of the rectangle and, with no parameter, equals *abs(rect)*. Like an empty rectangle, the area of an infinite rectangle is also zero. So, at least one of *fitz.Rect(p1, p2)* and *fitz.Rect(p2, p1)* has a zero area.
ja: 長方形の面積を計算し、パラメーターなしで *abs（rect）* と同じです。空の長方形の面積はゼロであるため、少なくとも *fitz.Rect（p1、p2）* と *fitz.Rect（p2、p1）* のいずれかがゼロの面積を持っている必要があります。

en: Specify required unit: respective squares of *px* (pixels, default), *in* (inches), *cm* (centimeters), or *mm* (millimeters).
ja: 必要な単位を指定します： *px* （ピクセル、デフォルト）の平方、*in* （インチ）、*cm* （センチメートル）、または *mm* （ミリメートル）の平方。

en: Checks whether *x* is contained in the rectangle. It may be an *IRect*, *Rect*, *Point* or number. If *x* is an empty rectangle, this is always true. If the rectangle is empty this is always *False* for all non-empty rectangles and for all points. `x in rect` and `rect.contains(x)` are equivalent.
ja: *x* が四角形内に含まれているかどうかをチェックします。xは *IRect*、*Rect*、*Point*、または数値のいずれかです。もし *x* が空の四角形である場合、これは常にtrueです。四角形が空である場合、これはすべての空でない四角形とすべてのポイントに対して常にfalseです。`x in rect` および `rect.contains(x)` は同等です。

en: the object to check.
ja: チェックするオブジェクト。

en: Checks whether the rectangle and a :data:`rect_like` "r" contain a common non-empty :ref:`Rect`. This will always be *False* if either is infinite or empty.
ja: 長方形と :data:`rect_like` "r" が共通の非空のRectを含むかどうかをチェックします。どちらかが無限または空の場合、これは常に *False* になります。

en: the rectangle to check.
ja: チェックする長方形。

en: New in version 1.19.3
ja: 新機能（バージョン1.19.3）

en: Compute the matrix which transforms this rectangle to a given one.
ja: この長方形を指定した長方形に変換する行列を計算します。

en: the target rectangle. Must not be empty or infinite.
ja: ターゲットの長方形。空または無限であってはいけません。

en: a matrix `mat` such that `self * mat = rect`. Can for example be used to transform between the page and the pixmap coordinates. See an example use here :ref:`RecipesImages_P`.
ja: `self * mat = rect` となるような行列 `mat` です。たとえば、ページとピクスマップの座標間を変換するのに使用できます。 使用例はこちらを参照してください :ref:`RecipesImages_P`

en: New in version 1.17.0
ja: 新機能バージョン1.17.0

en: Return a new quad after applying a matrix to the rectangle using the fixed point `fixpoint`.
ja: 固定点 `fixpoint` を使用して、行列を長方形に適用した後の新しい四角形を返します。

en: the fixed point.
ja: 固定ポイント。

en: the matrix.
ja: 行列。

en: a new :ref:`Quad`. This a wrapper for the same-named quad method. If infinite, the infinite quad is returned.
ja: 新しい :ref:`Quad` 。これは同じ名前の四角形メソッドのラッパーです。無限の場合、無限の四角形が返されます。

en: New in version 1.16.0
ja: 新機能バージョン1.16.0

en: Return the Euclidean norm of the rectangle treated as a vector of four numbers.
ja: 四角形を4つの数値のベクトルとして扱った場合のユークリッドノルムを返します。

en: **Replace** the rectangle with its valid version. This is done by shuffling the rectangle corners. After completion of this method, the bottom right corner will indeed be south-eastern to the top left one (but may still be empty).
ja: 長方形をその有効なバージョンで **置き換えます**。これは長方形のコーナーをシャッフルして行います。このメソッドの完了後、右下のコーナーは確かに左上のコーナーの南東になります（ただし、空である可能性があります）。

en: Equals result of method *round()*.
ja: *round()* メソッドの結果と同じです。

en: Equals *Point(x0, y0)*.
ja: *Point(x0, y0)* と等しい。

en: Equals `Point(x1, y0)`.
ja: `Point(x1, y0)` と等しい。

en: Equals `Point(x0, y1)`.
ja: `Point(x0, y1)` と等しい。

en: The quadrilateral `Quad(rect.tl, rect.tr, rect.bl, rect.br)`.
ja: 四角形 `Quad(rect.tl, rect.tr, rect.bl, rect.br)`。

en: Width of the rectangle. Equals `max(x1 - x0, 0)`.
ja: 長方形の幅。`max(x1 - x0, 0)` と等しい。

en: Height of the rectangle. Equals `max(y1 - y0, 0)`.
ja: 長方形の高さ。`max(y1 - y0, 0)` と等しい。

en: X-coordinate of the left corners.
ja: 左上の x 座標。

en: Y-coordinate of the top corners.
ja: 左上の y 座標。

en: X-coordinate of the right corners.
ja: 右下の x 座標。

en: Y-coordinate of the bottom corners.
ja: 右下の y 座標。

en: `True` if this is the infinite rectangle.
ja: これが無限の長方形の場合は `True`。

en: `True` if rectangle is empty.
ja: これが無限の長方形である場合は `True`。

en: `True` if rectangle is valid.
ja: 長方形が空である場合は `True`。

en: Rectangles can be used with arithmetic operators -- see chapter :ref:`Algebra`.
ja: 四角形は算術演算子と組み合わせて使用できます - :ref:`Algebra` の演算子代数の章を参照してください。
