JavaTM 2
Platform
Std.  Ed.  v1. 4.0

java.awt
클래스 Polygon

java.lang.Object 
  |
  +--java.awt.Polygon
모든 구현 인터페이스:
Serializable , Shape

public class Polygon
extends Object
implements Shape , Serializable

Polygon 클래스는 좌표 공간을 가지는 닫혀진 2 차원 area의 기술을 캡슐화합니다. 이 area는 다각형의 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)
          지정된 Point2DPolygon 의 경계내에 있을지 어떨지를 판정합니다.
 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 좌표의 배열입니다. 이 배열의 요소의 수는 이 Polygonx 좌표의 수보다 커집니다. 여분의 요소에 의해, 이 배열을 재차 작성하지 않고 , 이 Polygon 에 새로운 점을 추가할 수 있습니다. npoints 의 값은 이 Polygon 의 유효한 점의 수와 같습니다.

관련 항목:
addPoint(int, int)

ypoints

public int[] ypoints
y 좌표의 배열입니다. 이 배열의 요소의 수는 이 Polygony 좌표의 수보다 커집니다. 여분의 요소에 의해, 이 배열을 재차 작성하지 않고 , 이 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 - npointsxpoints 의 길이 또는 ypoints 의 길이보다 큰 경우
NullPointerException - xpoints 또는 ypointsnull 의 경우
메소드의 상세

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 등의 연산이 벌써 실행되고 있는 경우, 이 메소드는 바운딘그복스를 갱신합니다.

관련 항목:
getBounds() , contains(java.awt.Point)

getBounds

public Rectangle  getBounds()
Polygon 의 바운딘그복스를 돌려줍니다. 이 바운딘그복스는 옆이 좌표 공간의 x 축 및 y 축으로 평행으로 Polygon 를 완전하게 저장하는 최소의 Rectangle 입니다.

정의:
인터페이스 Shape 내의 getBounds
반환값:
Polygon 의 경계를 정의하는 Rectangle
도입된 버젼:
JDK1. 1
관련 항목:
Shape.getBounds2D()

getBoundingBox

public Rectangle  getBoundingBox()
추천 되고 있지 않습니다.  JDK 버젼 1.1 이후는 getBounds() 를 사용

Polygon 의 경계를 돌려줍니다.

반환값:
Polygon 의 경계

contains

public boolean contains(Point  p)
지정된 Point 가 이 Polygon 의 안쪽에 있을지 어떨지를 판정합니다.

파라미터:
p - 판정 대상의, 지정된 Point
반환값:
PolygonPoint 를 내포 하고 있는 경우는 true, 그렇지 않은 경우는 false
관련 항목:
contains(double, double)

contains

public boolean contains(int x,
                        int y)
지정된 좌표가 이 Polygon 의 안쪽에 있을지 어떨지를 판정합니다.

반환값:
Polygon 가 지정 좌표 (x,  y)를 내포 하고 있는 경우는 true, 그렇지 않은 경우는 false
도입된 버젼:
JDK1. 1
관련 항목:
contains(double, double)

inside

public boolean inside(int x,
                      int y)
추천 되고 있지 않습니다.  JDK 버젼 1.1 이후는 contains(int, int) 를 사용

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

반환값:
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
반환값:
Polygon 가 지정된 좌표를 내포 하고 있는 경우는 true, 그렇지 않은 경우는 false

contains

public boolean contains(Point2D  p)
지정된 Point2DPolygon 의 경계내에 있을지 어떨지를 판정합니다.

정의:
인터페이스 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
파라미터:
w - 지정된 구형 형상의 폭
h - 지정된 구형 형상의 높이
반환값:
Polygon 와 지정된 구형 좌표 세트의 내부가 교차하는 경우는 true, 그렇지 않은 경우는 false
관련 항목:
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
파라미터:
w - 구형 좌표 세트의 폭
h - 구형 좌표 세트의 높이
반환값:
Polygon 가 지정된 구형 좌표 세트를 완전하게 내포 하는 경우는 true, 그렇지 않은 경우는 false
관련 항목:
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 오브젝트

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.