jp.go.ipa.jgcl
クラス JgclConic3D

java.lang.Object
  |
  +--jp.go.ipa.jgcl.JgclGeometry
        |
        +--jp.go.ipa.jgcl.JgclParametricCurve
              |
              +--jp.go.ipa.jgcl.JgclParametricCurve3D
                    |
                    +--jp.go.ipa.jgcl.JgclConic3D
すべての実装インタフェース:
java.io.Serializable
直系の既知のサブクラス:
JgclCircle3D, JgclEllipse3D, JgclHyperbola3D, JgclParabola3D

public abstract class JgclConic3D
extends JgclParametricCurve3D

3次元 : 円錐曲線のクラス階層のルートとなる抽象クラス。

このクラスのインスタンスは、 円錐曲線の位置と傾きを決定する局所座標系 (配置情報、JgclAxis2Placement3D) position を保持する。

position は null であってはならない。

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

コンストラクタの概要
protected JgclConic3D(JgclAxis2Placement3D position)
          局所座標系を指定してオブジェクトを構築する。
 
メソッドの概要
protected static JgclBsplineCurve3D convertPolyBezierCurvesToOneBsplineCurve(JgclPureBezierCurve3D[] bezierCurves, boolean closed)
          ある円錐曲線の一部を再現する有理ベジエ曲線列を一本の有理Bスプライン曲線に変換する。
 JgclPointOnCurve3D[] inflexion()
          この曲線の変曲点を返す。
 JgclIntersectionPoint3D[] intersect(JgclParametricSurface3D mate)
          この曲線と他の曲面の交点を求める。
 double length(JgclParameterSection pint)
          与えられたパラメータ区間におけるこの曲線の実空間上での長さ (道のり) を返す。
 JgclAxis2Placement3D position()
          この円錐曲線の「中心」と局所軸の方向を決定している局所座標系を返す。
 JgclPointOnCurve3D[] projectFrom(JgclPoint3D point)
          与えられた点からこの曲線への投影点を求める。
 JgclPointOnCurve3D[] singular()
          この曲線の特異点を返す。
protected  JgclCartesianTransformationOperator3D toGlobal()
          スケーリング値を 1 として、 この円錐曲線の局所座標系から大域的な座標系への変換を行なう演算子を返す。
 JgclPolyline3D toPolyline(JgclParameterSection pint, JgclToleranceForDistance tol)
          この曲線の指定の区間を、与えられた誤差で直線近似するポリラインを返す。
 double torsion(double param)
          この曲線の、与えられたパラメータ値でのレイ率を返す。
 
クラス jp.go.ipa.jgcl.JgclParametricCurve3D から継承したメソッド
checkProjection, coordinates, curvature, dimension, doTransformBy, evaluation, hasPolyline, identicalParameter, intersect, is3D, isComposedOfOnlyPolylines, nearestProjectFrom, nearestProjectWithDistanceFrom, parallelTranslate, pointToParameter, reverseTransformBy, tangentVector, toBsplineCurve, transformBy, transformBy
 
クラス jp.go.ipa.jgcl.JgclParametricCurve から継承したメソッド
checkValidity, checkValidity, isClosed, isCurve, isFinite, isInfinite, isNonPeriodic, isOpen, isParametric, isPeriodic, isValid, parameterDomain
 
クラス jp.go.ipa.jgcl.JgclGeometry から継承したメソッド
getClassName, getToleranceForAngle, getToleranceForAngleAsObject, getToleranceForDistance, getToleranceForDistance2, getToleranceForDistanceAsObject, getToleranceForParameter, getToleranceForParameterAsObject, getToleranceForRealNumber, getToleranceForRealNumberAsObject, is1D, is2D, isFreeform, isPlacement, isPoint, isSurface, isTransformationOperator, isVector, makeIndent, output, output
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

JgclConic3D

protected JgclConic3D(JgclAxis2Placement3D position)
局所座標系を指定してオブジェクトを構築する。

position が null の場合には、 JgclInvalidArgumentValue の例外を発生する。

パラメータ:
position - 中心と軸方向
関連項目:
JgclInvalidArgumentValue
メソッドの詳細

toGlobal

protected JgclCartesianTransformationOperator3D toGlobal()
スケーリング値を 1 として、 この円錐曲線の局所座標系から大域的な座標系への変換を行なう演算子を返す。
戻り値:
局所座標系から大域的な座標系への変換を行なう演算子

length

public double length(JgclParameterSection pint)
与えられたパラメータ区間におけるこの曲線の実空間上での長さ (道のり) を返す。
オーバーライド:
クラス JgclParametricCurve 内の length
パラメータ:
pint - 曲線の長さを求めるパラメータ区間
戻り値:
指定されたパラメータ区間における曲線の長さ

toPolyline

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

結果として返されるポリラインを構成する点は JgclPointOnCurve3D で あることを期待できる。

なお、結果として得られるポリラインが点に縮退するような場合には JgclZeroLength の例外を発生する。

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

projectFrom

public JgclPointOnCurve3D[] projectFrom(JgclPoint3D point)
                                 throws JgclIndefiniteSolution
与えられた点からこの曲線への投影点を求める。

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

この曲線が円であるとき、 与えられた点とこの円の中心との距離が、 現在設定されている演算条件の距離の許容誤差よりも 小さい場合には、 パラメータ値 0 の点を suitable として JgclIndefiniteSolution の例外を投げる。

[内部処理]

オーバーライド:
クラス JgclParametricCurve3D 内の projectFrom
パラメータ:
point - 投影元の点
戻り値:
投影点の配列
例外:
JgclIndefiniteSolution - 解が不定 (曲線が円であり、投影元の点が円の中心に一致する)

position

public JgclAxis2Placement3D position()
この円錐曲線の「中心」と局所軸の方向を決定している局所座標系を返す。
戻り値:
中心と局所軸の方向を示す局所座標系

torsion

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

円錐曲線は捩じれていないので、常に 0 を返す。

オーバーライド:
クラス JgclParametricCurve3D 内の torsion
パラメータ:
param - パラメータ値
戻り値:
レイ率

singular

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

円錐曲線には特異点は存在しないので、常に長さ 0 の配列を返す。

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

inflexion

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

円錐曲線には変曲点は存在しないので、常に長さ 0 の配列を返す。

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

intersect

public JgclIntersectionPoint3D[] intersect(JgclParametricSurface3D mate)
                                    throws JgclIndefiniteSolution
この曲線と他の曲面の交点を求める。

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

オーバーライド:
クラス JgclParametricCurve3D 内の intersect
パラメータ:
mate - 他の曲面
戻り値:
交点の配列
例外:
JgclIndefiniteSolution - 解が不定である

convertPolyBezierCurvesToOneBsplineCurve

protected static JgclBsplineCurve3D convertPolyBezierCurvesToOneBsplineCurve(JgclPureBezierCurve3D[] bezierCurves,
                                                                             boolean closed)
ある円錐曲線の一部を再現する有理ベジエ曲線列を一本の有理Bスプライン曲線に変換する。

与えられる有理ベジエ曲線列は、ある円錐曲線の一部を再現したもので、 曲線列の要素数は 1 ないし 3 であり、 各要素はすべて2次曲線であるものと想定している。

この制限のため、このメソッドは、 ベジエ曲線あるいはBスプライン曲線等のクラスに置くべきではないと考える。

パラメータ:
bezierCurves - (ある円錐曲線の一部を再現する) 有理ベジエ曲線列
closed - 有理ベジエ曲線列が閉じていれば true、そうでなければ false
戻り値:
有理Bスプライン曲線