A path is a sequence of lines and curves that may either form a closed shape or be openended. More...
Classes  
class  Iterator 
Iterates the lines and curves that a path contains. More...  
Public Member Functions  
Path ()  
Creates an empty path.  
Path (const Path &)  
Creates a copy of another path.  
~Path ()  
Destructor.  
Path &  operator= (const Path &) 
Copies this path from another one.  
Path (Path &&) noexcept  
Move constructor.  
Path &  operator= (Path &&) noexcept 
Move assignment operator.  
bool  operator== (const Path &) const noexcept 
bool  operator!= (const Path &) const noexcept 
bool  isEmpty () const noexcept 
Returns true if the path doesn't contain any lines or curves.  
Rectangle< float >  getBounds () const noexcept 
Returns the smallest rectangle that contains all points within the path.  
Rectangle< float >  getBoundsTransformed (const AffineTransform &transform) const noexcept 
Returns the smallest rectangle that contains all points within the path after it's been transformed with the given transform matrix.  
bool  contains (float x, float y, float tolerance=defaultToleranceForTesting) const 
Checks whether a point lies within the path.  
bool  contains (Point< float > point, float tolerance=defaultToleranceForTesting) const 
Checks whether a point lies within the path.  
bool  intersectsLine (Line< float > line, float tolerance=defaultToleranceForTesting) const 
Checks whether a line crosses the path.  
Line< float >  getClippedLine (Line< float > line, bool keepSectionOutsidePath) const 
Cuts off parts of a line to keep the parts that are either inside or outside this path.  
float  getLength (const AffineTransform &transform=AffineTransform(), float tolerance=defaultToleranceForMeasurement) const 
Returns the length of the path.  
Point< float >  getPointAlongPath (float distanceFromStart, const AffineTransform &transform=AffineTransform(), float tolerance=defaultToleranceForMeasurement) const 
Returns a point that is the specified distance along the path.  
float  getNearestPoint (Point< float > targetPoint, Point< float > &pointOnPath, const AffineTransform &transform=AffineTransform(), float tolerance=defaultToleranceForMeasurement) const 
Finds the point along the path which is nearest to a given position.  
void  clear () noexcept 
Removes all lines and curves, resetting the path completely.  
void  startNewSubPath (float startX, float startY) 
Begins a new subpath with a given starting position.  
void  startNewSubPath (Point< float > start) 
Begins a new subpath with a given starting position.  
void  closeSubPath () 
Closes a the current subpath with a line back to its startpoint.  
void  lineTo (float endX, float endY) 
Adds a line from the shape's last position to a new endpoint.  
void  lineTo (Point< float > end) 
Adds a line from the shape's last position to a new endpoint.  
void  quadraticTo (float controlPointX, float controlPointY, float endPointX, float endPointY) 
Adds a quadratic bezier curve from the shape's last position to a new position.  
void  quadraticTo (Point< float > controlPoint, Point< float > endPoint) 
Adds a quadratic bezier curve from the shape's last position to a new position.  
void  cubicTo (float controlPoint1X, float controlPoint1Y, float controlPoint2X, float controlPoint2Y, float endPointX, float endPointY) 
Adds a cubic bezier curve from the shape's last position to a new position.  
void  cubicTo (Point< float > controlPoint1, Point< float > controlPoint2, Point< float > endPoint) 
Adds a cubic bezier curve from the shape's last position to a new position.  
Point< float >  getCurrentPosition () const 
Returns the last point that was added to the path by one of the drawing methods.  
void  addRectangle (float x, float y, float width, float height) 
Adds a rectangle to the path.  
template<typename ValueType >  
void  addRectangle (Rectangle< ValueType > rectangle) 
Adds a rectangle to the path.  
void  addRoundedRectangle (float x, float y, float width, float height, float cornerSize) 
Adds a rectangle with rounded corners to the path.  
void  addRoundedRectangle (float x, float y, float width, float height, float cornerSizeX, float cornerSizeY) 
Adds a rectangle with rounded corners to the path.  
void  addRoundedRectangle (float x, float y, float width, float height, float cornerSizeX, float cornerSizeY, bool curveTopLeft, bool curveTopRight, bool curveBottomLeft, bool curveBottomRight) 
Adds a rectangle with rounded corners to the path.  
template<typename ValueType >  
void  addRoundedRectangle (Rectangle< ValueType > rectangle, float cornerSizeX, float cornerSizeY) 
Adds a rectangle with rounded corners to the path.  
template<typename ValueType >  
void  addRoundedRectangle (Rectangle< ValueType > rectangle, float cornerSize) 
Adds a rectangle with rounded corners to the path.  
void  addTriangle (float x1, float y1, float x2, float y2, float x3, float y3) 
Adds a triangle to the path.  
void  addTriangle (Point< float > point1, Point< float > point2, Point< float > point3) 
Adds a triangle to the path.  
void  addQuadrilateral (float x1, float y1, float x2, float y2, float x3, float y3, float x4, float y4) 
Adds a quadrilateral to the path.  
void  addEllipse (float x, float y, float width, float height) 
Adds an ellipse to the path.  
void  addEllipse (Rectangle< float > area) 
Adds an ellipse to the path.  
void  addArc (float x, float y, float width, float height, float fromRadians, float toRadians, bool startAsNewSubPath=false) 
Adds an elliptical arc to the current path.  
void  addCentredArc (float centreX, float centreY, float radiusX, float radiusY, float rotationOfEllipse, float fromRadians, float toRadians, bool startAsNewSubPath=false) 
Adds an arc which is centred at a given point, and can have a rotation specified.  
void  addPieSegment (float x, float y, float width, float height, float fromRadians, float toRadians, float innerCircleProportionalSize) 
Adds a "piechart" shape to the path.  
void  addPieSegment (Rectangle< float > segmentBounds, float fromRadians, float toRadians, float innerCircleProportionalSize) 
Adds a "piechart" shape to the path.  
void  addLineSegment (Line< float > line, float lineThickness) 
Adds a line with a specified thickness.  
void  addArrow (Line< float > line, float lineThickness, float arrowheadWidth, float arrowheadLength) 
Adds a line with an arrowhead on the end.  
void  addPolygon (Point< float > centre, int numberOfSides, float radius, float startAngle=0.0f) 
Adds a polygon shape to the path.  
void  addStar (Point< float > centre, int numberOfPoints, float innerRadius, float outerRadius, float startAngle=0.0f) 
Adds a star shape to the path.  
void  addBubble (Rectangle< float > bodyArea, Rectangle< float > maximumArea, const Point< float > arrowTipPosition, const float cornerSize, const float arrowBaseWidth) 
Adds a speechbubble shape to the path.  
void  addPath (const Path &pathToAppend) 
Adds another path to this one.  
void  addPath (const Path &pathToAppend, const AffineTransform &transformToApply) 
Adds another path to this one, transforming it on the way in.  
void  swapWithPath (Path &) noexcept 
Swaps the contents of this path with another one.  
void  preallocateSpace (int numExtraCoordsToMakeSpaceFor) 
Preallocates enough space for adding the given number of coordinates to the path.  
void  applyTransform (const AffineTransform &transform) noexcept 
Applies a 2D transform to all the vertices in the path.  
void  scaleToFit (float x, float y, float width, float height, bool preserveProportions) noexcept 
Rescales this path to make it fit neatly into a given space.  
AffineTransform  getTransformToScaleToFit (float x, float y, float width, float height, bool preserveProportions, Justification justificationType=Justification::centred) const 
Returns a transform that can be used to rescale the path to fit into a given space.  
AffineTransform  getTransformToScaleToFit (Rectangle< float > area, bool preserveProportions, Justification justificationType=Justification::centred) const 
Returns a transform that can be used to rescale the path to fit into a given space.  
Path  createPathWithRoundedCorners (float cornerRadius) const 
Creates a version of this path where all sharp corners have been replaced by curves.  
void  setUsingNonZeroWinding (bool isNonZeroWinding) noexcept 
Changes the windingrule to be used when filling the path.  
bool  isUsingNonZeroWinding () const 
Returns the flag that indicates whether the path should use a nonzero winding rule.  
void  loadPathFromStream (InputStream &source) 
Loads a stored path from a data stream.  
void  loadPathFromData (const void *data, size_t numberOfBytes) 
Loads a stored path from a block of data.  
void  writePathToStream (OutputStream &destination) const 
Stores the path by writing it out to a stream.  
String  toString () const 
Creates a string containing a textual representation of this path.  
void  restoreFromString (StringRef stringVersion) 
Restores this path from a string that was created with the toString() method.  
Static Public Attributes  
static const float  defaultToleranceForTesting 
static const float  defaultToleranceForMeasurement 
A path is a sequence of lines and curves that may either form a closed shape or be openended.
To use a path, you can create an empty one, then add lines and curves to it to create shapes, then it can be rendered by a Graphics context or used for geometric operations.
e.g.
A path object can actually contain multiple subpaths, which may themselves be open or closed.
Path::Path  (  ) 
Creates an empty path.
Path::Path  (  const Path &  ) 
Creates a copy of another path.
Path::~Path  (  ) 
Destructor.

noexcept 
Move constructor.

noexcept 

noexcept 

noexcept 
Returns true if the path doesn't contain any lines or curves.

noexcept 
Returns the smallest rectangle that contains all points within the path.

noexcept 
Returns the smallest rectangle that contains all points within the path after it's been transformed with the given transform matrix.
bool Path::contains  (  float  x, 
float  y,  
float  tolerance = defaultToleranceForTesting 

)  const 
Checks whether a point lies within the path.
This is only relevant for closed paths (see closeSubPath()), and may produce false results if used on a path which has open subpaths.
The path's winding rule is taken into account by this method.
The tolerance parameter is the maximum error allowed when flattening the path, so this method could return a false positive when your point is up to this distance outside the path's boundary.
bool Path::contains  (  Point< float >  point, 
float  tolerance = defaultToleranceForTesting 

)  const 
Checks whether a point lies within the path.
This is only relevant for closed paths (see closeSubPath()), and may produce false results if used on a path which has open subpaths.
The path's winding rule is taken into account by this method.
The tolerance parameter is the maximum error allowed when flattening the path, so this method could return a false positive when your point is up to this distance outside the path's boundary.
bool Path::intersectsLine  (  Line< float >  line, 
float  tolerance = defaultToleranceForTesting 

)  const 
Checks whether a line crosses the path.
This will return positive if the line crosses any of the paths constituent lines or curves. It doesn't take into account whether the line is inside or outside the path, or whether the path is open or closed.
The tolerance parameter is the maximum error allowed when flattening the path, so this method could return a false positive when your point is up to this distance outside the path's boundary.
Cuts off parts of a line to keep the parts that are either inside or outside this path.
Note that this isn't smart enough to cope with situations where the line would need to be cut into multiple pieces to correctly clip against a reentrant shape.
line  the line to clip 
keepSectionOutsidePath  if true, it's the section outside the path that will be kept; if false its the section inside the path 
float Path::getLength  (  const AffineTransform &  transform = AffineTransform() , 
float  tolerance = defaultToleranceForMeasurement 

)  const 
Returns the length of the path.
Point< float > Path::getPointAlongPath  (  float  distanceFromStart, 
const AffineTransform &  transform = AffineTransform() , 

float  tolerance = defaultToleranceForMeasurement 

)  const 
Returns a point that is the specified distance along the path.
If the distance is greater than the total length of the path, this will return the end point.
float Path::getNearestPoint  (  Point< float >  targetPoint, 
Point< float > &  pointOnPath,  
const AffineTransform &  transform = AffineTransform() , 

float  tolerance = defaultToleranceForMeasurement 

)  const 
Finds the point along the path which is nearest to a given position.
This sets pointOnPath to the nearest point, and returns the distance of this point from the start of the path.

noexcept 
Removes all lines and curves, resetting the path completely.
void Path::startNewSubPath  (  float  startX, 
float  startY  
) 
Begins a new subpath with a given starting position.
This will move the path's current position to the coordinates passed in and make it ready to draw lines or curves starting from this position.
After adding whatever lines and curves are needed, you can either close the current subpath using closeSubPath() or call startNewSubPath() to move to a new subpath, leaving the old one openended.
void Path::startNewSubPath  (  Point< float >  start  ) 
Begins a new subpath with a given starting position.
This will move the path's current position to the coordinates passed in and make it ready to draw lines or curves starting from this position.
After adding whatever lines and curves are needed, you can either close the current subpath using closeSubPath() or call startNewSubPath() to move to a new subpath, leaving the old one openended.
void Path::closeSubPath  (  ) 
Closes a the current subpath with a line back to its startpoint.
When creating a closed shape such as a triangle, don't use 3 lineTo() calls  instead use two lineTo() calls, followed by a closeSubPath() to join the final point back to the start.
This ensures that closes shapes are recognised as such, and this is important for tasks like drawing strokes, which needs to know whether to draw endcaps or not.
void Path::lineTo  (  float  endX, 
float  endY  
) 
Adds a line from the shape's last position to a new endpoint.
This will connect the endpoint of the last line or curve that was added to a new point, using a straight line.
See the class description for an example of how to add lines and curves to a path.
void Path::lineTo  (  Point< float >  end  ) 
Adds a line from the shape's last position to a new endpoint.
This will connect the endpoint of the last line or curve that was added to a new point, using a straight line.
See the class description for an example of how to add lines and curves to a path.
void Path::quadraticTo  (  float  controlPointX, 
float  controlPointY,  
float  endPointX,  
float  endPointY  
) 
Adds a quadratic bezier curve from the shape's last position to a new position.
This will connect the endpoint of the last line or curve that was added to a new point, using a quadratic spline with one controlpoint.
See the class description for an example of how to add lines and curves to a path.
Adds a quadratic bezier curve from the shape's last position to a new position.
This will connect the endpoint of the last line or curve that was added to a new point, using a quadratic spline with one controlpoint.
See the class description for an example of how to add lines and curves to a path.
void Path::cubicTo  (  float  controlPoint1X, 
float  controlPoint1Y,  
float  controlPoint2X,  
float  controlPoint2Y,  
float  endPointX,  
float  endPointY  
) 
Adds a cubic bezier curve from the shape's last position to a new position.
This will connect the endpoint of the last line or curve that was added to a new point, using a cubic spline with two controlpoints.
See the class description for an example of how to add lines and curves to a path.
void Path::cubicTo  (  Point< float >  controlPoint1, 
Point< float >  controlPoint2,  
Point< float >  endPoint  
) 
Adds a cubic bezier curve from the shape's last position to a new position.
This will connect the endpoint of the last line or curve that was added to a new point, using a cubic spline with two controlpoints.
See the class description for an example of how to add lines and curves to a path.
Point< float > Path::getCurrentPosition  (  )  const 
Returns the last point that was added to the path by one of the drawing methods.
void Path::addRectangle  (  float  x, 
float  y,  
float  width,  
float  height  
) 
Adds a rectangle to the path.
The rectangle is added as a new subpath. (Any currently open paths will be left open).
Referenced by RectangleList< ValueType >::toPath().
void Path::addRectangle  (  Rectangle< ValueType >  rectangle  ) 
Adds a rectangle to the path.
The rectangle is added as a new subpath. (Any currently open paths will be left open).
void Path::addRoundedRectangle  (  float  x, 
float  y,  
float  width,  
float  height,  
float  cornerSize  
) 
Adds a rectangle with rounded corners to the path.
The rectangle is added as a new subpath. (Any currently open paths will be left open).
void Path::addRoundedRectangle  (  float  x, 
float  y,  
float  width,  
float  height,  
float  cornerSizeX,  
float  cornerSizeY  
) 
Adds a rectangle with rounded corners to the path.
The rectangle is added as a new subpath. (Any currently open paths will be left open).
void Path::addRoundedRectangle  (  float  x, 
float  y,  
float  width,  
float  height,  
float  cornerSizeX,  
float  cornerSizeY,  
bool  curveTopLeft,  
bool  curveTopRight,  
bool  curveBottomLeft,  
bool  curveBottomRight  
) 
Adds a rectangle with rounded corners to the path.
The rectangle is added as a new subpath. (Any currently open paths will be left open).
void Path::addRoundedRectangle  (  Rectangle< ValueType >  rectangle, 
float  cornerSizeX,  
float  cornerSizeY  
) 
Adds a rectangle with rounded corners to the path.
The rectangle is added as a new subpath. (Any currently open paths will be left open).
References Rectangle< ValueType >::getHeight(), Rectangle< ValueType >::getWidth(), Rectangle< ValueType >::getX(), and Rectangle< ValueType >::getY().
void Path::addRoundedRectangle  (  Rectangle< ValueType >  rectangle, 
float  cornerSize  
) 
Adds a rectangle with rounded corners to the path.
The rectangle is added as a new subpath. (Any currently open paths will be left open).
void Path::addTriangle  (  float  x1, 
float  y1,  
float  x2,  
float  y2,  
float  x3,  
float  y3  
) 
Adds a triangle to the path.
The triangle is added as a new closed subpath. (Any currently open paths will be left open).
Note that whether the vertices are specified in clockwise or anticlockwise order will affect how the triangle is filled when it overlaps other shapes (the winding order setting will affect this of course).
Adds a triangle to the path.
The triangle is added as a new closed subpath. (Any currently open paths will be left open).
Note that whether the vertices are specified in clockwise or anticlockwise order will affect how the triangle is filled when it overlaps other shapes (the winding order setting will affect this of course).
void Path::addQuadrilateral  (  float  x1, 
float  y1,  
float  x2,  
float  y2,  
float  x3,  
float  y3,  
float  x4,  
float  y4  
) 
Adds a quadrilateral to the path.
The quad is added as a new closed subpath. (Any currently open paths will be left open).
Note that whether the vertices are specified in clockwise or anticlockwise order will affect how the quad is filled when it overlaps other shapes (the winding order setting will affect this of course).
void Path::addEllipse  (  float  x, 
float  y,  
float  width,  
float  height  
) 
Adds an ellipse to the path.
The shape is added as a new subpath. (Any currently open paths will be left open).
void Path::addEllipse  (  Rectangle< float >  area  ) 
Adds an ellipse to the path.
The shape is added as a new subpath. (Any currently open paths will be left open).
void Path::addArc  (  float  x, 
float  y,  
float  width,  
float  height,  
float  fromRadians,  
float  toRadians,  
bool  startAsNewSubPath = false 

) 
Adds an elliptical arc to the current path.
Note that when specifying the start and end angles, the curve will be drawn either clockwise or anticlockwise according to whether the end angle is greater than the start. This means that sometimes you may need to use values greater than 2*Pi for the end angle.
x  the lefthand edge of the rectangle in which the elliptical outline fits 
y  the top edge of the rectangle in which the elliptical outline fits 
width  the width of the rectangle in which the elliptical outline fits 
height  the height of the rectangle in which the elliptical outline fits 
fromRadians  the angle (clockwise) in radians at which to start the arc segment (where 0 is the topcentre of the ellipse) 
toRadians  the angle (clockwise) in radians at which to end the arc segment (where 0 is the topcentre of the ellipse). This angle can be greater than 2*Pi, so for example to draw a curve clockwise from the 9 o'clock position to the 3 o'clock position via 12 o'clock, you'd use 1.5*Pi and 2.5*Pi as the start and finish points. 
startAsNewSubPath  if true, the arc will begin a new subpath from its starting point; if false, it will be added to the current subpath, continuing from the current position 
void Path::addCentredArc  (  float  centreX, 
float  centreY,  
float  radiusX,  
float  radiusY,  
float  rotationOfEllipse,  
float  fromRadians,  
float  toRadians,  
bool  startAsNewSubPath = false 

) 
Adds an arc which is centred at a given point, and can have a rotation specified.
Note that when specifying the start and end angles, the curve will be drawn either clockwise or anticlockwise according to whether the end angle is greater than the start. This means that sometimes you may need to use values greater than 2*Pi for the end angle.
centreX  the centre x of the ellipse 
centreY  the centre y of the ellipse 
radiusX  the horizontal radius of the ellipse 
radiusY  the vertical radius of the ellipse 
rotationOfEllipse  an angle by which the whole ellipse should be rotated about its centre, in radians (clockwise) 
fromRadians  the angle (clockwise) in radians at which to start the arc segment (where 0 is the topcentre of the ellipse) 
toRadians  the angle (clockwise) in radians at which to end the arc segment (where 0 is the topcentre of the ellipse). This angle can be greater than 2*Pi, so for example to draw a curve clockwise from the 9 o'clock position to the 3 o'clock position via 12 o'clock, you'd use 1.5*Pi and 2.5*Pi as the start and finish points. 
startAsNewSubPath  if true, the arc will begin a new subpath from its starting point; if false, it will be added to the current subpath, continuing from the current position 
void Path::addPieSegment  (  float  x, 
float  y,  
float  width,  
float  height,  
float  fromRadians,  
float  toRadians,  
float  innerCircleProportionalSize  
) 
Adds a "piechart" shape to the path.
The shape is added as a new subpath. (Any currently open paths will be left open).
Note that when specifying the start and end angles, the curve will be drawn either clockwise or anticlockwise according to whether the end angle is greater than the start. This means that sometimes you may need to use values greater than 2*Pi for the end angle.
x  the lefthand edge of the rectangle in which the elliptical outline fits 
y  the top edge of the rectangle in which the elliptical outline fits 
width  the width of the rectangle in which the elliptical outline fits 
height  the height of the rectangle in which the elliptical outline fits 
fromRadians  the angle (clockwise) in radians at which to start the arc segment (where 0 is the topcentre of the ellipse) 
toRadians  the angle (clockwise) in radians at which to end the arc segment (where 0 is the topcentre of the ellipse) 
innerCircleProportionalSize  if this is > 0, then the pie will be drawn as a curved band around a hollow ellipse at its centre, where this value indicates the inner ellipse's size with respect to the outer one. 
void Path::addPieSegment  (  Rectangle< float >  segmentBounds, 
float  fromRadians,  
float  toRadians,  
float  innerCircleProportionalSize  
) 
Adds a "piechart" shape to the path.
The shape is added as a new subpath. (Any currently open paths will be left open).
Note that when specifying the start and end angles, the curve will be drawn either clockwise or anticlockwise according to whether the end angle is greater than the start. This means that sometimes you may need to use values greater than 2*Pi for the end angle.
segmentBounds  the outer rectangle in which the elliptical outline fits 
fromRadians  the angle (clockwise) in radians at which to start the arc segment (where 0 is the topcentre of the ellipse) 
toRadians  the angle (clockwise) in radians at which to end the arc segment (where 0 is the topcentre of the ellipse) 
innerCircleProportionalSize  if this is > 0, then the pie will be drawn as a curved band around a hollow ellipse at its centre, where this value indicates the inner ellipse's size with respect to the outer one. 
void Path::addLineSegment  (  Line< float >  line, 
float  lineThickness  
) 
Adds a line with a specified thickness.
The line is added as a new closed subpath. (Any currently open paths will be left open).
void Path::addArrow  (  Line< float >  line, 
float  lineThickness,  
float  arrowheadWidth,  
float  arrowheadLength  
) 
Adds a line with an arrowhead on the end.
The arrow is added as a new closed subpath. (Any currently open paths will be left open).
void Path::addPolygon  (  Point< float >  centre, 
int  numberOfSides,  
float  radius,  
float  startAngle = 0.0f 

) 
Adds a polygon shape to the path.
void Path::addStar  (  Point< float >  centre, 
int  numberOfPoints,  
float  innerRadius,  
float  outerRadius,  
float  startAngle = 0.0f 

) 
Adds a star shape to the path.
void Path::addBubble  (  Rectangle< float >  bodyArea, 
Rectangle< float >  maximumArea,  
const Point< float >  arrowTipPosition,  
const float  cornerSize,  
const float  arrowBaseWidth  
) 
Adds a speechbubble shape to the path.
bodyArea  the area of the body of the bubble shape 
maximumArea  an area which encloses the body area and defines the limits within which the arrow tip can be drawn  if the tip lies outside this area, the bubble will be drawn without an arrow 
arrowTipPosition  the location of the tip of the arrow 
cornerSize  the size of the rounded corners 
arrowBaseWidth  the width of the base of the arrow where it joins the main rectangle 
void Path::addPath  (  const Path &  pathToAppend  ) 
Adds another path to this one.
The new path is added as a new subpath. (Any currently open paths in this path will be left open).
pathToAppend  the path to add 
void Path::addPath  (  const Path &  pathToAppend, 
const AffineTransform &  transformToApply  
) 
Adds another path to this one, transforming it on the way in.
The new path is added as a new subpath, its points being transformed by the given matrix before being added.
pathToAppend  the path to add 
transformToApply  an optional transform to apply to the incoming vertices 

