jp.go.ipa.jgcl
クラス JgclCircle3D

java.lang.Object
  |
  +--jp.go.ipa.jgcl.JgclGeometry
        |
        +--jp.go.ipa.jgcl.JgclParametricCurve
              |
              +--jp.go.ipa.jgcl.JgclParametricCurve3D
                    |
                    +--jp.go.ipa.jgcl.JgclConic3D
                          |
                          +--jp.go.ipa.jgcl.JgclCircle3D
すべての実装インタフェース:
java.io.Serializable

public class JgclCircle3D
extends JgclConic3D

3次元 : 円を表すクラス

円は、その中心の位置と局所 X/Y 軸の方向を示す局所座標系 (配置情報、JgclAxis2Placement3D) position と 半径 radius で定義される。

t をパラメータとする円 P(t) のパラメトリック表現は、以下の通り。

	P(t) = position.location() + radius * (cos(t) * position.x() + sin(t) * position.y())
 

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

コンストラクタの概要
JgclCircle3D(JgclAxis2Placement3D position, double radius)
          局所座標系と半径を与えてオブジェクトを構築する。
JgclCircle3D(JgclPoint3D pnt1, JgclPoint3D pnt2, JgclPoint3D pnt3)
          通過する三点を与えてオブジェクトを構築する。
JgclCircle3D(JgclPoint3D center, JgclVector3D normal, double radius)
          中心、法線ベクトルと半径を与えてオブジェクトを構築する。
 
メソッドの概要
 JgclPoint3D coordinates(double param)
          この曲線の、与えられたパラメータ値での座標値を返す。
 JgclCurveCurvature3D curvature(double param)
          この曲線の、与えられたパラメータ値での曲率を返す。
protected  JgclParametricCurve3D doTransformBy(boolean reverseTransform, JgclCartesianTransformationOperator3D transformationOperator, java.util.Hashtable transformedGeometries)
          この曲線を、与えられた幾何的変換演算子で変換する。
 JgclCurveDerivative3D evaluation(double param)
          この曲線の、与えられたパラメータ値での導関数を返す。
 JgclIntersectionPoint3D[] intersect(JgclParametricCurve3D mate)
          この曲線と他の曲線との交点を求める。
 double length(JgclParameterSection pint)
          与えられたパラメータ区間におけるこの曲線の実空間上での長さ (道のり) を返す。
protected  void output(java.io.PrintWriter writer, int indent)
          出力ストリームに形状情報を出力する。
 JgclParametricCurve3D parallelTranslate(JgclVector3D moveVec)
          この曲線を、与えられたベクトルに従って平行移動した曲線を返す。
 JgclPointOnCurve3D[] projectFrom(JgclPoint3D point)
          与えられた点からこの曲線への投影点を求める。
 double radius()
          この円の半径を返す。
 JgclVector3D tangentVector(double param)
          この曲線の、与えられたパラメータ値での接ベクトルを返す。
 JgclBsplineCurve3D toBsplineCurve(JgclParameterSection pint)
          この曲線の指定の区間を再現する有理Bスプライン曲線を返す。
 JgclPureBezierCurve3D[] toPolyBezierCurves(JgclParameterSection pint)
          この曲線の指定の区間を再現する有理ベジエ曲線の列を返す。
 JgclPolyline3D toPolyline(JgclParameterSection pint, JgclToleranceForDistance tol)
          この曲線の指定の区間を、与えられた誤差で直線近似するポリラインを返す。
 
クラス jp.go.ipa.jgcl.JgclConic3D から継承したメソッド
convertPolyBezierCurvesToOneBsplineCurve, inflexion, intersect, position, singular, toGlobal, torsion
 
クラス jp.go.ipa.jgcl.JgclParametricCurve3D から継承したメソッド
checkProjection, dimension, hasPolyline, identicalParameter, is3D, isComposedOfOnlyPolylines, nearestProjectFrom, nearestProjectWithDistanceFrom, pointToParameter, reverseTransformBy, 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
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

JgclCircle3D

public JgclCircle3D(JgclAxis2Placement3D position,
                    double radius)
局所座標系と半径を与えてオブジェクトを構築する。

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

radius の値が、 現在設定されている演算条件の距離の許容誤差よりも小さい場合には JgclInvalidArgumentValue の例外を発生する。

パラメータ:
position - 中心と局所 X/Y/Z 軸の方向を示す局所座標系
radius - 半径
関連項目:
JgclInvalidArgumentValue

JgclCircle3D

public JgclCircle3D(JgclPoint3D center,
                    JgclVector3D normal,
                    double radius)
中心、法線ベクトルと半径を与えてオブジェクトを構築する。

構築される円の局所 X/Y 軸の方向は、 このコンストラクタの内部で決定する。

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

radius の値が、 現在設定されている演算条件の距離の許容誤差よりも小さい場合には JgclInvalidArgumentValue の例外を発生する。

パラメータ:
center - 中心
normal - 法線ベクトル
radius - 半径
関連項目:
JgclInvalidArgumentValue

JgclCircle3D

public JgclCircle3D(JgclPoint3D pnt1,
                    JgclPoint3D pnt2,
                    JgclPoint3D pnt3)
通過する三点を与えてオブジェクトを構築する。

(pnt2 - pnt1) の方向を局所 X 軸の方向とする。

与えられた三点が共線状態の場合には JgclInvalidArgumentValue の例外を発生する。

パラメータ:
pnt1 - 円上の一点
pnt2 - 円上の一点
pnt3 - 円上の一点
関連項目:
JgclInvalidArgumentValue
メソッドの詳細

radius

public double radius()
この円の半径を返す。
戻り値:
半径

length

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

pint で与えられる区間は [0, 2 * PI] に収まっている必要はない。 また、pint の増分値は負でもかまわない。

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

coordinates

public JgclPoint3D coordinates(double param)
この曲線の、与えられたパラメータ値での座標値を返す。
オーバーライド:
クラス JgclParametricCurve3D 内の coordinates
パラメータ:
param - パラメータ値
戻り値:
座標値

tangentVector

public JgclVector3D tangentVector(double param)
この曲線の、与えられたパラメータ値での接ベクトルを返す。
オーバーライド:
クラス JgclParametricCurve3D 内の tangentVector
パラメータ:
param - パラメータ値
戻り値:
接ベクトル

curvature

public JgclCurveCurvature3D curvature(double param)
この曲線の、与えられたパラメータ値での曲率を返す。
オーバーライド:
クラス JgclParametricCurve3D 内の curvature
パラメータ:
param - パラメータ値
戻り値:
曲率

evaluation

public JgclCurveDerivative3D evaluation(double param)
この曲線の、与えられたパラメータ値での導関数を返す。
オーバーライド:
クラス JgclParametricCurve3D 内の evaluation
パラメータ:
param - パラメータ値
戻り値:
導関数

projectFrom

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

与えられた点がこの円の中心を通る局所 Z 軸上にない限り、 常に二つの投影点を返す。

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

オーバーライド:
クラス JgclConic3D 内の projectFrom
パラメータ:
point - 投影元の点
戻り値:
投影点の配列
例外:
JgclIndefiniteSolution - 解が不定 (投影元の点が円の中心を通る局所 Z 軸上にある)

toPolyline

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

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

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

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

toPolyBezierCurves

public JgclPureBezierCurve3D[] toPolyBezierCurves(JgclParameterSection pint)
この曲線の指定の区間を再現する有理ベジエ曲線の列を返す。

pint の増分値の絶対値が (2 * π) 以上の場合には、 それを (2 * π) と見なして処理する。

パラメータ:
pint - 再現するパラメータ区間
戻り値:
この曲線の指定の区間を再現する有理ベジエ曲線の配列

toBsplineCurve

public JgclBsplineCurve3D toBsplineCurve(JgclParameterSection pint)
この曲線の指定の区間を再現する有理Bスプライン曲線を返す。

pint の増分値の絶対値が (2 * π) 以上の場合には、 それを (2 * π) と見なして処理し、 閉じた形式の曲線を返す。

オーバーライド:
クラス JgclParametricCurve3D 内の toBsplineCurve
パラメータ:
pint - 再現するパラメータ区間
戻り値:
この曲線の指定の区間を再現する有理Bスプライン曲線
関連項目:
toPolyBezierCurves(JgclParameterSection)

intersect

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

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

相手も円のときに、 二円が同一平面上に乗っており、 二円の中心間の距離と二円の半径の差が、 ともに現在設定されている演算条件の距離の許容誤差より小さい場合には、 二円はオーバーラップしているものとして、 JgclIndefiniteSolution の例外を発生させる。

オーバーライド:
クラス JgclParametricCurve3D 内の intersect
パラメータ:
mate - 他の曲線
戻り値:
交点の配列
例外:
JgclIndefiniteSolution - mate も円で、二円はオーバーラップしており、解が不定である

parallelTranslate

public JgclParametricCurve3D parallelTranslate(JgclVector3D moveVec)
この曲線を、与えられたベクトルに従って平行移動した曲線を返す。
オーバーライド:
クラス JgclParametricCurve3D 内の parallelTranslate
パラメータ:
moveVec - 平行移動の方向と量を表すベクトル
戻り値:
平行移動後の曲線

doTransformBy

protected JgclParametricCurve3D doTransformBy(boolean reverseTransform,
                                              JgclCartesianTransformationOperator3D transformationOperator,
                                              java.util.Hashtable transformedGeometries)
この曲線を、与えられた幾何的変換演算子で変換する。

transformedGeometries は、 変換前の幾何要素をキーとし、 変換後の幾何要素を値とするハッシュテーブルである。

this が transformedGeometries 内にキーとして存在しない場合には、 this を transformationOperator で変換したものを返す。 この際にメソッド内部では this をキー、 変換結果を値として transformedGeometries に追加する。

this が transformedGeometries 内に既にキーとして存在する場合には、 実際の変換は行なわず、そのキーに対応する値を返す。 この処理は再帰的に行なわれる。

transformedGeometries は null でも構わない。 transformedGeometries は null の場合には、 常に this を transformationOperator で変換したものを返す。

オーバーライド:
クラス JgclParametricCurve3D 内の doTransformBy
パラメータ:
reverseTransform - 逆変換するのであれば true、そうでなければ false
transformationOperator - 幾何的変換演算子
transformedGeometries - 既に同様の変換を施した幾何要素を含むハッシュテーブル
戻り値:
変換後の幾何要素

output

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