|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--jp.go.ipa.jgcl.JgclGeometry | +--jp.go.ipa.jgcl.JgclParametricCurve | +--jp.go.ipa.jgcl.JgclParametricCurve3D | +--jp.go.ipa.jgcl.JgclLine3D
3次元 : 直線を表すクラス。
直線は、線上のある一点 pnt と方向ベクトル dir で定義される。
t をパラメータとする直線 P(t) のパラメトリック表現は、以下の通り。
P(t) = pnt + t * dir
直線も「曲線」です。
この直線は無限な直線を表す。
有限な直線を表したい場合には
JgclBoundedLine3D
や
JgclTrimmedCurve3D
が利用できる。
コンストラクタの概要 | |
JgclLine3D(JgclPoint3D pnt1,
JgclPoint3D pnt2)
通過する二点を与えてオブジェクトを構築する。 |
|
JgclLine3D(JgclPoint3D pnt,
JgclVector3D dir)
フィールドに設定する値をそのまま与えてオブジェクトを構築する。 |
メソッドの概要 | |
JgclPoint3D |
coordinates(double param)
この曲線の、与えられたパラメータ値での座標値を返す。 |
JgclCurveCurvature3D |
curvature(double param)
この曲線の、与えられたパラメータ値での曲率を返す。 |
JgclVector3D |
dir()
この直線を定義している方向ベクトルを返す。 |
protected JgclParametricCurve3D |
doTransformBy(boolean reverseTransform,
JgclCartesianTransformationOperator3D transformationOperator,
java.util.Hashtable transformedGeometries)
この曲線を、与えられた幾何的変換演算子で変換する。 |
JgclCurveDerivative3D |
evaluation(double param)
この曲線の、与えられたパラメータ値での導関数を返す。 |
JgclPointOnCurve3D[] |
inflexion()
この曲線の変曲点を返す。 |
JgclIntersectionPoint3D[] |
intersect(JgclParametricCurve3D mate)
この曲線と他の曲線の交点を求める。 |
JgclIntersectionPoint3D[] |
intersect(JgclParametricSurface3D mate)
この曲線と他の曲面の交点を求める。 |
JgclIntersectionPoint3D[] |
intersect(JgclPlane3D mate)
この曲線と他の曲面 (平面) の交点を求める。 |
JgclIntersectionPoint3D |
intersect1Line(JgclLine3D mate)
この直線と他の直線との (一つだけの) 交点を求める。 |
double |
length(JgclParameterSection pint)
この曲線の、与えられたパラメータ区間における実空間上での長さ (道のり) を返す。 |
protected void |
output(java.io.PrintWriter writer,
int indent)
出力ストリームに形状情報を出力する。 |
JgclParametricCurve3D |
parallelTranslate(JgclVector3D moveVec)
この曲線を、与えられたベクトルに従って平行移動した曲線を返す。 |
JgclPoint3D |
pnt()
この直線を定義している線上のある一点 (パラメータ値 0 に対応する点) を返す。 |
JgclPointOnCurve3D |
project1From(JgclPoint3D point)
与えられた点からこの直線への (一つだけ存在する) 投影点を求める。 |
JgclPointOnCurve3D[] |
projectFrom(JgclPoint3D point)
与えられた点からこの曲線への投影点を求める。 |
JgclPointOnCurve3D[] |
singular()
この曲線の特異点を返す。 |
JgclVector3D |
tangentVector(double param)
この曲線の、与えられたパラメータ値での接ベクトルを返す。 |
JgclBsplineCurve3D |
toBsplineCurve(JgclParameterSection pint)
この曲線の指定の区間を厳密に再現する有理 Bspline 曲線を返す。 |
JgclPolyline3D |
toPolyline(JgclParameterSection pint,
JgclToleranceForDistance tol)
この曲線の指定の区間を、与えられた誤差で直線近似するポリラインを返す。 |
double |
torsion(double param)
この曲線の、与えられたパラメータ値でのレイ率を返す。 |
クラス 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 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
public JgclLine3D(JgclPoint3D pnt, JgclVector3D dir)
pnt をパラメータ値 0 の点とし、 dir を方向ベクトルとする直線を生成する。
dir の大きさが、 現在設定されている演算条件の距離の許容誤差よりも小さい場合には JgclInvalidArgumentValue の例外を発生する。
pnt
- 線上のある一点 (パラメータ値 0 に対応する)dir
- 方向ベクトルJgclConditionOfOperation
,
JgclInvalidArgumentValue
public JgclLine3D(JgclPoint3D pnt1, JgclPoint3D pnt2)
pnt1 をパラメータ値 0 の点とし、 pnt2 をパラメータ値 1 の点とする 直線を生成する。
pnt と dir は、以下のように設定される。
pnt = pnt1 dir = pnt2 - pnt1
pnt1 と pnt2 が、 現在設定されている演算条件の距離の許容誤差の下で、 同一の点と見なせる場合には JgclInvalidArgumentValue の例外を発生する。
pnt1
- 線上のある一点 (パラメータ値 0 に対応する)pnt2
- 線上のある一点 (パラメータ値 1 に対応する)JgclConditionOfOperation
,
JgclInvalidArgumentValue
,
JgclPoint3D.identical(JgclPoint3D)
メソッドの詳細 |
public JgclPoint3D pnt()
public JgclVector3D dir()
このベクトルは、この直線の接ベクトルに等しい。
public double length(JgclParameterSection pint)
JgclParametricCurve
内の length
pint
- 長さを求めるパラメータ区間public JgclPoint3D coordinates(double param)
JgclParametricCurve3D
内の coordinates
param
- パラメータ値public JgclVector3D tangentVector(double param)
直線の接ベクトルは、常に dir に等しい。
JgclParametricCurve3D
内の tangentVector
param
- パラメータ値public JgclCurveCurvature3D curvature(double param)
直線の曲率は、常に 0 である。
JgclParametricCurve3D
内の curvature
param
- パラメータ値public JgclCurveDerivative3D evaluation(double param)
JgclParametricCurve3D
内の evaluation
param
- パラメータ値public double torsion(double param)
直線のレイ率は、常に 0 である。
JgclParametricCurve3D
内の torsion
param
- パラメータ値public JgclPointOnCurve3D[] singular()
直線には特異点は存在しないので、常に要素数 0 の配列を返す。
JgclParametricCurve3D
内の singular
public JgclPointOnCurve3D[] inflexion()
直線には変曲点は存在しないので、常に要素数 0 の配列を返す。
JgclParametricCurve3D
内の inflexion
public JgclPointOnCurve3D[] projectFrom(JgclPoint3D point)
ある直線への任意の点からの投影点の数は必ず 1 になる。
このメソッドは、
JgclParametricCurve3D
クラスで
抽象メソッドとして宣言されているものであるが、
このクラスには投影点を求めるメソッドとして、他に
project1From(JgclPoint3D)
がある。
project1From(JgclPoint3D) は、
「投影点の配列」ではなく、
一つだけ得られる「投影点」をそのまま返す。
JgclParametricCurve3D
内の projectFrom
point
- 投影元の点project1From(JgclPoint3D)
public JgclPolyline3D toPolyline(JgclParameterSection pint, JgclToleranceForDistance tol)
結果として返されるポリラインを構成する点は この曲線をベースとする JgclPointOnCurve3D で あることを期待できる。
なお、 結果として返されるポリラインは、 この直線の指定された区間の「近似」ではなく、厳密な「再現」である。 このメソッドの内部では tol の値は参照しない。
JgclParametricCurve3D
内の toPolyline
pint
- 直線近似するパラメータ区間tol
- 距離の許容誤差JgclPointOnCurve3D
public JgclBsplineCurve3D toBsplineCurve(JgclParameterSection pint)
結果として返される有理 Bspline 曲線は 1次で制御点数が 2、両端二重のユニフォームなノット列を持つ。
JgclParametricCurve3D
内の toBsplineCurve
pint
- 有理 Bspline 曲線で再現するパラメータ区間public JgclIntersectionPoint3D[] intersect(JgclParametricCurve3D mate) throws JgclIndefiniteSolution
交点が存在しないときは長さ 0 の配列を返す。
相手も直線で、二直線がオーバーラップしている場合には、
解が不定であるとして JgclIndefiniteSolution を発生する。
二直線がオーバーラップしていると判断する条件は
intersect1Line(JgclLine3D)
と同様である。
JgclParametricCurve3D
内の intersect
mate
- 他の曲線JgclIndefiniteSolution
- mate も直線で、二直線はオーバーラップしており、解が不定であるpublic JgclIntersectionPoint3D intersect1Line(JgclLine3D mate) throws JgclIndefiniteSolution
二直線が平行である場合には null を返す。 二直線の方向ベクトルのなす角度θ (もしくはπ - θ) が 現在設定されている演算条件の「角度の許容誤差以内」であれば、 二直線は平行であるものと判断する。
ただし、二直線が平行である場合に、 いずれかの pnt から相手への距離が 現在設定されている演算条件の「距離の許容誤差以内」であれば、 二直線はオーバーラップしているものとして、 JgclIndefiniteSolution の例外を発生させる。
mate
- 他の直線JgclIndefiniteSolution
- 二直線はオーバーラップしており、解が不定であるJgclConditionOfOperation
,
JgclVector3D.parallelDirection(JgclVector3D)
public JgclIntersectionPoint3D[] intersect(JgclParametricSurface3D mate) throws JgclIndefiniteSolution
交点が存在しないときは長さ 0 の配列を返す。
JgclParametricCurve3D
内の intersect
mate
- 他の曲面JgclIndefiniteSolution
- 解が不定であるpublic JgclIntersectionPoint3D[] intersect(JgclPlane3D mate) throws JgclIndefiniteSolution
交点が存在しないときは長さ 0 の配列を返す。
mate
- 他の曲面 (平面)JgclIndefiniteSolution
- this が mate に乗っており、解が不定であるpublic JgclPointOnCurve3D project1From(JgclPoint3D point)
内部処理は以下の通り。
(point - this.pnt) と (this.dir の単位ベクトル) の内積の値を
この直線に対する投影点のパラメータ値とし、
そのパラメータ値を持つ JgclPointOnCurve3D のインスタンスを返す。
point
- 投影元の点projectFrom(JgclPoint3D)
public JgclParametricCurve3D parallelTranslate(JgclVector3D moveVec)
JgclParametricCurve3D
内の parallelTranslate
moveVec
- 平行移動の方向と量を表すベクトル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、そうでなければ falsetransformationOperator
- 幾何的変換演算子transformedGeometries
- 既に同様の変換を施した幾何要素を含むハッシュテーブルprotected void output(java.io.PrintWriter writer, int indent)
JgclGeometry
内の output
writer
- PrintWriterindent
- インデントの深さJgclGeometry
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |