|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--jp.go.ipa.jgcl.JgclGeometry | +--jp.go.ipa.jgcl.JgclParametricCurve | +--jp.go.ipa.jgcl.JgclParametricCurve2D | +--jp.go.ipa.jgcl.JgclBoundedCurve2D | +--jp.go.ipa.jgcl.JgclPolyline2D
2次元 : ポリラインを表すクラス。
ポリラインは、節点の列 points と 閉じた形式か否かを表すフラグ closed で定義される。
closed の値が true であれば閉じた形式として、false であれば開いた形式として扱われる。 閉じた形式のポリラインは、 常に最初と最後の節点を結ぶ線分があるものとして扱われる。
ポリラインのパラメータ定義域は、 隣接する節点の間のパラメータ区間の大きさを常に 1 として、 曲線全域では [0, N] となる。 ここで N は、 ポリラインが開いた形式であれば (節点の数 - 1)、 閉じた形式であれば (節点の数) になる。
t をパラメータとするポリライン P(t) のパラメトリック表現は、以下の通り。
P(t) = (1 - (t - s)) * points[s] + (t - s) * points[s + 1]ここで s は t を越えない最大の整数。
コンストラクタの概要 | |
JgclPolyline2D(JgclBoundedCurve2D curve,
JgclToleranceForDistance tol)
与えられた有限曲線を指定の許容誤差で直線近似するものとしてオブジェクトを構築する。 |
|
JgclPolyline2D(JgclParametricCurve2D curve,
JgclParameterSection pint,
JgclToleranceForDistance tol)
与えられた曲線の指定の区間を指定の許容誤差で直線近似するものとしてオブジェクトを構築する。 |
|
JgclPolyline2D(JgclPoint2D[] points)
節点を与えて開いた形式としてオブジェクトを構築する。 |
|
JgclPolyline2D(JgclPoint2D[] points,
boolean closed)
節点と閉じた形式か否かを表すフラグを与えてオブジェクトを構築する。 |
メソッドの概要 | |
boolean |
closed()
このポリラインが閉じた形式であるか否かを返す。 |
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)
この曲線を、与えられた幾何的変換演算子で変換する。 |
JgclPoint2D |
endPoint()
この有限曲線の終了点を返す。 |
JgclCurveDerivative2D |
evaluation(double param)
この曲線の、与えられたパラメータ値での導関数を返す。 |
protected boolean |
hasPolyline()
この曲線がポリラインの部分を含むか否かを返す。 |
JgclPointOnCurve2D[] |
inflexion()
この曲線の変曲点を返す。 |
JgclCurveCurveInterference2D[] |
interfere(JgclBoundedCurve2D mate)
この有限曲線と他の有界曲線の干渉を求める。 |
JgclIntersectionPoint2D[] |
intersect(JgclParametricCurve2D mate)
この曲線と他の曲線の交点を求める。 |
protected boolean |
isComposedOfOnlyPolylines()
この曲線がポリラインの部分だけでできているか否かを返す。 |
boolean |
isFreeform()
この幾何要素が自由形状か否かを返す。 |
double |
length(JgclParameterSection pint)
与えられたパラメータ区間におけるこの曲線の実空間上での長さ (道のり) を返す。 |
int |
nPoints()
このポリラインの節点の数を返す。 |
int |
nSegments()
このポリラインのセグメントの数を返す。 |
JgclBoundedCurve2D |
offsetByBoundedCurve(JgclParameterSection pint,
double magni,
int side,
JgclToleranceForDistance tol)
この曲線の指定の区間をオフセットした曲線を、 与えられた誤差で近似する有限曲線を求める。 |
JgclBsplineCurve2D |
offsetByBsplineCurve(JgclParameterSection pint,
double magni,
int side,
JgclToleranceForDistance tol)
この曲線の指定の区間をオフセットした曲線を、 与えられた誤差で近似する Bspline 曲線を求める。 |
JgclCompositeCurve2D |
offsetByCompositeCurve(JgclParameterSection pint,
double magni,
int side,
JgclToleranceForDistance tol)
この曲線の指定の区間をオフセットした曲線を、 与えられた誤差で近似する複合曲線を求める。 |
protected void |
output(java.io.PrintWriter writer,
int indent)
出力ストリームに形状情報を出力する。 |
JgclPoint2D |
pointAt(int i)
このポリラインの i 番めの節点を返す。 |
JgclPoint2D[] |
points()
このポリラインの節点の配列を返す。 |
JgclPointOnCurve2D[] |
projectFrom(JgclPoint2D point)
与えられた点からこの曲線への投影点を求める。 |
JgclCurveCurveInterference2D[] |
selfInterfere()
このポリラインの自己干渉を求める。 |
JgclIntersectionPoint2D[] |
selfIntersect()
このポリラインの自己交差点を求める。 |
JgclPointOnCurve2D[] |
singular()
この曲線の特異点を返す。 |
JgclPoint2D |
startPoint()
この有限曲線の開始点を返す。 |
JgclVector2D |
tangentVector(double param)
この曲線の、与えられたパラメータ値での接ベクトルを返す。 |
JgclBoundedLine2D[] |
toBoundedLines()
このポリライン全体を線分列に変換する。 |
JgclBoundedLine2D[] |
toBoundedLines(JgclParameterSection pint)
このポリラインの指定の区間を線分列に変換する。 |
JgclBsplineCurve2D |
toBsplineCurve()
この有限曲線全体を厳密に再現する有理 Bspline 曲線を返す。 |
JgclBsplineCurve2D |
toBsplineCurve(JgclParameterSection pint)
この曲線の指定の区間を厳密に再現する有理 Bspline 曲線を返す。 |
JgclPolyline2D |
toPolyline(JgclParameterSection pint,
JgclToleranceForDistance tol)
この曲線の指定の区間を、与えられた誤差で直線近似するポリラインを返す。 |
クラス jp.go.ipa.jgcl.JgclBoundedCurve2D から継承したメソッド |
fillet, length, offsetByBoundedCurve, offsetByBsplineCurve, toPolyline |
クラス jp.go.ipa.jgcl.JgclParametricCurve2D から継承したメソッド |
checkProjection, dimension, fillet, identicalParameter, is2D, 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 JgclPolyline2D(JgclPoint2D[] points, boolean closed)
closed が false の場合、 points の要素数が 2 より小さければ JgclInvalidArgumentValue の例外を発生する。
closed が true の場合、 points の要素数が 3 より小さければ JgclInvalidArgumentValue の例外を発生する。
points
- 節点の配列closed
- 閉じているか否かを表すフラグJgclInvalidArgumentValue
public JgclPolyline2D(JgclPoint2D[] points)
points の要素数が 2 より小さければ JgclInvalidArgumentValue の例外を発生する。
points
- 節点の配列JgclInvalidArgumentValue
public JgclPolyline2D(JgclBoundedCurve2D curve, JgclToleranceForDistance tol)
curve
- 有限曲線tol
- 距離の許容誤差JgclBoundedCurve2D.toPolyline(JgclToleranceForDistance)
public JgclPolyline2D(JgclParametricCurve2D curve, JgclParameterSection pint, JgclToleranceForDistance tol)
curve
- 曲線pint
- 直線近似するパラメータ区間tol
- 距離の許容誤差JgclParametricCurve2D.toPolyline(JgclParameterSection, JgclToleranceForDistance)
メソッドの詳細 |
public JgclPoint2D[] points()
public JgclPoint2D pointAt(int i)
このポリラインが閉じた形式で、i が節点の数に等しい場合は、0 番目の節点を返す。
public boolean closed()
public int nPoints()
public int nSegments()
このポリラインが閉じた形式であれば、 セグメントの数は節点の数に等しい。 開いた形式であれば (節点の数 - 1) を返す。
public double length(JgclParameterSection pint)
pint の増分値は負でもかまわない。
与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve
内の length
pint
- 曲線の長さを求めるパラメータ区間JgclParameterOutOfRange
public JgclPoint2D coordinates(double param)
与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve2D
内の coordinates
param
- パラメータ値JgclParametricCurve.checkValidity(double)
,
JgclParameterOutOfRange
public JgclVector2D tangentVector(double param)
与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve2D
内の tangentVector
param
- パラメータ値JgclParametricCurve.checkValidity(double)
,
JgclParameterOutOfRange
public JgclCurveCurvature2D curvature(double param)
ポリラインの曲率は、常に 0 である。
与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve2D
内の curvature
param
- パラメータ値JgclParametricCurve.checkValidity(double)
,
JgclParameterOutOfRange
public JgclCurveDerivative2D evaluation(double param)
与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。
JgclParametricCurve2D
内の evaluation
param
- パラメータ値JgclParametricCurve.checkValidity(double)
,
JgclParameterOutOfRange
public JgclPointOnCurve2D[] singular()
特異点が存在しないときは長さ 0 の配列を返す。
JgclParametricCurve2D
内の singular
public JgclPointOnCurve2D[] inflexion()
ポリラインには変曲点は存在しないものとして、長さ 0 の配列を返す。
JgclParametricCurve2D
内の inflexion
public JgclPointOnCurve2D[] projectFrom(JgclPoint2D point)
投影点が存在しないときは長さ 0 の配列を返す。
JgclParametricCurve2D
内の projectFrom
point
- 投影元の点public JgclPolyline2D toPolyline(JgclParameterSection pint, JgclToleranceForDistance tol)
結果として返されるポリラインを構成する点は この曲線をベースとする JgclPointOnCurve2D で あることを期待できる。
JgclParametricCurve2D
内の toPolyline
pint
- 直線近似するパラメータ区間tol
- 距離の許容誤差public JgclBsplineCurve2D toBsplineCurve()
JgclBoundedCurve2D
内の toBsplineCurve
public JgclBsplineCurve2D toBsplineCurve(JgclParameterSection pint)
JgclParametricCurve2D
内の toBsplineCurve
pint
- 有理 Bspline 曲線で再現するパラメータ区間public JgclIntersectionPoint2D[] intersect(JgclParametricCurve2D mate)
交点が存在しないときは長さ 0 の配列を返す。
JgclParametricCurve2D
内の intersect
mate
- 他の曲線public JgclCurveCurveInterference2D[] interfere(JgclBoundedCurve2D mate)
干渉が存在しない場合には長さ 0 の配列を返す。
JgclBoundedCurve2D
内の interfere
mate
- 他の曲線public JgclIntersectionPoint2D[] selfIntersect()
自己交差が存在しないときは長さ 0 の配列を返す。
public JgclCurveCurveInterference2D[] selfInterfere()
自己干渉が存在しないときは長さ 0 の配列を返す。
public JgclCompositeCurve2D offsetByCompositeCurve(JgclParameterSection pint, double magni, int side, JgclToleranceForDistance tol)
結果として得られる複合曲線はこのポリラインのオフセット曲線を常に厳密に再現する。 よって、このメソッドの内部では tol の値は参照しない。
pint
- オフセットするパラメータ区間magni
- オフセット量side
- オフセットの向き (JgclWhichSide.LEFT/RIGHT)tol
- 距離の許容誤差JgclWhichSide
public JgclBsplineCurve2D offsetByBsplineCurve(JgclParameterSection pint, double magni, int side, JgclToleranceForDistance tol)
結果として得られる Bspline 曲線はこのポリラインのオフセット曲線を常に厳密に再現する。 よって、このメソッドの内部では tol の値は参照しない。
JgclParametricCurve2D
内の offsetByBsplineCurve
pint
- オフセットするパラメータ区間magni
- オフセット量side
- オフセットの向き (JgclWhichSide.LEFT/RIGHT)tol
- 距離の許容誤差JgclWhichSide
public JgclBoundedCurve2D offsetByBoundedCurve(JgclParameterSection pint, double magni, int side, JgclToleranceForDistance tol)
結果として得られる有限曲線はこのポリラインのオフセット曲線を常に厳密に再現する。 よって、このメソッドの内部では tol の値は参照しない。
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
- いまのところ、実装されない機能であるpublic boolean isFreeform()
JgclGeometry
内の isFreeform
public JgclPoint2D startPoint()
曲線が閉じた形式の場合は null を返す。
JgclBoundedCurve2D
内の startPoint
public JgclPoint2D endPoint()
曲線が閉じた形式の場合は null を返す。
JgclBoundedCurve2D
内の endPoint
public JgclBoundedLine2D[] toBoundedLines(JgclParameterSection pint)
pint
- 線分列に変換するパラメータ区間public JgclBoundedLine2D[] toBoundedLines()
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 boolean hasPolyline()
JgclParametricCurve2D
内の hasPolyline
protected boolean isComposedOfOnlyPolylines()
JgclParametricCurve2D
内の isComposedOfOnlyPolylines
protected void output(java.io.PrintWriter writer, int indent)
JgclGeometry
内の output
writer
- PrintWriterindent
- インデントの深さJgclGeometry
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |