public final class GeneralPath extends Object implements Shape
WIND_EVEN_ODD
or WIND_NON_ZERO
winding rule can be chosen.
The WIND_EVEN_ODD
winding rule defines a point as inside a path if:
A ray from the point towards infinity in an arbitrary direction intersects
the path an odd number of times. Points A and C in the
image are considered to be outside the path. (both intersect twice) Point
B intersects once, and is inside.
The WIND_NON_ZERO
winding rule defines a point as inside a path if:
The path intersects the ray in an equal number of opposite directions. Point
A
in the image is outside (one intersection in the 'up' direction,
one in the 'down' direction) Point B in the image is inside (one
intersection 'down') Point C in the image is inside (two intersections in the
'down' direction)
Modifier and Type | Field and Description |
---|---|
static int |
WIND_EVEN_ODD
Same constant as
PathIterator.WIND_EVEN_ODD |
static int |
WIND_NON_ZERO
Same constant as
PathIterator.WIND_NON_ZERO |
Constructor and Description |
---|
GeneralPath()
Constructs a GeneralPath with the default (
WIND_NON_ZERO )
winding rule and initial capacity (10). |
GeneralPath(int rule)
Constructs a GeneralPath with a specific winding rule and the default
initial capacity (10).
|
GeneralPath(int rule,
int initialCapacity)
Constructs a GeneralPath with a specific winding rule and the initial
capacity.
|
GeneralPath(Shape shape)
Constructs a GeneralPath from an arbitrary shape object.
|
Modifier and Type | Method and Description |
---|---|
void |
append(PathIterator path,
boolean connect)
Appends the segments of a PathIterator to this GeneralPath.
|
void |
append(Shape shape,
boolean connect)
Appends the segments of a Shape to the path.
|
void |
arcTo(double cX,
double cY,
double endX,
double endY) |
void |
arcTo(float cX,
float cY,
float endX,
float endY)
Adds an arc to the path.
|
void |
closePath()
Closes the current subpath by drawing a line back to the point of the
last moveTo, unless the path is already closed.
|
boolean |
contains(float x,
float y)
Checks if the given point is contained in the current shape.
|
boolean |
contains(int x,
int y)
Checks if the shape contains the given point.
|
Shape |
createTransformedShape(Transform m)
Returns a shape formed by transforming the current shape with the provided
transform.
|
void |
curveTo(double x1,
double y1,
double x2,
double y2,
double x3,
double y3) |
void |
curveTo(float x1,
float y1,
float x2,
float y2,
float x3,
float y3)
Appends a cubic Bezier curve to the current path.
|
Rectangle |
getBounds()
Returns the path's bounding box.
|
float[] |
getBounds2D()
Returns the path's bounding box, in float precision.
|
float[] |
getCurrentPoint()
Returns the current appending point of the path.
|
PathIterator |
getPathIterator()
Gets an iterator to walk all of the path segments of the shape.
|
PathIterator |
getPathIterator(Transform m)
Gets an iterator where all points are transformed by the provided transform.
|
int |
getWindingRule()
Returns the path's current winding rule.
|
void |
intersect(Shape shape)
Resets this path to be the intersection of itself with the given shape.
|
Shape |
intersection(Rectangle rect)
Returns the shape formed by the intersection of this shape and the provided
rectangle.
|
boolean |
isRectangle()
Checks if this shape is a rectangle.
|
void |
lineTo(double x,
double y) |
void |
lineTo(float x,
float y)
Appends a straight line to the current path.
|
void |
moveTo(double x,
double y) |
void |
moveTo(float x,
float y)
Adds a new point to a path.
|
void |
quadTo(double x1,
double y1,
double x2,
double y2) |
void |
quadTo(float x1,
float y1,
float x2,
float y2)
Appends a quadratic Bezier curve to the current path.
|
void |
reset()
Resets the path.
|
void |
setWindingRule(int rule)
Sets the path's winding rule, which controls which areas are considered
'inside' or 'outside' the path on drawing.
|
String |
toString()
Returns a string representation of the object.
|
public static final int WIND_EVEN_ODD
PathIterator.WIND_EVEN_ODD
public static final int WIND_NON_ZERO
PathIterator.WIND_NON_ZERO
public GeneralPath()
WIND_NON_ZERO
)
winding rule and initial capacity (10).public GeneralPath(int rule)
rule
- The winding rule. One of WIND_NON_ZERO
and
WIND_EVEN_ODD
WIND_NON_ZERO
,
WIND_EVEN_ODD
public GeneralPath(int rule, int initialCapacity)
rule
- The winding rule. (WIND_NON_ZERO
or
WIND_EVEN_ODD
).initialCapacity
- the inital capacity, in path segmentspublic GeneralPath(Shape shape)
shape
- public String toString()
Object
public void setWindingRule(int rule)
WIND_EVEN_ODD
for an even-odd winding rule, or
WIND_NON_ZERO
for a non-zero winding rule.rule
- the rule. (WIND_NON_ZERO
or WIND_EVEN_ODD
).public int getWindingRule()
WIND_NON_ZERO
or WIND_EVEN_ODD
public void moveTo(double x, double y)
public void moveTo(float x, float y)
x
- the x-coordinate.y
- the y-coordinate.public void lineTo(double x, double y)
public void lineTo(float x, float y)
x
- x coordinate of the line endpoint.y
- y coordinate of the line endpoint.public void quadTo(double x1, double y1, double x2, double y2)
public void quadTo(float x1, float y1, float x2, float y2)
x1
- x coordinate of the control pointy1
- y coordinate of the control pointx2
- x coordinate of the curve endpoint.y2
- y coordinate of the curve endpoint.public void curveTo(double x1, double y1, double x2, double y2, double x3, double y3)
public void curveTo(float x1, float y1, float x2, float y2, float x3, float y3)
x1
- x coordinate of the first control pointy1
- y coordinate of the first control pointx2
- x coordinate of the second control pointy2
- y coordinate of the second control pointx3
- x coordinate of the curve endpoint.y3
- y coordinate of the curve endpoint.public void arcTo(float cX, float cY, float endX, float endY)
cX
- The x-coordinate of the oval center.cY
- The y-coordinate of the oval center.endX
- The end X coordinate.endY
- The end Y coordinate.public void arcTo(double cX, double cY, double endX, double endY)
public void closePath()
public void append(Shape shape, boolean connect)
shape
- the shape (null not permitted).connect
- whether to connect the new shape to the existing path.public void append(PathIterator path, boolean connect)
PathIterator.SEG_MOVETO
segment of the appended path
is changed into a PathIterator.SEG_LINETO
segment.path
- the PathIterator specifying which segments shall be appended
(null not permitted).connect
- true for substituting the initial
PathIterator.SEG_MOVETO
segment by a
PathIterator.SEG_LINETO
, or false for not performing any
substitution. If this GeneralPath
is currently empty, connect is
assumed to be false, thus leaving the initial
PathIterator.SEG_MOVETO
unchanged.public float[] getCurrentPoint()
[x,y]
representing x
and y
coordinate of the current appending point of the path..public void reset()
public float[] getBounds2D()
getBounds2D
in interface Shape
[x, y, width, height]
.public Rectangle getBounds()
public boolean isRectangle()
Shape
isRectangle
in interface Shape
public PathIterator getPathIterator()
getPathIterator
in interface Shape
public PathIterator getPathIterator(Transform m)
Note: If Transform.isSupported()
is false, then using this iterator will throw a Runtime Exception.
getPathIterator
in interface Shape
public Shape createTransformedShape(Transform m)
Note: If Transform.isSupported()
is false, this may throw a RuntimeException.
m
- The transform to be used to transform the shape.public void intersect(Shape shape)
Rectangle
s are current supported. If you pass any other
shape, it will throw a RuntimeException.
Note: If com.codename1.ui.TransformisSupported
is false, this will throw a Runtime Exception
shape
- The shape to intersect with the current shape.public Shape intersection(Rectangle rect)
intersection
in interface Shape
rect
- A rectangle with which to form an intersection.public boolean contains(float x, float y)