|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
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
2次元 : 円を表すクラス。
円は、その中心の位置と局所 X/Y 軸の方向を示す局所座標系
(配置情報、JgclAxis2Placement2D
) position と
半径 radius で定義される。
t をパラメータとする円 P(t) のパラメトリック表現は、以下の通り。
P(t) = position.location() + radius * (cos(t) * position.x() + sin(t) * position.y())
コンストラクタの概要 | |
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 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
public JgclCircle2D(JgclAxis2Placement2D position, double radius)
position が null の場合には、 JgclInvalidArgumentValue の例外を発生する。
radius の値が、 現在設定されている演算条件の距離の許容誤差よりも小さい場合には JgclInvalidArgumentValue の例外を発生する。
position
- 中心と局所 X/Y 軸の方向を示す局所座標系radius
- 半径JgclInvalidArgumentValue
public JgclCircle2D(JgclPoint2D center, double radius)
構築される円の局所 X/Y 軸の方向は、 グローバルな座標系の X/Y 軸の方向に一致する。
center が null の場合には、 JgclInvalidArgumentValue の例外を発生する。
radius の値が、 現在設定されている演算条件の距離の許容誤差よりも小さい場合には JgclInvalidArgumentValue の例外を発生する。
center
- 中心radius
- 半径JgclInvalidArgumentValue
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
メソッドの詳細 |
public double radius()
public double length(JgclParameterSection pint)
pint で与えられる区間は [0, 2 * PI] に収まっている必要はない。 また、pint の増分値は負でもかまわない。
JgclParametricCurve
内の length
pint
- 曲線の長さを求めるパラメータ区間public JgclPoint2D coordinates(double param)
JgclParametricCurve2D
内の coordinates
param
- パラメータ値public JgclVector2D tangentVector(double param)
JgclParametricCurve2D
内の tangentVector
param
- パラメータ値public JgclCurveCurvature2D curvature(double param)
JgclParametricCurve2D
内の curvature
param
- パラメータ値public JgclCurveDerivative2D evaluation(double param)
JgclParametricCurve2D
内の evaluation
param
- パラメータ値public JgclPointOnCurve2D[] projectFrom(JgclPoint2D point) throws JgclIndefiniteSolution
与えられた点がこの円の中心に一致しない限り、 常に二つの投影点を返す。
与えられた点とこの円の中心との距離が、 現在設定されている演算条件の距離の許容誤差よりも 小さい場合には、 パラメータ値 0 の点を suitable として JgclIndefiniteSolution の例外を投げる。
JgclParametricCurve2D
内の projectFrom
point
- 投影元の点JgclIndefiniteSolution
- 解が不定 (投影元の点が円の中心に一致する)public JgclPolyline2D toPolyline(JgclParameterSection pint, JgclToleranceForDistance tol)
結果として返されるポリラインを構成する点は、 この曲線をベースとする JgclPointOnCurve2D で あることを期待できる。
なお、結果として得られるポリラインが点に縮退するような場合には JgclZeroLength の例外を発生する。
JgclConic2D
内の toPolyline
pint
- 直線近似するパラメータ区間tol
- 距離の許容誤差JgclPointOnCurve2D
,
JgclZeroLength
public JgclPureBezierCurve2D[] toPolyBezierCurves(JgclParameterSection pint)
pint の増分値の絶対値が (2 * π) 以上の場合には、 それを (2 * π) と見なして処理する。
pint
- 再現するパラメータ区間public JgclBsplineCurve2D toBsplineCurve(JgclParameterSection pint)
pint の増分値の絶対値が (2 * π) 以上の場合には、 それを (2 * π) と見なして処理し、 閉じた形式の曲線を返す。
JgclParametricCurve2D
内の toBsplineCurve
pint
- 再現するパラメータ区間toPolyBezierCurves(JgclParameterSection)
public JgclIntersectionPoint2D[] intersect(JgclParametricCurve2D mate) throws JgclIndefiniteSolution
交点が存在しないときは長さ 0 の配列を返す。
相手も円のときに、 二円の中心間の距離と二円の半径の差が、 ともに現在設定されている演算条件の距離の許容誤差より小さい場合には、 二円はオーバーラップしているものとして、 JgclIndefiniteSolution の例外を発生させる。
JgclParametricCurve2D
内の intersect
mate
- 他の曲線JgclIndefiniteSolution
- mate も円で、二円はオーバーラップしており、解が不定であるpublic JgclBsplineCurve2D offsetByBsplineCurve(JgclParameterSection pint, double magni, int side, JgclToleranceForDistance tol)
JgclParametricCurve2D
内の offsetByBsplineCurve
pint
- オフセットするパラメータ区間magni
- オフセット量side
- オフセットの向き (JgclWhichSide.LEFT/RIGHT)tol
- 距離の許容誤差JgclWhichSide
public JgclBoundedCurve2D offsetByBoundedCurve(JgclParameterSection pint, double magni, int side, JgclToleranceForDistance tol)
結果として返される有限曲線は、
JgclCircle2D のインスタンスを母曲線とする
JgclTrimmedCurve2D
のインスタンスである。
JgclParametricCurve2D
内の offsetByBoundedCurve
pint
- オフセットするパラメータ区間magni
- オフセット量side
- オフセットの向き (JgclWhichSide.LEFT/RIGHT)tol
- 距離の許容誤差JgclWhichSide
public JgclCommonTangent2D[] commonTangent(JgclParametricCurve2D mate)
共通接線が存在しない場合には長さ 0 の配列を返す。
現時点では実装されていないため、 JgclNotSupported の例外を発生する。
JgclParametricCurve2D
内の commonTangent
mate
- 他の曲線JgclNotSupported
- いまのところ、実装されない機能であるpublic JgclCommonNormal2D[] commonNormal(JgclParametricCurve2D mate)
共通法線が存在しない場合には長さ 0 の配列を返す。
現時点では実装されていないため、 JgclNotSupported の例外を発生する。
JgclParametricCurve2D
内の commonNormal
mate
- 他の曲線JgclNotSupported
- いまのところ、実装されない機能である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、そうでなければ falsetransformationOperator
- 幾何的変換演算子transformedGeometries
- 既に同様の変換を施した幾何要素を含むハッシュテーブルprotected void output(java.io.PrintWriter writer, int indent)
JgclGeometry
内の output
writer
- PrintWriterindent
- インデントの深さJgclGeometry
public static JgclTrimmedCurve2D makeTrimmedCurve(JgclPoint2D center, JgclPoint2D startPoint, JgclPoint2D endPoint)
円弧はトリム曲線で表現される。
トリム曲線の母曲線となる円の局所 X 軸の方向は、 中心から始点へ向かう方向となる。 また、円の半径は、「中心−始点間の距離」と「中心−終点間の距離」の平均値となる。 「中心−始点間の距離」と「中心−終点間の距離」の差については特に意識していない。
なお、円弧は、始点から終点に向かうパラメータ増分値の絶対値が πを越えないように生成される。 よって、円弧を表すトリム曲線のパラメータ増分値は負になることもあり得る。
center
- 中心startPoint
- 始点endPoint
- 終点
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |