|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--jp.go.ipa.jgcl.JgclGeometry | +--jp.go.ipa.jgcl.JgclParametricCurve | +--jp.go.ipa.jgcl.JgclParametricCurve2D | +--jp.go.ipa.jgcl.JgclBoundedCurve2D | +--jp.go.ipa.jgcl.JgclFreeformCurveWithControlPoints2D | +--jp.go.ipa.jgcl.JgclPureBezierCurve2D
2次元 : 非有理 (多項式) ベジエ曲線および有理ベジエ曲線を表すクラス
このクラスに特有な属性を表すフィールドは特にない。
制御点列などを保持するフィールドについては、
スーパークラスの解説
を参照。
ベジエ曲線のパラメータ定義域は [0, 1] となる。
t をパラメータとするベジエ曲線 P(t) のパラメトリック表現は、以下の通り。
n = 制御点の数 - 1 bi = controlPoints[i] wi = weights[i]として、非有理ベジエ曲線は
P(t) = (bi * Bn,i(t)) の総和 (i = 0, ..., n)有理ベジエ曲線は
(wi * bi * Bn,i(t)) の総和 P(t) = -------------------------- (i = 0, ..., n) (wi * Bn,i(t)) の総和ここで Bn,i(t) はバーンスタイン基底関数である。
クラス jp.go.ipa.jgcl.JgclFreeformCurveWithControlPoints2D から継承したフィールド |
controlPoints, weights |
コンストラクタの概要 | |
JgclPureBezierCurve2D(JgclPoint2D[] controlPoints)
制御点列を与えて多項式曲線としてオブジェクトを構築する。 |
|
JgclPureBezierCurve2D(JgclPoint2D[] controlPoints,
double[] weights)
制御点列と重み列を与えて有理曲線としてオブジェクトを構築する。 |
|
JgclPureBezierCurve2D(JgclPoint2D[] controlPoints,
double[] weights,
boolean doCheck)
制御点列と重み列を与えて 多項式曲線 (あるいは有理曲線) としてオブジェクトを構築する。 |
メソッドの概要 | |
JgclPoint2D |
blossoming(double[] parameters)
この曲線の、与えられたパラメータ列に対するブロッサミングの結果を返す。 |
JgclCommonNormal2D[] |
commonNormal(JgclParametricCurve2D mate)
この曲線と他の曲線との共通法線を求める。 |
JgclCommonTangent2D[] |
commonTangent(JgclParametricCurve2D mate)
この曲線と他の曲線との共通接線を求める。 |
JgclPoint2D |
coordinates(double param)
この曲線の、与えられたパラメータ値での座標値を返す。 |
JgclCurveCurvature2D |
curvature(double param)
この曲線の、与えられたパラメータ値での曲率を返す。 |
int |
degree()
この曲線の次数を返す。 |
JgclPureBezierCurve2D[] |
divide(double param)
このベジエ曲線を、与えられたパラメータ値で二つに分割する。 |
protected JgclParametricCurve2D |
doTransformBy(boolean reverseTransform,
JgclCartesianTransformationOperator2D transformationOperator,
java.util.Hashtable transformedGeometries)
この曲線を、与えられた幾何的変換演算子で変換する。 |
JgclPureBezierCurve2D |
elevateOneDegree()
この曲線を、形状をそのままにして、次数を一つ上げた曲線を返す。 |
JgclPoint2D |
endPoint()
この有限曲線の終了点を返す。 |
JgclCurveDerivative2D |
evaluation(double param)
この曲線の、与えられたパラメータ値での導関数を返す。 |
JgclPointOnCurve2D[] |
inflexion()
この曲線の変曲点を返す。 |
JgclCurveCurveInterference2D[] |
interfere(JgclBoundedCurve2D mate)
この有限曲線と他の有界曲線の干渉を求める。 |
JgclIntersectionPoint2D[] |
intersect(JgclParametricCurve2D mate)
この曲線と他の曲線の交点を求める。 |
double |
length(JgclParameterSection pint)
与えられたパラメータ区間におけるこの曲線の実空間上での長さ (道のり) を返す。 |
JgclBsplineCurve2D |
offsetByBsplineCurve(JgclParameterSection pint,
double magni,
int side,
JgclToleranceForDistance tol)
この曲線の指定の区間をオフセットした曲線を、 与えられた誤差で近似する Bspline 曲線を求める。 |
protected void |
output(java.io.PrintWriter writer,
int indent)
出力ストリームに形状情報を出力する。 |
JgclRealPolynomial[] |
polynomial(boolean isPoly)
この曲線の多項式表現を返す。 |
JgclPolynomialCurve2D |
polynomialCurve(boolean isPoly)
この曲線を再現する多項式曲線を返す。 |
JgclPointOnCurve2D[] |
projectFrom(JgclPoint2D mate)
与えられた点からこの曲線への投影点を求める。 |
JgclPointOnCurve2D[] |
singular()
この曲線の特異点を返す。 |
JgclPoint2D |
startPoint()
この有限曲線の開始点を返す。 |
JgclVector2D |
tangentVector(double param)
この曲線の、与えられたパラメータ値での接ベクトルを返す。 |
JgclBsplineCurve2D |
toBsplineCurve()
この有限曲線全体を厳密に再現する有理 Bspline 曲線を返す。 |
JgclBsplineCurve2D |
toBsplineCurve(JgclParameterSection pint)
この曲線の指定の区間を厳密に再現する有理 Bspline 曲線を返す。 |
JgclPolyline2D |
toPolyline(JgclParameterSection section,
JgclToleranceForDistance tolerance)
この曲線の指定の区間を、与えられた誤差で直線近似するポリラインを返す。 |
JgclPureBezierCurve2D |
truncate(JgclParameterSection section)
このベジエ曲線を、与えられたパラメータ区間で切断する。 |
クラス jp.go.ipa.jgcl.JgclBoundedCurve2D から継承したメソッド |
fillet, length, offsetByBoundedCurve, offsetByBsplineCurve, toPolyline |
クラス jp.go.ipa.jgcl.JgclParametricCurve から継承したメソッド |
checkValidity, checkValidity, isClosed, isCurve, isFinite, isInfinite, isNonPeriodic, isOpen, isParametric, isPeriodic, isValid, parameterDomain |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
public JgclPureBezierCurve2D(JgclPoint2D[] controlPoints)
このコンストラクタは、
super
(controlPoints)
を呼び出しているだけである。
controlPoints
- 制御点の配列public JgclPureBezierCurve2D(JgclPoint2D[] controlPoints, double[] weights)
このコンストラクタは、
super
(controlPoints, weights)
を呼び出しているだけである。
controlPoints
- 制御点の配列weights
- 重みの配列public JgclPureBezierCurve2D(JgclPoint2D[] controlPoints, double[] weights, boolean doCheck)
このコンストラクタは、
super
(controlPoints, weights, doCheck)
を呼び出しているだけである。
controlPoints
- 制御点の配列。weights
- 重みの配列doCheck
- 引数のチェックをするかどうかメソッドの詳細 |
public int degree()
public JgclRealPolynomial[] polynomial(boolean isPoly)
結果として得られる配列 R の要素数は、 この曲線が非有理であれば 2、 有理であれば 3 である。
非有理曲線の場合、 R[0] は X 成分、 R[1] は Y 成分 の多項式表現を表す。
有理曲線の場合、 R[0] は WX 成分、 R[1] は WY 成分 R[2] は W 成分 の多項式表現を表す。
isPoly
- 非有理であるかどうかpolynomialCurve(boolean)
public JgclPolynomialCurve2D polynomialCurve(boolean isPoly)
isPoly
- 非有理であるかどうかpolynomial(boolean)
public double length(JgclParameterSection pint)
pint の増分値は負でもかまわない。
与えられたパラメータ区間がこの曲線の定義域を外れている場合には JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve
内の length
pint
- 曲線の長さを求めるパラメータ区間JgclParameterOutOfRange
public JgclPoint2D coordinates(double param)
与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve2D
内の coordinates
param
- パラメータ値JgclParameterOutOfRange
public JgclVector2D tangentVector(double param)
与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve2D
内の tangentVector
param
- パラメータ値JgclParameterOutOfRange
public JgclCurveCurvature2D curvature(double param)
与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve2D
内の curvature
param
- パラメータ値JgclParameterOutOfRange
public JgclCurveDerivative2D evaluation(double param)
与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve2D
内の evaluation
param
- パラメータ値JgclParameterOutOfRange
public JgclPoint2D blossoming(double[] parameters)
parameters の要素数は、この曲線の次数に一致している必要がある。
与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
parameters
- パラメータ値の配列JgclParameterOutOfRange
public JgclPointOnCurve2D[] singular() throws JgclIndefiniteSolution
特異点が存在しないときは長さ 0 の配列を返す。
JgclParametricCurve2D
内の singular
JgclIndefiniteSolution
- 曲線全体が縮退しているpublic JgclPointOnCurve2D[] inflexion() throws JgclIndefiniteSolution
変曲点が存在しないときは長さ 0 の配列を返す。
JgclParametricCurve2D
内の inflexion
JgclIndefiniteSolution
- 解が不定である (この曲線は直線状である)public JgclPointOnCurve2D[] projectFrom(JgclPoint2D mate)
投影点が存在しないときは長さ 0 の配列を返す。
[内部処理]
曲線上のある点 P(t) から与えられた点へ向かうベクトルと
P(t) における接ベクトル P'(t) の内積を表す多項式 D(t) を生成し、
それを左辺とする代数方程式 D(t) = 0 を解いている。
JgclParametricCurve2D
内の projectFrom
point
- 投影元の点public JgclBsplineCurve2D toBsplineCurve()
JgclBoundedCurve2D
内の toBsplineCurve
public JgclBsplineCurve2D toBsplineCurve(JgclParameterSection pint)
JgclParametricCurve2D
内の toBsplineCurve
pint
- 有理 Bspline 曲線で再現するパラメータ区間public JgclIntersectionPoint2D[] intersect(JgclParametricCurve2D mate)
交点が存在しないときは長さ 0 の配列を返す。
JgclParametricCurve2D
内の intersect
mate
- 他の曲線public JgclCurveCurveInterference2D[] interfere(JgclBoundedCurve2D mate)
干渉が存在しない場合には長さ 0 の配列を返す。
JgclBoundedCurve2D
内の interfere
mate
- 他の曲線public JgclBsplineCurve2D offsetByBsplineCurve(JgclParameterSection pint, double magni, int side, JgclToleranceForDistance tol)
JgclParametricCurve2D
内の offsetByBsplineCurve
pint
- オフセットするパラメータ区間magni
- オフセット量side
- オフセットの向き (JgclWhichSide.LEFT/RIGHT)tol
- 距離の許容誤差JgclWhichSide
public JgclCommonTangent2D[] commonTangent(JgclParametricCurve2D mate)
共通接線が存在しない場合には長さ 0 の配列を返す。
現時点では実装されていないため、 JgclNotSupported の例外を発生する。
JgclParametricCurve2D
内の commonTangent
mate
- 他の曲線JgclNotSupported
- いまのところ、実装されない機能であるpublic JgclCommonNormal2D[] commonNormal(JgclParametricCurve2D mate)
共通法線が存在しない場合には長さ 0 の配列を返す。
現時点では実装されていないため、 JgclNotSupported の例外を発生する。
JgclParametricCurve2D
内の commonNormal
mate
- 他の曲線JgclNotSupported
- いまのところ、実装されない機能であるpublic JgclPureBezierCurve2D[] divide(double param)
param の値が、このベジエ曲線の定義域を外れている場合には JgclParameterOutOfRange の例外を発生する。
結果として得られる配列の要素数は 2 で、 最初の要素に「始点から分割点までを表すベジエ曲線」、 二番目の要素に「分割点から終点までを表すベジエ曲線」 が入る。
param
- パラメータ値JgclParameterOutOfRange
public JgclPureBezierCurve2D truncate(JgclParameterSection section)
section の増分値が負の場合には、進行方向が反転したベジエ曲線を返す。
section の値が、このベジエ曲線の定義域を外れている場合には JgclParameterOutOfRange の例外を発生する。
section
- 切断して残す部分を表すパラメータ区間JgclParameterOutOfRange
public JgclPolyline2D toPolyline(JgclParameterSection section, JgclToleranceForDistance tolerance)
結果として返されるポリラインを構成する点は この曲線をベースとする JgclPointOnCurve2D で あることを期待できる。
section の値が、このベジエ曲線の定義域を外れている場合には JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve2D
内の toPolyline
section
- 直線近似するパラメータ区間tolerance
- 距離の許容誤差JgclParameterOutOfRange
public JgclPoint2D startPoint()
JgclBoundedCurve2D
内の startPoint
public JgclPoint2D endPoint()
JgclBoundedCurve2D
内の endPoint
public JgclPureBezierCurve2D elevateOneDegree()
protected JgclParametricCurve2D doTransformBy(boolean reverseTransform, JgclCartesianTransformationOperator2D transformationOperator, java.util.Hashtable transformedGeometries)
transformedGeometries は、 変換前の幾何要素をキーとし、 変換後の幾何要素を値とするハッシュテーブルである。
this が transformedGeometries 内にキーとして存在しない場合には、 this を transformationOperator で変換したものを返す。 この際にメソッド内部では this をキー、 変換結果を値として transformedGeometries に追加する。
this が transformedGeometries 内に既にキーとして存在する場合には、 実際の変換は行なわず、そのキーに対応する値を返す。 この処理は再帰的に行なわれる。
transformedGeometries は null でも構わない。 transformedGeometries は null の場合には、 常に this を transformationOperator で変換したものを返す。
JgclParametricCurve2D
内の doTransformBy
reverseTransform
- 逆変換するのであれば true、そうでなければ falsetransformationOperator
- 幾何的変換演算子transformedGeometries
- 既に同様の変換を施した幾何要素を含むハッシュテーブルprotected void output(java.io.PrintWriter writer, int indent)
JgclGeometry
内の output
writer
- PrintWriterindent
- インデントの深さJgclGeometry
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |