java.awt.geom
클래스 GeneralPath

java.lang.Object 
  java.awt.geom.GeneralPath

모든 구현된 인터페이스:

Shape, Cloneable

public final class GeneralPath
extends Object 
implements Shape,
 Cloneable 

GeneralPath 클래스는 직선, 2 차 곡선 및 3 차 (베쥬) 곡선으로부터 작성된 지오 시학 패스를 나타냅니다. 이 클래스는 복수의 서브 패스를 가질 수가 있습니다.

굴곡 규칙은 패스의 내부를 어떻게 결정할 수 있는지를 지정합니다. 굴곡 규칙에는 EVEN_ODD와 NON_ZERO 2개의 타입이 있습니다.

EVEN_ODD인 경우, 패스가 둘러싸는 영역은 패스의 외측에서 영역의 안쪽의 점으로 향해 이동할 경우에 내부 영역과 외부 영역이 바뀝니다.

NON_ZERO 에서는 지정된 점을 기점으로서 무한원점으로 향해 임의의 방향으로 광선이 렌더링 되는 경우, 그 광선과 패스가 교차하는 장소를 조사해, 패스가 광선을 왼쪽에서 오른쪽으로 횡단하는 회수와 오른쪽에서 왼쪽으로 횡단하는 회수가 같지 않은 경우에만, 점은 패스의 안쪽에 있습니다.

필드 개요

static int	WIND_EVEN_ODD 패스의 내부를 결정하는 우기굴곡 규칙입니다.
static int	WIND_NON_ZERO 패스의 내부를 결정하는 비제로 굴곡 규칙입니다.

생성자 개요

GeneralPath ()
새로운 GeneralPath 객체를 구축합니다.

GeneralPath (int rule)
패스의 내부를 정의할 필요가 있는 오퍼레이션을 제어하기 위해서 굴곡 규칙을 지정해, 새로운 GeneralPath 객체를 구축합니다.

GeneralPath (int rule, int initialCapacity)
굴곡 규칙 및 패스의 좌표를 포함하는 초기 용량을 지정해, 새로운 GeneralPath 객체를 구축합니다.

GeneralPath (Shape s)
임의 Shape 객체로부터 새로운 GeneralPath 객체를 구축합니다.

메서드 개요

void	append (PathIterator pi, boolean connect) 지정된 PathIterator 객체의 지오메트리를 패스에 추가합니다.
void	append (Shape s, boolean connect) 지정된 Shape 객체의 지오메트리를 패스에 추가합니다.
Object	clone () 이 객체와 같은 클래스의 새로운 객체를 작성합니다.
void	closePath () 마지막 moveTo 좌표까지 직선을 렌더링의해 현재의 서브 패스를 닫습니다.
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) 지정된 Rectangle2D가 이 Shape 경계내에 있을지 어떨지를 판정합니다.
Shape	createTransformedShape (AffineTransform at) 변환된, 새로운 Shape를 리턴합니다.
void	curveTo (float x1, float y1, float x2, float y2, float x3, float y3) 3개의 새로운 점에 의해 정의되는 곡선 세그먼트(segment)를 패스에 추가합니다.
Rectangle	getBounds () 패스의 바운딩박스를 리턴합니다.
Rectangle2D	getBounds2D () 패스의 바운딩박스를 리턴합니다.
Point2D	getCurrentPoint () 패스의 마지막에 추가된 가장 새로운 좌표를 Point2D 객체로서 리턴합니다.
PathIterator	getPathIterator (AffineTransform at) 이 Shape 경계를 따라 반복 처리를 실시해, 이 Shape 윤곽의 지오메트리에의 액세스를 제공하는 PathIterator 객체를 리턴합니다.
PathIterator	getPathIterator (AffineTransform at, double flatness) 평탄화 된 Shape 경계를 따라 반복 처리를 실시해, Shape 윤곽의 지오메트리에의 액세스를 제공하는 PathIterator 객체를 리턴합니다.
int	getWindingRule () 전부 칠해 스타일 굴곡 규칙을 리턴합니다.
boolean	intersects (double x, double y, double w, double h) 이 Shape 내부가 지정된 구형 좌표 세트의 내부와 교차할지 어떨지를 판정합니다.
boolean	intersects (Rectangle2D r) 이 Shape 내부가 지정된 Rectangle2D 내부와 교차할지 어떨지를 판정합니다.
void	lineTo (float x, float y) 현재의 좌표로부터 새롭게 지정된 좌표까지 직선을 렌더링의해 점을 패스에 추가합니다.
void	moveTo (float x, float y) 지정된 좌표로 이동해 점을 패스에 추가합니다.
void	quadTo (float x1, float y1, float x2, float y2) 2개의 새로운 점에 의해 정의되는 곡선 세그먼트(segment)를 패스에 추가합니다.
void	reset () 패스를 리셋 합니다.
void	setWindingRule (int rule) 이 패스의 굴곡 규칙이 지정된 값으로 설정합니다.
void	transform (AffineTransform at) 지정된 AffineTransform를 사용해, 이 패스의 지오메트리를 변환합니다.

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

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

필드의 상세

WIND_EVEN_ODD

public static final int WIND_EVEN_ODD

패스의 내부를 결정하는 우기굴곡 규칙입니다.

관련 항목:

정수 필드값

WIND_NON_ZERO

public static final int WIND_NON_ZERO

패스의 내부를 결정하는 비제로 굴곡 규칙입니다.

관련 항목:

정수 필드값

생성자 상세

GeneralPath

public GeneralPath()

새로운 GeneralPath 객체를 구축합니다. 패스의 내부를 정의할 필요가 있는 오퍼레이션이 이 패스로 실행되는 경우, 디폴트의 NON_ZERO 굴곡 규칙이 사용됩니다.

관련 항목:

WIND_NON_ZERO

GeneralPath

public GeneralPath(int rule)

패스의 내부를 정의할 필요가 있는 오퍼레이션을 제어하기 위해서 굴곡 규칙을 지정해, 새로운 GeneralPath 객체를 구축합니다.

파라미터:

rule - 굴곡 규칙

관련 항목:

WIND_EVEN_ODD, WIND_NON_ZERO

GeneralPath

public GeneralPath(int rule,
                   int initialCapacity)

굴곡 규칙 및 패스의 좌표를 포함하는 초기 용량을 지정해, 새로운 GeneralPath 객체를 구축합니다. 이 숫자는 패스에 존재하는 패스 세그먼트(segment)의 수에 대한 초기 추정입니다만, 이 패스에 패스 세그먼트(segment)가 추가될 때 필요에 따라서 확장됩니다.

파라미터:

rule - 굴곡 규칙

initialCapacity - 패스에 있는 패스 세그먼트(segment)의 수의 추정치

관련 항목:

WIND_EVEN_ODD, WIND_NON_ZERO

GeneralPath

public GeneralPath(Shape  s)

임의 Shape 객체로부터 새로운 GeneralPath 객체를 구축합니다. 이 패스의 초기 지오메트리 및 굴곡 규칙은 모두, 지정된 Shape 객체로부터 빼앗깁니다.

파라미터:

s - 지정된 Shape 객체

메서드의 상세

moveTo

public void moveTo(float x,
                   float y)

지정된 좌표로 이동해 점을 패스에 추가합니다.

파라미터:

x, y - 지정된 좌표

lineTo

public void lineTo(float x,
                   float y)

현재의 좌표로부터 새롭게 지정된 좌표까지 직선을 렌더링의해 점을 패스에 추가합니다.

파라미터:

x, y - 지정된 좌표

quadTo

public void quadTo(float x1,
                   float y1,
                   float x2,
                   float y2)

2개의 새로운 점에 의해 정의되는 곡선 세그먼트(segment)를 패스에 추가합니다. 곡선 세그먼트(segment)는 지정된 점 (x1, y1)을 2 차 파라메트릭 제어점으로서 사용해, 현재의 좌표와 지정된 좌표 (x2, y2)를 통과하는 2 차 곡선으로서 렌더링 합니다.

파라미터:

x1, y1 - 최초의 2 차 제어점의 좌표

x2, y2 - 마지막 단 점의 좌표

curveTo

public void curveTo(float x1,
                    float y1,
                    float x2,
                    float y2,
                    float x3,
                    float y3)

3개의 새로운 점에 의해 정의되는 곡선 세그먼트(segment)를 패스에 추가합니다. 곡선 세그먼트(segment)는 지정된 점 (x1, y1) 및 점 (x2, y2)을 베쥬 제어점으로서 사용해, 현재의 좌표와 지정된 좌표 (x3, y3)의 양쪽 모두를 통과하는 베지에곡선으로서 렌더링 합니다.

파라미터:

x1, y1 - 최초의 베쥬 제어점의 좌표

x2, y2 - 2번째의 베쥬 제어점의 좌표

x3, y3 - 마지막 단 점의 좌표

closePath

public void closePath()

마지막 moveTo 좌표까지 직선을 렌더링의해 현재의 서브 패스를 닫습니다. 패스가 이미 닫혀 있는 경우, 이 메서드는 효과가 없습니다.

append

public void append(Shape  s,
                   boolean connect)

지정된 Shape 객체의 지오메트리를 패스에 추가합니다. 그 새로운 지오메트리를 라인 세그먼트(segment)로 기존의 패스 세그먼트(segment)에 접속하는 일도 가능합니다. connect 파라미터가 true 이며, 패스가 비어있지 않은 경우, 추가된 Shape 지오메트리의 초기 moveTo는 lineTo 세그먼트(segment)로 바뀝니다. 그러한 접속 lineTo 세그먼트(segment)의 목적지의 좌표가 현재 열려 있는 서브 패스의 종료 좌표와 일치하는 경우, 세그먼트(segment)는 불필요해서 생략 됩니다. 지정된 Shape 굴곡 규칙은 무시되어 추가된 지오메트리는 이 패스로 지정된 굴곡 규칙으로 제어됩니다.

파라미터:

s - 이 패스에 지오메트리?? 추가되는 Shape

connect - 새로운 지오메트리를 기존의 패스에 접속하기 위해서 초기 moveTo 세그먼트(segment)를 lineTo 세그먼트(segment)로 바꿀지 어떨지를 제어하는 boolean 치

append

public void append(PathIterator  pi,
                   boolean connect)

지정된 PathIterator 객체의 지오메트리를 패스에 추가합니다. 그 새로운 지오메트리를 라인 세그먼트(segment)로 기존의 패스 세그먼트(segment)에 접속하는 일도 가능합니다. connect 파라미터가 true 이며, 패스가 비어있지 않은 경우, 추가된 Shape 지오메트리의 초기 moveTo는 lineTo 세그먼트(segment)로 바뀝니다. 그러한 접속 lineTo 세그먼트(segment)의 목적지의 좌표가 현재 열려 있는 서브 패스의 종료 좌표와 일치하는 경우, 세그먼트(segment)는 불필요해서 생략 됩니다. 지정된 Shape 굴곡 규칙은 무시되어 추가된 지오메트리는 이 패스로 지정된 굴곡 규칙에 제어됩니다.

파라미터:

pi - 이 패스에 지오메트리?? 추가되는 PathIterator

connect - 새로운 지오메트리를 기존의 패스에 접속하기 위해서 초기 moveTo 세그먼트(segment)를 lineTo 세그먼트(segment)로 바꿀지 어떨지를 제어하는 boolean 치

getWindingRule

public int getWindingRule()

전부 칠해 스타일 굴곡 규칙을 리턴합니다.

반환값:

현재의 굴곡 규칙을 나타내는 정수

관련 항목:

WIND_EVEN_ODD, WIND_NON_ZERO, setWindingRule(int)

setWindingRule

public void setWindingRule(int rule)

이 패스의 굴곡 규칙이 지정된 값으로 설정합니다.

파라미터:

rule - 지정된 굴곡 규칙을 나타내는 정수

예외:

IllegalArgumentException - rule가 WIND_EVEN_ODD도 WIND_NON_ZERO도 아닌 경우

관련 항목:

WIND_EVEN_ODD, WIND_NON_ZERO, getWindingRule()

getCurrentPoint

public Point2D  getCurrentPoint()

패스의 마지막에 추가된 가장 새로운 좌표를 Point2D 객체로서 리턴합니다.

반환값:

패스의 종료 좌표를 포함하는 Point2D 객체. 패스에 점이 없는 경우는 null

reset

public void reset()

패스를 리셋 합니다. 추가 위치는 패스의 선두로 다시 설정해 모든 좌표 및 점의 타입은 파기됩니다.

transform

public void transform(AffineTransform  at)

지정된 AffineTransform를 사용해, 이 패스의 지오메트리를 변환합니다. 지오메트리는 적절히 변환되어 이것에 의해 이 객체에 의해 정의되는 경계가 영구적으로 변경됩니다.

