jp.go.ipa.jgcl
クラス JgclPolyline2D

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

public class JgclPolyline2D
extends JgclBoundedCurve2D

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 を越えない最大の整数。

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

コンストラクタの概要
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
 
クラス jp.go.ipa.jgcl.JgclGeometry から継承したメソッド
getClassName, getToleranceForAngle, getToleranceForAngleAsObject, getToleranceForDistance, getToleranceForDistance2, getToleranceForDistanceAsObject, getToleranceForParameter, getToleranceForParameterAsObject, getToleranceForRealNumber, getToleranceForRealNumberAsObject, is1D, is3D, isPlacement, isPoint, isSurface, isTransformationOperator, isVector, makeIndent, output
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

JgclPolyline2D

public JgclPolyline2D(JgclPoint2D[] points,
                      boolean closed)
節点と閉じた形式か否かを表すフラグを与えてオブジェクトを構築する。

closed が false の場合、 points の要素数が 2 より小さければ JgclInvalidArgumentValue の例外を発生する。

closed が true の場合、 points の要素数が 3 より小さければ JgclInvalidArgumentValue の例外を発生する。

パラメータ:
points - 節点の配列
closed - 閉じているか否かを表すフラグ
関連項目:
JgclInvalidArgumentValue

JgclPolyline2D

public JgclPolyline2D(JgclPoint2D[] points)
節点を与えて開いた形式としてオブジェクトを構築する。

points の要素数が 2 より小さければ JgclInvalidArgumentValue の例外を発生する。

パラメータ:
points - 節点の配列
関連項目:
JgclInvalidArgumentValue

JgclPolyline2D

public JgclPolyline2D(JgclBoundedCurve2D curve,
                      JgclToleranceForDistance tol)
与えられた有限曲線を指定の許容誤差で直線近似するものとしてオブジェクトを構築する。
パラメータ:
curve - 有限曲線
tol - 距離の許容誤差
関連項目:
JgclBoundedCurve2D.toPolyline(JgclToleranceForDistance)

JgclPolyline2D

public JgclPolyline2D(JgclParametricCurve2D curve,
                      JgclParameterSection pint,
                      JgclToleranceForDistance tol)
与えられた曲線の指定の区間を指定の許容誤差で直線近似するものとしてオブジェクトを構築する。
パラメータ:
curve - 曲線
pint - 直線近似するパラメータ区間
tol - 距離の許容誤差
関連項目:
JgclParametricCurve2D.toPolyline(JgclParameterSection, JgclToleranceForDistance)
メソッドの詳細

points

public JgclPoint2D[] points()
このポリラインの節点の配列を返す。
戻り値:
節点の配列

pointAt

public JgclPoint2D pointAt(int i)
このポリラインの i 番めの節点を返す。

このポリラインが閉じた形式で、i が節点の数に等しい場合は、0 番目の節点を返す。

戻り値:
i 番めの節点

closed

public boolean closed()
このポリラインが閉じた形式であるか否かを返す。
戻り値:
閉じた形式であれば true、さもなくば false

nPoints

public int nPoints()
このポリラインの節点の数を返す。
戻り値:
節点の数

nSegments

public int nSegments()
このポリラインのセグメントの数を返す。

このポリラインが閉じた形式であれば、 セグメントの数は節点の数に等しい。 開いた形式であれば (節点の数 - 1) を返す。

戻り値:
セグメントの数

length

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

pint の増分値は負でもかまわない。

与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

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

coordinates

public JgclPoint2D coordinates(double param)
この曲線の、与えられたパラメータ値での座標値を返す。

与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の coordinates
パラメータ:
param - パラメータ値
戻り値:
座標値
関連項目:
JgclParametricCurve.checkValidity(double), JgclParameterOutOfRange

tangentVector

public JgclVector2D tangentVector(double param)
この曲線の、与えられたパラメータ値での接ベクトルを返す。

与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の tangentVector
パラメータ:
param - パラメータ値
戻り値:
接ベクトル
関連項目:
JgclParametricCurve.checkValidity(double), JgclParameterOutOfRange

curvature

public JgclCurveCurvature2D curvature(double param)
この曲線の、与えられたパラメータ値での曲率を返す。

ポリラインの曲率は、常に 0 である。

与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の curvature
パラメータ:
param - パラメータ値
戻り値:
曲率
関連項目:
JgclParametricCurve.checkValidity(double), JgclParameterOutOfRange

evaluation

public JgclCurveDerivative2D evaluation(double param)
この曲線の、与えられたパラメータ値での導関数を返す。

与えられたパラメータ区間が定義域を外れている場合には、 JgclParameterOutOfRange の例外を発生する。

オーバーライド:
クラス JgclParametricCurve2D 内の evaluation
パラメータ:
param - パラメータ値
戻り値:
導関数
関連項目:
JgclParametricCurve.checkValidity(double), JgclParameterOutOfRange

singular

public JgclPointOnCurve2D[] singular()
この曲線の特異点を返す。

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

オーバーライド:
クラス JgclParametricCurve2D 内の singular
戻り値:
特異点の配列

inflexion

public JgclPointOnCurve2D[] inflexion()
この曲線の変曲点を返す。

ポリラインには変曲点は存在しないものとして、長さ 0 の配列を返す。

オーバーライド:
クラス JgclParametricCurve2D 内の inflexion
戻り値:
変曲点の配列

projectFrom

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

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

オーバーライド:
クラス JgclParametricCurve2D 内の projectFrom
パラメータ:
point - 投影元の点
戻り値:
投影点

toPolyline

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

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

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

toBsplineCurve

public JgclBsplineCurve2D toBsplineCurve()
この有限曲線全体を厳密に再現する有理 Bspline 曲線を返す。
オーバーライド:
クラス JgclBoundedCurve2D 内の toBsplineCurve
戻り値:
この曲線全体を再現する有理 Bspline 曲線

toBsplineCurve

public JgclBsplineCurve2D toBsplineCurve(JgclParameterSection pint)
この曲線の指定の区間を厳密に再現する有理 Bspline 曲線を返す。
オーバーライド:
クラス JgclParametricCurve2D 内の toBsplineCurve
パラメータ:
pint - 有理 Bspline 曲線で再現するパラメータ区間
戻り値:
この曲線の指定の区間を再現する有理 Bspline 曲線

intersect

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

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

オーバーライド:
クラス JgclParametricCurve2D 内の intersect
パラメータ:
mate - 他の曲線
戻り値:
交点の配列

interfere

public JgclCurveCurveInterference2D[] interfere(JgclBoundedCurve2D mate)
この有限曲線と他の有界曲線の干渉を求める。

干渉が存在しない場合には長さ 0 の配列を返す。

オーバーライド:
クラス JgclBoundedCurve2D 内の interfere
パラメータ:
mate - 他の曲線
戻り値:
二曲線の干渉の配列

selfIntersect

public JgclIntersectionPoint2D[] selfIntersect()
このポリラインの自己交差点を求める。

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

戻り値:
自己交差点の配列

selfInterfere

public JgclCurveCurveInterference2D[] selfInterfere()
このポリラインの自己干渉を求める。

自己干渉が存在しないときは長さ 0 の配列を返す。

戻り値:
自己干渉の配列

offsetByCompositeCurve

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

結果として得られる複合曲線はこのポリラインのオフセット曲線を常に厳密に再現する。 よって、このメソッドの内部では tol の値は参照しない。

パラメータ:
pint - オフセットするパラメータ区間
magni - オフセット量
side - オフセットの向き (JgclWhichSide.LEFT/RIGHT)
tol - 距離の許容誤差
戻り値:
この曲線の指定の区間のオフセット曲線を近似する複合曲線
関連項目:
JgclWhichSide

offsetByBsplineCurve

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

結果として得られる Bspline 曲線はこのポリラインのオフセット曲線を常に厳密に再現する。 よって、このメソッドの内部では tol の値は参照しない。

オーバーライド:
クラス JgclParametricCurve2D 内の offsetByBsplineCurve
パラメータ:
pint - オフセットするパラメータ区間
magni - オフセット量
side - オフセットの向き (JgclWhichSide.LEFT/RIGHT)
tol - 距離の許容誤差
戻り値:
この曲線の指定の区間のオフセット曲線を近似する Bspline 曲線
関連項目:
JgclWhichSide

offsetByBoundedCurve

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

結果として得られる有限曲線はこのポリラインのオフセット曲線を常に厳密に再現する。 よって、このメソッドの内部では tol の値は参照しない。

オーバーライド:
クラス 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 - いまのところ、実装されない機能である

isFreeform

public boolean isFreeform()
この幾何要素が自由形状か否かを返す。
オーバーライド:
クラス JgclGeometry 内の isFreeform
戻り値:
常に true

startPoint

public JgclPoint2D startPoint()
この有限曲線の開始点を返す。

曲線が閉じた形式の場合は null を返す。

オーバーライド:
クラス JgclBoundedCurve2D 内の startPoint
戻り値:
開始点

endPoint

public JgclPoint2D endPoint()
この有限曲線の終了点を返す。

曲線が閉じた形式の場合は null を返す。

オーバーライド:
クラス JgclBoundedCurve2D 内の endPoint
戻り値:
終了点

toBoundedLines

public JgclBoundedLine2D[] toBoundedLines(JgclParameterSection pint)
このポリラインの指定の区間を線分列に変換する。
パラメータ:
pint - 線分列に変換するパラメータ区間
戻り値:
指定された区間を変換した線分列

toBoundedLines

public JgclBoundedLine2D[] toBoundedLines()
このポリライン全体を線分列に変換する。
戻り値:
曲線全体を変換した線分列

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 - 既に同様の変換を施した幾何要素を含むハッシュテーブル
戻り値:
変換後の幾何要素

hasPolyline

protected boolean hasPolyline()
この曲線がポリラインの部分を含むか否かを返す。
オーバーライド:
クラス JgclParametricCurve2D 内の hasPolyline
戻り値:
常に true

isComposedOfOnlyPolylines

protected boolean isComposedOfOnlyPolylines()
この曲線がポリラインの部分だけでできているか否かを返す。
オーバーライド:
クラス JgclParametricCurve2D 内の isComposedOfOnlyPolylines
戻り値:
常に true

output

protected void output(java.io.PrintWriter writer,
                      int indent)
出力ストリームに形状情報を出力する。
オーバーライド:
クラス JgclGeometry 内の output
パラメータ:
writer - PrintWriter
indent - インデントの深さ
関連項目:
JgclGeometry