JavaTM 2 Platform
Std. Ed. v1.3

java.awt.geom
クラス QuadCurve2D

java.lang.Object
  |
  +--java.awt.geom.QuadCurve2D
すべての実装インタフェース:
Cloneable, Shape
直系の既知のサブクラス:
QuadCurve2D.Double, QuadCurve2D.Float

public abstract class QuadCurve2D
extends Object
implements Shape, Cloneable

QuadCurve2D クラスは、(x, y) 座標空間の 2 次パラメトリック曲線セグメントを定義します。

このクラスは、2D の 2 次曲線セグメントを格納するすべてのオブジェクトの抽象スーパークラスであり、座標の実際の記憶域表現は、サブクラスに委ねられます。


内部クラスの概要
static class QuadCurve2D.Double
          double 座標で指定された 2 次パラメトリック曲線セグメントです。
static class QuadCurve2D.Float
          float 座標で指定された 2 次パラメトリック曲線セグメントです。
 
コンストラクタの概要
protected QuadCurve2D()
          これは、インスタンスを直接には生成できない抽象クラスです。
 
メソッドの概要
 Object clone()
          このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。
 boolean contains(double x, double y)
          指定された座標がこの QuadCurve2D の形状の境界内にあるかどうかを判定します。
 boolean contains(double x, double y, double w, double h)
          この QuadCurve2D の形状の内部が、指定された矩形座標セットを完全に内包するかどうかを判定します。
 boolean contains(Point2D p)
          指定された Point2D がこの QuadCurve2D の形状の境界内にあるかどうかを判定します。
 boolean contains(Rectangle2D r)
          この QuadCurve2D の形状の内部が、指定された Rectangle2D を完全に内包するかどうかを判定します。
 Rectangle getBounds()
          この QuadCurve2D のバウンディングボックスを返します。
abstract  Point2D getCtrlPt()
          制御点を返します。
abstract  double getCtrlX()
          制御点の x 座標を double 精度で返します。
abstract  double getCtrlY()
          制御点の y 座標を double 精度で返します。
 double getFlatness()
          この QuadCurve2D のフラットネス、つまり端点を結ぶ線から制御点までの最大距離を返します。
static double getFlatness(double[] coords, int offset)
          指定された配列の指定されたインデックスに格納された制御点で示される 2 次曲線のフラットネス、つまり端点を結ぶ線から制御点までの最大距離を返します。
static double getFlatness(double x1, double y1, double ctrlx, double ctrly, double x2, double y2)
          指定された制御点によって指定される 2 次曲線のフラットネス、つまり端点間を接続する線から制御点までの最大距離を返します。
 double getFlatnessSq()
          この QuadCurve2D のフラットネスの 2 乗、つまり端点を結ぶ線から制御点までの最大距離の 2 乗を返します。
static double getFlatnessSq(double[] coords, int offset)
          指定された配列の指定されたインデックスに格納された制御点によって指定される 2 次曲線のフラットネスの 2 乗、つまり端点間を接続する線から制御点までの最大距離の 2 乗を返します。
static double getFlatnessSq(double x1, double y1, double ctrlx, double ctrly, double x2, double y2)
          指定された制御点によって指定される 2 次曲線のフラットネスの 2 乗、つまり端点間を接続する線から制御点までの最大距離の 2 乗を返します。
abstract  Point2D getP1()
          始点を返します。
abstract  Point2D getP2()
          終点を返します。
 PathIterator getPathIterator(AffineTransform at)
          この QuadCurve2D の形状の境界を定義する繰り返しオブジェクトを返します。
 PathIterator getPathIterator(AffineTransform at, double flatness)
          この QuadCurve2D の平坦化された形状の境界を定義する繰り返しオブジェクトを返します。
abstract  double getX1()
          始点の x 座標を double 精度で返します。
abstract  double getX2()
          終点の x 座標を double 精度で返します。
abstract  double getY1()
          始点の y 座標を double 精度で返します。
abstract  double getY2()
          終点の y 座標を double 精度で返します。
 boolean intersects(double x, double y, double w, double h)
          この QuadCurve2D の形状が、指定された矩形座標セットの内部と交差するかどうかを判定します。
 boolean intersects(Rectangle2D r)
          この QuadCurve2D の形状が、指定された Rectangle2D の内部と交差するかどうかを判定します。
 void setCurve(double[] coords, int offset)
          この QuadCurve2D の端点と制御点の位置を、指定された配列の指定されたオフセットにある double 型の座標に設定します。
abstract  void setCurve(double x1, double y1, double ctrlx, double ctrly, double x2, double y2)
          この曲線の端点と制御点の位置を、指定された double 座標に設定します。
 void setCurve(Point2D[] pts, int offset)
          この QuadCurve2D の端点と制御点の位置を、指定された配列の指定されたオフセットにある Point2D オブジェクトの座標に設定します。
 void setCurve(Point2D p1, Point2D cp, Point2D p2)
          この QuadCurve2D の端点と制御点の位置を、指定された Point2D 座標に設定します。
 void setCurve(QuadCurve2D c)
          この QuadCurve2D の端点と制御点の位置を、指定された QuadCurve2D と同じに設定します。
static int solveQuadratic(double[] eqn)
          係数が eqn 配列にある 2 次方程式の解を得て、非複素数解を同じ配列に戻し、結果として解の個数を返します。
static int solveQuadratic(double[] eqn, double[] res)
          係数が eqn 配列にある 2 次方程式の解を得て、非複素数解を res 配列に置き、結果として解の個数を返します。
static void subdivide(double[] src, int srcoff, double[] left, int leftoff, double[] right, int rightoff)
          src 配列のインデックス srcoff から srcoff + 5 に格納されている座標で指定される 2 次曲線を分割して、分割した 2 つの曲線を 2 つの配列の対応するインデックスに格納します。
 void subdivide(QuadCurve2D left, QuadCurve2D right)
          この QuadCurve2D を分割して、分割した 2 つの曲線を left および right 曲線パラメータに格納します。
static void subdivide(QuadCurve2D src, QuadCurve2D left, QuadCurve2D right)
          src パラメータで指定された 2 次曲線を分割し、分割された 2 つの曲線を left および right 曲線パラメータに保存します。
 
クラス java.lang.Object から継承したメソッド
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
インタフェース java.awt.Shape から継承したメソッド
getBounds2D
 

コンストラクタの詳細

QuadCurve2D

protected QuadCurve2D()
これは、インスタンスを直接には生成できない抽象クラスです。インスタンス生成のためには型固有の実装サブクラスが用意されており、これらのサブクラスにより、下記の各種アクセス用メソッドに必要な情報を格納するための形式が多数提供されます。
関連項目:
QuadCurve2D.Float, QuadCurve2D.Double
メソッドの詳細

getX1

public abstract double getX1()
始点の x 座標を double 精度で返します。
戻り値:
始点の x 座標

getY1

public abstract double getY1()
始点の y 座標を double 精度で返します。
戻り値:
始点の y 座標

getP1

public abstract Point2D getP1()
始点を返します。
戻り値:
この QuadCurve2D の始点を表す Point2D

getCtrlX

public abstract double getCtrlX()
制御点の x 座標を double 精度で返します。
戻り値:
制御点の x 座標

getCtrlY

public abstract double getCtrlY()
制御点の y 座標を double 精度で返します。
戻り値:
制御点の y 座標

getCtrlPt

public abstract Point2D getCtrlPt()
制御点を返します。
戻り値:
この Point2D の制御点を表す Point2D

getX2

public abstract double getX2()
終点の x 座標を double 精度で返します。
戻り値:
終点の x 座標

getY2

public abstract double getY2()
終点の y 座標を double 精度で返します。
戻り値:
終点の y 座標

getP2

public abstract Point2D getP2()
終点を返します。
戻り値:
この Point2D の終点を表す Point オブジェクト

setCurve

