java.awt
인터페이스 Shape

알려진 구현 클래스 목록:

Arc2D, Arc2D.Double, Arc2D.Float, Area, BasicTextUI.BasicCaret, CubicCurve2D, CubicCurve2D.Double, CubicCurve2D.Float, DefaultCaret, Ellipse2D, Ellipse2D.Double, Ellipse2D.Float, GeneralPath, Line2D, Line2D.Double, Line2D.Float, Polygon, QuadCurve2D, QuadCurve2D.Double, QuadCurve2D.Float, Rectangle, Rectangle2D, Rectangle2D.Double, Rectangle2D.Float, RectangularShape, RoundRectangle2D, RoundRectangle2D.Double, RoundRectangle2D.Float

public interface Shape

Shape인터페이스는 하등의 기하학적인 형태를 나타내는 객체의 정의를 제공합니다. Shape는 Shape 윤곽과 윤곽이 어떻게 2D 평면을 내부 영역의 점과 외부 영역의 점과에 분할하는지를 결정하는 규칙을 나타낼 수 있는 PathIterator 객체에 의해 기술됩니다. 각 Shape객체는 지오메트리의 바운딩박스를 취득하거나 점 또는 구형의 일부 또는 전체가 Shape 내부 영역내에 있을지 어떨지를 판정하거나Shape 윤곽의 궤도 윤곽선을 기술하는 PathIterator 객체를 취득하거나하기 위한 콜백을 제공합니다.

안쪽의 정의: 점은 다음과 같은 경우에만 Shape 안쪽에 있다고 보여집니다.

• Shape 경계의 완전하게 안쪽에 있는 경우
• Shape 경계선상에 위치해, 그 점에 인접하는 X 축방향의 플러스 측에 있는 스페이스가 완전하게 경계내에 들어가는 경우
• 수평 방향의 경계 세그먼트(segment)상에 위치해, 그 점에 인접하는 Y 축방향의 플러스 측에 있는 스페이스가 경계내에 들어가는 경우

contains와 intersects 메서드는 Shape 내부가 전부 칠해져 있는 것과 같게 닫혀진 영역이라고 봅니다. 즉, 형상이 구형을 포함하고 있는지, 구형과 교차하고 있든가 혹은 형상이 점을 포함하고 있는지를 판정하기 위해서 이러한 메서드가 닫혀지지 않은 형상을 닫혀지고 있는 것과 암묵적으로 보는 것을 의미합니다.

관련 항목:

PathIterator, AffineTransform, FlatteningPathIterator, GeneralPath

메서드 개요

boolean	contains (double x, double y) 지정된 좌표가 Shape 경계내에 있을지 어떨지를 판정합니다.
boolean	contains (double x, double y, double w, double h) Shape 내부 영역이, 지정된 구형 영역을 완전하게 포함 할지 어떨지를 판정합니다.
boolean	contains (Point2D p) 지정된 Point2D 가 Shape 경계내에 있을지 어떨지를 판정합니다.
boolean	contains (Rectangle2D r) Shape 내부 영역이, 지정된 Rectangle2D를 완전하게 포함 하고 있을지 어떨지를 판정합니다.
Rectangle	getBounds () Shape를 완전하게 둘러싸는 정수형 Rectangle를 리턴합니다.
Rectangle2D	getBounds2D () 고정밀도로 getBounds 메서드보다 정밀한, Shape 바운딩박스를 리턴합니다.
PathIterator	getPathIterator (AffineTransform at) Shape 경계를 따라 반복 처리를 실시해, Shape 윤곽의 지오메트리에 액세스 할 수 있도록 하는 반복자 객체를 리턴합니다.
PathIterator	getPathIterator (AffineTransform at, double flatness) Shape 경계를 따라 반복 처리를 실시해, Shape 윤곽의 지오메트리의 평탄화 된 뷰에 액세스 할 수 있도록 하는 반복자 객체를 리턴합니다.
boolean	intersects (double x, double y, double w, double h) Shape 내부 영역이, 지정된 구형 영역의 내부 영역과 교차할지 어떨지를 판정합니다.
boolean	intersects (Rectangle2D r) Shape 내부 영역이, 지정된 Rectangle2D 내부 영역과 교차할지 어떨지를 판정합니다.

