jp.go.ipa.jgcl
クラス JgclBsplineCurve2D

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.JgclBsplineCurve2D
すべての実装インタフェース:
java.io.Serializable

public class JgclBsplineCurve2D
extends JgclFreeformCurveWithControlPoints2D

2次元 : 非有理 (多項式) Bスプライン曲線および有理Bスプライン曲線を表すクラス。

このクラスのインスタンスは、 Bスプラインのノット列に関する情報 knotData (JgclBsplineKnot) を持つ。 制御点列などを保持するフィールドについては、 スーパークラスの解説 を参照。

Bスプライン曲線のパラメータ定義域は、対応するノット列によって決まる。

t をパラメータとするBスプライン曲線 P(t) のパラメトリック表現は、以下の通り。

	n = 曲線の次数
	m = セグメントの数 (開いた形式 : (制御点の数 - 曲線の次数), 閉じた形式 : 制御点の数)
	di = controlPoints[i]
	wi = weights[i]
 
として、非有理Bスプライン曲線は
	P(t) =	(di * Nn,i(t)) の総和		(i = 0, ..., (m + n - 1))
 
有理Bスプライン曲線は
		(wi * di * Nn,i(t)) の総和
	P(t) =	-------------------------- 	(i = 0, ..., (m + n - 1))
		(wi * Nn,i(t)) の総和
 
ここで Nn,i(t) はBスプライン基底関数。 なお、閉じた形式の場合に i > (制御点の数 - 1) となる i については、 対応する制御点と重みがそれぞれ dj, wj (j = i - 制御点の数) となる。

バージョン:
$Revision: 1.98 $, $Date: 2000/08/11 06:18:42 $
作成者:
Information-technology Promotion Agency, Japan
関連項目:
直列化された形式

クラス jp.go.ipa.jgcl.JgclFreeformCurveWithControlPoints2D から継承したフィールド
controlPoints, weights
 
コンストラクタの概要
JgclBsplineCurve2D(int degree, boolean periodic, int[] knotMultiplicities, double[] knots, JgclPoint2D[] controlPoints)
          ノット列を明示し、 制御点列を与えて多項式曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(int degree, boolean periodic, int[] knotMultiplicities, double[] knots, JgclPoint2D[] controlPoints, double[] weights)
          ノット列を明示し、 制御点列と重み列を与えて有理曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(int degree, boolean periodic, int knotSpec, JgclPoint2D[] controlPoints)
          ノット列を明示せずに ノット列の種別と制御点列を与えて多項式曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(int degree, boolean periodic, int knotSpec, JgclPoint2D[] controlPoints, double[] weights)
          ノット列を明示せずに ノット列の種別と制御点列および重み列を与えて有理曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(int degree, int[] knotMultiplicities, double[] knots, JgclPoint2D[] controlPoints)
          ノット列を明示し、制御点列を与えて開いた形式の多項式曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(int degree, int[] knotMultiplicities, double[] knots, JgclPoint2D[] controlPoints, double[] weights)
          ノット列を明示し、 制御点列と重み列を与えて開いた形式の有理曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(int degree, int knotSpec, JgclPoint2D[] controlPoints)
          ノット列を明示せずに ノット列の種別と制御点列を与えて開いた多項式曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(int degree, int knotSpec, JgclPoint2D[] controlPoints, double[] weights)
          ノット列を明示せずに ノット列の種別と制御点列および重み列を与えて開いた形式の有理曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(JgclPoint2D[] points, double[] params)
          点列と、それに対応するパラメータ値の列を与えて、 その点列を補間する開いた形式の多項式曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(JgclPoint2D[] points, double[] params, JgclVector2D[] endvecs)
          点列と、それに対応するパラメータ値の列および両端点での接ベクトルを与えて、 その点列を補間する開いた形式の多項式曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(JgclPoint2D[] points, double[] params, JgclVector2D[] endvecs, boolean isClosed)
          点列と、それに対応するパラメータ値の列、両端点での接ベクトルおよび開閉情報を与えて、 その点列を補間する多項式曲線としてオブジェクトを構築する。
JgclBsplineCurve2D(JgclPoint2D[] points, double[] params, JgclVector2D[] endDir, boolean isClosed, JgclToleranceForDistance tol, JgclToleranceForDistance midTol)
          点列と、それに対応するパラメータ値の列、両端点での接線の方向および開閉情報を与えて、 その点列を近似する多項式曲線としてオブジェクトを構築する。
 
メソッドの概要
 JgclPoint2D blossoming(int segNumber, double[] parameters)
          この曲線の、与えられたパラメータ列に対するブロッサミングの結果を返す。
 JgclCommonNormal2D[] commonNormal(JgclParametricCurve2D mate)
          この曲線と他の曲線との共通法線を求める。
 JgclCommonTangent2D[] commonTangent(JgclParametricCurve2D mate)
          この曲線と他の曲線との共通接線を求める。
 JgclPoint2D controlPointAt(int n)
          この曲線の n 番目の制御点を返す。
 JgclPoint2D coordinates(double param)
          この曲線の、与えられたパラメータ値での座標値を返す。
 JgclCurveCurvature2D curvature(double param)
          この曲線の、与えられたパラメータ値での曲率を返す。
 int degree()
          この曲線の次数を返す。
 JgclBsplineCurve2D[] divide(double param)
          このBスプライン曲線を、与えられたパラメータ値で分割する。
protected  JgclParametricCurve2D doTransformBy(boolean reverseTransform, JgclCartesianTransformationOperator2D transformationOperator, java.util.Hashtable transformedGeometries)
          この曲線を、与えられた幾何的変換演算子で変換する。
 JgclBsplineCurve2D elevateOneDegree()
          この曲線を、形状をそのままにして、次数を一つ上げた曲線を返す。
 JgclCurveDerivative2D evaluation(double param)
          この曲線の、与えられたパラメータ値での導関数を返す。
 JgclPointOnCurve2D[] inflexion()
          この曲線の変曲点を返す。
 JgclBsplineCurve2D insertKnot(double param)
          この曲線の、指定のパラメータ値の位置に新たなノットを挿入した曲線を返す。
 JgclCurveCurveInterference2D[] interfere(JgclBoundedCurve2D mate)
          この有限曲線と他の有界曲線の干渉を求める。
 JgclIntersectionPoint2D[] intersect(JgclParametricCurve2D mate)
          この曲線と他の曲線の交点を求める。
 boolean isPeriodic()
          この曲線のパラメータ定義域が周期的か否かを返す。
 int knotSpec()
          この曲線のノットの種別を返す。
 double knotValueAt(int n)
          この曲線のノット列の n 番めのノット値を返す。
 double length(JgclParameterSection pint)
          与えられたパラメータ区間におけるこの曲線の実空間上での長さ (道のり) を返す。
 JgclBsplineCurve2D mergeIfContinuous(JgclBsplineCurve2D mate)
          このBスプライン曲線と、 このBスプライン曲線の終了点に幾何的に繋がっているBスプライン曲線を 一本のBスプライン曲線にする。
 int nKnotValues()
          この曲線のノットの数を返す。
 JgclBsplineCurve2D offsetByBsplineCurve(JgclParameterSection pint, double magni, int side, JgclToleranceForDistance tol)
          この曲線の指定の区間をオフセットした曲線を、 与えられた誤差で近似する Bspline 曲線を求める。
protected  void output(java.io.PrintWriter writer, int indent)
          出力ストリームに形状情報を出力する。
 JgclRealPolynomial[] polynomial(int iSseg, boolean isPoly)
          この曲線の指定のセグメントの多項式表現を返す。
 JgclPointOnCurve2D[] projectFrom(JgclPoint2D mate)
          与えられた点からこの曲線への投影点を求める。
 JgclBsplineCurve2D shiftIfPeriodic(double newStartParam)
          この「閉じた形式」のBスプライン曲線の形状を変えずに、 与えられたパラメータ値に対応する点を開始点とするように 変換したものを返す。
 JgclPointOnCurve2D[] singular()
          この曲線の特異点を返す。
 JgclVector2D tangentVector(double param)
          この曲線の、与えられたパラメータ値での接ベクトルを返す。
 JgclBsplineCurve2D toBsplineCurve()
          この有限曲線全体を厳密に再現する有理 Bspline 曲線を返す。
 JgclBsplineCurve2D toBsplineCurve(JgclParameterSection pint)
          この曲線の指定の区間を厳密に再現する有理 Bspline 曲線を返す。
 JgclPolyline2D toPolyline(JgclParameterSection section, JgclToleranceForDistance tolerance)
          この曲線の指定の区間を、与えられた誤差で直線近似するポリラインを返す。
 JgclPureBezierCurve2D[] toPureBezierCurveArray()
          このBスプライン曲線を再現するベジエ曲線の列を返す。
 JgclBsplineCurve2D truncate(JgclParameterSection section)
          このBスプライン曲線を、与えられたパラメータ区間で切断する。
 
クラス jp.go.ipa.jgcl.JgclFreeformCurveWithControlPoints2D から継承したメソッド
allocateDoubleArray, controlPoints, convRational0Deriv, convRational1Deriv, convRational2Deriv, isFreeform, isPolynomial, isRational, makeUniformWeights, nControlPoints, setCoordinatesToDoubleArray, toDoubleArray, weightAt, weights
 
クラス jp.go.ipa.jgcl.JgclBoundedCurve2D から継承したメソッド
endPoint, fillet, length, offsetByBoundedCurve, offsetByBsplineCurve, startPoint, toPolyline
 
クラス jp.go.ipa.jgcl.JgclParametricCurve2D から継承したメソッド
checkProjection, dimension, fillet, hasPolyline, identicalParameter, is2D, isComposedOfOnlyPolylines, nearestProjectFrom, nearestProjectWithDistanceFrom, offsetByBoundedCurve, pointToParameter, reverseTransformBy, transformBy, transformBy
 
クラス jp.go.ipa.jgcl.JgclParametricCurve から継承したメソッド
checkValidity, checkValidity, isClosed, isCurve, isFinite, isInfinite, isNonPeriodic, isOpen, isParametric, isValid, parameterDomain
 
クラス jp.go.ipa.jgcl.JgclGeometry から継承したメソッド
getClassName, getToleranceForAngle, getToleranceForAngleAsObject, getToleranceForDistance, getToleranceForDistance2, getToleranceForDistanceAsObject, getToleranceForParameter, getToleranceForParameterAsObject, getToleranceForRealNumber, getToleranceForRealNumberAsObject, is1D, is3D, isPlacement, isPoint, isSurface, isTransformationOperator, isVector, makeIndent, output
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

JgclBsplineCurve2D

public JgclBsplineCurve2D(int degree,
                          boolean periodic,
                          int[] knotMultiplicities,
                          double[] knots,
                          JgclPoint2D[] controlPoints)
ノット列を明示し、 制御点列を与えて多項式曲線としてオブジェクトを構築する。

このコンストラクタは、 super(controlPoints) を呼び出している。

knotData の構築には、 new JgclBsplineKnot(degree, JgclKnotType.UNSPECIFIED, periodic, knotMultiplicities, knots, nControlPoints()) を呼び出している。

パラメータ:
degree - 曲線の次数
periodic - 閉じた形式か否かを表すフラグ
knotMultiplicities - ノット多重度の配列
knots - ノット値の配列
controlPoints - 制御点の配列

JgclBsplineCurve2D

public JgclBsplineCurve2D(int degree,
                          int[] knotMultiplicities,
                          double[] knots,
                          JgclPoint2D[] controlPoints)
ノット列を明示し、制御点列を与えて開いた形式の多項式曲線としてオブジェクトを構築する。

このコンストラクタは、 super(controlPoints) を呼び出している。

knotData の構築には、 new JgclBsplineKnot(degree, JgclKnotType.UNSPECIFIED, false, knotMultiplicities, knots, nControlPoints()) を呼び出している。

パラメータ:
degree - 曲線の次数
knotMultiplicities - ノット多重度の配列
knots - ノット値の配列
controlPoints - 制御点の配列

JgclBsplineCurve2D

public JgclBsplineCurve2D(int degree,
                          boolean periodic,
                          int[] knotMultiplicities,
                          double[] knots,
                          JgclPoint2D[] controlPoints,
                          double[] weights)
ノット列を明示し、 制御点列と重み列を与えて有理曲線としてオブジェクトを構築する。

このコンストラクタは、 super(controlPoints, weights) を呼び出している。

knotData の構築には、 new JgclBsplineKnot(degree, JgclKnotType.UNSPECIFIED, periodic, knotMultiplicities, knots, nControlPoints()) を呼び出している。

パラメータ:
degree - 曲線の次数
periodic - 閉じた形式か否かを表すフラグ
knotMultiplicities - ノット多重度の配列
knots - ノット値の配列
controlPoints - 制御点の配列
weights - 重みの配列

JgclBsplineCurve2D

public JgclBsplineCurve2D(int degree,
                          int[] knotMultiplicities,
                          double[] knots,
                          JgclPoint2D[] controlPoints,
                          double[] weights)
ノット列を明示し、 制御点列と重み列を与えて開いた形式の有理曲線としてオブジェクトを構築する。

このコンストラクタは、 super(controlPoints, weights) を呼び出している。

knotData の構築には、 new JgclBsplineKnot(degree, JgclKnotType.UNSPECIFIED, false, knotMultiplicities, knots, nControlPoints()) を呼び出している。

パラメータ:
degree - 曲線の次数
knotMultiplicities - ノット多重度の配列
knots - ノット値の配列
controlPoints - 制御点の配列
weights - 重みの配列

JgclBsplineCurve2D

public JgclBsplineCurve2D(int degree,
                          boolean periodic,
                          int knotSpec,
                          JgclPoint2D[] controlPoints)
ノット列を明示せずに ノット列の種別と制御点列を与えて多項式曲線としてオブジェクトを構築する。

いまのところ、knotSpec がとり得る値は JgclKnotType.UNIFORM_KNOTS だけである (JgclKnotType.{QUASI_UNIFORM_KNOTS, PIECEWISE_BEZIER_KNOTS} には未対応) 。

このコンストラクタは、 super(controlPoints) を呼び出している。

knotData の構築には、 new JgclBsplineKnot(degree, knotSpec, periodic, null, null, nControlPoints()) を呼び出している。

パラメータ:
degree - 曲線の次数
periodic - 閉じた形式か否かを表すフラグ
knotSpec - ノット列の種別
controlPoints - 制御点の配列

JgclBsplineCurve2D

public JgclBsplineCurve2D(int degree,
                          int knotSpec,
                          JgclPoint2D[] controlPoints)
ノット列を明示せずに ノット列の種別と制御点列を与えて開いた多項式曲線としてオブジェクトを構築する。

いまのところ、knotSpec がとり得る値は JgclKnotType.UNIFORM_KNOTS だけである (JgclKnotType.{QUASI_UNIFORM_KNOTS, PIECEWISE_BEZIER_KNOTS} には未対応) 。

このコンストラクタは、 super(controlPoints) を呼び出している。

knotData の構築には、 new JgclBsplineKnot(degree, knotSpec, false, null, null, nControlPoints()) を呼び出している。

パラメータ:
degree - 曲線の次数
knotSpec - ノット列の種別
controlPoints - 制御点の配列

JgclBsplineCurve2D

public JgclBsplineCurve2D(int degree,
                          boolean periodic,
                          int knotSpec,
                          JgclPoint2D[] controlPoints,
                          double[] weights)
ノット列を明示せずに ノット列の種別と制御点列および重み列を与えて有理曲線としてオブジェクトを構築する。

いまのところ、knotSpec がとり得る値は JgclKnotType.UNIFORM_KNOTS だけである (JgclKnotType.{QUASI_UNIFORM_KNOTS, PIECEWISE_BEZIER_KNOTS} には未対応) 。

このコンストラクタは、 super(controlPoints, weights) を呼び出している。

knotData の構築には、 new JgclBsplineKnot(degree, knotSpec, periodic, null, null, nControlPoints()) を呼び出している。

パラメータ:
degree - 曲線の次数
periodic - 閉じた形式か否かを表すフラグ
knotSpec - ノット列の種別
controlPoints - 制御点の配列
weights - 重みの配列

JgclBsplineCurve2D

public JgclBsplineCurve2D(int degree,
                          int knotSpec,
                          JgclPoint2D[] controlPoints,
                          double[] weights)
ノット列を明示せずに ノット列の種別と制御点列および重み列を与えて開いた形式の有理曲線としてオブジェクトを構築する。

いまのところ、knotSpec がとり得る値は JgclKnotType.UNIFORM_KNOTS だけである (JgclKnotType.{QUASI_UNIFORM_KNOTS, PIECEWISE_BEZIER_KNOTS} には未対応) 。

このコンストラクタは、 super(controlPoints, weights) を呼び出している。

knotData の構築には、 new JgclBsplineKnot(degree, knotSpec, false, null, null, nControlPoints()) を呼び出している。

パラメータ:
degree - 曲線の次数
knotSpec - ノット列の種別
controlPoints - 制御点の配列
weights - 重みの配列

JgclBsplineCurve2D

public JgclBsplineCurve2D(JgclPoint2D[] points,
                          double[] params)
点列と、それに対応するパラメータ値の列を与えて、 その点列を補間する開いた形式の多項式曲線としてオブジェクトを構築する。
パラメータ:
points - 補間する点列
params - 点列内の各点におけるパラメータ値の列

JgclBsplineCurve2D

public JgclBsplineCurve2D(JgclPoint2D[] points,
                          double[] params,
                          JgclVector2D[] endvecs)
点列と、それに対応するパラメータ値の列および両端点での接ベクトルを与えて、 その点列を補間する開いた形式の多項式曲線としてオブジェクトを構築する。

endvecs[0] で始点での接ベクトル、 endvecs[1] で終点での接ベクトルを示す。

パラメータ:
points - 補間する点列
params - 点列内の各点におけるパラメータ値の列
endvecs - 両端点での接ベクトル

JgclBsplineCurve2D

public JgclBsplineCurve2D(JgclPoint2D[] points,
                          double[] params,
                          JgclVector2D[] endvecs,
                          boolean isClosed)
点列と、それに対応するパラメータ値の列、両端点での接ベクトルおよび開閉情報を与えて、 その点列を補間する多項式曲線としてオブジェクトを構築する。

isClosed が true の場合、 (params の要素数) = (points の要素数 + 1) となっている必要がある。

endvecs[0] で始点での接ベクトル、 endvecs[1] で終点での接ベクトルを示す。 なお、isClosed が true の場合には、この配列は参照されない。

パラメータ:
points - 補間する点列
params - 点列内の各点におけるパラメータ値の列
endvecs - 両端点での接ベクトル
isClosed - 閉じた形式の曲線を生成するか否かのフラグ

JgclBsplineCurve2D

public JgclBsplineCurve2D(JgclPoint2D[] points,
                          double[] params,
                          JgclVector2D[] endDir,
                          boolean isClosed,
                          JgclToleranceForDistance tol,
                          JgclToleranceForDistance midTol)
点列と、それに対応するパラメータ値の列、両端点での接線の方向および開閉情報を与えて、 その点列を近似する多項式曲線としてオブジェクトを構築する。

isClosed が true の場合、 (params の要素数) = (points の要素数 + 1) となっている必要がある。

endDir[0] で始点での接線方向、 endDir[1] で終点での接線方向を示す。 なお、isClosed が true の場合には、この配列は参照されない。

指定された精度で近似できなかった場合には、 与えられた点列を補間する曲線を生成する。

パラメータ:
points - 補間する点列
params - 点列内の各点におけるパラメータ値の列
endDir - 両端点での接線の方向
isClosed - 閉じた形式の曲線を生成するか否かのフラグ
tol - 各点における近似の精度
midTol - 点の中間における近似の精度
メソッドの詳細

degree

public int degree()
この曲線の次数を返す。
戻り値:
次数

knotSpec

public int knotSpec()
この曲線のノットの種別を返す。
戻り値:
ノットの種別
関連項目:
JgclKnotType

nKnotValues

public int nKnotValues()
この曲線のノットの数を返す。

ここで言う「ノットの数」とは knotData の knots フィールドに設定されたノット値の配列の長さではなく、 Bスプラインのノット列本来のノットの数である。

戻り値:
ノットの数

knotValueAt

public double knotValueAt(int n)
この曲線のノット列の n 番めのノット値を返す。

ここで言う「n 番目」とは knotData の knots フィールドに設定されたノット値の配列内のインデックスではなく、 Bスプラインのノット列本来の意味でのインデックスである。

パラメータ:
n - インデックス
戻り値:
n 番めのノット値

isPeriodic

public boolean isPeriodic()
この曲線のパラメータ定義域が周期的か否かを返す。

パラメータドメインを調べる必要がないのでオーバーライドする。

オーバーライド:
クラス JgclParametricCurve 内の isPeriodic
戻り値:
周期的であれば true、そうでなければ false

controlPointAt

public JgclPoint2D controlPointAt(int n)
この曲線の n 番目の制御点を返す。

閉じた形式の場合はインデックスを周期的に扱う。

オーバーライド:
クラス JgclFreeformCurveWithControlPoints2D 内の controlPointAt
パラメータ:
n - インデックス
戻り値:
制御点

polynomial

public JgclRealPolynomial[] polynomial(int iSseg,
                                       boolean isPoly)
この曲線の指定のセグメントの多項式表現を返す。

結果として得られる配列 R の要素数は、 この曲線が非有理であれば 2、 有理であれば 3 である。

非有理曲線の場合、 R[0] は X 成分、 R[1] は Y 成分 の多項式表現を表す。

有理曲線の場合、 R[0] は WX 成分、 R[1] は WY 成分 R[2] は W 成分 の多項式表現を表す。

パラメータ:
iSseg - セグメントの番号
isPoly - 非有理であるかどうか
戻り値:
多項式の配列

length

public double length(JgclParameterSection pint)
与えられたパラメータ区間におけるこの曲線の実空間上での長さ (道のり) を返す。

pint の増分値は負でもかまわない。

与えられたパラメータ区間がこの曲線の定義域を外れている場合には JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve 内の length
パラメータ:
pint - 曲線の長さを求めるパラメータ区間
戻り値:
指定されたパラメータ区間における曲線の長さ
関連項目:
JgclParameterOutOfRange

coordinates

public JgclPoint2D coordinates(double param)
この曲線の、与えられたパラメータ値での座標値を返す。

与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の coordinates
パラメータ:
param - パラメータ値
戻り値:
座標値
関連項目:
JgclParameterOutOfRange

tangentVector

public JgclVector2D tangentVector(double param)
この曲線の、与えられたパラメータ値での接ベクトルを返す。

与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の tangentVector
パラメータ:
param - パラメータ値
戻り値:
接ベクトル
関連項目:
JgclParameterOutOfRange

curvature

public JgclCurveCurvature2D curvature(double param)
この曲線の、与えられたパラメータ値での曲率を返す。

与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の curvature
パラメータ:
param - パラメータ値
戻り値:
曲率
関連項目:
JgclParameterOutOfRange

evaluation

public JgclCurveDerivative2D evaluation(double param)
この曲線の、与えられたパラメータ値での導関数を返す。

与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の evaluation
パラメータ:
param - パラメータ値
戻り値:
導関数
関連項目:
JgclParameterOutOfRange

blossoming

public JgclPoint2D blossoming(int segNumber,
                              double[] parameters)
この曲線の、与えられたパラメータ列に対するブロッサミングの結果を返す。

parameters の要素数は、この曲線の次数に一致している必要がある。

与えられたパラメータ値が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

パラメータ:
segNumber - 演算対象となるセグメントの番号 (先頭は 0)
parameters - パラメータ値の配列
戻り値:
ブロッサミングの結果である座標値
関連項目:
JgclParameterOutOfRange

singular

public JgclPointOnCurve2D[] singular()
この曲線の特異点を返す。

特異点が存在しないときは長さ 0 の配列を返す。

オーバーライド:
クラス JgclParametricCurve2D 内の singular
戻り値:
特異点の配列

inflexion

public JgclPointOnCurve2D[] inflexion()
この曲線の変曲点を返す。

変曲点が存在しないときは長さ 0 の配列を返す。

オーバーライド:
クラス JgclParametricCurve2D 内の inflexion
戻り値:
変曲点の配列

projectFrom

public JgclPointOnCurve2D[] projectFrom(JgclPoint2D mate)
与えられた点からこの曲線への投影点を求める。

投影点が存在しないときは長さ 0 の配列を返す。

[内部処理]
曲線上のある点 P(t) から与えられた点へ向かうベクトルと P(t) における接ベクトル P'(t) の内積を表す多項式 D(t) を生成し、 それを左辺とする代数方程式 D(t) = 0 を解いている。

