java.awt
클래스 Polygon

java.lang.Object 
  java.awt.Polygon

모든 구현된 인터페이스:

Shape, Serializable

public class Polygon
extends Object 
implements Shape,
 Serializable 

Polygon 클래스는 좌표 공간을 가지는 닫혀진 2 차원 영역의 기술을 캡슐화합니다. 이 영역은 다각형의 1 옆을 이루는 선세그먼트(segment)의 임의의 수에 의해 경계를 단락지어집니다. 내부적으로는 다각형은 (x, y) 좌표 페어의 리스트로부터 구성됩니다. 이 경우 각 페어는 다각형의 「정점」을 정의해, 연속하는 2개의 페어는 다각형의 1 옆을 이루는 선의 단 점이 됩니다. (x, y) 점의 최초와 마지막 페어는 다각형을 닫는 선세그먼트(segment)에 의해 결합됩니다. 이 Polygon는 우기굴곡 규칙에 의해 정의됩니다. 우기굴곡 규칙의 정의에 대해서는 WIND_EVEN_ODD를 참조하십시오. contains, intersects 및 inside 메서드를 포함한 이 클래스의 히트 검사 메서드는 Shape 클래스의 코멘트에 기술된 「안쪽」의 정의를 사용합니다.

도입된 버전 :

JDK1. 0

관련 항목:

Shape, 직렬화 된 형식

필드 개요

protected Rectangle	bounds 다각형의 경계입니다.
int	npoints 점의 총수입니다.
int[]	xpoints x 좌표의 배열입니다.
int[]	ypoints y 좌표의 배열입니다.

생성자 개요

Polygon ()
비어있는 다각형을 작성합니다.

Polygon (int[] xpoints, int[] ypoints, int npoints)
지정된 파라미터로부터 Polygon을 구축 및 초기화합니다.

메서드 개요

void	addPoint (int x, int y) 이 Polygon로 지정된 좌표를 추가합니다.
boolean	contains (double x, double y) 지정된 좌표가 Polygon 안쪽에 있을지 어떨지를 판정합니다.
boolean	contains (double x, double y, double w, double h) 이 Polygon 내부가 지정된 구형 좌표 세트를 완전하게 내포 할지 어떨지를 판정합니다.
boolean	contains (int x, int y) 지정된 좌표가 이 Polygon 안쪽에 있을지 어떨지를 판정합니다.
boolean	contains (Point p) 지정된 Point 가 이 Polygon 안쪽에 있을지 어떨지를 판정합니다.
boolean	contains (Point2D p) 지정된 Point2D 가 이 Polygon 경계내에 있을지 어떨지를 판정합니다.
boolean	contains (Rectangle2D r) 이 Polygon 내부가 지정된 Rectangle2D를 완전하게 내포 할지 어떨지를 판정합니다.
Rectangle	getBoundingBox () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getBounds()를 사용합니다.
Rectangle	getBounds () 이 Polygon 바운딩박스를 리턴합니다.
Rectangle2D	getBounds2D () Shape 고정밀도 바운딩박스를 리턴합니다.
PathIterator	getPathIterator (AffineTransform at) 이 Polygon 경계를 따라 반복 처리를 실시해, Polygon 윤곽의 지오메트리에의 액세스를 제공하는 반복자 객체를 리턴합니다.
PathIterator	getPathIterator (AffineTransform at, double flatness) Shape 경계를 따라 반복 처리를 실시해, Shape 윤곽의 지오메트리에의 액세스를 제공하는 반복자 객체를 리턴합니다.
boolean	inside (int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 contains(int, int)로 옮겨졌습니다.
boolean	intersects (double x, double y, double w, double h) 이 Polygon 내부가 지정된 구형 좌표 세트의 내부와 교차할지 어떨지를 판정합니다.
boolean	intersects (Rectangle2D r) 이 Polygon 내부가 지정된 Rectangle2D 내부와 교차할지 어떨지를 판정합니다.
void	invalidate () 이 Polygon 정점의 좌표에 의존된 내부에 캐쉬된 모든 데이터를 무효로 하는지, 또는 플래시 합니다.
void	reset () 이 Polygon 객체를 비어있는 다각형에 리셋 합니다.
void	translate (int deltaX, int deltaY) Polygon 정점을 x 축으로 따라 deltaX 및 y 축으로 따라 deltaY 이동합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

npoints

public int npoints

점의 총수입니다. npoints값은 이 Polygon 유효한 점의 수를 나타내, xpoints 또는 ypoints 요소의 수보다 작아집니다. 이 값은 null을 취할 수 있습니다 .

관련 항목:

addPoint(int, int)

xpoints

public int[] xpoints

x 좌표의 배열입니다. 이 배열의 요소의 수는 이 Polygon x 좌표의 수보다 커집니다. 여분의 요소에의해 이 배열을 재차 작성하지 않고, 이 Polygon에 새로운 점을 추가할 수 있습니다. npoints 값은 이 Polygon 유효한 점의 수와 같습니다.

관련 항목:

addPoint(int, int)

ypoints

public int[] ypoints

y 좌표의 배열입니다. 이 배열의 요소의 수는 이 Polygon y 좌표의 수보다 커집니다. 여분의 요소에의해 이 배열을 재차 작성하지 않고, 이 Polygon에 새로운 점을 추가할 수 있습니다. npoints값은 이 Polygon 유효한 점의 수와 같습니다.

관련 항목:

addPoint(int, int)

bounds

protected Rectangle  bounds

다각형의 경계입니다. 이 값은 null을 취할 수 있습니다 . javadoc 코멘트의 getBounds()를 참조하십시오.

관련 항목:

getBoundingBox(), getBounds()

생성자 상세

Polygon

public Polygon()

비어있는 다각형을 작성합니다.

Polygon

public Polygon(int[] xpoints,
               int[] ypoints,
               int npoints)

지정된 파라미터로부터 Polygon을 구축 및 초기화합니다.

파라미터:

xpoints - x 좌표의 배열

ypoints - y 좌표의 배열

npoints - Polygon 점의 총수

예외:

NegativeArraySizeException - npoints값이 부인 경우

IndexOutOfBoundsException - npoints가 xpoints 길이 또는 ypoints 길이보다 큰 경우

NullPointerException - xpoints 또는 ypoints가 null인 경우

메서드의 상세

reset

public void reset()

이 Polygon 객체를 비어있는 다각형에 리셋 합니다. 그 중에 있는 좌표 배열과 데이터는 그대로 남습니다만, 점의 수는 제로에 리셋 되어 낡은 정점의 데이터를 무효로서 마크 해, 처음부터 새로운 정점의 데이터의 축적을 개시합니다. 내부에 캐쉬된 모든 낡은 정점으로 관한 데이터는 파기됩니다. 리셋 하기 전의 좌표 배열이 재사용되므로 새로운 다각형의 데이터의 정점의 수가 리셋전의 데이터의 정점의 수보다 꽤 작은 경우는 새로운 비어있는 Polygon 작성이 현재의 다각형을 리셋 하는 것보다도 메모리를 보다 효율적으로 사용할 수 있는 것에 주의해 주세요.

도입된 버전 :

1.4

관련 항목:

invalidate()

invalidate

public void invalidate()

이 Polygon 정점의 좌표에 의존된 내부에 캐쉬된 모든 데이터를 무효로 하는지, 또는 플래시 합니다. 이 메서드는 xpoints 또는 ypoints 배열의 좌표를 직접 조작한 뒤에 호출할 필요가 있습니다. 이것은 정점의 좌표에 관련하기 이전의 계산으로부터 데이터를 캐쉬하고 있는 getBounds 또는 contains 등의 메서드로부터 일관한 결과를 얻을 수 있도록 하기 때문에입니다.

도입된 버전 :

1.4

관련 항목:

getBounds()

translate

public void translate(int deltaX,
                      int deltaY)

Polygon 정점을 x 축으로 따라 deltaX 및 y 축으로 따라 deltaY 이동합니다.

파라미터:

deltaX - x 축으로 따라 이동하는 거리

deltaY - y 축으로 따라 이동하는 거리

도입된 버전 :

JDK1. 1

addPoint

public void addPoint(int x,
                     int y)

이 Polygon로 지정된 좌표를 추가합니다.

이 Polygon 바운딩박스를 계산하는 getBounds 또는 contains 등의 연산이 이미 실행되고 있는 경우, 이 메서드는 바운딩박스를 갱신합니다.

파라미터:

x - 지정된 x 좌표

y - 지정된 y 좌표

관련 항목:

getBounds(), contains(java.awt.Point)

getBounds

public Rectangle  getBounds()

이 Polygon 바운딩박스를 리턴합니다. 이 바운딩박스는 옆이 좌표 공간의 x 축 및 y 축으로 평행으로 Polygon을 완전하게 포함하는 최소 Rectangle 입니다.

정의:

인터페이스 Shape 내의 getBounds

반환값:

이 Polygon 경계를 정의하는 Rectangle

도입된 버전 :

JDK1. 1

관련 항목:

Shape.getBounds2D()

getBoundingBox

@Deprecated 
public Rectangle  getBoundingBox()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getBounds()를 사용합니다.

이 Polygon 경계를 리턴합니다.

반환값:

이 Polygon 경계

contains

public boolean contains(Point  p)

지정된 Point 가 이 Polygon 안쪽에 있을지 어떨지를 판정합니다.

파라미터:

p - 판정 대상의, 지정된 Point

반환값:

Polygon가 Point를 내포 하고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

contains(double, double)

contains

public boolean contains(int x,
                        int y)

지정된 좌표가 이 Polygon 안쪽에 있을지 어떨지를 판정합니다.

파라미터:

x - 판정 대상의 지정된 x 좌표

y - 판정 대상의 지정된 y 좌표

반환값:

이 Polygon가 지정 좌표 (x, y)를 내포 하고 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 1

관련 항목:

contains(double, double)

inside

@Deprecated 
public boolean inside(int x,
                                 int y)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 contains(int, int)로 옮겨졌습니다.

지정된 좌표가 이 Polygon에 내포 되고 있는지를 판정합니다.

파라미터:

x - 판정 대상의 지정된 x 좌표

y - 판정 대상의 지정된 y 좌표

반환값:

이 Polygon가 지정 좌표 (x, y)를 내포 하고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

contains(double, double)

getBounds2D

public Rectangle2D  getBounds2D()

Shape 고정밀도 바운딩박스를 리턴합니다.

정의:

인터페이스 Shape 내의 getBounds2D

반환값:

Shape 정확한 경계가 되는 Rectangle2D

관련 항목:

Shape.getBounds()

contains

public boolean contains(double x,
                        double y)

지정된 좌표가 Polygon 안쪽에 있을지 어떨지를 판정합니다. 「안쪽」의 정의에 대해서는 Shape 클래스의 코멘트를 참조하십시오.

정의:

인터페이스 Shape 내의 contains

파라미터:

x - 지정된 x 좌표

y - 지정된 y 좌표

반환값:

Polygon가 지정된 좌표를 내포 하고 있는 경우는 true, 그렇지 않은 경우는 false

contains

public boolean contains(Point2D  p)

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

정의:

인터페이스 Shape 내의 contains

파라미터:

p - 지정된 Point2D

반환값:

이 Polygon가 지정된 Point2D를 내포 하고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

contains(double, double)

intersects

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

이 Polygon 내부가 지정된 구형 좌표 세트의 내부와 교차할지 어떨지를 판정합니다.

정의:

인터페이스 Shape 내의 intersects

파라미터:

x - 지정된 구형 형상의 좌상구석의 x 좌표

y - 지정된 구형 형상의 좌상구석의 y 좌표

w - 지정된 구형 형상의 폭

h - 지정된 구형 형상의 높이

반환값:

이 Polygon와 지정된 구형 좌표 세트의 내부가 교차하는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.2

관련 항목:

Area

intersects

public boolean intersects(Rectangle2D  r)

이 Polygon 내부가 지정된 Rectangle2D 내부와 교차할지 어떨지를 판정합니다.

정의:

인터페이스 Shape 내의 intersects

파라미터:

r - 지정된 Rectangle2D

반환값:

이 Polygon와 지정된 Rectangle2D 내부가 교차하는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Shape.intersects(double, double, double, double)

contains

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

이 Polygon 내부가 지정된 구형 좌표 세트를 완전하게 내포 할지 어떨지를 판정합니다.

정의:

인터페이스 Shape 내의 contains

파라미터:

x - 지정된 구형 좌표 세트의 좌상구석의 x 좌표

y - 지정된 구형 좌표 세트의 좌상구석의 y 좌표

w - 구형 좌표 세트의 폭

h - 구형 좌표 세트의 높이

반환값:

이 Polygon가 지정된 구형 좌표 세트를 완전하게 내포 하는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.2

관련 항목:

Area, Shape.intersects(double, double, double, double)

contains

public boolean contains(Rectangle2D  r)

이 Polygon 내부가 지정된 Rectangle2D를 완전하게 내포 할지 어떨지를 판정합니다.

정의:

인터페이스 Shape 내의 contains

파라미터:

r - 지정된 Rectangle2D

반환값:

이 Polygon가 지정된 Rectangle2D를 완전하게 내포 하는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

contains(double, double, double, double)

getPathIterator

public PathIterator  getPathIterator(AffineTransform  at)

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

정의:

인터페이스 Shape 내의 getPathIterator

파라미터:

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

반환값:

이 Polygon 지오메트리에의 액세스를 제공하는 PathIterator

getPathIterator

public PathIterator  getPathIterator(AffineTransform  at,
                                    double flatness)

Shape 경계를 따라 반복 처리를 실시해, Shape 윤곽의 지오메트리에의 액세스를 제공하는 반복자 객체를 리턴합니다. SEG_MOVETO, SEG_LINETO 및 SEG_CLOSE 포인트형만이 반복자에 의해 리턴됩니다 . 다각형은 이미 평탄하기 때문에 flatness 파라미터는 무시됩니다. 옵션의 AffineTransform는 반복 처리로 리턴된 좌표가 거기에 응해 변환되는 경우로 지정할 수 있습니다 .

정의:

인터페이스 Shape 내의 getPathIterator

파라미터:

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

flatness - 지정된 곡선상의 제어점을 움직였을 때, 분할된 곡선이 단 점을 묶는 직선에 의해 치환되지 않는 조건으로 제어점이 이 직선으로부터도와 도 떨어지는 거리. 다각형은 이미 평탄하기 때문에 flatness 파라미터는 무시된다

반환값:

Shape 객체의 지오메트리에의 액세스를 제공하는 PathIterator 객체