jp.go.ipa.jgcl
クラス JgclCircle2D

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

public class JgclCircle2D
extends JgclConic2D

2次元 : 円を表すクラス。

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

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

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

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

コンストラクタの概要
JgclCircle2D(JgclAxis2Placement2D position, double radius)
          局所座標系と半径を与えてオブジェクトを構築する。
JgclCircle2D(JgclPoint2D center, double radius)
          中心と半径を与えてオブジェクトを構築する。
JgclCircle2D(JgclPoint2D pnt1, JgclPoint2D pnt2, JgclPoint2D pnt3)
          通過する三点を与えてオブジェクトを構築する。
 
メソッドの概要
 JgclCommonNormal2D[] commonNormal(JgclParametricCurve2D mate)
          この曲線と他の曲線との共通法線を求める。
 JgclCommonTangent2D[] commonTangent(JgclParametricCurve2D mate)
          この曲線と他の曲線との共通接線を求める。
 JgclPoint2D coordinates(double param)
          この曲線の、与えられたパラメータ値での座標値を返す。
 JgclCurveCurvature2D curvature(double param)
          この曲線の、与えられたパラメータ値での曲率を返す。
protected  JgclParametricCurve2D doTransformBy(boolean reverseTransform, JgclCartesianTransformationOperator2D transformationOperator, java.util.Hashtable transformedGeometries)
          この曲線を、与えられた幾何的変換演算子で変換する。
 JgclCurveDerivative2D evaluation(double param)
          この曲線の、与えられたパラメータ値での導関数を返す。
 JgclIntersectionPoint2D[] intersect(JgclParametricCurve2D mate)
          この曲線と他の曲線との交点を求める。
 double length(JgclParameterSection pint)
          与えられたパラメータ区間におけるこの曲線の実空間上での長さ (道のり) を返す。
static JgclTrimmedCurve2D makeTrimmedCurve(JgclPoint2D center, JgclPoint2D startPoint, JgclPoint2D endPoint)
          中心と始点、終点から円弧を生成する。
 JgclBoundedCurve2D offsetByBoundedCurve(JgclParameterSection pint, double magni, int side, JgclToleranceForDistance tol)
          この曲線の指定の区間をオフセットした曲線を、 与えられた誤差で近似する有限曲線を求める。
 JgclBsplineCurve2D offsetByBsplineCurve(JgclParameterSection pint, double magni, int side, JgclToleranceForDistance tol)
          この曲線の指定の区間をオフセットした曲線を、 与えられた誤差で近似する Bspline 曲線を求める。
protected  void output(java.io.PrintWriter writer, int indent)
          出力ストリームに形状情報を出力する。
 JgclPointOnCurve2D[] projectFrom(JgclPoint2D point)
          与えられた点からこの曲線への投影点を求める。
 double radius()
          この円の半径を返す。
 JgclVector2D tangentVector(double param)
          この曲線の、与えられたパラメータ値での接ベクトルを返す。
 JgclBsplineCurve2D toBsplineCurve(JgclParameterSection pint)
          この曲線の指定の区間を再現する有理Bスプライン曲線を返す。
 JgclPureBezierCurve2D[] toPolyBezierCurves(JgclParameterSection pint)
          この曲線の指定の区間を再現する有理ベジエ曲線の列を返す。
 JgclPolyline2D toPolyline(JgclParameterSection pint, JgclToleranceForDistance tol)
          この曲線の指定の区間を、与えられた誤差で直線近似するポリラインを返す。
 
クラス jp.go.ipa.jgcl.JgclConic2D から継承したメソッド
convertPolyBezierCurvesToOneBsplineCurve, getControlPointsOfBezierCurve, inflexion, position, singular
 
クラス jp.go.ipa.jgcl.JgclParametricCurve2D から継承したメソッド
checkProjection, dimension, fillet, hasPolyline, identicalParameter, is2D, 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, is3D, isFreeform, isPlacement, isPoint, isSurface, isTransformationOperator, isVector, makeIndent, output
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

JgclCircle2D

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

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

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

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

JgclCircle2D

public JgclCircle2D(JgclPoint2D center,
                    double radius)
中心と半径を与えてオブジェクトを構築する。

構築される円の局所 X/Y 軸の方向は、 グローバルな座標系の X/Y 軸の方向に一致する。

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

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

パラメータ:
center - 中心
radius - 半径
関連項目:
JgclInvalidArgumentValue

JgclCircle2D

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

構築される円の局所 X/Y 軸の方向は、 グローバルな座標系の X/Y 軸の方向に一致する。

pnt1, pnt2, pnt3 のいずれかが null の場合には JgclInvalidArgumentValue の例外を発生する。

また、pnt1, pnt2, pnt3 が共線状態にある場合にも JgclInvalidArgumentValue の例外を発生する。

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

radius

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

length

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

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

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

coordinates

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

tangentVector

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

curvature

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

evaluation

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

projectFrom

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

与えられた点がこの円の中心に一致しない限り、 常に二つの投影点を返す。

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

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

toPolyline

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

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

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

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

toPolyBezierCurves

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

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

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

toBsplineCurve

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

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

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

intersect

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

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

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

オーバーライド:
クラス JgclParametricCurve2D 内の intersect
パラメータ:
mate - 他の曲線
戻り値:
交点の配列
例外:
JgclIndefiniteSolution - 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

offsetByBoundedCurve

public JgclBoundedCurve2D offsetByBoundedCurve(JgclParameterSection pint,
                                               double magni,
                                               int side,
                                               JgclToleranceForDistance tol)
この曲線の指定の区間をオフセットした曲線を、 与えられた誤差で近似する有限曲線を求める。

結果として返される有限曲線は、 JgclCircle2D のインスタンスを母曲線とする JgclTrimmedCurve2D のインスタンスである。

オーバーライド:
クラス JgclParametricCurve2D 内の offsetByBoundedCurve
パラメータ:
pint - オフセットするパラメータ区間
magni - オフセット量
side - オフセットの向き (JgclWhichSide.LEFT/RIGHT)
tol - 距離の許容誤差
戻り値:
この曲線の指定の区間のオフセット曲線を近似する有限曲線
関連項目:
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 - いまのところ、実装されない機能である

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

makeTrimmedCurve

public static JgclTrimmedCurve2D makeTrimmedCurve(JgclPoint2D center,
                                                  JgclPoint2D startPoint,
                                                  JgclPoint2D endPoint)
中心と始点、終点から円弧を生成する。

円弧はトリム曲線で表現される。

トリム曲線の母曲線となる円の局所 X 軸の方向は、 中心から始点へ向かう方向となる。 また、円の半径は、「中心−始点間の距離」と「中心−終点間の距離」の平均値となる。 「中心−始点間の距離」と「中心−終点間の距離」の差については特に意識していない。

なお、円弧は、始点から終点に向かうパラメータ増分値の絶対値が πを越えないように生成される。 よって、円弧を表すトリム曲線のパラメータ増分値は負になることもあり得る。

パラメータ:
center - 中心
startPoint - 始点
endPoint - 終点
戻り値:
円弧を表すトリム曲線