java.awt.geom
클래스 CubicCurve2D

java.lang.Object 
  |
  +--java.awt.geom.CubicCurve2D

모든 구현 인터페이스:

Cloneable , Shape

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

CubicCurve2D.Double , CubicCurve2D.Float

public abstract class CubicCurve2D

extends Object

implements Shape , Cloneable

CubicCurve2D 클래스는 (x, y) 좌표 공간의 3 차 파라메트릭 곡선 세그먼트(segment)를 정의합니다.

이 클래스는 2D 의 3 차 곡선 세그먼트(segment)를 저장하는 모든 오브젝트의 추상 슈퍼 클래스이며, 좌표의 실제의 기억역표현은 서브 클래스에 맡길 수 있습니다.

중첩된 클래스의 개요

static class	CubicCurve2D.Double double 좌표로 지정된 3 차 파라메트릭 곡선 세그먼트(segment)입니다.
static class	CubicCurve2D.Float float 좌표로 지정된 3 차 파라메트릭 곡선 세그먼트(segment)입니다.

생성자의 개요

protected

CubicCurve2D () 이것은 인스턴스를 직접은 생성할 수 없는 추상 클래스입니다.

메소드의 개요

Object	clone () 이 오브젝트와 같은 클래스의 새로운 오브젝트를 작성합니다.
boolean	contains (double x, double y) 지정된 좌표가 형상의 경계내에 있을지 어떨지를 판정합니다.
boolean	contains (double x, double y, double w, double h) 형상의 내부가, 지정된 구형 좌표 세트를 완전하게 포함 하고 있을지 어떨지를 판정합니다.
boolean	contains (Point2D p) 지정된 Point2D 가 형상의 경계내에 있을지 어떨지를 판정합니다.
boolean	contains (Rectangle2D r) 형상의 내부가, 지정된 Rectangle2D 를 완전하게 포함 하고 있을지 어떨지를 판정합니다.
Rectangle	getBounds () 형상의 바운딘그복스를 돌려줍니다.
abstract Point2D	getCtrlP1 () 최초의 제어점을 돌려줍니다.
abstract Point2D	getCtrlP2 () 2 번째의 제어점을 돌려줍니다.
abstract double	getCtrlX1 () 최초의 제어점의 X 좌표를 배정밀도로 돌려줍니다.
abstract double	getCtrlX2 () 2 번째의 제어점의 X 좌표를 배정밀도로 돌려줍니다.
abstract double	getCtrlY1 () 최초의 제어점의 Y 좌표를 배정밀도로 돌려줍니다.
abstract double	getCtrlY2 () 2 번째의 제어점의 Y 좌표를 배정밀도로 돌려줍니다.
double	getFlatness () 이 곡선의 후랏트네스를 돌려줍니다.
static double	getFlatness (double[] coords, int offset) 지정된 배열의, 지정된 인덱스에 저장된 제어점으로써 나타나는 3 차 곡선의 후랏트네스를 돌려줍니다.
static double	getFlatness (double x1, double y1, double ctrlx1, double ctrly1, double ctrlx2, double ctrly2, double x2, double y2) 지정된 제어점으로써 지정되는 3 차 곡선의 후랏트네스를 돌려줍니다.
double	getFlatnessSq () 이 곡선의 후랏트네스의 2 승을 돌려줍니다.
static double	getFlatnessSq (double[] coords, int offset) 지정된 배열의, 지정된 인덱스에 저장된 제어점으로써 나타나는 3 차 곡선의 후랏트네스의 2 승을 돌려줍니다.
static double	getFlatnessSq (double x1, double y1, double ctrlx1, double ctrly1, double ctrlx2, double ctrly2, double x2, double y2) 지정된 제어점으로써 나타나는 3 차 방정식의 후랏트네스의 2 승을 돌려줍니다.
abstract Point2D	getP1 () 시점을 돌려줍니다.
abstract Point2D	getP2 () 종점을 돌려줍니다.
PathIterator	getPathIterator (AffineTransform at) 형상의 경계를 정의하는 반복 오브젝트를 돌려줍니다.
PathIterator	getPathIterator (AffineTransform at, double flatness) 평탄화 된 형상의 경계를 정의하는 반복 오브젝트를 돌려줍니다.
abstract double	getX1 () 시점의 X 좌표를 배정밀도로 돌려줍니다.
abstract double	getX2 () 종점의 X 좌표를 배정밀도로 돌려줍니다.
abstract double	getY1 () 시점의 Y 좌표를 배정밀도로 돌려줍니다.
abstract double	getY2 () 종점의 Y 좌표를 배정밀도로 돌려줍니다.
boolean	intersects (double x, double y, double w, double h) 형상이, 지정된 구형 좌표 세트의 내부와 교차할지 어떨지를 판정합니다.
boolean	intersects (Rectangle2D r) 형상이, 지정된 Rectangle2D 의 내부와 교차할지 어떨지를 판정합니다.
void	setCurve (CubicCurve2D c) 이 곡선의 단 점과 제어점의 위치를, 지정된 CubicCurve2D 내의 대응하는 위치와 같게 설정합니다.
void	setCurve (double[] coords, int offset) 이 곡선의 단 점과 제어점의 위치를, 지정된 오프셋(offset)에 있는 double 좌표로 지정된 배열로서 설정합니다.
abstract void	setCurve (double x1, double y1, double ctrlx1, double ctrly1, double ctrlx2, double ctrly2, double x2, double y2) 이 곡선의 단 점과 제어점의 위치를, 지정된 double 좌표로 설정합니다.
void	setCurve (Point2D [] pts, int offset) 지정된 배열의 지정된 오프셋(offset)에 있는 Point2D 오브젝트의 좌표에, 이 곡선의 단 점과 제어점의 위치를 설정합니다.
void	setCurve (Point2D p1, Point2D cp1, Point2D cp2, Point2D p2) 이 곡선의 단 점과 제어점의 위치를, 지정된 Point2D 좌표로 설정합니다.
static int	solveCubic (double[] eqn) 계수가 eqn 배열에 있는 3 차 방정식의 해를 얻어, 비복소수해를 같은 배열에 되돌려, 결과적으로 해의 개수를 돌려줍니다.
static int	solveCubic (double[] eqn, double[] res) 계수가 eqn 배열에 있는 3 차 방정식의 해를 얻어, 비복소수해를 res 배열에 되돌려, 결과적으로 해의 개수를 돌려줍니다.
void	subdivide (CubicCurve2D left, CubicCurve2D right) 이 3 차 곡선을 분할해, 분할한 2 개의 곡선을 left 및 right 의 3 차 곡선 파라미터에 저장합니다.
static void	subdivide (CubicCurve2D src, CubicCurve2D left, CubicCurve2D right) src 파라미터로 지정된 3 차 곡선을 분할해, 분할한 2 개의 곡선을 left 및 right 의 곡선 파라미터에 저장합니다.
static void	subdivide (double[] src, int srcoff, double[] left, int leftoff, double[] right, int rightoff) src 배열의 인덱스 srcoff 로부터 (srcoff + 7)까지 저장되고 있는 좌표로 지정되는 3 차 곡선을 분할해, 분할한 2 개의 곡선을 2 개의 배열의 대응하는 인덱스에 저장합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

인터페이스 java.awt. Shape 에서 상속받은 메소드

getBounds2D

생성자의 상세

CubicCurve2D

protected CubicCurve2D()

이것은 인스턴스를 직접은 생성할 수 없는 추상 클래스입니다. 인스턴스 생성을 위해서(때문에)는 형태 고유의 구현 서브 클래스가 준비되어 있어 이러한 서브 클래스에 의해, 아래와 같은 각종 액세스용 메소드에 필요한 정보를 저장하기 위한 형식이 다수 제공됩니다.

관련 항목:

CubicCurve2D.Float , CubicCurve2D.Double

메소드의 상세

getX1

public abstract double getX1()

시점의 X 좌표를 배정밀도로 돌려줍니다.

반환값:

CubicCurve2D 의 시점의 X 좌표

getY1

public abstract double getY1()

시점의 Y 좌표를 배정밀도로 돌려줍니다.

반환값:

CubicCurve2D 의 시점의 Y 좌표

getP1

public abstract Point2D  getP1()

시점을 돌려줍니다.

반환값:

CubicCurve2D 의 시점을 나타내는 Point2D

getCtrlX1

public abstract double getCtrlX1()

최초의 제어점의 X 좌표를 배정밀도로 돌려줍니다.

반환값:

CubicCurve2D 의 최초의 제어점의 X 좌표

getCtrlY1

public abstract double getCtrlY1()

최초의 제어점의 Y 좌표를 배정밀도로 돌려줍니다.

반환값:

CubicCurve2D 의 최초의 제어점의 Y 좌표

getCtrlP1

public abstract Point2D  getCtrlP1()

최초의 제어점을 돌려줍니다.

반환값:

CubicCurve2D 의 최초의 제어점을 나타내는 Point2D

getCtrlX2

public abstract double getCtrlX2()

2 번째의 제어점의 X 좌표를 배정밀도로 돌려줍니다.

반환값:

CubicCurve2D 의 2 번째의 제어점의 X 좌표

getCtrlY2

public abstract double getCtrlY2()

2 번째의 제어점의 Y 좌표를 배정밀도로 돌려줍니다.

반환값:

CubicCurve2D 의 2 번째의 제어점의 Y 좌표

getCtrlP2

public abstract Point2D  getCtrlP2()

2 번째의 제어점을 돌려줍니다.

반환값:

CubicCurve2D 의 2 번째의 제어점을 나타내는 Point2D

getX2

public abstract double getX2()

종점의 X 좌표를 배정밀도로 돌려줍니다.

반환값:

CubicCurve2D 의 종점의 X 좌표

getY2

public abstract double getY2()

종점의 Y 좌표를 배정밀도로 돌려줍니다.

반환값:

CubicCurve2D 의 종점의 Y 좌표

getP2

public abstract Point2D  getP2()

종점을 돌려줍니다.

반환값:

CubicCurve2D 의 종점을 나타내는 Point2D

setCurve

public abstract void setCurve(double x1,
                              double y1,
                              double ctrlx1,
                              double ctrly1,
                              double ctrlx2,
                              double ctrly2,
                              double x2,
                              double y2)

이 곡선의 단 점과 제어점의 위치를, 지정된 double 좌표로 설정합니다.

setCurve

public void setCurve(double[] coords,
                     int offset)

이 곡선의 단 점과 제어점의 위치를, 지정된 오프셋(offset)에 있는 double 좌표로 지정된 배열로서 설정합니다.

파라미터:

coords - 좌표를 저장하는 double 배열

offset - coords 의 인덱스. 이 인덱스 위치 이후의 coords 에 저장된 좌표에, 이 곡선의 단 점과 제어점을 설정한다

setCurve

public void setCurve(Point2D  p1,
                     Point2D  cp1,
                     Point2D  cp2,
                     Point2D  p2)

이 곡선의 단 점과 제어점의 위치를, 지정된 Point2D 좌표로 설정합니다.

파라미터:

p1 - 이 곡선의 시점을 설정하는데 사용된다, 최초로 지정된 Point2D

cp1 - 이 곡선의 최초의 제어점을 설정하는데 사용되는 2 번째로 지정된 Point2D

cp2 - 이 곡선의 2 번째의 제어점을 설정하는데 사용되는 3 번째로 지정된 Point2D

p2 - 이 곡선의 종점을 설정하는데 사용되는 4 번째로 지정된 Point2D

setCurve

public void setCurve(Point2D [] pts,
                     int offset)

지정된 배열의 지정된 오프셋(offset)에 있는 Point2D 오브젝트의 좌표에, 이 곡선의 단 점과 제어점의 위치를 설정합니다.

파라미터:

pts - Point2D 오브젝트의 배열