public abstract void setCurve(double x1,
                              double y1,
                              double ctrlx,
                              double ctrly,
                              double x2,
                              double y2)
この曲線の端点と制御点の位置を、指定された double 座標に設定します。
パラメータ:
x1, y1 - 始点の座標
ctrlx, ctrly - 制御点の座標
x2, y1 - 終点の座標

setCurve

public void setCurve(double[] coords,
                     int offset)
この QuadCurve2D の端点と制御点の位置を、指定された配列の指定されたオフセットにある double 型の座標に設定します。
パラメータ:
coords - 座標値を格納している配列
offset - この QuadCurve2D に割り当てる座標値を取得する開始位置を示す配列内のインデックス

setCurve

public void setCurve(Point2D p1,
                     Point2D cp,
                     Point2D p2)
この QuadCurve2D の端点と制御点の位置を、指定された Point2D 座標に設定します。
パラメータ:
p1 - 始点
cp - 制御点
p2 - 終点

setCurve

public void setCurve(Point2D[] pts,
                     int offset)
この QuadCurve2D の端点と制御点の位置を、指定された配列の指定されたオフセットにある Point2D オブジェクトの座標に設定します。
パラメータ:
pts - 座標値を定義する Point2D を格納している配列
offset - この QuadCurve2D に割り当てる座標値を取得する開始位置を示す pts 内のインデックス

setCurve

public void setCurve(QuadCurve2D c)
この QuadCurve2D の端点と制御点の位置を、指定された QuadCurve2D と同じに設定します。
パラメータ:
c - 指定された QuadCurve2D

getFlatnessSq

public static double getFlatnessSq(double x1,
                                   double y1,
                                   double ctrlx,
                                   double ctrly,
                                   double x2,
                                   double y2)
指定された制御点によって指定される 2 次曲線のフラットネスの 2 乗、つまり端点間を接続する線から制御点までの最大距離の 2 乗を返します。
パラメータ:
x1, y1 - 始点の座標
ctrlx, ctrly - 制御点の座標
x2, y1 - 終点の座標
戻り値:
指定された座標で定義される 2 次曲線のフラットネスの 2 乗

getFlatness

public static double getFlatness(double x1,
                                 double y1,
                                 double ctrlx,
                                 double ctrly,
                                 double x2,
                                 double y2)
指定された制御点によって指定される 2 次曲線のフラットネス、つまり端点間を接続する線から制御点までの最大距離を返します。
パラメータ:
x1, y1 - 始点の座標
ctrlx, ctrly - 制御点の座標
x2, y1 - 終点の座標
戻り値:
指定された座標で定義される 2 次曲線のフラットネス

getFlatnessSq

public static double getFlatnessSq(double[] coords,
                                   int offset)
指定された配列の指定されたインデックスに格納された制御点によって指定される 2 次曲線のフラットネスの 2 乗、つまり端点間を接続する線から制御点までの最大距離の 2 乗を返します。
パラメータ:
coords - 座標値を格納する配列
offset - 2 次曲線に割り当てる値を取得する開始位置を示す coords 内のインデックス
戻り値:
指定された配列の指定されたインデックスにある値で定義される 2 次曲線のフラットネス

getFlatness

public static double getFlatness(double[] coords,
                                 int offset)
指定された配列の指定されたインデックスに格納された制御点で示される 2 次曲線のフラットネス、つまり端点を結ぶ線から制御点までの最大距離を返します。
パラメータ:
coords - 座標値を格納する配列
offset - 2 次曲線に割り当てる座標値を取得する開始位置を示す coords 内のインデックス
戻り値:
指定された配列の指定されたオフセットにある座標値で定義される 2 次曲線のフラットネス

getFlatnessSq

public double getFlatnessSq()
この QuadCurve2D のフラットネスの 2 乗、つまり端点を結ぶ線から制御点までの最大距離の 2 乗を返します。
戻り値:
この QuadCurve2D のフラットネスの 2 乗

getFlatness