메서드의 상세

getBounds

Rectangle  getBounds()

Shape를 완전하게 둘러싸는 정수형 Rectangle를 리턴합니다. 리턴된 Rectangle가 Shape를 둘러싸는 최소의 바운딩박스이다고는 할 수 없습니다. 나타난 Rectangle 내에 Shape가 완전하게 수습된다고 할 뿐입니다. 또, Shape가 정수형의 제한 범위를 넘는 경우, 리턴된 Rectangle는 Shape를 완전하게 둘러싸지 못하는 것도 있습니다. 일반적으로getBounds2D 메서드가 표현의 자유도가 높기 위해, 비교적 딱 한 바운딩박스를 리턴합니다.

반환값:

Shape를 완전하게 둘러싸는 정수형의 Rectangle

관련 항목:

getBounds2D()

getBounds2D

Rectangle2D  getBounds2D()

고정밀도로 getBounds 메서드보다 정밀한, Shape 바운딩박스를 리턴합니다. 리턴된 Rectangle2D 가 Shape를 둘러싸는 최소의 바운딩박스이다고는 할 수 없습니다. 나타난 Rectangle2D 내에 Shape가 완전하게 수습된다고 할 뿐입니다. 반환값을 배정밀도치를 사용해 크기를 포함하는 Rectangle2D 인스턴스로 할 수도 있기 때문에 이 메서드에 의해 리턴된 바운딩박스는 보통, getBounds 메서드에 의해 리턴된 바운딩박스 보다 딱 한 것이 되어, 오버플로우를 위해서 실패할 것은 없습니다.

반환값:

Shape 고정밀도 바운딩박스를 나타내는 Rectangle2D 인스턴스

관련 항목:

getBounds()

contains

boolean contains(double x,
                 double y)

지정된 좌표가 Shape 경계내에 있을지 어떨지를 판정합니다.

파라미터:

x - 지정된 x 좌표

y - 지정된 y 좌표

반환값:

지정된 좌표가 Shape 경계내에 있는 경우는 true, 그렇지 않은 경우는 false

contains

boolean contains(Point2D  p)

지정된 Point2D 가 Shape 경계내에 있을지 어떨지를 판정합니다.

파라미터:

p - 지정된 Point2D

반환값:

지정된 Point2D가 Shape 경계내에 있는 경우는 true, 그렇지 않은 경우는 false

intersects

boolean intersects(double x,
                   double y,
                   double w,
                   double h)

Shape 내부 영역이, 지정된 구형 영역의 내부 영역과 교차할지 어떨지를 판정합니다. Shape 내부 영역과 지정된 구형 영역의 양쪽 모두에 포함되는 점이 있는 경우, 구형 영역은 Shape와 교차하고 있다고 보여집니다.

이 메서드는 다음과 같은 경우에서도 true를 돌려주는 일이 있습니다.

• 구형 영역과 Shape가 서로 겹치고 있을 가능성이 꽤 높지만,
• 이 공통 부분을 정확하게 판단하는 계산의 부하가 꽤 크다

즉, 이 메서드는 구형 영역이 Shape와 교차하지 않는 경우에서도 true를 돌려주는 일이 있습니다. 보다 정확한 결과가 필요한 경우에는 Area 클래스를 사용하면, Shape 객체의 기하학적인 공통 부분의 것보다 정밀한 계산을 할 수 있습니다 .

파라미터:

x - 지정된 구형 영역의 x 좌표

y - 지정된 구형 영역의 y 좌표

w - 지정된 구형 영역의 폭

h - 지정된 구형 영역의 높이

반환값:

Shape 내부 영역과 구형 영역의 내부 영역이 교차하는 경우, 또는 교차할 가능성이 높지만, 부하가 너무 커 공통 부분의 계산을 실시할 수 없는 경우도 true. 그 외의 경우는 false

관련 항목:

Area

intersects

boolean intersects(Rectangle2D  r)

Shape 내부 영역이, 지정된 Rectangle2D 내부 영역과 교차할지 어떨지를 판정합니다. 이 메서드는 다음과 같은 경우에도 true를 돌려주는 일이 있습니다.

• Rectangle2D와 Shape가 교차할 가능성이 높지만,
• 이 공통 부분을 정확하게 판단하는 계산의 부하가 꽤 크다

즉, 이 메서드는 Rectangle2D가 Shape와 교차하지 않는 경우에서도 true를 돌려주는 일이 있습니다.

파라미터:

r - 지정된 Rectangle2D

반환값:

Shape 내부 영역과 지정된 Rectangle2D 내부 영역이 교차하는 경우, 또는 교차할 가능성이 꽤 높지만, 부하가 너무 커 공통 부분의 계산을 실시할 수 없는 경우도 true. 그 외의 경우는 false

관련 항목:

intersects(double, double, double, double)

contains

boolean contains(double x,
                 double y,
                 double w,
                 double h)

Shape 내부 영역이, 지정된 구형 영역을 완전하게 포함 할지 어떨지를 판정합니다. 구형 영역 전체가 Shape에 포함 되고 있다고 보여지기 위해서는 구형 영역내에 있는 모든 좌표가 Shape 내에 위치하고 있을 필요가 있습니다.

이 메서드는 다음과 같은 경우에서도 false를 돌려주는 일이 있습니다.

• intersect 메서드가 true를 돌려주고,
• Shape가 구형 영역을 완전하게 포함 할지 어떨지를 판별하는 계산의 부하가 꽤 크다

즉, 이 메서드는 Shape가 구형 영역을 포함 하는 경우에서도 false를 돌려주는 일이 있습니다. 보다 정밀한 결과가 필요한 경우는 Area 클래스를 사용하면, Shape 기하학적인 공통 부분의 정확한 계산을 실시할 수 있습니다.

파라미터:

x - 지정된 구형 영역의 x 좌표

y - 지정된 구형 영역의 y 좌표

w - 지정된 구형 영역의 폭

h - 지정된 구형 영역의 높이

반환값:

Shape 내부 영역이, 지정된 구형 영역을 완전하게 포함 하는 경우는 true, 그렇지 않은 경우는 false. 또, Shape가 구형 영역을 포함 해, intersects 메서드가 true를 돌려주고, 부하가 너무 커 포함의 계산을 실시할 수 없는 경우도 false

관련 항목:

Area, intersects(double, double, double, double)

contains

boolean contains(Rectangle2D  r)

Shape 내부 영역이, 지정된 Rectangle2D를 완전하게 포함 하고 있을지 어떨지를 판정합니다. 이 메서드는 다음과 같은 경우에도 false를 돌려주는 일이 있습니다.

• intersect 메서드가 true를 돌려주고,
• Shape가 Rectangle2D를 완전하게 포함 할지 어떨지를 판단하는 계산의 부하가 크다

즉, 이 메서드는 Shape가 Rectangle2D를 포함 하는 경우에서도 false를 돌려주는 일이 있습니다. 보다 정밀한 결과가 필요한 경우에는 Area 클래스를 사용하면, Shape 객체의 기하학적인 공통 부분의, 보다 정확한 계산을 실시할 수 있습니다 .

파라미터:

r - 지정된 Rectangle2D

반환값:

Shape 내부 영역이 Rectangle2D를 완전하게 포함 하는 경우는 true. 그렇지 않은 경우는 false. 또, Shape가 Rectangle2D를 포함 해, intersects 메서드가 true를 돌려주고, 부하가 너무 커 포함의 계산을 실시할 수 없는 경우도 false

관련 항목:

contains(double, double, double, double)

getPathIterator

PathIterator  getPathIterator(AffineTransform  at)

Shape 경계를 따라 반복 처리를 실시해, Shape 윤곽의 지오메트리에 액세스 할 수 있도록 하는 반복자 객체를 리턴합니다. 임의 AffineTransform 가 지정되었을 경우, 반복 처리로 리턴된 좌표가 거기에 응해 변환됩니다.

이 메서드를 호출할 때마다, 동시에 사용되고 있는 것 외의 모든 PathIterator 객체 (와)는 관계없는 것으로Shape 객체의 지오메트리를 이동하는 새로운 PathIterator 객체가 리턴됩니다 .

Shape인터페이스를 구현하는 객체는 실행중의 반복 처리를 원의 객체의 지오메트리에 대해서 발생할 가능성이 있는 변경으로부터 분리시키는 것이 추천 됩니다만, 이것은 보증되고는 있지 않습니다.

동시에 복수의 thread로 Shape인터페이스의 특정의 구현을 사용하는 경우는 사전에 문서를 참조해, 반복 처리라고 변경과의 분리에 대해 보증되고 있는지를 확인해 주세요.

파라미터:

at - 반복 처리로 리턴된 좌표에 적용되는 옵션의 AffineTransform. 변환되어 있지 않은 좌표가 필요한 경우는 null

반환값:

Shape 지오메트리를 독립해 이동하는 새로운 PathIterator 객체

getPathIterator

PathIterator  getPathIterator(AffineTransform  at,
                             double flatness)

Shape 경계를 따라 반복 처리를 실시해, Shape 윤곽의 지오메트리의 평탄화 된 뷰에 액세스 할 수 있도록 하는 반복자 객체를 리턴합니다.

반복자가 돌려주는 것은 포인트형 SEG_MOVETO, SEG_LINETO 및 SEG_CLOSE 뿐입니다.

옵션의 AffineTransform가 지정되면, 반복 처리로 리턴된 좌표가 거기에 응해 변환됩니다.

곡선 세그먼트(segment)의 분할의 양은 평탄화되어 있지 않은 변환된 곡선상의 점이, 리턴된 평탄화 된 윤곽선 세그먼트 (segment)로부터도와 도 떨어지는 거리를 지정하는 flatness 파라미터에 의해 제어됩니다. 평탄화 된 윤곽선의 정밀도에 대해서 예고없이 제한이 더해지는 일이 있어, 이 경우 매우 작은 평탄화 파라미터가 큰 값으로 해서 다루어지는 일이 있습니다. 이 제한은 사용되는 특정의 구현에 의해 정해집니다.

이 메서드를 호출할 때마다, 동시에 사용되고 있는 것 외의 모든 PathIterator 객체 (와)는 관계없는 것으로Shape 객체의 지오메트리를 이동하는 새로운 PathIterator 객체가 리턴됩니다 .

Shape인터페이스를 구현하는 객체는 실행중의 반복 처리를 원의 객체의 지오메트리에 대해서 발생할 가능성이 있는 변경으로부터 분리시키는 것이 추천 됩니다만, 이것은 보증되고는 있지 않습니다.

동시에 복수의 thread로 이 인터페이스의 특정의 구현을 사용하는 경우는 사전에 문서를 참조해, 반복이라고 변경과의 분리에 대해 보증되고 있는지를 확인해 주세요.

파라미터:

at - 반복 처리로 리턴된 좌표에 적용되는 옵션의 AffineTransform. 변환되어 있지 않은 좌표가 필요한 경우는 null

flatness - 곡선 세그먼트(segment)를 작성하기 위해서 사용되는 라인 세그먼트(segment)가 원의 곡선상의 임의의 점으로부터 멀어질 수 있는 최대의 거리

반환값:

Shape 지오메트리를 독립해 이동하는 새로운 PathIterator