offset - pts 의 인덱스. 이 인덱스 위치 이후의 pts 에 저장된 점에, 이 곡선의 단 점과 제어점을 설정한다

setCurve

public void setCurve(CubicCurve2D  c)

이 곡선의 단 점과 제어점의 위치를, 지정된 CubicCurve2D 내의 대응하는 위치와 같게 설정합니다.

파라미터:

c - 지정된 CubicCurve2D

getFlatnessSq

public static double getFlatnessSq(double x1,
                                   double y1,
                                   double ctrlx1,
                                   double ctrly1,
                                   double ctrlx2,
                                   double ctrly2,
                                   double x2,
                                   double y2)

지정된 제어점으로써 나타나는 3 차 방정식의 후랏트네스의 2 승을 돌려줍니다. 후랏트네스란, 단 점간을 묶는 선으로부터 제어점에의 최대 거리입니다.

반환값:

지정된 좌표로 나타내지는 CubicCurve2D 의 후랏트네스의 2 승

getFlatness

public static double getFlatness(double x1,
                                 double y1,
                                 double ctrlx1,
                                 double ctrly1,
                                 double ctrlx2,
                                 double ctrly2,
                                 double x2,
                                 double y2)

지정된 제어점으로써 지정되는 3 차 곡선의 후랏트네스를 돌려줍니다. 후랏트네스란, 단 점간을 묶는 선으로부터 제어점에의 최대 거리입니다.

반환값:

지정된 좌표로 나타내지는 CubicCurve2D 의 후랏트네스

getFlatnessSq

public static double getFlatnessSq(double[] coords,
                                   int offset)

지정된 배열의, 지정된 인덱스에 저장된 제어점으로써 나타나는 3 차 곡선의 후랏트네스의 2 승을 돌려줍니다. 후랏트네스란, 단 점간을 묶는 선으로부터 제어점에의 최대 거리입니다.

파라미터:

coords - 좌표가 저장되고 있는 배열

offset - coords 의 인덱스. 이 인덱스 위치 이후의 coords 에 저장된 좌표에, 이 곡선의 단 점과 제어점을 설정한다

반환값:

coords 의 지정된 오프셋(offset)에 있는 좌표로 나타나는 CubicCurve2D 의 후랏트네스의 2 승

getFlatness

public static double getFlatness(double[] coords,
                                 int offset)

지정된 배열의, 지정된 인덱스에 저장된 제어점으로써 나타나는 3 차 곡선의 후랏트네스를 돌려줍니다. 후랏트네스란, 단 점간을 묶는 선으로부터 제어점에의 최대 거리입니다.

파라미터:

coords - 좌표가 저장되고 있는 배열

offset - coords 의 인덱스. 이 인덱스 위치 이후의 coords 에 저장된 좌표에, 이 곡선의 단 점과 제어점을 설정한다

반환값:

coords 의 지정된 오프셋(offset)에 있는 좌표로 나타나는 CubicCurve2D 의 후랏트네스

getFlatnessSq

public double getFlatnessSq()

이 곡선의 후랏트네스의 2 승을 돌려줍니다. 후랏트네스란, 단 점간을 묶는 선으로부터 제어점에의 최대 거리입니다.

반환값:

이 곡선의 후랏트네스의 2 승

getFlatness

public double getFlatness()

이 곡선의 후랏트네스를 돌려줍니다. 후랏트네스란, 단 점간을 묶는 선으로부터 제어점에의 최대 거리입니다.

반환값:

이 곡선의 후랏트네스

subdivide

public void subdivide(CubicCurve2D  left,
                      CubicCurve2D  right)

이 3 차 곡선을 분할해, 분할한 2 개의 곡선을 left 및 right 의 3 차 곡선 파라미터에 저장합니다. left 오브젝트와 right 오브젝트의 어느 쪽인지 또는 양쪽 모두, 이 오브젝트와 같은가 null 가 됩니다.

파라미터:

left - 분할된 곡선의 좌측 (최초의 반)을 저장하기 위한 3 차 곡선 오브젝트

