java.awt.geom
클래스 RectangularShape

java.lang.Object 
  java.awt.geom.RectangularShape

모든 구현된 인터페이스:

Shape , Cloneable

직계의 기존의 서브 클래스:

Arc2D , Ellipse2D , Rectangle2D , RoundRectangle2D

public abstract class RectangularShape
extends Object 
implements Shape , Cloneable 

RectangularShape 는, 기하학적 도형이 구형 프레임에 의해 정의되는 많은 Shape 객체의 base class입니다. 이 클래스는, 그 자체로 특정의 기하학적 도형을 직접 지정하지 않고, 단지 모든 Shape 객체의 전카테고리에 의해 상속되는 조작 메소드를 제공합니다. 이 클래스가 제공하는 조작 메소드를 사용하면(자), 서브 클래스가 그 기하학적 도형을 정의하기 위한 참조를 제공하는 구형 프레임을 문의하거나 변경하거나 할 수 있습니다.

도입된 버젼:

1.2

생성자 의 개요

protected

RectangularShape () 이것은, 인스턴스를 직접은 생성할 수 없는 abstract 클래스입니다.

메소드의 개요

Object	clone () 이 객체와 같은 클래스에서, 같은 내용의 새로운 객체를 작성합니다.
boolean	contains (Point2D p) 지정된 Point2D 가 Shape 의 경계내에 있을지 어떨지를 판정합니다.
boolean	contains (Rectangle2D r) Shape 의 내부가, 지정된 Rectangle2D 를 완전하게 내포 할지 어떨지를 판정합니다.
Rectangle	getBounds () Shape 를 완전하게 둘러싸는 정수형 Rectangle 를 돌려줍니다.
double	getCenterX () Shape 의 표시범위 구형의 중심의 X 좌표를 double 정밀도로 돌려줍니다.
double	getCenterY () Shape 의 표시범위 구형의 중심의 Y 좌표를 double 정밀도로 돌려줍니다.
Rectangle2D	getFrame () 이 객체의 형상 전체를 정의하는 표시범위 Rectangle2D 를 돌려줍니다.
abstract double	getHeight () 표시범위 구형의 높이를 double 정밀도로 돌려줍니다.
double	getMaxX () Shape 의 표시범위 구형의 최대의 X 좌표를 double 정밀도로 돌려줍니다.
double	getMaxY () Shape 의 표시범위 구형의 최대의 Y 좌표를 double 정밀도로 돌려줍니다.
double	getMinX () Shape 의 표시범위 구형의 최소의 X 좌표를 double 정밀도로 돌려줍니다.
double	getMinY () Shape 의 표시범위 구형의 최소의 Y 좌표를 double 정밀도로 돌려줍니다.
PathIterator	getPathIterator (AffineTransform at, double flatness) Shape 객체의 경계를 따라 반복 처리 하는 반복자 객체를 돌려주어,Shape 객체의 기하학적 도형의 윤곽의 평탄화 된 뷰에의 액세스를 제공합니다.
abstract double	getWidth () 표시범위 구형의 폭을 double 정밀도로 돌려줍니다.
abstract double	getX () 표시범위 구형의 좌상구석의 X 좌표를 double 정밀도로 돌려줍니다.
abstract double	getY () 표시범위 구형의 좌상구석의 Y 좌표를 double 정밀도로 돌려줍니다.
boolean	intersects (Rectangle2D r) Shape 의 내부가, 지정된 Rectangle2D 의 내부와 교차할지 어떨지를 판정합니다.
abstract boolean	isEmpty () RectangularShape 가 빈 상태(empty)인가 어떤가를 판정합니다.
abstract void	setFrame (double x, double y, double w, double h) 이 Shape 의 표시범위 구형의 위치와 사이즈를, 지정된 구형치로 설정합니다.
void	setFrame (Point2D loc, Dimension2D size) 이 Shape 의 표시범위 구형의 위치와 사이즈를, 각각 지정된 Point2D 와 Dimension2D 로 설정합니다.
void	setFrame (Rectangle2D r) 이 Shape 의 표시범위 구형을, 지정된 Rectangle2D 로 설정합니다.
void	setFrameFromCenter (double centerX, double centerY, double cornerX, double cornerY) 이 Shape 의 표시범위 구형을, 지정된 중심점 및 모퉁이의 점의 좌표에 근거해 설정합니다.
void	setFrameFromCenter (Point2D center, Point2D corner) 이 Shape 의 표시범위 구형을, 중심을 나타내는 Point2D 및 모퉁이를 나타내는 Point2D 에 근거해 설정합니다.
void	setFrameFromDiagonal (double x1, double y1, double x2, double y2) 이 Shape 의 표시범위 구형의 대각선을, 지정된 2 개의 좌표에 근거해 설정합니다.
void	setFrameFromDiagonal (Point2D p1, Point2D p2) 이 Shape 의 표시범위 구형의 대각선을, 지정된 2 개의 Point2D 객체에 근거해 설정합니다.

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

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

인터페이스 java.awt. Shape 로부터 상속된 메소드

contains , contains , getBounds2D , getPathIterator , intersects

생성자 의 상세

RectangularShape

protected RectangularShape()

이것은, 인스턴스를 직접은 생성할 수 없는 abstract 클래스입니다.

도입된 버젼:

1.2

관련 항목:

Arc2D , Ellipse2D , Rectangle2D , RoundRectangle2D

메소드의 상세

getX

public abstract double getX()

표시범위 구형의 좌상구석의 X 좌표를 double 정밀도로 돌려줍니다.

반환값:

표시범위 구형의 좌상구석의 X 좌표

도입된 버젼:

1.2

getY

public abstract double getY()

표시범위 구형의 좌상구석의 Y 좌표를 double 정밀도로 돌려줍니다.

반환값:

표시범위 구형의 좌상구석의 Y 좌표

도입된 버젼:

1.2

getWidth

public abstract double getWidth()

표시범위 구형의 폭을 double 정밀도로 돌려줍니다.

반환값:

표시범위 구형의 폭

도입된 버젼:

1.2

getHeight

public abstract double getHeight()

표시범위 구형의 높이를 double 정밀도로 돌려줍니다.

반환값:

표시범위 구형의 높이

도입된 버젼:

1.2

getMinX

public double getMinX()

Shape 의 표시범위 구형의 최소의 X 좌표를 double 정밀도로 돌려줍니다.

반환값:

Shape 의 표시범위 구형의 최소의 X 좌표

도입된 버젼:

1.2

getMinY

public double getMinY()

Shape 의 표시범위 구형의 최소의 Y 좌표를 double 정밀도로 돌려줍니다.

반환값:

Shape 의 표시범위 구형의 최소의 Y 좌표

도입된 버젼:

1.2

getMaxX

public double getMaxX()

Shape 의 표시범위 구형의 최대의 X 좌표를 double 정밀도로 돌려줍니다.

반환값:

Shape 의 표시범위 구형의 최대의 X 좌표

도입된 버젼:

1.2

getMaxY

public double getMaxY()

Shape 의 표시범위 구형의 최대의 Y 좌표를 double 정밀도로 돌려줍니다.

반환값:

Shape 의 표시범위 구형의 최대의 Y 좌표

도입된 버젼:

1.2

getCenterX

public double getCenterX()

Shape 의 표시범위 구형의 중심의 X 좌표를 double 정밀도로 돌려줍니다.

반환값:

Shape 의 표시범위 구형의 중심의 X 좌표

도입된 버젼:

1.2

getCenterY

public double getCenterY()

Shape 의 표시범위 구형의 중심의 Y 좌표를 double 정밀도로 돌려줍니다.

반환값:

Shape 의 표시범위 구형의 중심의 Y 좌표

도입된 버젼:

1.2

getFrame

public Rectangle2D  getFrame()

이 객체의 형상 전체를 정의하는 표시범위 Rectangle2D 를 돌려줍니다.

반환값:

double 형의 좌표로 지정되었다 Rectangle2D

도입된 버젼:

1.2

관련 항목:

setFrame(double, double, double, double) , setFrame(Point2D, Dimension2D) , setFrame(Rectangle2D)

isEmpty

public abstract boolean isEmpty()

RectangularShape 가 빈 상태(empty)인가 어떤가를 판정합니다. 빈 상태(empty)의 경우는,RectangularShape 에 영역은 없습니다.

반환값:

RectangularShape 가 빈 상태(empty)인 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.2

setFrame

public abstract void setFrame(double x,
                              double y,
                              double w,
                              double h)

이 Shape 의 표시범위 구형의 위치와 사이즈를, 지정된 구형치로 설정합니다.

파라미터:

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

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

w - 지정된 구형 형상의 폭

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

도입된 버젼:

1.2

관련 항목:

getFrame()

setFrame

public void setFrame(Point2D  loc,
                     Dimension2D  size)

이 Shape 의 표시범위 구형의 위치와 사이즈를, 각각 지정된 Point2D 와 Dimension2D 로 설정합니다. 표시범위 구형은,RectangularShape 의 서브 클래스가 기하학적 도형을 정의하기 위해서 사용합니다.

파라미터:

loc - 지정된 Point2D

size - 지정된 Dimension2D

도입된 버젼:

1.2

관련 항목:

getFrame()

setFrame

public void setFrame(Rectangle2D  r)

이 Shape 의 표시범위 구형을, 지정된 Rectangle2D 로 설정합니다. 표시범위 구형은,RectangularShape 의 서브 클래스가 기하학적 도형을 정의하기 위해서 사용합니다.

파라미터:

r - 지정된 Rectangle2D

도입된 버젼:

1.2

관련 항목:

getFrame()

setFrameFromDiagonal

public void setFrameFromDiagonal(double x1,
                                 double y1,
                                 double x2,
                                 double y2)

이 Shape 의 표시범위 구형의 대각선을, 지정된 2 개의 좌표에 근거해 설정합니다. 표시범위 구형은,RectangularShape 의 서브 클래스가 기하학적 도형을 정의하기 위해서 사용합니다.

파라미터:

x1 - 지정된 대각선의 시점의 X 좌표

y1 - 지정된 대각선의 시점의 Y 좌표

x2 - 지정된 대각선의 종점의 X 좌표

y2 - 지정된 대각선의 종점의 Y 좌표

도입된 버젼:

1.2

setFrameFromDiagonal

public void setFrameFromDiagonal(Point2D  p1,
                                 Point2D  p2)

이 Shape 의 표시범위 구형의 대각선을, 지정된 2 개의 Point2D 객체에 근거해 설정합니다. 표시범위 구형은,RectangularShape 의 서브 클래스가 기하학적 도형을 정의하기 위해서 사용합니다.

파라미터:

p1 - 지정된 대각선의 시점을 나타내는 Point2D

p2 - 지정된 대각선의 종점을 나타내는 Point2D

도입된 버젼:

1.2

setFrameFromCenter

public void setFrameFromCenter(double centerX,
                               double centerY,
                               double cornerX,
                               double cornerY)

이 Shape 의 표시범위 구형을, 지정된 중심점 및 모퉁이의 점의 좌표에 근거해 설정합니다. 표시범위 구형은,RectangularShape 의 서브 클래스가 기하학적 도형을 정의하기 위해서 사용합니다.

파라미터:

centerX - 지정된 중심점의 X 좌표

centerY - 지정된 중심점의 Y 좌표

cornerX - 지정된 모퉁이의 점의 X 좌표

cornerY - 지정된 모퉁이의 점의 Y 좌표

도입된 버젼:

1.2

setFrameFromCenter

public void setFrameFromCenter(Point2D  center,
                               Point2D  corner)

이 Shape 의 표시범위 구형을, 중심을 나타내는 Point2D 및 모퉁이를 나타내는 Point2D 에 근거해 설정합니다. 표시범위 구형은,RectangularShape 의 서브 클래스가 기하학적 도형을 정의하기 위해서 사용합니다.

파라미터:

center - 지정된 중심의 Point2D

corner - 지정된 모퉁이의 Point2D

도입된 버젼:

1.2

contains

public boolean contains(Point2D  p)

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

정의:

인터페이스 Shape 내의 contains

파라미터:

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

반환값:

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

도입된 버젼:

1.2

intersects

public boolean intersects(Rectangle2D  r)

Shape 의 내부가, 지정된 Rectangle2D 의 내부와 교차할지 어떨지를 판정합니다. Shape.intersects() 메소드를 사용하면(자), 다음과 같은 경우에 Shape 구현은 true 를 돌려주는 일이 있습니다.

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

즉,Shape 에 따라서는,Rectangle2D 가 Shape 와 교차하지 않는 경우에서도 이 메소드가 true 를 돌려주는 일이 있습니다. Area 클래스는, 대부분의 Shape 객체의 기하학적인 공통 부분의 것보다 정밀한 계산을 실시하기 (위해)때문에, 보다 정확한 결과가 필요한 경우에 사용할 수 있습니다.

정의:

인터페이스 Shape 내의 intersects

파라미터:

r - 지정된 Rectangle2D

반환값:

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

도입된 버젼:

1.2

관련 항목:

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

contains

public boolean contains(Rectangle2D  r)

Shape 의 내부가, 지정된 Rectangle2D 를 완전하게 내포 할지 어떨지를 판정합니다. Shape.contains() 메소드를 사용하면(자), 다음과 같은 경우에 Shape 구현은 false 를 돌려주는 일이 있습니다.

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

즉,Shape 에 따라서는,Shape 가 Rectangle2D 를 포함 하는 경우에서도 이 메소드가 false 를 돌려주는 일이 있습니다. Area 클래스는, 대부분의 Shape 객체의 것보다 정밀한 기하학적 계산을 실시하기 (위해)때문에, 보다 정확한 결과가 필요한 경우에 사용할 수 있습니다.

정의:

인터페이스 Shape 내의 contains

파라미터:

r - 지정된 Rectangle2D

반환값:

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

도입된 버젼:

1.2

관련 항목:

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

getBounds

public Rectangle  getBounds()

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

정의:

인터페이스 Shape 내의 getBounds

반환값:

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

도입된 버젼:

1.2

관련 항목:

Shape.getBounds2D()

getPathIterator

public PathIterator  getPathIterator(AffineTransform  at,
                                    double flatness)

Shape 객체의 경계를 따라 반복 처리 하는 반복자 객체를 돌려주어,Shape 객체의 기하학적 도형의 윤곽의 평탄화 된 뷰에의 액세스를 제공합니다.

반복자에 의해 반환되는 것은, SEG_MOVETO, SEG_LINETO, 및 SEG_CLOSE 의 포인트의 형태 뿐입니다.

곡선 세그먼트(segment)의 분할의 양은, 평탄화 되지 않는 변환을 받은 곡선상의 점이, 반환되는 평탄화 된 패스 세그먼트(segment)로부터도 와도 떨어지는 거리를 지정하는 flatness 파라미터에 의해 제어됩니다. 임의로 AffineTransform 를 지정할 수 있어 그 경우는 반복 처리로 반환되는 좌표는 거기에 응해 변환됩니다.

정의:

인터페이스 Shape 내의 getPathIterator

파라미터:

at - 반복 처리로 돌려주어질 때 좌표에 적용된다 옵션의 AffineTransform, 변환되어 있지 않은 좌표가 필요한 경우는 null

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

반환값:

Shape 객체의 평탄화 된 기하학적 도형에의 액세스를 제공하는 PathIterator 객체

도입된 버젼:

1.2

clone

public Object  clone()

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

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

예외:

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

도입된 버젼:

1.2

관련 항목:

Cloneable