public final class Arc extends java.lang.Object implements ICurve
Arc
, which is defined by its
enclosing framing Rectangle
, a start Angle
(relative to the
x-axis), and an angular extend in counter-clockwise (CCW) direction.Modifier and Type | Field and Description |
---|---|
protected Angle |
angularExtent
The counter-clockwise (CCW)
Angle that spans this
AbstractArcBasedGeometry . |
protected Angle |
startAngle
The counter-clockwise (CCW)
Angle to the x-axis at which this
AbstractArcBasedGeometry begins. |
Constructor and Description |
---|
Arc(org.eclipse.gef.geometry.planar.AbstractRectangleBasedGeometry<?,?> r,
Angle startAngle,
Angle angularExtent)
Constructs a new
Arc of the given values. |
Arc(double x,
double y,
double width,
double height,
Angle startAngle,
Angle angularExtent)
Constructs a new
Arc of the given values. |
Modifier and Type | Method and Description |
---|---|
java.lang.Object |
clone()
Overridden with public visibility as recommended within
Cloneable
. |
protected CubicCurve[] |
computeBezierApproximation()
Computes a
CubicCurve approximation for this
AbstractArcBasedGeometry . |
boolean |
contains(Point p)
|
boolean |
equals(java.lang.Object obj) |
T |
expand(double h,
double v)
Expands the horizontal and vertical sides of this
AbstractRectangleBasedGeometry with the values provided as input,
and returns this for convenience. |
T |
expand(double left,
double top,
double right,
double bottom)
Expands this
AbstractRectangleBasedGeometry by the given amounts,
and returns this for convenience. |
Angle |
getAngularExtent()
|
Rectangle |
getBounds()
|
Point |
getCenter()
Returns the center
Point of this
AbstractRectangleBasedGeometry . |
Arc |
getCopy()
Returns a new identical copy of this
IGeometry . |
T |
getExpanded(double h,
double v)
Returns a new expanded
AbstractRectangleBasedGeometry , where the
sides are incremented by the horizontal and vertical values provided. |
T |
getExpanded(double left,
double top,
double right,
double bottom)
Creates and returns a new
AbstractRectangleBasedGeometry with the
bounds of this AbstractRectangleBasedGeometry expanded by the
given insets. |
double |
getHeight()
Returns the height of this
AbstractRectangleBasedGeometry . |
Point[] |
getIntersections(ICurve c)
|
Point |
getLocation()
Returns a
Point specifying the x and y coordinates of this
AbstractRectangleBasedGeometry . |
ICurve[] |
getOverlaps(ICurve c)
|
Point |
getP1()
Returns the start
Point of this AbstractArcBasedGeometry . |
Point |
getP2()
Returns the end
Point of this AbstractArcBasedGeometry . |
Point |
getPoint(Angle angularExtent)
Computes a
Point on this AbstractArcBasedGeometry . |
Point |
getProjection(Point reference)
|
PolyBezier |
getRotatedCCW(Angle angle)
|
PolyBezier |
getRotatedCCW(Angle angle,
double cx,
double cy)
|
PolyBezier |
getRotatedCCW(Angle angle,
Point center)
|
PolyBezier |
getRotatedCW(Angle angle)
|
PolyBezier |
getRotatedCW(Angle angle,
double cx,
double cy)
|
PolyBezier |
getRotatedCW(Angle angle,
Point center)
|
T |
getScaled(double factor)
Scales a copy of the calling object by the given factor relative to its
center
Point . |
T |
getScaled(double factorX,
double factorY)
Scales a copy of the calling object by the given factors relative to its
center
Point . |
T |
getScaled(double factor,
double centerX,
double centerY)
Scales a copy of the calling object by the given factor relative to the
given center
Point (cx, cy). |
T |
getScaled(double factorX,
double factorY,
double centerX,
double centerY)
Scales a copy of the calling object by the given factors relative to the
given center
Point (cx, cy). |
T |
getScaled(double factorX,
double factorY,
Point center)
Scales a copy of the calling object by the given factors relative to the
given center
Point . |
T |
getScaled(double factor,
Point center)
Scales a copy of the calling object by the given factor relative to the
given center
Point . |
T |
getShrinked(double h,
double v)
Returns a new
AbstractRectangleBasedGeometry , where the sides are
shrinked by the horizontal and vertical values supplied. |
T |
getShrinked(double left,
double top,
double right,
double bottom)
Returns a new
AbstractRectangleBasedGeometry shrinked by the
specified insets. |
Dimension |
getSize()
Returns a
Dimension that records the width and height of this
AbstractRectangleBasedGeometry . |
Angle |
getStartAngle()
Returns this
AbstractArcBasedGeometry 's start Angle . |
IGeometry |
getTransformed(AffineTransform t)
|
T |
getTranslated(double dx,
double dy)
Translates a copy of this object by the given values in x and y
direction.
|
T |
getTranslated(Point pt)
Translates a copy of this object by the given
Point . |
double |
getWidth()
Returns the width of this
AbstractRectangleBasedGeometry . |
double |
getX()
Returns the x coordinate this
AbstractRectangleBasedGeometry . |
double |
getX1()
Returns the x coordinate of the start
Point of this
AbstractArcBasedGeometry . |
double |
getX2()
Returns the x coordinate of the end
Point of this
AbstractArcBasedGeometry . |
double |
getY()
Returns the y coordinate of this
AbstractRectangleBasedGeometry . |
double |
getY1()
Returns the y coordinate of the start
Point of this
AbstractArcBasedGeometry . |
double |
getY2()
Returns the y coordinate of the end
Point of this
AbstractArcBasedGeometry . |
int |
hashCode() |
boolean |
intersects(ICurve c)
|
boolean |
overlaps(ICurve c)
|
T |
scale(double factor)
Scales the calling object by the given factor relative to its center
Point . |
T |
scale(double fx,
double fy)
Scales the calling object by the given factors relative to the given
center
Point . |
T |
scale(double factor,
double cx,
double cy)
Scales the calling object by the given factor relative to the given
center
Point (cx, cy). |
T |
scale(double fx,
double fy,
double cx,
double cy)
Scales the calling object by the given factors relative to the given
center
Point (cx, cy). |
T |
scale(double fx,
double fy,
Point center)
Scales the calling object by the given factors relative to the given
center
Point . |
T |
scale(double factor,
Point center)
Scales the calling object by the given factor relative to the given
center
Point . |
T |
setAngularExtent(Angle angularExtent)
Sets the extension
Angle of this AbstractArcBasedGeometry
. |
T |
setBounds(double x,
double y,
double w,
double h)
Sets the x, y, width, and height values of this
AbstractRectangleBasedGeometry to the given values. |
T |
setBounds(Point loc,
Dimension size)
|
T |
setBounds(Rectangle r)
Sets the x and y coordinates and the width and height of this
AbstractRectangleBasedGeometry to the respective values of the
given Rectangle . |
T |
setHeight(double height)
Sets the height of this
AbstractRectangleBasedGeometry to the
given value. |
T |
setLocation(double x,
double y)
Sets the x and y coordinates of this
AbstractRectangleBasedGeometry to the specified values. |
T |
setLocation(Point p)
Sets the x and y coordinates of this
AbstractRectangleBasedGeometry to the respective values of the
given Point . |
T |
setSize(Dimension d)
Sets the width and height of this
AbstractRectangleBasedGeometry
to the width and height of the given Dimension . |
T |
setSize(double w,
double h)
Sets the width and height of this
AbstractRectangleBasedGeometry
to the given values. |
T |
setStartAngle(Angle startAngle)
Sets the start
Angle of this AbstractArcBasedGeometry . |
T |
setWidth(double width)
Sets the width of this
AbstractRectangleBasedGeometry to the
passed-in value. |
T |
setX(double x)
Sets the x-coordinate of this
AbstractRectangleBasedGeometry to
the given value. |
T |
setY(double y)
Sets the y-coordinate of this
AbstractRectangleBasedGeometry to
the given value. |
T |
shrink(double h,
double v)
Shrinks the sides of this
AbstractRectangleBasedGeometry by the
horizontal and vertical values provided as input, and returns this
AbstractRectangleBasedGeometry for convenience. |
T |
shrink(double left,
double top,
double right,
double bottom)
Shrinks this
AbstractRectangleBasedGeometry by the specified
amounts. |
CubicCurve[] |
toBezier()
Computes a list of
BezierCurve s that approximate the
ICurve . |
Path |
toPath()
|
java.lang.String |
toString() |
boolean |
touches(IGeometry g)
|
T |
translate(double dx,
double dy)
Translates the object by the given values in x and y direction.
|
T |
translate(Point p)
Translates the object by the given
Point . |
finalize, getClass, notify, notifyAll, wait, wait, wait
getP1, getP2, getX1, getX2, getY1, getY2
getTransformed, toPath, touches
protected Angle startAngle
Angle
to the x-axis at which this
AbstractArcBasedGeometry
begins.public Arc(org.eclipse.gef.geometry.planar.AbstractRectangleBasedGeometry<?,?> r, Angle startAngle, Angle angularExtent)
Arc
of the given values. An Arc
is cut
out of an Ellipse
. The start Angle
is the
counter-clockwise (CCW) Angle
to the x-axis at which the
Arc
begins. The angular extent is the CCW Angle
that
spans the Arc
, i.e. the resulting end Angle
of the
Arc
is the sum of the start Angle
and the angular extent.public Arc(double x, double y, double width, double height, Angle startAngle, Angle angularExtent)
Arc
of the given values. An Arc
is cut
out of an Ellipse
. The start Angle
is the
counter-clockwise (CCW) Angle
to the x-axis at which the
Arc
begins. The angular extent is the CCW Angle
that
spans the Arc
, i.e. the resulting end Angle
of the
Arc
is the sum of the start Angle
and the angular extent.x
- the x coordinate of the bounds of the Ellipse
of which
the Arc
is cut outy
- the y coordinate of the bounds of the Ellipse
of which
the Arc
is cut outwidth
- the width of the bounds of the Ellipse
of which the
Arc
is cut outheight
- the height of the bounds of the Ellipse
of which the
Arc
is cut outstartAngle
- the CCW Angle
at which the Arc
beginsangularExtent
- the CCW Angle
that spans the Arc
public boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
public Arc getCopy()
IGeometry
IGeometry
.public Point[] getIntersections(ICurve c)
ICurve
getIntersections
in interface ICurve
c
- The ICurve
to compute intersection points with.public ICurve[] getOverlaps(ICurve c)
ICurve
getOverlaps
in interface ICurve
c
- The curve to compute overlaps with.public Point getProjection(Point reference)
ICurve
Point
onto
this ICurve
, i.e. a Point
on this ICurve
that is
closest to the given reference Point
. Note, thatgetProjection
in interface ICurve
reference
- The reference Point
for which to return the
projection.Point
onto
this ICurve
.public PolyBezier getRotatedCCW(Angle angle)
IRotatable
Angle
counter-clock-wise
(CCW) around its center Point
. Does not necessarily return an
object of the same type.getRotatedCCW
in interface IRotatable<PolyBezier>
angle
- rotation Angle
IGeometry
representing the result of the rotationpublic PolyBezier getRotatedCCW(Angle angle, double cx, double cy)
IRotatable
Angle
counter-clock-wise (CCW) around the specified center Point
(cx,
cy). Does not necessarily return an object of the same type.getRotatedCCW
in interface IRotatable<PolyBezier>
angle
- rotation Angle
cx
- x-coordinate of the relative Point
for the rotationcy
- y-coordinate of the relative Point
for the rotationIGeometry
representing the result of the rotationpublic PolyBezier getRotatedCCW(Angle angle, Point center)
IRotatable
Angle
counter-clock-wise (CCW) around the specified center Point
. Does
not necessarily return an object of the same type.getRotatedCCW
in interface IRotatable<PolyBezier>
angle
- rotation Angle
center
- relative Point
for the rotationIGeometry
representing the result of the rotationpublic PolyBezier getRotatedCW(Angle angle)
IRotatable
Angle
clock-wise (CW)
around its center Point
. Does not necessarily return an object of
the same type.getRotatedCW
in interface IRotatable<PolyBezier>
angle
- rotation Angle
IGeometry
representing the result of the rotationpublic PolyBezier getRotatedCW(Angle angle, double cx, double cy)
IRotatable
Angle
clock-wise (CW)
around the specified center Point
(cx, cy). Does not necessarily
return an object of the same type.getRotatedCW
in interface IRotatable<PolyBezier>
angle
- rotation Angle
cx
- x-coordinate of the relative Point
for the rotationcy
- y-coordinate of the relative Point
for the rotationIGeometry
representing the result of the rotationpublic PolyBezier getRotatedCW(Angle angle, Point center)
IRotatable
Angle
clock-wise (CW)
around the specified center Point
. Does not necessarily return an
object of the same type.getRotatedCW
in interface IRotatable<PolyBezier>
angle
- rotation Angle
center
- relative Point
for the rotationIGeometry
representing the result of the rotationpublic boolean intersects(ICurve c)
ICurve
ICurve
and the given ICurve
intersect, i.e.
whether a final set of intersection points exists. Two curves intersect
if they touch (see IGeometry.touches(IGeometry)
) but do not
overlap (see ICurve.overlaps(ICurve)
).intersects
in interface ICurve
c
- The ICurve
to test for intersections.true
if they intersect, false
otherwisepublic boolean overlaps(ICurve c)
ICurve
ICurve
and the given ICurve
overlap, i.e.
whether an infinite set of intersection points exists. Two curves overlap
if they touch (see IGeometry.touches(IGeometry)
) but not
intersect (see ICurve.intersects(ICurve)
).public CubicCurve[] toBezier()
ICurve
BezierCurve
s that approximate the
ICurve
. For example, a Line
or a BezierCurve
in
general could return a list with the curve itself as its only element.
But an Ellipse
or an Arc
may return a list of consecutive
BezierCurve
s which approximate the ICurve
.toBezier
in interface ICurve
BezierCurve
s that approximate the
ICurve
public java.lang.String toString()
toString
in class java.lang.Object
protected CubicCurve[] computeBezierApproximation()
CubicCurve
approximation for this
AbstractArcBasedGeometry
. It is approximated by a maximum of four
CubicCurve
s, each of which covers a maximum of 90 degrees.CubicCurve
approximation for this
AbstractArcBasedGeometry
public Angle getAngularExtent()
Angle
of this
AbstractArcBasedGeometry
, i.e. the Angle
defining the
span of this AbstractArcBasedGeometry
.Angle
of this
AbstractArcBasedGeometry
public Point getP1()
Point
of this AbstractArcBasedGeometry
.Point
of this AbstractArcBasedGeometry
public Point getP2()
Point
of this AbstractArcBasedGeometry
.Point
of this AbstractArcBasedGeometry
public Angle getStartAngle()
AbstractArcBasedGeometry
's start Angle
.AbstractArcBasedGeometry
's start Angle
public double getX1()
Point
of this
AbstractArcBasedGeometry
.Point
of this
AbstractArcBasedGeometry
public double getX2()
Point
of this
AbstractArcBasedGeometry
.Point
of this
AbstractArcBasedGeometry
public double getY1()
Point
of this
AbstractArcBasedGeometry
.Point
of this
AbstractArcBasedGeometry
public double getY2()
Point
of this
AbstractArcBasedGeometry
.Point
of this
AbstractArcBasedGeometry
public T setAngularExtent(Angle angularExtent)
Angle
of this AbstractArcBasedGeometry
.angularExtent
- the new extension Angle
for this
AbstractArcBasedGeometry
this
for conveniencepublic T setStartAngle(Angle startAngle)
Angle
of this AbstractArcBasedGeometry
.startAngle
- the new start Angle
for this
AbstractArcBasedGeometry
this
for conveniencepublic Path toPath()
IGeometry
Path
representation for this IGeometry
.IGeometry.toPath()
public T expand(double h, double v)
AbstractRectangleBasedGeometry
with the values provided as input,
and returns this
for convenience. The location of its center
is kept constant.h
- the horizontal incrementv
- the vertical incrementthis
for conveniencepublic T expand(double left, double top, double right, double bottom)
AbstractRectangleBasedGeometry
by the given amounts,
and returns this for convenience.left
- the amount to expand the left sidetop
- the amount to expand the top sideright
- the amount to expand the right sidebottom
- the amount to expand the bottom sidethis
for conveniencepublic Point getCenter()
Point
of this
AbstractRectangleBasedGeometry
.Point
of this
AbstractRectangleBasedGeometry
public T getExpanded(double h, double v)
AbstractRectangleBasedGeometry
, where the
sides are incremented by the horizontal and vertical values provided. The
center of the AbstractRectangleBasedGeometry
is maintained
constant.h
- The horizontal incrementv
- The vertical incrementAbstractRectangleBasedGeometry
public T getExpanded(double left, double top, double right, double bottom)
AbstractRectangleBasedGeometry
with the
bounds of this AbstractRectangleBasedGeometry
expanded by the
given insets.left
- the amount to expand the left sidetop
- the amount to expand the top sideright
- the amount to expand the right sidebottom
- the amount to expand the bottom sideAbstractRectangleBasedGeometry
public final double getHeight()
AbstractRectangleBasedGeometry
.AbstractRectangleBasedGeometry
public Point getLocation()
Point
specifying the x and y coordinates of this
AbstractRectangleBasedGeometry
.Point
representing the x and y coordinates of this
AbstractRectangleBasedGeometry
public T getScaled(double factor)
IScalable
Point
.public T getScaled(double factorX, double factorY)
IScalable
Point
.public T getScaled(double factor, double centerX, double centerY)
IScalable
Point
(cx, cy).getScaled
in interface IScalable<T extends org.eclipse.gef.geometry.planar.AbstractRectangleBasedGeometry<?,?>>
factor
- scale-factorcenterX
- x-coordinate of the relative Point
for the scalingcenterY
- y-coordinate of the relative Point
for the scalingpublic T getScaled(double factorX, double factorY, double centerX, double centerY)
IScalable
Point
(cx, cy).getScaled
in interface IScalable<T extends org.eclipse.gef.geometry.planar.AbstractRectangleBasedGeometry<?,?>>
factorX
- x-scale-factorfactorY
- y-scale-factorcenterX
- x-coordinate of the relative Point
for the scalingcenterY
- y-coordinate of the relative Point
for the scalingpublic T getScaled(double factorX, double factorY, Point center)
IScalable
Point
.public T getScaled(double factor, Point center)
IScalable
Point
.public T getShrinked(double h, double v)
AbstractRectangleBasedGeometry
, where the sides are
shrinked by the horizontal and vertical values supplied. The center of
this AbstractRectangleBasedGeometry
is kept constant.h
- horizontal reduction amountv
- vertical reduction amountAbstractRectangleBasedGeometry
public T getShrinked(double left, double top, double right, double bottom)
AbstractRectangleBasedGeometry
shrinked by the
specified insets.left
- the amount to shrink the left sidetop
- the amount to shrink the top sideright
- the amount to shrink the right sidebottom
- the amount to shrink the bottom sideAbstractRectangleBasedGeometry
public final Dimension getSize()
Dimension
that records the width and height of this
AbstractRectangleBasedGeometry
.Dimension
that records the width and height of this
AbstractRectangleBasedGeometry
public T getTranslated(double dx, double dy)
ITranslatable
getTranslated
in interface ITranslatable<T extends org.eclipse.gef.geometry.planar.AbstractRectangleBasedGeometry<?,?>>
dx
- x-translationdy
- y-translationpublic T getTranslated(Point pt)
ITranslatable
Point
.getTranslated
in interface ITranslatable<T extends org.eclipse.gef.geometry.planar.AbstractRectangleBasedGeometry<?,?>>
pt
- translation Point
public final double getWidth()
AbstractRectangleBasedGeometry
.AbstractRectangleBasedGeometry
public final double getX()
AbstractRectangleBasedGeometry
.AbstractRectangleBasedGeometry
public final double getY()
AbstractRectangleBasedGeometry
.AbstractRectangleBasedGeometry
public T scale(double factor)
IScalable
Point
.public T scale(double fx, double fy)
IScalable
Point
.public T scale(double factor, double cx, double cy)
IScalable
Point
(cx, cy).public T scale(double fx, double fy, double cx, double cy)
IScalable
Point
(cx, cy).scale
in interface IScalable<T extends org.eclipse.gef.geometry.planar.AbstractRectangleBasedGeometry<?,?>>
fx
- x-scale-factorfy
- y-scale-factorcx
- x-coordinate of the relative Point
for the scalingcy
- y-coordinate of the relative Point
for the scalingthis
for conveniencepublic T scale(double fx, double fy, Point center)
IScalable
Point
.public T scale(double factor, Point center)
IScalable
Point
.public final T setBounds(double x, double y, double w, double h)
AbstractRectangleBasedGeometry
to the given values.x
- the new x-coordinatey
- the new y-coordinatew
- the new widthh
- the new heightthis
for conveniencepublic final T setBounds(Rectangle r)
AbstractRectangleBasedGeometry
to the respective values of the
given Rectangle
.r
- the Rectangle
specifying the new x, y, width, and
height values of this AbstractRectangleBasedGeometry
this
for conveniencepublic final T setHeight(double height)
AbstractRectangleBasedGeometry
to the
given value.height
- the new heightthis
for conveniencepublic final T setLocation(double x, double y)
AbstractRectangleBasedGeometry
to the specified values.x
- the new x coordinate of this
AbstractRectangleBasedGeometry
y
- the new y coordinate of this
AbstractRectangleBasedGeometry
this
for conveniencepublic final T setLocation(Point p)
AbstractRectangleBasedGeometry
to the respective values of the
given Point
.p
- the Point
specifying the new x and y coordinates of
this AbstractRectangleBasedGeometry
this
for conveniencepublic final T setSize(Dimension d)
AbstractRectangleBasedGeometry
to the width and height of the given Dimension
.d
- the Dimension
specifying the new width and height of
this AbstractRectangleBasedGeometry
this
for conveniencepublic final T setSize(double w, double h)
AbstractRectangleBasedGeometry
to the given values.w
- the new width of this AbstractRectangleBasedGeometry
h
- the new height of this AbstractRectangleBasedGeometry
this
for conveniencepublic final T setWidth(double width)
AbstractRectangleBasedGeometry
to the
passed-in value.width
- the new width of this AbstractRectangleBasedGeometry
this
for conveniencepublic final T setX(double x)
AbstractRectangleBasedGeometry
to
the given value.x
- The new x-coordinate.this
for convenience.public final T setY(double y)
AbstractRectangleBasedGeometry
to
the given value.y
- The new y-coordinate.this
for convenience.public T shrink(double h, double v)
AbstractRectangleBasedGeometry
by the
horizontal and vertical values provided as input, and returns this
AbstractRectangleBasedGeometry
for convenience. The center of
this AbstractRectangleBasedGeometry
is kept constant.h
- horizontal reduction amountv
- vertical reduction amountthis
for conveniencepublic T shrink(double left, double top, double right, double bottom)
AbstractRectangleBasedGeometry
by the specified
amounts.left
- the amount to shrink the left sidetop
- the amount to shrink the top sideright
- the amount to shrink the right sidebottom
- the amount to shrink the bottom sidethis
for conveniencepublic T translate(double dx, double dy)
ITranslatable
translate
in interface ITranslatable<T extends org.eclipse.gef.geometry.planar.AbstractRectangleBasedGeometry<?,?>>
dx
- x-translationdy
- y-translationthis
for conveniencepublic T translate(Point p)
ITranslatable
Point
.translate
in interface ITranslatable<T extends org.eclipse.gef.geometry.planar.AbstractRectangleBasedGeometry<?,?>>
p
- translation Point
this
for conveniencepublic java.lang.Object clone()
Cloneable
.clone
in class java.lang.Object
public IGeometry getTransformed(AffineTransform t)
Path
representation of this IGeometry
. Subclasses may override this
method to return a more specific representation.getTransformed
in interface IGeometry
t
- The AffineTransform
to be appliedPath
representation of this
IGeometry
public final int hashCode()
hashCode
in class java.lang.Object
Object.hashCode()
Copyright (c) 2014 itemis AG, and others. All rights reserved.