IRect#

IRect（整数長方形）は、Rect (矩形) と非常に似ているが、すべての角の座標が整数であるという点が異なります。IRectは、レンダリング中に画像データを受け取る領域を指定するために使用されます。それ以外にも、長方形の空白や有効性に関する考慮事項が適用されます。メソッドと属性は同じ名前を持ち、多くの場合、対応する Rect (矩形) の対応部分を再利用して実装されています。

属性/メソッド	短い説明
`IRect.contains()`	他のオブジェクトの含まれているかを確認します。
`IRect.get_area()`	長方形の面積を計算します。
`IRect.intersect()`	別の長方形との共通部分を取得します。
`IRect.intersects()`	非空の交差をチェックします。
`IRect.morph()`	ポイントと行列を使用して変換します。
`IRect.torect()`	別の長方形に変換する行列。
`IRect.norm()`	ユークリッドノルム。
`IRect.normalize()`	長方形を有限にします。
`IRect.bottom_left`	左下のポイント、同義語の bl
`IRect.bottom_right`	右下のポイント、同義語の br
`IRect.height`	長方形の高さ
`IRect.is_empty`	長方形が空かどうか
`IRect.is_infinite`	長方形が無限であるかどうか
`IRect.rect`	Rect (矩形) の同等物
`IRect.top_left`	左上のポイント、同義語の tl
`IRect.top_right`	右上のポイント、同義語の tr
`IRect.quad`	長方形の角から作成された四角形
`IRect.width`	長方形の幅
`IRect.x0`	左上隅のX座標
`IRect.x1`	右下隅のX座標
`IRect.y0`	左上隅のY座標
`IRect.y1`	右下隅のY座標

クラスAPI

class IRect#

__init__(self)#

__init__(self, x0, y0, x1, y1)#

__init__(self, irect)#

__init__(self, sequence)#

オーバーロードされたコンストラクタ。また、以下の例と Rect (矩形) クラスの例も参照してください。

別のirectが指定された場合、新しいコピー が作成されます。

シーケンスが指定された場合、それは4つの数値のPythonシーケンス型である必要があります（PythonシーケンスをPyMuPDFで引数として使用する場合）。整数以外の数値は切り捨てられ、数値以外の値は例外を発生させます。

その他のパラメータは整数座標を意味します。

get_area([unit])#

長方形の面積を計算し、パラメータなしで abs(IRect) に等しいです。空の長方形と同様に、無限の長方形の面積もゼロです。

パラメータ:: unit (str) -- 必要な単位を指定します：「px」（ピクセル、デフォルト）、「in」（インチ）、「cm」（センチメートル）、または「mm」（ミリメートル）のそれぞれの平方。
戻り値の型:: float

intersect(ir)#

現在の長方形と ir の交差（共通の長方形領域）を計算し、現在の長方形に置き換えます。どちらかの長方形が空の場合、結果も空です。どちらかの長方形が無限の場合、もう一方が結果として取られます。したがって、両方の長方形が無限である場合、結果も無限です。

パラメータ:: ir (rect_like) -- 第2の長方形。

contains(x)#

x が長方形に含まれているかどうかを確認します。それは rect_like、point_like、または数値であるかもしれません。x が空の長方形の場合、これは常に真です。逆に、長方形が空の場合、これは常に偽です。xが空の長方形でなく、数値でない場合、これは常に偽です。 x が数値の場合、それは4つの構成要素の1つであることが確認されます。 x in irect および irect.contains(x) は同等です

パラメータ:: x (IRect or Rect (矩形) or Point (ポイント) or int) -- 確認するオブジェクト。
戻り値の型:: bool

intersects(r)#

長方形と rect_like`「r」が共通の非空 :ref:`IRect を含むかどうかをチェックします。どちらかが無限または空の場合、これは常に False になります。

パラメータ:: r (rect_like) -- チェックする長方形。
戻り値の型:: bool

torect(rect)#

バージョン1.19.3で新登場

この長方形を指定された長方形に変換する行列を計算します。Rect.torect() を参照してください。

パラメータ:: rect (rect_like) -- ターゲットの長方形。空または無限であってはなりません。
戻り値の型:: Matrix (マトリックス)
戻り値:: self * mat = rect となるような行列 mat 。たとえば、ページとピクセルマップの座標間を変換するために使用できます。

morph(fixpoint, matrix)#

新機能バージョン1.17.0

指定された固定点に行列を適用した後の新しい四角形を返します。

パラメータ:

fixpoint (point_like) -- 固定点。
matrix (matrix_like) -- 行列。

戻り値:

新しい Quad (クアッド)。これは同じ名前のquadメソッドのラッパーです。無限であれば、無限の四角形が返されます。

norm()#

新機能バージョン1.16.0

四角形を4つの数字のベクトルとして扱った場合のユークリッドノルムを返します。

normalize()#: 四角形を有限にします。これは四角形の角を入れ替えることによって行われます。この操作後、右下の角は確かに左上の角の南東になります。詳細については、Rect (矩形) を参照してください。

top_left#

tl#

Point(x0, y0) と同等です。

Type:: Point (ポイント)

top_right#

tr#

Point(x1, y0) と同等です。

Type:: Point (ポイント)

bottom_left#

bl#

Point(x0, y1) と同等です。

Type:: Point (ポイント)

bottom_right#

br#

Point(x1, y1) と同等です。

Type:: Point (ポイント)

rect#

浮動小数点座標と同じ座標を持つ Rect (矩形) です。

Type:: Rect (矩形)

quad#

四角形 Quad(irect.tl, irect.tr, irect.bl, irect.br)です 。

Type:: Quad (クアッド)

width#

境界ボックスの幅を含みます。abs(x1 - x0) と同等です。

Type:: int

height#

境界ボックスの高さを含みます。abs(y1 - y0) と同等です。

Type:: int

x0#

左上隅のX座標です。

Type:: int

y0#

上端のY座標です。

Type:: int

x1#

右上隅のX座標です。

Type:: int

y1#

下端のY座標です。

Type:: int

is_infinite#

四角形が無限の場合は True 、それ以外の場合は*False* です。

Type:: bool

is_empty#

四角形が空の場合は True、それ以外の場合は False です。

Type:: bool

注釈

このクラスはPythonのシーケンスプロトコルに従っているため、コンポーネントはインデックスを使用してアクセスできます。また、PythonシーケンスをPyMuPDFで引数として使用する場合も参照してください。
また、四角形は算術演算子と一緒に使用できます - 幾何学オブジェクトのためのオペレーター代数を参照してください。

Do you have any feedback on this page?

This software is provided AS-IS with no warranty, either express or implied. This software is distributed under license and may not be copied, modified or distributed except as expressly authorized under the terms of that license. Refer to licensing information at artifex.com or contact Artifex Software Inc., 39 Mesa Street, Suite 108A, San Francisco CA 94129, United States for further information.