jp.go.ipa.jgcl
クラス JgclEllipse2D

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

public class JgclEllipse2D
extends JgclConic2D

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

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

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

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

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

コンストラクタの概要
JgclEllipse2D(JgclAxis2Placement2D position, double semiAxis1, double semiAxis2)
          局所座標系と各軸に対する半径を与えてオブジェクトを構築する。
 
メソッドの概要
 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)
          与えられたパラメータ区間におけるこの曲線の実空間上での長さ (道のり) を返す。
 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 semiAxis1()
          この楕円の半径1 (局所座標系の X 軸方向の半径) を返す。
 double semiAxis2()
          この楕円の半径2 (局所座標系の Y 軸方向の半径) を返す。
 JgclVector2D tangentVector(double param)
          この曲線の、与えられたパラメータ値での接ベクトルを返す。
 JgclBsplineCurve2D toBsplineCurve(JgclParameterSection pint)
          この曲線の指定の区間を再現する有理Bスプライン曲線を返す。
 JgclPureBezierCurve2D[] toPolyBezierCurves(JgclParameterSection pint)
          この曲線の指定の区間を再現する有理ベジエ曲線の列を返す。
 double xRadius()
          semiAxis1() の別名メソッド。
 double yRadius()
          semiAxis2() の別名メソッド。
 
クラス jp.go.ipa.jgcl.JgclConic2D から継承したメソッド
convertPolyBezierCurvesToOneBsplineCurve, getControlPointsOfBezierCurve, inflexion, position, singular, 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, 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
 

コンストラクタの詳細

JgclEllipse2D

public JgclEllipse2D(JgclAxis2Placement2D position,
                     double semiAxis1,
                     double semiAxis2)
局所座標系と各軸に対する半径を与えてオブジェクトを構築する。

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

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

パラメータ:
position - 中心と局所 X/Y 軸の方向を示す局所座標系
semiAxis1 - 半径1 (局所 X 軸に対する半径)
semiAxis2 - 半径2 (局所 Y 軸に対する半径)
関連項目:
JgclInvalidArgumentValue
メソッドの詳細

semiAxis1

public double semiAxis1()
この楕円の半径1 (局所座標系の X 軸方向の半径) を返す。
戻り値:
半径1

xRadius

public double xRadius()
semiAxis1() の別名メソッド。
戻り値:
半径1

semiAxis2

public double semiAxis2()
この楕円の半径2 (局所座標系の Y 軸方向の半径) を返す。
戻り値:
半径2

yRadius

public double yRadius()
semiAxis2() の別名メソッド。
戻り値:
半径2

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 - 解が不定 (投影元の点が円状の楕円の中心に一致する)

toPolyBezierCurves

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

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

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

toBsplineCurve

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

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

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

intersect

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

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

相手も楕円のときに、 現在設定されている演算条件の下で、 二楕円の中心間の距離が距離の許容誤差より小さく、 二楕円の局所 X 軸のなす角度が角度の許容誤差より小さく、 二楕円の局所 X/Y 軸それぞれについての半径の差が距離の許容誤差以内である場合には、 二楕円はオーバーラップしているものとして、 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

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