
Java™ Platform Standard Ed. 6 

PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 
java.lang.Object java.awt.geom.Path2D java.awt.geom.Path2D.Float
public static class Path2D.Float
The Float
class defines a geometric path with
coordinates stored in single precision floating point.
Nested Class Summary 

Nested classes/interfaces inherited from class java.awt.geom.Path2D 

Path2D.Double, Path2D.Float 
Field Summary 

Fields inherited from class java.awt.geom.Path2D 

WIND_EVEN_ODD, WIND_NON_ZERO 
Constructor Summary  

Path2D.Float()
Constructs a new empty single precision Path2D object
with a default winding rule of Path2D.WIND_NON_ZERO . 

Path2D.Float(int rule)
Constructs a new empty single precision Path2D object
with the specified winding rule to control operations that
require the interior of the path to be defined. 

Path2D.Float(int rule,
int initialCapacity)
Constructs a new empty single precision Path2D object
with the specified winding rule and the specified initial
capacity to store path segments. 

Path2D.Float(Shape s)
Constructs a new single precision Path2D object
from an arbitrary Shape object. 

Path2D.Float(Shape s,
AffineTransform at)
Constructs a new single precision Path2D object
from an arbitrary Shape object, transformed by an
AffineTransform object. 
Method Summary  

void 
append(PathIterator pi,
boolean connect)
Appends the geometry of the specified PathIterator object
to the path, possibly connecting the new geometry to the existing
path segments with a line segment. 
Object 
clone()
Creates a new object of the same class as this object. 
void 
curveTo(double x1,
double y1,
double x2,
double y2,
double x3,
double y3)
Adds a curved segment, defined by three new points, to the path by drawing a Bézier curve that intersects both the current coordinates and the specified coordinates (x3,y3) ,
using the specified points (x1,y1) and (x2,y2) as
Bézier control points. 
void 
curveTo(float x1,
float y1,
float x2,
float y2,
float x3,
float y3)
Adds a curved segment, defined by three new points, to the path by drawing a Bézier curve that intersects both the current coordinates and the specified coordinates (x3,y3) ,
using the specified points (x1,y1) and (x2,y2) as
Bézier control points. 
Rectangle2D 
getBounds2D()
Returns a high precision and more accurate bounding box of the Shape than the getBounds method. 
PathIterator 
getPathIterator(AffineTransform at)
Returns an iterator object that iterates along the Shape boundary and provides access to the geometry of the
Shape outline. 
void 
lineTo(double x,
double y)
Adds a point to the path by drawing a straight line from the current coordinates to the new specified coordinates specified in double precision. 
void 
lineTo(float x,
float y)
Adds a point to the path by drawing a straight line from the current coordinates to the new specified coordinates specified in float precision. 
void 
moveTo(double x,
double y)
Adds a point to the path by moving to the specified coordinates specified in double precision. 
void 
moveTo(float x,
float y)
Adds a point to the path by moving to the specified coordinates specified in float precision. 
void 
quadTo(double x1,
double y1,
double x2,
double y2)
Adds a curved segment, defined by two new points, to the path by drawing a Quadratic curve that intersects both the current coordinates and the specified coordinates (x2,y2) ,
using the specified point (x1,y1) as a quadratic
parametric control point. 
void 
quadTo(float x1,
float y1,
float x2,
float y2)
Adds a curved segment, defined by two new points, to the path by drawing a Quadratic curve that intersects both the current coordinates and the specified coordinates (x2,y2) ,
using the specified point (x1,y1) as a quadratic
parametric control point. 
void 
transform(AffineTransform at)
Transforms the geometry of this path using the specified AffineTransform . 
Methods inherited from class java.awt.geom.Path2D 

append, closePath, contains, contains, contains, contains, contains, contains, contains, contains, createTransformedShape, getBounds, getCurrentPoint, getPathIterator, getWindingRule, intersects, intersects, intersects, intersects, reset, setWindingRule 
Methods inherited from class java.lang.Object 

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 
Constructor Detail 

public Path2D.Float()
Path2D
object
with a default winding rule of Path2D.WIND_NON_ZERO
.
public Path2D.Float(int rule)
Path2D
object
with the specified winding rule to control operations that
require the interior of the path to be defined.
rule
 the winding rulePath2D.WIND_EVEN_ODD
,
Path2D.WIND_NON_ZERO
public Path2D.Float(int rule, int initialCapacity)
Path2D
object
with the specified winding rule and the specified initial
capacity to store path segments.
This number is an initial guess as to how many path segments
will be added to the path, but the storage is expanded as
needed to store whatever path segments are added.
rule
 the winding ruleinitialCapacity
 the estimate for the number of path segments
in the pathPath2D.WIND_EVEN_ODD
,
Path2D.WIND_NON_ZERO
public Path2D.Float(Shape s)
Path2D
object
from an arbitrary Shape
object.
All of the initial geometry and the winding rule for this path are
taken from the specified Shape
object.
s
 the specified Shape
objectpublic Path2D.Float(Shape s, AffineTransform at)
Path2D
object
from an arbitrary Shape
object, transformed by an
AffineTransform
object.
All of the initial geometry and the winding rule for this path are
taken from the specified Shape
object and transformed
by the specified AffineTransform
object.
s
 the specified Shape
objectat
 the specified AffineTransform
objectMethod Detail 