オーバーライド:
クラス JgclParametricCurve2D 内の projectFrom
パラメータ:
point - 投影元の点
戻り値:
投影点の配列

toBsplineCurve

public JgclBsplineCurve2D toBsplineCurve()
この有限曲線全体を厳密に再現する有理 Bspline 曲線を返す。
オーバーライド:
クラス JgclBoundedCurve2D 内の toBsplineCurve
戻り値:
この曲線全体を再現する有理 Bspline 曲線

toBsplineCurve

public JgclBsplineCurve2D toBsplineCurve(JgclParameterSection pint)
この曲線の指定の区間を厳密に再現する有理 Bspline 曲線を返す。

pint の値が、このBスプライン曲線の定義域を外れている場合には JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の toBsplineCurve
パラメータ:
pint - 有理 Bspline 曲線で再現するパラメータ区間
戻り値:
この曲線の指定の区間を再現する有理 Bspline 曲線
関連項目:
JgclParameterOutOfRange

intersect

public JgclIntersectionPoint2D[] intersect(JgclParametricCurve2D mate)
この曲線と他の曲線の交点を求める。

交点が存在しないときは長さ 0 の配列を返す。

オーバーライド:
クラス JgclParametricCurve2D 内の intersect
パラメータ:
mate - 他の曲線
戻り値:
交点の配列

interfere

public JgclCurveCurveInterference2D[] interfere(JgclBoundedCurve2D mate)
この有限曲線と他の有界曲線の干渉を求める。

干渉が存在しない場合には長さ 0 の配列を返す。

オーバーライド:
クラス JgclBoundedCurve2D 内の interfere
パラメータ:
mate - 他の曲線
戻り値:
二曲線の干渉の配列

offsetByBsplineCurve

public JgclBsplineCurve2D offsetByBsplineCurve(JgclParameterSection pint,
                                               double magni,
                                               int side,
                                               JgclToleranceForDistance tol)
この曲線の指定の区間をオフセットした曲線を、 与えられた誤差で近似する Bspline 曲線を求める。
オーバーライド:
クラス JgclParametricCurve2D 内の offsetByBsplineCurve
パラメータ:
pint - オフセットするパラメータ区間
magni - オフセット量
side - オフセットの向き (JgclWhichSide.LEFT/RIGHT)
tol - 距離の許容誤差
戻り値:
この曲線の指定の区間のオフセット曲線を近似する Bspline 曲線
関連項目:
JgclWhichSide

commonTangent

public JgclCommonTangent2D[] commonTangent(JgclParametricCurve2D mate)
この曲線と他の曲線との共通接線を求める。

共通接線が存在しない場合には長さ 0 の配列を返す。

現時点では実装されていないため、 JgclNotSupported の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の commonTangent
パラメータ:
mate - 他の曲線
戻り値:
共通接線の配列
例外:
JgclNotSupported - いまのところ、実装されない機能である

commonNormal

public JgclCommonNormal2D[] commonNormal(JgclParametricCurve2D mate)
この曲線と他の曲線との共通法線を求める。

共通法線が存在しない場合には長さ 0 の配列を返す。

現時点では実装されていないため、 JgclNotSupported の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の commonNormal
パラメータ:
mate - 他の曲線
戻り値:
共通法線の配列
例外:
JgclNotSupported - いまのところ、実装されない機能である

insertKnot

public JgclBsplineCurve2D insertKnot(double param)
この曲線の、指定のパラメータ値の位置に新たなノットを挿入した曲線を返す。

形状はこの曲線のままで、セグメントが一つ増えたBスプライン曲線を返す。

パラメータ:
param - ノットを挿入するパラメータ値
戻り値:
ノット挿入後のBスプライン曲線

divide

public JgclBsplineCurve2D[] divide(double param)
このBスプライン曲線を、与えられたパラメータ値で分割する。

この曲線が開いた形式の場合には、 param に対応する点で前後二本に分割する。 結果として得られる配列の要素数は 2 で、 最初の要素に「始点から分割点までを表すBスプライン曲線 A」、 二番目の要素に「分割点から終点までを表すBスプライン曲線 B」 が入る。 この曲線のパラメータ定義域を [start, end] とすると、 A のパラメータ定義域は [start, param]、 B のパラメータ定義域は [0, (end - param)] になる。

