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`	사각형 모서리로 만든 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가 지정되면 새 복사본 이 만들어집니다.

sequence가 지정되면 4개의 숫자로 구성된 Python 시퀀스 유형이어야 합니다( 에서 Python 시퀀스를 인수로 사용하기 참조). 정수가 아닌 숫자는 잘리고, 숫자가 아닌 값은 예외를 발생시킵니다.

다른 매개변수는 정수 좌표를 의미합니다.

get_area([unit])¶

사각형의 영역을 계산하며, 매개변수 없이는 abs(IRect) 와 같습니다. 빈 사각형과 마찬가지로 무한 사각형의 영역도 0입니다.

매개변수:: unit (str) – 필요한 단위 지정: “px”(픽셀, 기본값), “in”(인치), “cm”(센티미터) 또는 “mm”(밀리미터)의 각각의 제곱.
반환 형식:: float

intersect(ir)¶

현재 사각형과 ir 의 교집합(공통 사각형 영역)이 계산되어 현재 사각형을 대체합니다. 사각형 중 하나가 비어 있으면 결과도 비어 있습니다. 사각형 중 하나가 무한이면 다른 하나가 결과로 사용됩니다 – 따라서 두 사각형이 모두 무한이면 결과도 무한입니다.

매개변수:: ir (rect_like) – 두 번째 사각형.

contains(x)¶

x 가 사각형에 포함되어 있는지 확인합니다. 이것은 rect_like, point_like 또는 숫자일 수 있습니다. x 가 빈 사각형이면 이것은 항상 true입니다. 반대로, 사각형이 비어 있으면 이것은 항상 False 입니다. x 가 빈 사각형이 아니고 숫자가 아닌 경우. x 가 숫자이면 4개의 구성 요소 중 하나인지 확인됩니다. x in irect 와 irect.contains(x) 는 동일합니다.

매개변수:: x (IRect or Rect or Point or int.) – 확인할 객체.
반환 형식:: bool

intersects(r)¶

사각형과 rect_like “r”이 공통의 비어 있지 않은 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에서 새로 추가됨

고정점을 사용하여 행렬을 적용한 후 새 quad를 반환합니다.

매개변수:

fixpoint (point_like) – 고정점.
matrix (matrix_like) – 행렬.

반환:

새 Quad. 이것은 동일한 이름의 quad 메서드의 래퍼입니다. 무한이면 무한 quad가 반환됩니다.

norm()¶

버전 1.16.0에서 새로 추가됨

4개의 숫자 벡터로 처리된 사각형의 유클리드 노름을 반환합니다.

normalize()¶: 사각형을 유한하게 만듭니다. 이것은 사각형 모서리를 재배치하여 수행됩니다. 이 작업 후, 오른쪽 아래 모서리는 실제로 왼쪽 위 모서리의 남동쪽이 됩니다. 자세한 내용은 Rect 를 참조하세요.

top_left¶

tl¶

Point(x0, y0) 와 같습니다.

유형:: Point

top_right¶

tr¶

Point(x1, y0) 와 같습니다.

유형:: Point

bottom_left¶

bl¶

Point(x0, y1) 와 같습니다.

유형:: Point

bottom_right¶

br¶

Point(x1, y1) 와 같습니다.

유형:: Point

rect¶

float와 동일한 좌표를 가진 Rect.

유형:: Rect

quad¶

사각형 Quad(irect.tl, irect.tr, irect.bl, irect.br).

유형:: Quad

width¶

경계 상자의 너비를 포함합니다. abs(x1 - x0) 와 같습니다.

유형:: int

height¶

경계 상자의 높이를 포함합니다. abs(y1 - y0) 와 같습니다.

유형:: int

x0¶

왼쪽 모서리의 X 좌표.

유형:: int

y0¶

위쪽 모서리의 Y 좌표.

유형:: int

x1¶

오른쪽 모서리의 X 좌표.

유형:: int

y1¶

아래쪽 모서리의 Y 좌표.

유형:: int

is_infinite¶

사각형이 무한이면 True, 그렇지 않으면 False.

유형:: bool

is_empty¶

사각형이 비어 있으면 True, 그렇지 않으면 False.

유형:: bool

참고

이 클래스는 Python 시퀀스 프로토콜을 따르므로 구성 요소는 인덱스를 통해 액세스할 수도 있습니다. 에서 Python 시퀀스를 인수로 사용하기 도 참조하세요.
사각형은 산술 연산자와 함께 사용할 수 있습니다 – 기하 객체를 위한 연산자 대수 장을 참조하세요.

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.