public final void moveTo(double x, double y)
moveTo
in class Path2D
x
 the specified X coordinatey
 the specified Y coordinatepublic final void moveTo(float x, float y)
This method provides a single precision variant of
the double precision moveTo()
method on the
base Path2D
class.
x
 the specified X coordinatey
 the specified Y coordinatePath2D.moveTo(double, double)
public final void lineTo(double x, double y)
lineTo
in class Path2D
x
 the specified X coordinatey
 the specified Y coordinatepublic final void lineTo(float x, float y)
This method provides a single precision variant of
the double precision lineTo()
method on the
base Path2D
class.
x
 the specified X coordinatey
 the specified Y coordinatePath2D.lineTo(double, double)
public final void quadTo(double x1, double y1, double x2, double y2)
(x2,y2)
,
using the specified point (x1,y1)
as a quadratic
parametric control point.
All coordinates are specified in double precision.
quadTo
in class Path2D
x1
 the X coordinate of the quadratic control pointy1
 the Y coordinate of the quadratic control pointx2
 the X coordinate of the final end pointy2
 the Y coordinate of the final end pointpublic final void quadTo(float x1, float y1, float x2, float y2)
(x2,y2)
,
using the specified point (x1,y1)
as a quadratic
parametric control point.
All coordinates are specified in float precision.
This method provides a single precision variant of
the double precision quadTo()
method on the
base Path2D
class.
x1
 the X coordinate of the quadratic control pointy1
 the Y coordinate of the quadratic control pointx2
 the X coordinate of the final end pointy2
 the Y coordinate of the final end pointPath2D.quadTo(double, double, double, double)
public final void curveTo(double x1, double y1, double x2, double y2, double x3, double y3)
(x3,y3)
,
using the specified points (x1,y1)
and (x2,y2)
as
Bézier control points.
All coordinates are specified in double precision.
curveTo
in class Path2D
x1
 the X coordinate of the first Bézier control pointy1
 the Y coordinate of the first Bézier control pointx2
 the X coordinate of the second Bézier control pointy2
 the Y coordinate of the second Bézier control pointx3
 the X coordinate of the final end pointy3
 the Y coordinate of the final end pointpublic final void curveTo(float x1, float y1, float x2, float y2, float x3, float y3)
(x3,y3)
,
using the specified points (x1,y1)
and (x2,y2)
as
Bézier control points.
All coordinates are specified in float precision.
This method provides a single precision variant of
the double precision curveTo()
method on the
base Path2D
class.
x1
 the X coordinate of the first Bézier control pointy1
 the Y coordinate of the first Bézier control pointx2
 the X coordinate of the second Bézier control pointy2
 the Y coordinate of the second Bézier control pointx3
 the X coordinate of the final end pointy3
 the Y coordinate of the final end pointPath2D.curveTo(double, double, double, double, double, double)
public final void append(PathIterator pi, boolean connect)
PathIterator
object
to the path, possibly connecting the new geometry to the existing
path segments with a line segment.
If the connect
parameter is true
and the
path is not empty then any initial moveTo
in the
geometry of the appended Shape
is turned into a
lineTo
segment.
If the destination coordinates of such a connecting lineTo
segment match the ending coordinates of a currently open
subpath then the segment is omitted as superfluous.
The winding rule of the specified Shape
is ignored
and the appended geometry is governed by the winding
rule specified for this path.
append
in class Path2D
pi
 the PathIterator
whose geometry is appended to
this pathconnect
 a boolean to control whether or not to turn an initial
moveTo
segment into a lineTo
segment
to connect the new geometry to the existing pathpublic final void transform(AffineTransform at)
AffineTransform
.
The geometry is transformed in place, which permanently changes the
boundary defined by this object.
transform
in class Path2D
at
 the AffineTransform
used to transform the areapublic final Rectangle2D getBounds2D()
Shape
than the getBounds
method.
Note that there is no guarantee that the returned
Rectangle2D
is the smallest bounding box that encloses
the Shape
, only that the Shape
lies
entirely within the indicated Rectangle2D
. The
bounding box returned by this method is usually tighter than that
returned by the getBounds
method and never fails due
to overflow problems since the return value can be an instance of
the Rectangle2D
that uses double precision values to
store the dimensions.
getBounds2D
in interface Shape
Rectangle2D
that is a
highprecision bounding box of the Shape
.Shape.getBounds()
public PathIterator getPathIterator(AffineTransform at)
Shape
boundary and provides access to the geometry of the
Shape
outline. If an optional AffineTransform
is specified, the coordinates returned in the iteration are
transformed accordingly.
Each call to this method returns a fresh PathIterator
object that traverses the geometry of the Shape
object
independently from any other PathIterator
objects in use
at the same time.
It is recommended, but not guaranteed, that objects
implementing the Shape
interface isolate iterations
that are in process from any changes that might occur to the original
object's geometry during such iterations.
The iterator for this class is not multithreaded safe,
which means that the Path2D
class does not
guarantee that modifications to the geometry of this
Path2D
object do not affect any iterations of
that geometry that are already in process.
getPathIterator
in interface Shape
at
 an optional AffineTransform
to be applied to the
coordinates as they are returned in the iteration, or
null
if untransformed coordinates are desired
PathIterator
object, which independently
traverses the geometry of the Shape
.public final Object clone()
clone
in class Path2D
OutOfMemoryError
 if there is not enough memory.Cloneable

Java™ Platform Standard Ed. 6 

PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.