この曲線が閉じた形式の場合には、 param に対応する点を両端とする開いた形式の 一本のBスプライン曲線 C に変換する。 結果として得られる配列の要素数は 1 である。 この曲線のパラメータ定義域を [start, end] とすると、 C のパラメータ定義域は [0, (end - start)] になる。

param の値が、このBスプライン曲線の定義域を外れている場合には JgclParameterOutOfRange の例外を発生する。

パラメータ:
param - パラメータ値
戻り値:
分割後のBスプライン曲線を含む配列
関連項目:
JgclParameterOutOfRange

truncate

public JgclBsplineCurve2D truncate(JgclParameterSection section)
このBスプライン曲線を、与えられたパラメータ区間で切断する。

section の増分値が負の場合には、進行方向が反転したBスプライン曲線を返す。

section の値が、このBスプライン曲線の定義域を外れている場合には JgclParameterOutOfRange の例外を発生する。

切断後の曲線のパラメータ定義域は [0, section.absIncrease()] になる。

パラメータ:
section - 切断して残す部分を表すパラメータ区間
戻り値:
切断して残した部分を表すBスプライン曲線
関連項目:
JgclParameterOutOfRange

shiftIfPeriodic

public JgclBsplineCurve2D shiftIfPeriodic(double newStartParam)
                                   throws JgclOpenCurve
この「閉じた形式」のBスプライン曲線の形状を変えずに、 与えられたパラメータ値に対応する点を開始点とするように 変換したものを返す。

結果として得られるBスプライン曲線の開始点のパラメータ値は常に 0 になる。

パラメータ:
newStartParam - 開始点となるパラメータ値
戻り値:
与えられたパラメータ値に対応する点を開始点とするBスプライン曲線
例外:
JgclOpenCurve - この曲線は開いた形式である

toPolyline

public JgclPolyline2D toPolyline(JgclParameterSection section,
                                 JgclToleranceForDistance tolerance)
この曲線の指定の区間を、与えられた誤差で直線近似するポリラインを返す。

結果として返されるポリラインを構成する点は この曲線をベース曲線とする JgclPointOnCurve2D で あることを期待できる。

section の値が、このベジエ曲線の定義域を外れている場合には JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の toPolyline
パラメータ:
section - 直線近似するパラメータ区間
tolerance - 距離の許容誤差
戻り値:
この曲線の指定の区間を直線近似するポリライン
関連項目:
JgclParameterOutOfRange

toPureBezierCurveArray

public JgclPureBezierCurve2D[] toPureBezierCurveArray()
このBスプライン曲線を再現するベジエ曲線の列を返す。

この曲線の、パラメータ的に縮退していない有効セグメントに対応するベジエ曲線の列を返す。

戻り値:
ベジエ曲線の配列

elevateOneDegree

public JgclBsplineCurve2D elevateOneDegree()
この曲線を、形状をそのままにして、次数を一つ上げた曲線を返す。
戻り値:
同一形状で、次数が一つ上がった曲線

mergeIfContinuous

public JgclBsplineCurve2D mergeIfContinuous(JgclBsplineCurve2D mate)
                                     throws JgclTwoGeomertiesAreNotContinuous
このBスプライン曲線と、 このBスプライン曲線の終了点に幾何的に繋がっているBスプライン曲線を 一本のBスプライン曲線にする。
パラメータ:
mate - この曲線の終了点に繋がる曲線
戻り値:
this の終了点と mate の開始点を繋いで一本にした曲線
例外:
JgclTwoGeomertiesAreNotContinuous - this の終了点と mate の開始点が一致しない

doTransformBy

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、そうでなければ false
transformationOperator - 幾何的変換演算子
transformedGeometries - 既に同様の変換を施した幾何要素を含むハッシュテーブル
戻り値:
変換後の幾何要素

output

protected void output(java.io.PrintWriter writer,
                      int indent)
出力ストリームに形状情報を出力する。
オーバーライド:
クラス JgclGeometry 内の output
パラメータ:
writer - PrintWriter
indent - インデントの深さ
関連項目:
JgclGeometry