Module java.desktop
Package java.awt.geom

# Class GeneralPath

java.lang.Object
java.awt.geom.Path2D
java.awt.geom.Path2D.Float
java.awt.geom.GeneralPath

All Implemented Interfaces:
  `Shape`, `Serializable`, `Cloneable`

public final class GeneralPath extends Path2D.Float
The `GeneralPath` class represents a geometric path constructed from straight lines, and quadratic and cubic (Bézier) curves. It can contain multiple subpaths.

`GeneralPath` is a legacy final class which exactly implements the behavior of its superclass `Path2D.Float`. Together with `Path2D.Double`, the `Path2D` classes provide full implementations of a general geometric path that support all of the functionality of the `Shape` and `PathIterator` interfaces with the ability to explicitly select different levels of internal coordinate precision.

Use `Path2D.Float` (or this legacy `GeneralPath` subclass) when dealing with data that can be represented and used with floating point precision. Use `Path2D.Double` for data that requires the accuracy or range of double precision.

Since:
  1.2
See Also:
  - Serialized Form

- ## Nested Class Summary

  ## Nested classes/interfaces declared in class java.awt.geom.Path2D

  `Path2D.Double, Path2D.Float`

- ## Field Summary

  ### Fields declared in class java.awt.geom.Path2D

  `WIND_EVEN_ODD, WIND_NON_ZERO`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `GeneralPath()`
  Constructs a new empty single precision `GeneralPath` object with a default winding rule of `Path2D.WIND_NON_ZERO`.
  `GeneralPath(int rule)`
  Constructs a new `GeneralPath` object with the specified winding rule to control operations that require the interior of the path to be defined.
  `GeneralPath(int rule, int initialCapacity)`
  Constructs a new `GeneralPath` object with the specified winding rule and the specified initial capacity to store path coordinates.
  `GeneralPath(Shape s)`
  Constructs a new `GeneralPath` object from an arbitrary `Shape` object.

- ## Method Summary

  ### Methods declared in class java.awt.geom.Path2D.Float

  `append, clone, curveTo, curveTo, getBounds2D, getPathIterator, lineTo, lineTo, moveTo, moveTo, quadTo, quadTo, transform, trimToSize`

  ### Methods declared in 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 declared in class java.lang.Object

  `equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Constructor Details

  - ### GeneralPath

    public GeneralPath()
    Constructs a new empty single precision `GeneralPath` object with a default winding rule of `Path2D.WIND_NON_ZERO`.
    Since:
      1.2

  - ### GeneralPath

    public GeneralPath(int rule)
    Constructs a new `GeneralPath` object with the specified winding rule to control operations that require the interior of the path to be defined.
    Parameters:
      `rule` - the winding rule
    Throws:
      `IllegalArgumentException` - if `rule` is not either `Path2D.WIND_EVEN_ODD` or `Path2D.WIND_NON_ZERO`
    Since:
      1.2
    See Also:
      - `Path2D.WIND_EVEN_ODD`
      - `Path2D.WIND_NON_ZERO`

  - ### GeneralPath

    public GeneralPath(int rule, int initialCapacity)
    Constructs a new `GeneralPath` object with the specified winding rule and the specified initial capacity to store path coordinates. 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.
    Parameters:
      `rule` - the winding rule
      `initialCapacity` - the estimate for the number of path segments in the path
    Throws:
      `IllegalArgumentException` - if `rule` is not either `Path2D.WIND_EVEN_ODD` or `Path2D.WIND_NON_ZERO`
      `NegativeArraySizeException` - if `initialCapacity` is negative
    Since:
      1.2
    See Also:
      - `Path2D.WIND_EVEN_ODD`
      - `Path2D.WIND_NON_ZERO`

  - ### GeneralPath

    public GeneralPath(Shape s)
    Constructs a new `GeneralPath` 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.
    Parameters:
      `s` - the specified `Shape` object
    Throws:
      `NullPointerException` - if `s` is `null`
    Since:
      1.2