|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object math.geom2d.curve.AbstractContinuousCurve2D math.geom2d.curve.AbstractSmoothCurve2D math.geom2d.line.AbstractLine2D math.geom2d.line.Ray2D
public class Ray2D
Ray, or half-line, defined from an origin and a direction vector. It is composed of all points satisfying the parametric equation:
x(t) = x0+t*dx
y(t) = y0+t*dy
t comprised between 0 and +INFINITY.
Field Summary
Fields inherited from interface math.geom2d.Shape2D
ACCURACY
Constructor Summary
Ray2D()
Empty constructor for Ray2D.
Ray2D(double x,
double y,
double angle)
Creates a new Ray2D, originating from point
(x, y)<\code>, and going
in the direction specified by angle<\code> (in radians).
Ray2D(double x1,
double y1,
double dx,
double dy)
Creates a new Ray2D, originating from point
(x1,y1)<\code>, and going
in the direction defined by vector (dx, dy)<\code>.
Ray2D(LinearShape2D line)
Define a new Ray, with same characteristics as given object.
Ray2D(Point2D point,
double angle)
Creates a new Ray2D, originating from point point<\code>, and going
in the direction specified by angle<\code> (in radians).
Ray2D(Point2D point,
double dx,
double dy)
Creates a new Ray2D, originating from point point<\code>, and going
in the direction defined by vector (dx,dy)<\code>.
Ray2D(Point2D point1,
Point2D point2)
Creates a new Ray2D, originating from
point1<\code>, and going in the
direction of point2<\code>.
Ray2D(Point2D point,
Vector2D vector)
Creates a new Ray2D, originating from point point<\code>, and going
in the direction specified by vector<\code>.
Method Summary
boolean
almostEquals(GeometricObject2D obj,
double eps)
Checks if the two objects are similar up to a given threshold value.
java.awt.geom.GeneralPath
appendPath(java.awt.geom.GeneralPath path)
Throws an infiniteShapeException
Box2D
boundingBox()
Returns the bounding box of the shape.
Ray2D
clone()
Ensures public declaration of clone(), and ensures valid return type.
boolean
contains(double x,
double y)
Checks if the shape contains the planar point defined by (x,y).
static Ray2D
create(Point2D origin,
Point2D target)
Deprecated. since 0.11.1
static Ray2D
create(Point2D origin,
Vector2D direction)
Deprecated. since 0.11.1
boolean
equals(java.lang.Object obj)
Point2D
firstPoint()
Returns the first point of the curve.
java.awt.geom.GeneralPath
getGeneralPath()
Throws an infiniteShapeException
double
getT0()
Deprecated. replaced by t0() (since 0.11.1).
double
getT1()
Deprecated. replaced by t1() (since 0.11.1).
boolean
isBounded()
Always returns false, because a ray is not bounded.
Ray2D
parallel(double d)
Returns a new ray parallel to this one, at the given relative distance.
Point2D
point(double t)
Returns the point located at the given position on the curve.
InvertedRay2D
reverse()
Reverses this curve, and return the result as an instance of
InvertedRay2D.
double
t0()
Get value of parameter t for the first point of the curve.
double
t1()
Returns the position of the last point of the ray, which is always
Double.POSITIVE_INFINITY.
java.lang.String
toString()
Ray2D
transform(AffineTransform2D trans)
Transforms the curve by an affine transform.
Methods inherited from class math.geom2d.line.AbstractLine2D
buffer, cartesianEquation, clip, contains, continuousCurves, curvature, direction, distance, distance, getIntersection, getSymmetric, getSymmetric, horizontalAngle, intersection, intersections, isClosed, isColinear, isColinear, isEmpty, isInside, isParallel, isParallel, length, length, origin, parallel, parametric, perpendicular, polarCoefficients, polarCoefficientsSigned, position, position, positionOnLine, positionOnLine, project, projectedPoint, projectedPoint, signedDistance, signedDistance, smoothPieces, subCurve, supportingLine, tangent, transform, windingAngle
Methods inherited from class math.geom2d.curve.AbstractSmoothCurve2D
isSingular, leftTangent, normal, rightTangent, singularPoints, vertices
Methods inherited from class math.geom2d.curve.AbstractContinuousCurve2D
asAwtShape, asPolyline, draw, lastPoint
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface math.geom2d.curve.SmoothCurve2D
normal
Methods inherited from interface math.geom2d.curve.ContinuousCurve2D
asPolyline, leftTangent, rightTangent
Methods inherited from interface math.geom2d.curve.Curve2D
asAwtShape, draw, isSingular, lastPoint, singularPoints, vertices
Constructor Detail
Ray2D
public Ray2D()
- Empty constructor for Ray2D. Default is ray starting at origin, and
having a slope of 1*dx and 0*dy.
Ray2D
public Ray2D(Point2D point1,
Point2D point2)
- Creates a new Ray2D, originating from
point1<\code>, and going in the
direction of point2<\code>.
Ray2D
public Ray2D(double x1,
double y1,
double dx,
double dy)
- Creates a new Ray2D, originating from point
(x1,y1)<\code>, and going
in the direction defined by vector (dx, dy)<\code>.
Ray2D
public Ray2D(Point2D point,
double dx,
double dy)
- Creates a new Ray2D, originating from point
point<\code>, and going
in the direction defined by vector (dx,dy)<\code>.
Ray2D
public Ray2D(Point2D point,
Vector2D vector)
- Creates a new Ray2D, originating from point
point<\code>, and going
in the direction specified by vector<\code>.
Ray2D
public Ray2D(Point2D point,
double angle)
- Creates a new Ray2D, originating from point
point<\code>, and going
in the direction specified by angle<\code> (in radians).
Ray2D
public Ray2D(double x,
double y,
double angle)
- Creates a new Ray2D, originating from point
(x, y)<\code>, and going
in the direction specified by angle<\code> (in radians).
Ray2D
public Ray2D(LinearShape2D line)
- Define a new Ray, with same characteristics as given object.
Method Detail
create
@Deprecated
public static Ray2D create(Point2D origin,
Vector2D direction)
- Deprecated. since 0.11.1
- Static factory for creating a new ray.
create
@Deprecated
public static Ray2D create(Point2D origin,
Point2D target)
- Deprecated. since 0.11.1
- Static factory for creating a new ray, originating from
origin<\code>, and going in the
direction of target<\code>.
parallel
public Ray2D parallel(double d)
- Returns a new ray parallel to this one, at the given relative distance.
- Specified by:
parallel
in interface CirculinearContinuousCurve2D
- Specified by:
parallel
in interface CirculinearCurve2D
- Specified by:
parallel
in interface CirculinearElement2D
- Parameters:
d
- the distance between the original curve and he parallel curve.
- Returns:
- the parallel curve
- See Also:
CirculinearCurve2D.parallel(double)
appendPath
public java.awt.geom.GeneralPath appendPath(java.awt.geom.GeneralPath path)
- Throws an infiniteShapeException
- Specified by:
appendPath
in interface ContinuousCurve2D
- Parameters:
path
- a path to modify
- Returns:
- the modified path
getGeneralPath
public java.awt.geom.GeneralPath getGeneralPath()
- Throws an infiniteShapeException
firstPoint
public Point2D firstPoint()
- Description copied from interface:
Curve2D
- Returns the first point of the curve. It must returns the same result as
point(t0())
.
- Specified by:
firstPoint
in interface Curve2D
- Overrides:
firstPoint
in class AbstractContinuousCurve2D
- Returns:
- the first point of the curve
- See Also:
Curve2D.t0()
,
Curve2D.point(double)
point
public Point2D point(double t)
- Description copied from interface:
Curve2D
- Returns the point located at the given position on the curve. If the
parameter lies outside the definition range, the parameter corresponding
to the closest bound is used instead. This method can be used to draw an
approximated outline of a curve, by selecting multiple values for t and
drawing lines between them.
- Specified by:
point
in interface Curve2D
t0
public double t0()
- Description copied from interface:
Curve2D
- Get value of parameter t for the first point of the curve. It can be
-Infinity, in this case the piece of curve is not bounded.
- Specified by:
t0
in interface Curve2D
getT0
@Deprecated
public double getT0()
- Deprecated. replaced by t0() (since 0.11.1).
- Specified by:
getT0
in interface Curve2D
t1
public double t1()
- Returns the position of the last point of the ray, which is always
Double.POSITIVE_INFINITY.
- Specified by:
t1
in interface Curve2D
getT1
@Deprecated
public double getT1()
- Deprecated. replaced by t1() (since 0.11.1).
- Specified by:
getT1
in interface Curve2D
reverse
public InvertedRay2D reverse()
- Reverses this curve, and return the result as an instance of
InvertedRay2D.
- Specified by:
reverse
in interface CirculinearContinuousCurve2D
- Specified by:
reverse
in interface CirculinearCurve2D
- Specified by:
reverse
in interface CirculinearElement2D
- Specified by:
reverse
in interface ContinuousCurve2D
- Specified by:
reverse
in interface Curve2D
- Specified by:
reverse
in interface SmoothCurve2D
- Specified by:
reverse
in interface ContinuousOrientedCurve2D
- Specified by:
reverse
in interface OrientedCurve2D
- Specified by:
reverse
in interface SmoothOrientedCurve2D
- See Also:
InvertedRay2D.reverse()
isBounded
public boolean isBounded()
- Always returns false, because a ray is not bounded.
- Specified by:
isBounded
in interface Shape2D
contains
public boolean contains(double x,
double y)
- Description copied from interface:
Shape2D
- Checks if the shape contains the planar point defined by (x,y).
- Specified by:
contains
in interface Shape2D
boundingBox
public Box2D boundingBox()
- Description copied from interface:
Shape2D
- Returns the bounding box of the shape.
- Specified by:
boundingBox
in interface Shape2D
- Returns:
- the bounding box of the shape.
transform
public Ray2D transform(AffineTransform2D trans)
- Description copied from interface:
Curve2D
- Transforms the curve by an affine transform. The result is an instance of
Curve2D.
- Specified by:
transform
in interface ContinuousCurve2D
- Specified by:
transform
in interface Curve2D
- Specified by:
transform
in interface SmoothCurve2D
- Specified by:
transform
in interface ContinuousOrientedCurve2D
- Specified by:
transform
in interface OrientedCurve2D
- Specified by:
transform
in interface SmoothOrientedCurve2D
- Specified by:
transform
in interface LinearElement2D
- Specified by:
transform
in interface LinearShape2D
- Specified by:
transform
in interface Shape2D
- Specified by:
transform
in class AbstractLine2D
- Parameters:
trans
- an affine transform
- Returns:
- the transformed shape
almostEquals
public boolean almostEquals(GeometricObject2D obj,
double eps)
- Description copied from interface:
GeometricObject2D
- Checks if the two objects are similar up to a given threshold value.
This method can be used to compare the results of geometric
computations, that introduce errors due to numerical computations.
- Specified by:
almostEquals
in interface GeometricObject2D
- Parameters:
obj
- the object to compareeps
- a threshold value, for example the minimal coordinate difference
- Returns:
- true if both object have the same value up to the threshold
toString
public java.lang.String toString()
- Overrides:
toString
in class java.lang.Object
equals
public boolean equals(java.lang.Object obj)
- Overrides:
equals
in class java.lang.Object
clone
public Ray2D clone()
- Description copied from class:
AbstractLine2D
- Ensures public declaration of clone(), and ensures valid return type.
- Specified by:
clone
in interface Curve2D
- Specified by:
clone
in class AbstractLine2D
- Returns:
- the cloned curve
Overview
Package
Class
Use
Tree
Deprecated
Index
Help
PREV CLASS
NEXT CLASS
FRAMES
NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD
DETAIL: FIELD | CONSTR | METHOD