org.jscience.mathematics.geometry
Class Polyline2D

java.lang.Object
  extended by org.jscience.mathematics.geometry.GeometryElement
      extended by org.jscience.mathematics.geometry.AbstractParametricCurve
          extended by org.jscience.mathematics.geometry.ParametricCurve2D
              extended by org.jscience.mathematics.geometry.BoundedCurve2D
                  extended by org.jscience.mathematics.geometry.Polyline2D
All Implemented Interfaces:
java.io.Serializable

public class Polyline2D
extends BoundedCurve2D

�Q���� : �|�����C����\���N���X?B

�|�����C����?A?ߓ_�̗� points �� �‚����`�����ۂ���\���t���O closed �Œ�`�����?B

closed �̒l�� true �ł���Ε‚����`���Ƃ���?Afalse �ł���ΊJ�����`���Ƃ��Ĉ�����?B �‚����`���̃|�����C����?A ?��?�?���?Ō��?ߓ_�싂�?�����̂Ƃ��Ĉ�����?B

�|�����C���̃p���??[�^��`���?A ��?ڂ���?ߓ_�̊Ԃ̃p���??[�^��Ԃ̑傫����?�� 1 �Ƃ���?A ��?�S��ł� [0, N] �ƂȂ�?B ������ N ��?A �|�����C�����J�����`���ł���� (?ߓ_��?� - 1)?A �‚����`���ł���� (?ߓ_��?�) �ɂȂ�?B

t ��p���??[�^�Ƃ���|�����C�� P(t) �̃p���?�g���b�N�\����?A�ȉ��̒ʂ�?B

        P(t) = (1 - (t - s)) * points[s] + (t - s) * points[s + 1]
 
������ s �� t ��z���Ȃ�?ő��?�?�?B

See Also:
Serialized Form

Constructor Summary
Polyline2D(BoundedCurve2D curve, ToleranceForDistance tol)
          �^����ꂽ�L� �?
Polyline2D(ParametricCurve2D curve, ParameterSection pint, ToleranceForDistance tol)
          �^����ꂽ��?
Polyline2D(Point2D[] points)
          ?
Polyline2D(Point2D[] points, boolean closed)
          ?
 
Method Summary
 boolean closed()
          ���̃|�����C�����‚����`���ł��邩�ۂ���Ԃ�?
 CommonNormal2D[] commonNormal(ParametricCurve2D mate)
          ���̋�?
 CommonTangent2D[] commonTangent(ParametricCurve2D mate)
          ���̋�?
 Point2D coordinates(double param)
          ���̋�?
 CurveCurvature2D curvature(double param)
          ���̋�?
protected  ParametricCurve2D doTransformBy(boolean reverseTransform, CartesianTransformationOperator2D transformationOperator, java.util.Hashtable transformedGeometries)
          ���̋�?
 Point2D endPoint()
          ���̗L� �?
 CurveDerivative2D evaluation(double param)
          ���̋�?
protected  boolean hasPolyline()
          ���̋�?
 PointOnCurve2D[] inflexion()
          ���̋�?
 CurveCurveInterference2D[] interfere(BoundedCurve2D mate)
          ���̗L� �?
 IntersectionPoint2D[] intersect(ParametricCurve2D mate)
          ���̋�?
protected  boolean isComposedOfOnlyPolylines()
          ���̋�?
 boolean isFreeform()
          ���̊􉽗v�f�����R�`?
 double length(ParameterSection pint)
          �^����ꂽ�p���??
 int nPoints()
          ���̃|�����C����?
 int nSegments()
          ���̃|�����C���̃Z�O�?
 BoundedCurve2D offsetByBoundedCurve(ParameterSection pint, double magni, int side, ToleranceForDistance tol)
          ���̋�?
 BsplineCurve2D offsetByBsplineCurve(ParameterSection pint, double magni, int side, ToleranceForDistance tol)
          ���̋�?
 CompositeCurve2D offsetByCompositeCurve(ParameterSection pint, double magni, int side, ToleranceForDistance tol)
          ���̋�?
protected  void output(java.io.PrintWriter writer, int indent)
          ?
 Point2D pointAt(int i)
          ���̃|�����C���� i �Ԃ߂�?
 Point2D[] points()
          ���̃|�����C����?
 PointOnCurve2D[] projectFrom(Point2D point)
          �^����ꂽ�_���炱�̋�?
 CurveCurveInterference2D[] selfInterfere()
          ���̃|�����C���̎��Ȋ�?
 IntersectionPoint2D[] selfIntersect()
          ���̃|�����C���̎��Ȍ�?
 PointOnCurve2D[] singular()
          ���̋�?
 Point2D startPoint()
          ���̗L� �?
 Vector2D tangentVector(double param)
          ���̋�?
 BoundedLine2D[] toBoundedLines()
          ���̃|�����C���S�̂�?
 BoundedLine2D[] toBoundedLines(ParameterSection pint)
          ���̃|�����C���̎w��̋�Ԃ�?
 BsplineCurve2D toBsplineCurve()
          ���̗L� �?
 BsplineCurve2D toBsplineCurve(ParameterSection pint)
          ���̋�?
 Polyline2D toPolyline(ParameterSection pint, ToleranceForDistance tol)
          ���̋�?
 
Methods inherited from class org.jscience.mathematics.geometry.BoundedCurve2D
fillet, length, offsetByBoundedCurve, offsetByBsplineCurve, toPolyline
 
Methods inherited from class org.jscience.mathematics.geometry.ParametricCurve2D
checkProjection, dimension, fillet, identicalParameter, is2D, nearestProjectFrom, nearestProjectWithDistanceFrom, pointToParameter, reverseTransformBy, transformBy, transformBy
 
Methods inherited from class org.jscience.mathematics.geometry.AbstractParametricCurve
checkValidity, checkValidity, isClosed, isCurve, isFinite, isInfinite, isNonPeriodic, isOpen, isParametric, isPeriodic, isValid, parameterDomain
 
Methods inherited from class org.jscience.mathematics.geometry.GeometryElement
getClassName, getToleranceForAngle, getToleranceForAngleAsObject, getToleranceForDistance, getToleranceForDistance2, getToleranceForDistanceAsObject, getToleranceForParameter, getToleranceForParameterAsObject, getToleranceForRealNumber, getToleranceForRealNumberAsObject, is1D, is3D, isPlacement, isPoint, isSurface, isTransformationOperator, isVector, makeIndent, output
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Polyline2D

public Polyline2D(Point2D[] points,
                  boolean closed)
?ߓ_�ƕ‚����`�����ۂ���\���t���O��^���ăI�u�W�F�N�g��?\�z����?B

closed �� false ��?�?�?A points �̗v�f?��� 2 ���?�������� InvalidArgumentValueException �̗�O��?�����?B

closed �� true ��?�?�?A points �̗v�f?��� 3 ���?�������� InvalidArgumentValueException �̗�O��?�����?B

Parameters:
points - ?ߓ_�̔z��
closed - �‚��Ă��邩�ۂ���\���t���O
See Also:
InvalidArgumentValueException

Polyline2D

public Polyline2D(Point2D[] points)
?ߓ_��^���ĊJ�����`���Ƃ��ăI�u�W�F�N�g��?\�z����?B

points �̗v�f?��� 2 ���?�������� InvalidArgumentValueException �̗�O��?�����?B

Parameters:
points - ?ߓ_�̔z��
See Also:
InvalidArgumentValueException

Polyline2D

public Polyline2D(BoundedCurve2D curve,
                  ToleranceForDistance tol)
�^����ꂽ�L� �?��w��̋��e��?��Œ�?�ߎ������̂Ƃ��ăI�u�W�F�N�g��?\�z����?B

Parameters:
curve - �L� �?�
tol - �����̋��e��?�
See Also:
BoundedCurve2D.toPolyline(ToleranceForDistance)

Polyline2D

public Polyline2D(ParametricCurve2D curve,
                  ParameterSection pint,
                  ToleranceForDistance tol)
�^����ꂽ��?�̎w��̋�Ԃ�w��̋��e��?��Œ�?�ߎ������̂Ƃ��ăI�u�W�F�N�g��?\�z����?B

Parameters:
curve - ��?�
pint - ��?�ߎ�����p���??[�^���
tol - �����̋��e��?�
See Also:
ParametricCurve2D.toPolyline(ParameterSection,ToleranceForDistance)
Method Detail

points

public Point2D[] points()
���̃|�����C����?ߓ_�̔z���Ԃ�?B

Returns:
?ߓ_�̔z��

pointAt

public Point2D pointAt(int i)
���̃|�����C���� i �Ԃ߂�?ߓ_��Ԃ�?B

���̃|�����C�����‚����`����?Ai ��?ߓ_��?��ɓ�����?�?���?A0 �Ԗڂ�?ߓ_��Ԃ�?B

Returns:
i �Ԃ߂�?ߓ_

closed

public boolean closed()
���̃|�����C�����‚����`���ł��邩�ۂ���Ԃ�?B

Returns:
�‚����`���ł���� true?A����Ȃ��� false

nPoints

public int nPoints()
���̃|�����C����?ߓ_��?���Ԃ�?B

Returns:
?ߓ_��?�

nSegments

public int nSegments()
���̃|�����C���̃Z�O�?���g��?���Ԃ�?B

���̃|�����C�����‚����`���ł����?A �Z�O�?���g��?���?ߓ_��?��ɓ�����?B �J�����`���ł���� (?ߓ_��?� - 1) ��Ԃ�?B

Returns:
�Z�O�?���g��?�

length

public double length(ParameterSection pint)
�^����ꂽ�p���??[�^��Ԃɂ����邱�̋�?�̎ ��?�ł̒��� (���̂�) ��Ԃ�?B

pint �̑?���l�͕��ł©�܂�Ȃ�?B

�^����ꂽ�p���??[�^��Ԃ���`���O��Ă���?�?��ɂ�?A ParameterOutOfRange �̗�O��?�����?B

Specified by:
length in class AbstractParametricCurve
Parameters:
pint - ��?�̒�����?�߂�p���??[�^���
Returns:
�w�肳�ꂽ�p���??[�^��Ԃɂ������?�̒���
See Also:
ParameterOutOfRange

coordinates

public Point2D coordinates(double param)
���̋�?��?A�^����ꂽ�p���??[�^�l�ł�?W�l��Ԃ�?B

�^����ꂽ�p���??[�^��Ԃ���`���O��Ă���?�?��ɂ�?A ParameterOutOfRange �̗�O��?�����?B

Specified by:
coordinates in class ParametricCurve2D
Parameters:
param - �p���??[�^�l
Returns:
?W�l
See Also:
AbstractParametricCurve.checkValidity(double), ParameterOutOfRange

tangentVector

public Vector2D tangentVector(double param)
���̋�?��?A�^����ꂽ�p���??[�^�l�ł�?ڃx�N�g����Ԃ�?B

�^����ꂽ�p���??[�^��Ԃ���`���O��Ă���?�?��ɂ�?A ParameterOutOfRange �̗�O��?�����?B

Specified by:
tangentVector in class ParametricCurve2D
Parameters:
param - �p���??[�^�l
Returns:
?ڃx�N�g��
See Also:
AbstractParametricCurve.checkValidity(double), ParameterOutOfRange

curvature

public CurveCurvature2D curvature(double param)
���̋�?��?A�^����ꂽ�p���??[�^�l�ł̋ȗ���Ԃ�?B

�|�����C���̋ȗ���?A?�� 0 �ł���?B

�^����ꂽ�p���??[�^��Ԃ���`���O��Ă���?�?��ɂ�?A ParameterOutOfRange �̗�O��?�����?B

Specified by:
curvature in class ParametricCurve2D
Parameters:
param - �p���??[�^�l
Returns:
�ȗ�
See Also:
AbstractParametricCurve.checkValidity(double), ParameterOutOfRange

evaluation

public CurveDerivative2D evaluation(double param)
���̋�?��?A�^����ꂽ�p���??[�^�l�ł̓���?���Ԃ�?B

�^����ꂽ�p���??[�^��Ԃ���`���O��Ă���?�?��ɂ�?A ParameterOutOfRange �̗�O��?�����?B

Specified by:
evaluation in class ParametricCurve2D
Parameters:
param - �p���??[�^�l
Returns:
����?�
See Also:
AbstractParametricCurve.checkValidity(double), ParameterOutOfRange

singular

public PointOnCurve2D[] singular()
���̋�?�̓Hٓ_��Ԃ�?B

�Hٓ_����?݂��Ȃ��Ƃ��͒��� 0 �̔z���Ԃ�?B

Specified by:
singular in class ParametricCurve2D
Returns:
�Hٓ_�̔z��

inflexion

public PointOnCurve2D[] inflexion()
���̋�?�̕ϋȓ_��Ԃ�?B

�|�����C���ɂ͕ϋȓ_�͑�?݂��Ȃ���̂Ƃ���?A���� 0 �̔z���Ԃ�?B

Specified by:
inflexion in class ParametricCurve2D
Returns:
�ϋȓ_�̔z��

projectFrom

public PointOnCurve2D[] projectFrom(Point2D point)
�^����ꂽ�_���炱�̋�?�ւ̓��e�_��?�߂�?B

���e�_����?݂��Ȃ��Ƃ��͒��� 0 �̔z���Ԃ�?B

Specified by:
projectFrom in class ParametricCurve2D
Parameters:
point - ���e���̓_
Returns:
���e�_

toPolyline

public Polyline2D toPolyline(ParameterSection pint,
                             ToleranceForDistance tol)
���̋�?�̎w��̋�Ԃ�?A�^����ꂽ��?��Œ�?�ߎ�����|�����C����Ԃ�?B

���ʂƂ��ĕԂ����|�����C����?\?�����_�� ���̋�?��x?[�X�Ƃ��� PointOnCurve2D �� ���邱�Ƃ��҂ł���?B

Specified by:
toPolyline in class ParametricCurve2D
Parameters:
pint - ��?�ߎ�����p���??[�^���
tol - �����̋��e��?�
Returns:
���̋�?�̎w��̋�Ԃ�?�ߎ�����|�����C��
See Also:
PointOnCurve2D

toBsplineCurve

public BsplineCurve2D toBsplineCurve()
���̗L� �?�S�̂쵖���?Č�����L�? Bspline ��?��Ԃ�?B

Overrides:
toBsplineCurve in class BoundedCurve2D
Returns:
���̋�?�S�̂�?Č�����L�? Bspline ��?�

toBsplineCurve

public BsplineCurve2D toBsplineCurve(ParameterSection pint)
���̋�?�̎w��̋�Ԃ쵖���?Č�����L�? Bspline ��?��Ԃ�?B

Specified by:
toBsplineCurve in class ParametricCurve2D
Parameters:
pint - �L�? Bspline ��?��?�����p���??[�^���
Returns:
���̋�?�̎w��̋�Ԃ�?Č�����L�? Bspline ��?�

intersect

public IntersectionPoint2D[] intersect(ParametricCurve2D mate)
���̋�?�Ƒ��̋�?�̌�_��?�߂�?B

��_����?݂��Ȃ��Ƃ��͒��� 0 �̔z���Ԃ�?B

Specified by:
intersect in class ParametricCurve2D
Parameters:
mate - ���̋�?�
Returns:
��_�̔z��

interfere

public CurveCurveInterference2D[] interfere(BoundedCurve2D mate)
���̗L� �?�Ƒ��̗L�E��?�̊�?‚�?�߂�?B

��?‚���?݂��Ȃ�?�?��ɂ͒��� 0 �̔z���Ԃ�?B

Specified by:
interfere in class BoundedCurve2D
Parameters:
mate - ���̋�?�
Returns:
���?�̊�?‚̔z��

selfIntersect

public IntersectionPoint2D[] selfIntersect()
���̃|�����C���̎��Ȍ�?��_��?�߂�?B

���Ȍ�?�����?݂��Ȃ��Ƃ��͒��� 0 �̔z���Ԃ�?B

Returns:
���Ȍ�?��_�̔z��

selfInterfere

public CurveCurveInterference2D[] selfInterfere()
���̃|�����C���̎��Ȋ�?‚�?�߂�?B

���Ȋ�?‚���?݂��Ȃ��Ƃ��͒��� 0 �̔z���Ԃ�?B

Returns:
���Ȋ�?‚̔z��

offsetByCompositeCurve

public CompositeCurve2D offsetByCompositeCurve(ParameterSection pint,
                                               double magni,
                                               int side,
                                               ToleranceForDistance tol)
���̋�?�̎w��̋�Ԃ�I�t�Z�b�g������?��?A �^����ꂽ��?��ŋߎ����镡?���?��?�߂�?B

���ʂƂ��ē����镡?���?�͂��̃|�����C���̃I�t�Z�b�g��?��?�Ɍ�����?Č�����?B ��B�?A���̃?�\�b�h�̓Ք�ł� tol �̒l�͎Q?Ƃ��Ȃ�?B

Parameters:
pint - �I�t�Z�b�g����p���??[�^���
magni - �I�t�Z�b�g��
side - �I�t�Z�b�g�̌� (WhichSide.LEFT/RIGHT)
tol - �����̋��e��?�
Returns:
���̋�?�̎w��̋�Ԃ̃I�t�Z�b�g��?��ߎ����镡?���?�
See Also:
WhichSide

offsetByBsplineCurve

public BsplineCurve2D offsetByBsplineCurve(ParameterSection pint,
                                           double magni,
                                           int side,
                                           ToleranceForDistance tol)
���̋�?�̎w��̋�Ԃ�I�t�Z�b�g������?��?A �^����ꂽ��?��ŋߎ����� Bspline ��?��?�߂�?B

���ʂƂ��ē����� Bspline ��?�͂��̃|�����C���̃I�t�Z�b�g��?��?�Ɍ�����?Č�����?B ��B�?A���̃?�\�b�h�̓Ք�ł� tol �̒l�͎Q?Ƃ��Ȃ�?B

Specified by:
offsetByBsplineCurve in class ParametricCurve2D
Parameters:
pint - �I�t�Z�b�g����p���??[�^���
magni - �I�t�Z�b�g��
side - �I�t�Z�b�g�̌� (WhichSide.LEFT/RIGHT)
tol - �����̋��e��?�
Returns:
���̋�?�̎w��̋�Ԃ̃I�t�Z�b�g��?��ߎ����� Bspline ��?�
See Also:
WhichSide

offsetByBoundedCurve

public BoundedCurve2D offsetByBoundedCurve(ParameterSection pint,
                                           double magni,
                                           int side,
                                           ToleranceForDistance tol)
���̋�?�̎w��̋�Ԃ�I�t�Z�b�g������?��?A �^����ꂽ��?��ŋߎ�����L� �?��?�߂�?B

���ʂƂ��ē�����L� �?�͂��̃|�����C���̃I�t�Z�b�g��?��?�Ɍ�����?Č�����?B ��B�?A���̃?�\�b�h�̓Ք�ł� tol �̒l�͎Q?Ƃ��Ȃ�?B

Overrides:
offsetByBoundedCurve in class ParametricCurve2D
Parameters:
pint - �I�t�Z�b�g����p���??[�^���
magni - �I�t�Z�b�g��
side - �I�t�Z�b�g�̌� (WhichSide.LEFT/RIGHT)
tol - �����̋��e��?�
Returns:
���̋�?�̎w��̋�Ԃ̃I�t�Z�b�g��?��ߎ�����L� �?�
See Also:
WhichSide

commonTangent

public CommonTangent2D[] commonTangent(ParametricCurve2D mate)
���̋�?�Ƒ��̋�?�Ƃ̋���?�?��?�߂�?B

����?�?�?݂��Ȃ�?�?��ɂ͒��� 0 �̔z���Ԃ�?B

�����_�ł͎�����Ă��Ȃ�����?A UnsupportedOperationException �̗�O��?�����?B

Specified by:
commonTangent in class ParametricCurve2D
Parameters:
mate - ���̋�?�
Returns:
����?�?�̔z��
Throws:
java.lang.UnsupportedOperationException - ���܂̂Ƃ���?A������Ȃ��@�\�ł���

commonNormal

public CommonNormal2D[] commonNormal(ParametricCurve2D mate)
���̋�?�Ƒ��̋�?�Ƃ̋��ʖ@?��?�߂�?B

���ʖ@?�?݂��Ȃ�?�?��ɂ͒��� 0 �̔z���Ԃ�?B

�����_�ł͎�����Ă��Ȃ�����?A UnsupportedOperationException �̗�O��?�����?B

Specified by:
commonNormal in class ParametricCurve2D
Parameters:
mate - ���̋�?�
Returns:
���ʖ@?�̔z��
Throws:
java.lang.UnsupportedOperationException - ���܂̂Ƃ���?A������Ȃ��@�\�ł���

isFreeform

public boolean isFreeform()
���̊􉽗v�f�����R�`?󂩔ۂ���Ԃ�?B

Overrides:
isFreeform in class GeometryElement
Returns:
?�� true

startPoint

public Point2D startPoint()
���̗L� �?�̊J�n�_��Ԃ�?B

��?�‚����`����?�?��� null ��Ԃ�?B

Overrides:
startPoint in class BoundedCurve2D
Returns:
�J�n�_

endPoint

public Point2D endPoint()
���̗L� �?��?I���_��Ԃ�?B

��?�‚����`����?�?��� null ��Ԃ�?B

Overrides:
endPoint in class BoundedCurve2D
Returns:
?I���_

toBoundedLines

public BoundedLine2D[] toBoundedLines(ParameterSection pint)
���̃|�����C���̎w��̋�Ԃ�?��ɕϊ�����?B

Parameters:
pint - ?��ɕϊ�����p���??[�^���
Returns:
�w�肳�ꂽ��Ԃ�ϊ�����?��

toBoundedLines

public BoundedLine2D[] toBoundedLines()
���̃|�����C���S�̂�?��ɕϊ�����?B

Returns:
��?�S�̂�ϊ�����?��

doTransformBy

protected ParametricCurve2D doTransformBy(boolean reverseTransform,
                                          CartesianTransformationOperator2D transformationOperator,
                                          java.util.Hashtable transformedGeometries)
���̋�?��?A�^����ꂽ�􉽓I�ϊ����Z�q�ŕϊ�����?B

transformedGeometries ��?A �ϊ��O�̊􉽗v�f��L?[�Ƃ�?A �ϊ���̊􉽗v�f��l�Ƃ���n�b�V���e?[�u���ł���?B

this �� transformedGeometries ��ɃL?[�Ƃ��đ�?݂��Ȃ�?�?��ɂ�?A this �� transformationOperator �ŕϊ�������̂�Ԃ�?B ����?ۂɃ?�\�b�h�Ք�ł� this ��L?[?A �ϊ����ʂ�l�Ƃ��� transformedGeometries �ɒljB���?B

this �� transformedGeometries ��Ɋ�ɃL?[�Ƃ��đ�?݂���?�?��ɂ�?A ��?ۂ̕ϊ���?s�Ȃ킸?A���̃L?[�ɑΉ�����l��Ԃ�?B ����?��?��?ċA�I��?s�Ȃ���?B

transformedGeometries �� null �ł�?\��Ȃ�?B transformedGeometries �� null ��?�?��ɂ�?A ?�� this �� transformationOperator �ŕϊ�������̂�Ԃ�?B

Specified by:
doTransformBy in class ParametricCurve2D
Parameters:
reverseTransform - �t�ϊ�����̂ł���� true?A�����łȂ���� false
transformationOperator - �􉽓I�ϊ����Z�q
transformedGeometries - ��ɓ��l�̕ϊ���{�����􉽗v�f��܂ރn�b�V���e?[�u��
Returns:
�ϊ���̊􉽗v�f

hasPolyline

protected boolean hasPolyline()
���̋�?�|�����C���̕�����܂ނ��ۂ���Ԃ�?B

Overrides:
hasPolyline in class ParametricCurve2D
Returns:
?�� true

isComposedOfOnlyPolylines

protected boolean isComposedOfOnlyPolylines()
���̋�?�|�����C���̕��������łł��Ă��邩�ۂ���Ԃ�?B

Overrides:
isComposedOfOnlyPolylines in class ParametricCurve2D
Returns:
?�� true

output

protected void output(java.io.PrintWriter writer,
                      int indent)
?o�̓X�g��?[���Ɍ`?�?���?o�͂���?B

Specified by:
output in class GeometryElement
Parameters:
writer - PrintWriter
indent - �C���f���g��?[��
See Also:
GeometryElement