right - 분할된 곡선의 우측 (나머지 반)을 저장하기 위한 3 차 곡선 오브젝트

subdivide

public static void subdivide(CubicCurve2D  src,
                             CubicCurve2D  left,
                             CubicCurve2D  right)

src 파라미터로 지정된 3 차 곡선을 분할해, 분할한 2 개의 곡선을 left 및 right 의 곡선 파라미터에 저장합니다. left 오브젝트와 right 오브젝트의 어느 쪽인지 또는 양쪽 모두,src 오브젝트와 같은가 null 가 됩니다.

파라미터:

src - 분할되는 3 차 곡선

left - 분할된 곡선의 좌측 (최초의 반)을 저장하기 위한 3 차 곡선 오브젝트

right - 분할된 곡선의 우측 (나머지 반)을 저장하기 위한 3 차 곡선 오브젝트

subdivide

public static void subdivide(double[] src,
                             int srcoff,
                             double[] left,
                             int leftoff,
                             double[] right,
                             int rightoff)

src 배열의 인덱스 srcoff 로부터 (srcoff + 7)까지 저장되고 있는 좌표로 지정되는 3 차 곡선을 분할해, 분할한 2 개의 곡선을 2 개의 배열의 대응하는 인덱스에 저장합니다. left 배열과 right 배열의 어느 쪽인지 또는 양쪽 모두,null 인가,src 배열과 같은 배열에의 참조가 됩니다. 다만, 분할된 최초의 곡선의 종점은 2 번째의 곡선의 시점과 같습니다. 그 때문에 이 공통의 점에 여분의 기억역을 할당하는 것을 피하기 위해서(때문에),left 용과 right 용으로서 같은 배열을 건네주어,rightoff 가 (leftoff + 6)와 동일한 오프셋(offset)를 사용할 수 있습니다.

파라미터:

src - 전송원곡선의 좌표를 보관 유지하는 배열

srcoff - 6 개의 전송원좌표의 선두의 배열에의 오프셋(offset)

left - 분할된 곡선의 최초의 반의 좌표를 저장하기 위한 배열

leftoff - 6 개의 왼쪽 좌표의 선두의 배열에의 오프셋(offset)

right - 분할된 곡선의 나머지 반의 좌표를 저장하기 위한 배열

rightoff - 6 개의 오른쪽 좌표의 선두의 배열에의 오프셋(offset)

solveCubic

public static int solveCubic(double[] eqn)

계수가 eqn 배열에 있는 3 차 방정식의 해를 얻어, 비복소수해를 같은 배열에 되돌려, 결과적으로 해의 개수를 돌려줍니다. 해를 얻은 3 차 방정식은 다음의 등식에서 나타내집니다.

     eqn = {c, b, a, d}
     dx^3 + ax^2 + bx + c = 0
 

반환값의 것 -1 을 사용하면(자), 항상 0 이든가 또는 0 이 아닌 정수 방정식과 제로를 가지지 않는 방정식을 구별할 수 있습니다.

파라미터:

eqn - 3 차 방정식의 계수를 저장하고 있는 배열

반환값:

해의 개수. 다만, 방정식이 정수의 경우는 -1

solveCubic

public static int solveCubic(double[] eqn,
                             double[] res)

계수가 eqn 배열에 있는 3 차 방정식의 해를 얻어, 비복소수해를 res 배열에 되돌려, 결과적으로 해의 개수를 돌려줍니다. 해를 얻은 3 차 방정식은 eqn = {c, b, a, d} dx^3 + ax^2 + bx + c = 0 이라고 하는 등식에서 나타내집니다. 반환값의 것 -1 을 사용하면(자), 항상 0 이든가 또는 0 이 아닌 정수 방정식과 제로를 가지지 않는 방정식을 구별할 수 있습니다.

파라미터:

eqn - 3 차 방정식의 해를 얻는데 사용하는 계수의, 지정된 배열

res - 3 차 방정식의 해로부터 얻을 수 있는 비복소수해를 저장하는 배열

반환값:

해의 개수. 다만, 방정식이 정수의 경우는 -1