noexcept 
Swaps the contents of this path with another one.
The internal data of the two paths is swapped over, so this is much faster than copying it to a temp variable and back.
void Path::preallocateSpace  (  int  numExtraCoordsToMakeSpaceFor  ) 
Preallocates enough space for adding the given number of coordinates to the path.
If you're about to add a large number of lines or curves to the path, it can make the task much more efficient to call this first and avoid costly reallocations as the structure grows. The actual value to pass is a bit tricky to calculate because the space required depends on what you're adding  e.g. each lineTo() or startNewSubPath() will require 3 coords (x, y and a type marker). Each quadraticTo() will need 5, and a cubicTo() will require 7. Closing a subpath will require 1.

noexcept 
Applies a 2D transform to all the vertices in the path.

noexcept 
Rescales this path to make it fit neatly into a given space.
This is effectively a quick way of calling applyTransform (getTransformToScaleToFit (x, y, w, h, preserveProportions))
x  the x position of the rectangle to fit the path inside 
y  the y position of the rectangle to fit the path inside 
width  the width of the rectangle to fit the path inside 
height  the height of the rectangle to fit the path inside 
preserveProportions  if true, it will fit the path into the space without altering its horizontal/vertical scale ratio; if false, it will distort the path to fill the specified ratio both horizontally and vertically 
AffineTransform Path::getTransformToScaleToFit  (  float  x, 
float  y,  
float  width,  
float  height,  
bool  preserveProportions,  
Justification  justificationType = Justification::centred 

)  const 
Returns a transform that can be used to rescale the path to fit into a given space.
x  the x position of the rectangle to fit the path inside 
y  the y position of the rectangle to fit the path inside 
width  the width of the rectangle to fit the path inside 
height  the height of the rectangle to fit the path inside 
preserveProportions  if true, it will fit the path into the space without altering its horizontal/vertical scale ratio; if false, it will distort the path to fill the specified ratio both horizontally and vertically 
justificationType  if the proportions are preserved, the resultant path may be smaller than the available rectangle, so this describes how it should be positioned within the space. 
AffineTransform Path::getTransformToScaleToFit  (  Rectangle< float >  area, 
bool  preserveProportions,  
Justification  justificationType = Justification::centred 

)  const 
Returns a transform that can be used to rescale the path to fit into a given space.
area  the rectangle to fit the path inside 
preserveProportions  if true, it will fit the path into the space without altering its horizontal/vertical scale ratio; if false, it will distort the path to fill the specified ratio both horizontally and vertically 
justificationType  if the proportions are preserved, the resultant path may be smaller than the available rectangle, so this describes how it should be positioned within the space. 
Path Path::createPathWithRoundedCorners  (  float  cornerRadius  )  const 
Creates a version of this path where all sharp corners have been replaced by curves.
Wherever two lines meet at an angle, this will replace the corner with a curve of the given radius.