public double getFlatness()
この QuadCurve2D のフラットネス、つまり端点を結ぶ線から制御点までの最大距離を返します。
戻り値:
この QuadCurve2D のフラットネス

subdivide

public void subdivide(QuadCurve2D left,
                      QuadCurve2D right)
この QuadCurve2D を分割して、分割した 2 つの曲線を left および right 曲線パラメータに格納します。left オブジェクトと right オブジェクトのどちらか、または両方とも、この QuadCurve2D と同じか null になります。
パラメータ:
left - 分割された曲線の左側 (最初の半分) を格納するための QuadCurve2D オブジェクト
right - 分割された曲線の右側 (残り半分) を格納するための QuadCurve2D オブジェクト

subdivide

public static void subdivide(QuadCurve2D src,
                             QuadCurve2D left,
                             QuadCurve2D right)
src パラメータで指定された 2 次曲線を分割し、分割された 2 つの曲線を left および right 曲線パラメータに保存します。left オブジェクトおよび right オブジェクトのどちらか、または両方とも src オブジェクトと同じになるか null になります。
パラメータ:
src - 分割される 2 次曲線
left - 分割された曲線の左側 (最初の半分) を格納するための QuadCurve2D オブジェクト
right - 分割された曲線の右側 (残り半分) を格納するための QuadCurve2D オブジェクト

subdivide

public static void subdivide(double[] src,
                             int srcoff,
                             double[] left,
                             int leftoff,
                             double[] right,
                             int rightoff)
src 配列のインデックス srcoff から srcoff + 5 に格納されている座標で指定される 2 次曲線を分割して、分割した 2 つの曲線を 2 つの配列の対応するインデックスに格納します。left 配列および right 配列のどちらか、または両方とも null になるか、または src 配列と同じ配列およびオフセットへの参照になります。分割された最初の曲線の終点は分割された 2 番目の曲線の始点と同じです。そのため、この共通の点に余分な記憶域を割り当てるのを避けるために、left 用と right 用として同じ配列を渡して、rightoffleftoff + 4 と等しいオフセットを使用できます。
パラメータ:
src - 転送元曲線の座標を保持する配列
srcoff - 6 つの転送元座標の先頭の配列へのオフセット
left - 分割された曲線の最初の半分の座標を格納するための配列
leftoff - 6 つの左座標の先頭の配列へのオフセット
right - 分割された曲線の残り半分の座標を格納するための配列
rightoff - 6 つの右座標の先頭の配列へのオフセット

solveQuadratic

public static int solveQuadratic(double[] eqn)
係数が eqn 配列にある 2 次方程式の解を得て、非複素数解を同じ配列に戻し、結果として解の個数を返します。解を得た 2 次方程式は次の等式で表されます。
     eqn = {C, B, A};
     ax^2 + bx + c = 0
 
戻り値の -1 を使用すると、常に 0 か 0 でない定数方程式と、ゼロを持たない方程式とを区別できます。
パラメータ:
equ - 2 次方程式の係数を格納している配列
戻り値:
解の個数。ただし、方程式が定数の場合は -1

solveQuadratic

public static int solveQuadratic(double[] eqn,
                                 double[] res)
係数が eqn 配列にある 2 次方程式の解を得て、非複素数解を res 配列に置き、結果として解の個数を返します。解を得た 2 次方程式は次の等式で表されます。
     eqn = {C, B, A};
     ax^2 + bx + c = 0
 
戻り値の -1 を使用すると、常に 0 か 0 でない定数方程式と、ゼロを持たない方程式とを区別できます。
戻り値:
解の個数。ただし、方程式が定数の場合は -1

contains

public boolean contains(double x,
                        double y)
指定された座標がこの QuadCurve2D の形状の境界内にあるかどうかを判定します。
定義:
インタフェース Shape 内の contains
パラメータ:
x, y - 指定された座標
戻り値:
指定された座標がこの QuadCurve2D の形状の境界内にある場合は true、そうでない場合は false

contains

public boolean contains(Point2D p)
指定された Point2D がこの QuadCurve2D の形状の境界内にあるかどうかを判定します。
定義:
インタフェース Shape 内の contains
パラメータ:
p - 指定された Point2D
戻り値:
指定された Point2D がこの QuadCurve2D の形状の境界内にある場合は true

intersects

public boolean intersects(double x,
                          double y,
                          double w,
                          double h)
この QuadCurve2D の形状が、指定された矩形座標セットの内部と交差するかどうかを判定します。
定義:
インタフェース Shape 内の intersects
パラメータ:
x, y - 指定された矩形領域の左上隅の座標
w - 指定された矩形領域の幅
h - 指定された矩形領域の高さ
戻り値:
この QuadCurve2D の形状が指定された矩形座標セットの内部と交差する場合は true、そうでない場合は false

intersects

public boolean intersects(Rectangle2D r)
この QuadCurve2D の形状が、指定された Rectangle2D の内部と交差するかどうかを判定します。
定義:
インタフェース Shape 内の intersects
パラメータ:
r - 指定された Rectangle2D
戻り値:
この QuadCurve2D の形状が指定された Rectangle2D の内部と交差する場合は true、そうでない場合は false

contains

public boolean contains(double x,
                        double y,
                        double w,
                        double h)
この QuadCurve2D の形状の内部が、指定された矩形座標セットを完全に内包するかどうかを判定します。
定義:
インタフェース Shape 内の contains
パラメータ:
x, y - 指定された矩形領域の左上隅の座標
w - 指定された矩形領域の幅
h - 指定された矩形領域の高さ
戻り値:
この QuadCurve2D の形状の内部が指定された矩形領域を完全に内包する場合は true、そうでない場合は false

contains

public boolean contains(Rectangle2D r)
この QuadCurve2D の形状の内部が、指定された Rectangle2D を完全に内包するかどうかを判定します。
定義:
インタフェース Shape 内の contains
パラメータ:
r - 指定された Rectangle2D
戻り値:
この QuadCurve2D の形状の内部が指定された Rectangle2D を完全に内包する場合は true、そうでない場合は false

getBounds

public Rectangle getBounds()
この QuadCurve2D のバウンディングボックスを返します。
定義:
インタフェース Shape 内の getBounds
戻り値:
この QuadCurve2D の形状のバウンディングボックスを表す Rectangle

getPathIterator

public PathIterator getPathIterator(AffineTransform at)
この QuadCurve2D の形状の境界を定義する繰り返しオブジェクトを返します。このクラスの反復子は、マルチスレッドに対して安全ではありません。つまりこの QuadCurve2D クラスでは、この QuadCurve2D オブジェクトのジオメトリを変更すると、このジオメトリについてすでに進行中の繰り返し処理に影響を及ぼす場合があります。
定義:
インタフェース Shape 内の getPathIterator
パラメータ:
at - 形状の境界に適用される任意の AffineTransform
戻り値:
形状の境界を定義する PathIterator オブジェクト

getPathIterator

public PathIterator getPathIterator(AffineTransform at,
                                    double flatness)
この QuadCurve2D の平坦化された形状の境界を定義する繰り返しオブジェクトを返します。このクラスの反復子は、マルチスレッドに対して安全ではありません。つまりこの QuadCurve2D クラスでは、この QuadCurve2D オブジェクトのジオメトリを変更すると、このジオメトリについてすでに進行中の繰り返し処理に影響を及ぼす場合があります。
定義:
インタフェース Shape 内の getPathIterator
パラメータ:
at - 形状の境界に適用される任意の AffineTransform
flatness - この曲線が端点を結ぶ直線により置換されない条件で、分割された曲線の制御点がこの曲線の端点間を結ぶ線から離れることができる最大距離
戻り値:
形状の平坦化された境界を定義する PathIterator オブジェクト

clone

public Object clone()
このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。
オーバーライド:
クラス Object 内の clone
戻り値:
このインスタンスの複製
例外:
OutOfMemoryError - 十分なメモリがない場合
導入されたバージョン:
1.2
関連項目:
Cloneable

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.