파라미터:

at - 영역을 변환하기 위해서 사용되는 AffineTransform

createTransformedShape

public Shape  createTransformedShape(AffineTransform  at)

변환된, 새로운 Shape를 리턴합니다.

파라미터:

at - 새로운 Shape를 변환하기 위해서 사용되는 AffineTransform

반환값:

지정된 AffineTransform로 변환된, 새로운 Shape

getBounds

public Rectangle  getBounds()

패스의 바운딩박스를 리턴합니다.

정의:

인터페이스 Shape 내의 getBounds

반환값:

현재의 패스의 경계가 되는 Rectangle 객체

관련 항목:

Shape.getBounds2D()

getBounds2D

public Rectangle2D  getBounds2D()

패스의 바운딩박스를 리턴합니다.

정의:

인터페이스 Shape 내의 getBounds2D

반환값:

현재의 패스의 경계가 되는 Rectangle2D 객체

관련 항목:

Shape.getBounds()

contains

public boolean contains(double x,
                        double y)

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

정의:

인터페이스 Shape 내의 contains

파라미터:

x, y - 지정된 좌표

반환값:

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

contains

public boolean contains(Point2D  p)

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

정의:

인터페이스 Shape 내의 contains

파라미터:

p - 지정된 Point2D

반환값:

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

contains

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

지정된 구형 영역이 이 Shape 경계내에 있을지 어떨지를 판정합니다.

정의:

인터페이스 Shape 내의 contains

파라미터:

x, y - 지정된 좌표

w - 지정된 구형 영역의 폭

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

반환값:

이 Shape가 지정된 구형 영역을 내포 하고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

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

contains

public boolean contains(Rectangle2D  r)

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

정의:

인터페이스 Shape 내의 contains

파라미터:

r - 지정된 Rectangle2D

반환값:

이 Shape 경계내로 지정된 Rectangle2D가 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Shape.contains(double, double, double, double)

intersects

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

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

정의:

인터페이스 Shape 내의 intersects

파라미터:

x, y - 지정된 좌표

w - 지정된 구형 좌표의 폭

h - 지정된 구형 좌표의 높이

반환값:

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

관련 항목:

Area

intersects

public boolean intersects(Rectangle2D  r)

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

정의:

인터페이스 Shape 내의 intersects

파라미터:

r - 지정된 Rectangle2D

반환값:

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

관련 항목:

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

getPathIterator

public PathIterator  getPathIterator(AffineTransform  at)

이 Shape 경계를 따라 반복 처리를 실시해, 이 Shape 윤곽의 지오메트리에의 액세스를 제공하는 PathIterator 객체를 리턴합니다. 이 클래스의 반복자는 multi-thread에 대해서 안전하지는 않습니다. 즉 이 GeneralPath 클래스는 이 GeneralPath 객체의 지오메트리를 변경하면, 이 지오메트리에 대해 이미 진행중의 반복 처리에 영향을 미치는 경우가 있습니다.

정의:

인터페이스 Shape 내의 getPathIterator

파라미터:

at - AffineTransform

반환값:

이 Shape 경계를 따라 반복 처리를 실시해, 이 Shape 윤곽의 지오메트리에의 액세스를 제공하는 새로운 PathIterator

getPathIterator

public PathIterator  getPathIterator(AffineTransform  at,
                                    double flatness)

평탄화 된 Shape 경계를 따라 반복 처리를 실시해, Shape 윤곽의 지오메트리에의 액세스를 제공하는 PathIterator 객체를 리턴합니다. 이 클래스의 반복자는 multi-thread에 대해서 안전하지는 않습니다. 즉 이 GeneralPath 클래스는 이 GeneralPath 객체의 지오메트리를 변경하면, 이 지오메트리에 대해 이미 진행중의 반복 처리에 영향을 미치는 경우가 있습니다.

정의:

인터페이스 Shape 내의 getPathIterator

파라미터:

at - AffineTransform

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

반환값:

평탄화 된 Shape 경계를 따라 반복 처리를 실시하는 새로운 PathIterator

clone

public Object  clone()

이 객체와 같은 클래스의 새로운 객체를 작성합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

예외:

OutOfMemoryError - 충분한 메모리가 없는 경우

도입된 버전 :

1.2

관련 항목:

Cloneable