noexcept 
Changes the windingrule to be used when filling the path.
If set to true (which is the default), then the path uses a nonzerowinding rule to determine which points are inside the path. If set to false, it uses an alternatewinding rule.
The windingrule comes into play when areas of the shape overlap other areas, and determines whether the overlapping regions are considered to be inside or outside.
Changing this value just sets a flag  it doesn't affect the contents of the path.
bool Path::isUsingNonZeroWinding  (  )  const 
Returns the flag that indicates whether the path should use a nonzero winding rule.
The default for a new path is true.
void Path::loadPathFromStream  (  InputStream &  source  ) 
Loads a stored path from a data stream.
The data in the stream must have been written using writePathToStream().
Note that this will append the stored path to whatever is currently in this path, so you might need to call clear() beforehand.
void Path::loadPathFromData  (  const void *  data, 
size_t  numberOfBytes  
) 
Loads a stored path from a block of data.
This is similar to loadPathFromStream(), but just reads from a block of data. Useful if you're including stored shapes in your code as a block of static data.
void Path::writePathToStream  (  OutputStream &  destination  )  const 
Stores the path by writing it out to a stream.
After writing out a path, you can reload it using loadPathFromStream().
String Path::toString  (  )  const 
Creates a string containing a textual representation of this path.
void Path::restoreFromString  (  StringRef  stringVersion  ) 
Restores this path from a string that was created with the toString() method.

static 

static 