contains

public boolean contains(double x,
                        double y)

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

정의:

인터페이스 Shape 내의 contains

반환값:

좌표가 형상의 경계내에 있는 경우는 true, 그렇지 않은 경우는 false

contains

public boolean contains(Point2D  p)

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

정의:

인터페이스 Shape 내의 contains

파라미터:

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

반환값:

p 가 형상의 경계내에 있는 경우는 true, 그렇지 않은 경우는 false

intersects

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

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

정의:

인터페이스 Shape 내의 intersects

파라미터:

w - 지정된 구형 area의 폭

h - 지정된 구형 area의 높이

반환값:

형상이, 지정된 구형 area의 내부와 교차하는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Area

intersects

public boolean intersects(Rectangle2D  r)

형상이, 지정된 Rectangle2D 의 내부와 교차할지 어떨지를 판정합니다.

정의:

인터페이스 Shape 내의 intersects

파라미터:

r - 판정 대상의, 지정된 Rectangle2D

반환값:

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

관련 항목:

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

contains

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

형상의 내부가, 지정된 구형 좌표 세트를 완전하게 포함 하고 있을지 어떨지를 판정합니다.

정의:

인터페이스 Shape 내의 contains

파라미터:

w - 지정된 구형 형상의 폭

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

반환값:

형상이, 지정된 구형 좌표 세트를 완전하게 포함 하고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

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

contains

public boolean contains(Rectangle2D  r)

형상의 내부가, 지정된 Rectangle2D 를 완전하게 포함 하고 있을지 어떨지를 판정합니다.

정의:

인터페이스 Shape 내의 contains

파라미터:

r - 판정 대상의, 지정된 Rectangle2D

반환값:

형상이, 지정된 Rectangle2D 를 완전하게 포함 하고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

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

getBounds

public Rectangle  getBounds()

형상의 바운딘그복스를 돌려줍니다.

정의:

인터페이스 Shape 내의 getBounds

반환값:

형상의 바운딘그복스를 나타내는 Rectangle

관련 항목:

Shape.getBounds2D()

getPathIterator

public PathIterator  getPathIterator(AffineTransform  at)

형상의 경계를 정의하는 반복 오브젝트를 돌려줍니다. 이 클래스의 반복자는 multi-thread에 대해서 안전하지는 않습니다. 즉 이 CubicCurve2D 클래스에서는 이 CubicCurve2D 오브젝트의 지오메트리를 변경하면(자), 이 지오메트리에 대해 벌써 진행중의 반복 처리에 영향을 미치는 경우가 있습니다.

정의:

인터페이스 Shape 내의 getPathIterator

파라미터:

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

반환값:

이 CubicCurve2D 의 윤곽의 지오메트리를 한 번에 1 세그먼트(segment)씩 돌려주는 PathIterator 오브젝트

getPathIterator

public PathIterator  getPathIterator(AffineTransform  at,
                                    double flatness)

평탄화 된 형상의 경계를 정의하는 반복 오브젝트를 돌려줍니다. 이 클래스의 반복자는 multi-thread에 대해서 안전하지는 않습니다. 즉 이 CubicCurve2D 클래스에서는 이 CubicCurve2D 오브젝트의 지오메트리를 변경하면(자), 이 지오메트리에 대해 벌써 진행중의 반복 처리에 영향을 미치는 경우가 있습니다.

정의:

인터페이스 Shape 내의 getPathIterator

파라미터:

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

flatness - 지정된 곡선상의 제어점을 움직였을 때, 분할된 곡선이 단 점을 묶는 직선에 의해 치환되지 않는 조건으로, 제어점이 이 직선으로부터도 와도 떨어지는 거리

반환값:

이 CubicCurve2D 의 윤곽의 지오메트리를 한 번에 1 세그먼트(segment)씩 돌려주는 PathIterator 오브젝트

clone

public Object  clone()

이 오브젝트와 같은 클래스의 새로운 오브젝트를 작성합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

예외:

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

도입된 버젼:

1.2

관련 항목:

Cloneable