public abstract class CubicCurve2D extends Object implements Shape, Cloneable
CubicCurve2D
クラスは、(x,y)
座標空間の 3 次パラメトリック曲線セグメントを定義します。
このクラスは、2D の 3 次曲線セグメントを格納するすべてのオブジェクトの抽象スーパークラスにすぎません。座標の実際の記憶域表現はサブクラスに委ねられます。
修飾子と型 | クラスと説明 |
---|---|
static class |
CubicCurve2D.Double
double 座標で指定された 3 次パラメトリック曲線セグメント。 |
static class |
CubicCurve2D.Float
float 座標で指定された 3 次パラメトリック曲線セグメント。 |
修飾子 | コンストラクタと説明 |
---|---|
protected |
CubicCurve2D()
これは、インスタンスを直接には生成できない abstract クラスです。
|
修飾子と型 | メソッドと説明 |
---|---|
Object |
clone()
このオブジェクトと同じクラスの新しいオブジェクトを作成します。
|
boolean |
contains(double x, double y)
指定された座標が、内側の定義によって記述された
Shape の境界の内側にあるかどうかをテストします。 |
boolean |
contains(double x, double y, double w, double h)
Shape の内部に、指定された矩形領域が完全に含まれるかどうかをテストします。 |
boolean |
contains(Point2D p)
|
boolean |
contains(Rectangle2D r)
Shape の内部に、指定された Rectangle2D が完全に含まれるかどうかをテストします。 |
Rectangle |
getBounds()
Shape を完全に囲む整数の Rectangle を返します。 |
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)
Shape の内部が指定された矩形領域の内部と交差しているかどうかをテストします。 |
boolean |
intersects(Rectangle2D r)
Shape の内部が指定された Rectangle2D の内部と交差しているかどうかをテストします。 |
void |
setCurve(CubicCurve2D c)
この曲線の終点と制御点の位置を、指定された
CubicCurve2D のそれらと同じに設定します。 |
void |
setCurve(double[] coords, int 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)
指定された配列の指定されたオフセットにある
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 つの配列の対応するインデックスに格納します。 |
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getBounds2D
protected CubicCurve2D()
CubicCurve2D.Float
、CubicCurve2D.Double
public abstract double getX1()
CubicCurve2D
の始点の X 座標。public abstract double getY1()
CubicCurve2D
の始点の Y 座標。public abstract Point2D getP1()
CubicCurve2D
の始点である Point2D
。public abstract double getCtrlX1()
CubicCurve2D
の最初の制御点の X 座標。public abstract double getCtrlY1()
CubicCurve2D
の最初の制御点の Y 座標。public abstract Point2D getCtrlP1()
CubicCurve2D
の最初の制御点である Point2D
。public abstract double getCtrlX2()
CubicCurve2D
の 2 番目の制御点の X 座標。public abstract double getCtrlY2()
CubicCurve2D
の 2 番目の制御点の Y 座標。public abstract Point2D getCtrlP2()
CubicCurve2D
の 2 番目の制御点である Point2D
。public abstract double getX2()
CubicCurve2D
の終点の X 座標。public abstract double getY2()
CubicCurve2D
の終点の Y 座標。public abstract Point2D getP2()
CubicCurve2D
の終点である Point2D
。public abstract void setCurve(double x1, double y1, double ctrlx1, double ctrly1, double ctrlx2, double ctrly2, double x2, double y2)
x1
- 次に対する始点を設定するために使用される X 座標: CubicCurve2D
y1
- 次に対する始点を設定するために使用される Y 座標: CubicCurve2D
ctrlx1
- 次に対する最初の制御点を設定するために使用される X 座標: CubicCurve2D
ctrly1
- 次に対する最初の制御点を設定するために使用される Y 座標: CubicCurve2D
ctrlx2
- 次に対する 2 番目の制御点を設定するために使用される X 座標: CubicCurve2D
ctrly2
- 次に対する 2 番目の制御点を設定するために使用される Y 座標: CubicCurve2D
x2
- 次に対する終点を設定するために使用される X 座標: CubicCurve2D
y2
- 次に対する終点を設定するために使用される Y 座標: CubicCurve2D
public void setCurve(double[] coords, int offset)
coords
- 座標を含む double 配列offset
- この曲線の終点と制御点の、coords
に含まれている座標への設定を開始する位置を示す coords
のインデックスpublic void setCurve(Point2D p1, Point2D cp1, Point2D cp2, Point2D p2)
Point2D
座標に設定します。p1
- この曲線の始点を設定するために使用される、最初に指定された Point2D
cp1
- この曲線の最初の制御点を設定するために使用される、2 番目に指定された Point2D
cp2
- この曲線の 2 番目の制御点を設定するために使用される、3 番目に指定された Point2D
p2
- この曲線の終点を設定するために使用される、4 番目に指定された Point2D
public void setCurve(Point2D[] pts, int offset)
Point2D
オブジェクトの座標に、この曲線の終点と制御点の位置を設定します。pts
- Point2D
オブジェクトの配列offset
- この曲線の終点と制御点の、pts
に含まれている点への設定を開始する位置を示す pts
のインデックスpublic void setCurve(CubicCurve2D c)
CubicCurve2D
のそれらと同じに設定します。c
- 指定されたCubicCurve2D
public static double getFlatnessSq(double x1, double y1, double ctrlx1, double ctrly1, double ctrlx2, double ctrly2, double x2, double y2)
x1
- 次に対する始点を指定する X 座標: CubicCurve2D
y1
- 次に対する始点を指定する Y 座標: CubicCurve2D
ctrlx1
- 次に対する最初の制御点を指定する X 座標: CubicCurve2D
ctrly1
- 次に対する最初の制御点を指定する Y 座標: CubicCurve2D
ctrlx2
- 次に対する 2 番目の制御点を指定する X 座標: CubicCurve2D
ctrly2
- 次に対する 2 番目の制御点を指定する Y 座標: CubicCurve2D
x2
- 次に対する終点を指定する X 座標: CubicCurve2D
y2
- 次に対する終点を指定する Y 座標: CubicCurve2D
CubicCurve2D
のフラットネスの 2 乗。public static double getFlatness(double x1, double y1, double ctrlx1, double ctrly1, double ctrlx2, double ctrly2, double x2, double y2)
x1
- 次に対する始点を指定する X 座標: CubicCurve2D
y1
- 次に対する始点を指定する Y 座標: CubicCurve2D
ctrlx1
- 次に対する最初の制御点を指定する X 座標: CubicCurve2D
ctrly1
- 次に対する最初の制御点を指定する Y 座標: CubicCurve2D
ctrlx2
- 次に対する 2 番目の制御点を指定する X 座標: CubicCurve2D
ctrly2
- 次に対する 2 番目の制御点を指定する Y 座標: CubicCurve2D
x2
- 次に対する終点を指定する X 座標: CubicCurve2D
y2
- 次に対する終点を指定する Y 座標: CubicCurve2D
CubicCurve2D
のフラットネス。public static double getFlatnessSq(double[] coords, int offset)
coords
- 座標が格納されている配列offset
- coords
のインデックス。ここから、曲線の終点と制御点を取得するcoords
内の指定されたオフセット位置にある座標によって指定された CubicCurve2D
のフラットネスの 2 乗。public static double getFlatness(double[] coords, int offset)
coords
- 座標が格納されている配列offset
- coords
のインデックス。ここから、曲線の終点と制御点を取得するcoords
内の指定されたオフセット位置にある座標によって指定された CubicCurve2D
のフラットネス。public double getFlatnessSq()
public double getFlatness()
public void subdivide(CubicCurve2D left, CubicCurve2D right)
left
- 分割された曲線の左側または最初の半分を格納するための 3 次曲線オブジェクトright
- 分割された曲線の右側または残り半分を格納するための 3 次曲線オブジェクト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 次曲線オブジェクト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) に等しくなるようにオフセットを使用することができます。src
- 転送元曲線の座標を保持する配列srcoff
- 6 つの転送元座標の先頭の配列へのオフセットleft
- 分割された曲線の最初の半分の座標を格納するための配列leftoff
- 6 つの左座標の先頭の配列へのオフセットright
- 分割された曲線の残り半分の座標を格納するための配列rightoff
- 6 つの右座標の先頭の配列へのオフセット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 次方程式の係数を含む配列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 次方程式の解から得られる非複素数解を含む配列public boolean contains(double x, double y)
Shape
の境界の内側にあるかどうかをテストします。public boolean contains(Point2D p)
public boolean intersects(double x, double y, double w, double h)
Shape
の内部が指定された矩形領域の内部と交差しているかどうかをテストします。Shape
の内部と指定された矩形領域の両方に含まれている点が存在する場合、その矩形領域は Shape
と交差していると見なされます。
Shape.intersects()
メソッドを使用すると、次のような場合に、Shape
実装は内部的に true
を返すことができます。
Shape
が交差している可能性が高いが、
Shapes
によっては、矩形領域が Shape
と交差していない場合でもこのメソッドが true
を返すことがあります。Area
クラスは、ほとんどの Shape
オブジェクトより正確な、幾何学的な共通部分の計算を実行するため、より的確な答えが必要な場合に使用できます。intersects
、インタフェース: Shape
x
- 指定された矩形領域の左上隅の X 座標y
- 指定された矩形領域の左上隅の Y 座標w
- 指定された矩形領域の幅h
- 指定された矩形領域の高さShape
の内部と矩形領域の内部が交差しているか、またはどちらも交差している可能性が高いが、負荷が大きすぎて共通部分の計算を実行できない場合は true
、それ以外の場合は false
。Area
public boolean intersects(Rectangle2D r)
Shape
の内部が指定された Rectangle2D
の内部と交差しているかどうかをテストします。Shape.intersects()
メソッドを使用すると、次のような場合に、Shape
実装は内部的に true
を返すことができます。
Rectangle2D
と Shape
が交差している可能性が高いが、
Shapes
によっては、Rectangle2D
が Shape
と交差していない場合でもこのメソッドが true
を返すことがあります。Area
クラスは、ほとんどの Shape
オブジェクトより正確な、幾何学的な共通部分の計算を実行するため、より的確な答えが必要な場合に使用できます。intersects
、インタフェース: Shape
r
- 指定された Rectangle2D
Shape
の内部と指定された Rectangle2D
の内部が交差しているか、またはどちらも交差している可能性が高いが、負荷が大きすぎて共通部分の計算を実行できない場合は true
、それ以外の場合は false
。Shape.intersects(double, double, double, double)
public boolean contains(double x, double y, double w, double h)
Shape
の内部に、指定された矩形領域が完全に含まれるかどうかをテストします。矩形領域全体が Shape
内に含まれていると見なされるには、矩形領域の内側にあるすべての座標が Shape
内にある必要があります。
Shape.contains()
メソッドを使用すると、次のような場合に、Shape
実装は内部的に false
を返すことができます。
intersect
メソッドが true
を返し、かつ
Shape
に矩形領域が完全に含まれるかどうかを判定するための計算の負荷が非常に大きい。
Shapes
によっては、Shape
に矩形領域が含まれている場合でもこのメソッドが false
を返すことがあります。Area
クラスは、ほとんどの Shape
オブジェクトより正確な幾何学的計算を実行するため、より的確な答えが必要な場合に使用できます。contains
、インタフェース: Shape
x
- 指定された矩形領域の左上隅の X 座標y
- 指定された矩形領域の左上隅の Y 座標w
- 指定された矩形領域の幅h
- 指定された矩形領域の高さShape
の内部に、指定された矩形領域が完全に含まれる場合は true
、それ以外の場合、または Shape
に矩形領域が含まれ、intersects
メソッドが true
を返し、さらに負荷が大きすぎて包含の計算を実行できない場合は false
。Area
、Shape.intersects(double, double, double, double)
public boolean contains(Rectangle2D r)
Shape
の内部に、指定された Rectangle2D
が完全に含まれるかどうかをテストします。Shape.contains()
メソッドを使用すると、次のような場合に、Shape
実装は内部的に false
を返すことができます。
intersect
メソッドが true
を返し、かつ
Shape
に Rectangle2D
が完全に含まれるかどうかを判定するための計算の負荷が非常に大きい。
Shapes
によっては、Shape
に Rectangle2D
が含まれている場合でもこのメソッドが false
を返すことがあります。Area
クラスは、ほとんどの Shape
オブジェクトより正確な幾何学的計算を実行するため、より的確な答えが必要な場合に使用できます。contains
、インタフェース: Shape
r
- 指定された Rectangle2D
Shape
の内部に Rectangle2D
が完全に含まれる場合は true
、それ以外の場合、または Shape
に Rectangle2D
が含まれ、intersects
メソッドが true
を返し、さらに負荷が大きすぎて包含の計算を実行できない場合は false
。Shape.contains(double, double, double, double)
public Rectangle getBounds()
Shape
を完全に囲む整数の Rectangle
を返します。返された Rectangle
が Shape
を囲む最小のバウンディングボックスであるとは限りません。示された Rectangle
内に Shape
が完全に収まるというだけです。また、Shape
が整数型の制限範囲を超える場合、返された Rectangle
は Shape
を完全に囲むことができないこともあります。通常は、getBounds2D
メソッドの方が、表現の自由度が高いために、比較的ぴったりしたバウンディングボックスを返します。
内側の定義によって、shape
の定義する輪郭上の点が、返された bounds
オブジェクトに含まれていると見なされない状況が発生する場合があります。ただし、これは、これらの点が元の shape
にも含まれていないと見なされる場合のみです。
point
が contains(point)
メソッドに従って shape
の内側にある場合は、bounds
の contains(point)
メソッドに従って、返された Rectangle
境界オブジェクトの内側にある必要があります。具体的には、次のようになります。
shape.contains(x,y)
には次が必要: bounds.contains(x,y)
point
が shape
の内側にない場合は、引き続き bounds
オブジェクトに含まれている可能性があります。
bounds.contains(x,y)
は次を示さない: shape.contains(x,y)
getBounds
、インタフェース: Shape
Shape
を完全に囲む整数型の Rectangle
。Shape.getBounds2D()
public PathIterator getPathIterator(AffineTransform at)
CubicCurve2D
クラスでは、この CubicCurve2D
オブジェクトの幾何学的図形を変更すると、この幾何学的図形についてすでに進行中の反復処理に影響を及ぼす場合があります。getPathIterator
、インタフェース: Shape
at
- 反復処理で返されるときに座標に適用されるオプションの AffineTransform
、または変換されていない座標が必要な場合は null
CubicCurve2D
の輪郭の幾何学的図形を一度に 1 セグメントずつ返す PathIterator
オブジェクト。public PathIterator getPathIterator(AffineTransform at, double flatness)
CubicCurve2D
クラスでは、この CubicCurve2D
オブジェクトの幾何学的図形を変更すると、この幾何学的図形についてすでに進行中の反復処理に影響を及ぼす場合があります。getPathIterator
、インタフェース: Shape
at
- 反復処理で返されるときに座標に適用されるオプションの AffineTransform
、または変換されていない座標が必要な場合は null
flatness
- 分割された曲線が終点を結ぶ直線によって置換される前に、指定された曲線の制御点が共線から外れることのできる最大距離CubicCurve2D
の輪郭の幾何学的図形を一度に 1 セグメントずつ返す PathIterator
オブジェクト。public Object clone()
clone
、クラス: Object
OutOfMemoryError
- 十分なメモリーがない場合。Cloneable
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.