Add API Javadocs for ClipperBase, Clipper64, and ClipperD

[Copilot]

This updates the public-facing clipping APIs to add missing Javadocs across ClipperBase, Clipper64, and ClipperD. The goal is to make the core entry points and result-building methods self-describing in generated API docs without changing runtime behavior.

• ClipperBase API coverage

  • Documented core configuration and lifecycle methods such as:
    • getPreserveCollinear()
    • getReverseSolution()
    • setReverseSolution(...)
    • clear()
    • getBounds()
  • Added Javadocs for path-loading methods and reusable-data entry points:
    • addSubject(...)
    • addOpenSubject(...)
    • addClip(...)
    • addPath(...)
    • addPaths(...)
    • addReuseableData(...)
  • Documented solution-construction helpers used by subclasses:
    • ExecuteInternal(...)
    • buildPath(...)
    • BuildPaths(...)
    • BuildTree(...)

• Clipper64 execute overloads

  • Added Javadocs for the public execute(...) overloads returning:
    • Paths64
    • PolyTree64
  • Documented the reusable-data override so the long-coordinate API is fully covered in generated docs.

• ClipperD double-coordinate API

  • Documented constructors, including precision behavior for internal scaling.
  • Added Javadocs for all public path-loading helpers:
    • addPath(...)
    • addPaths(...)
    • addSubject(...)
    • addOpenSubject(...)
    • addClip(...)
    • plural variants for each
  • Added Javadocs for all execute(...) overloads returning:
    • PathsD
    • PolyTreeD

• Example

  • The updated docs now describe usage directly at the API boundary, e.g.:

ClipperD clipper = new ClipperD(3);
clipper.addSubject(subjectPaths);
clipper.addClips(clipPaths);

PathsD closed = new PathsD();
PathsD open = new PathsD();
clipper.execute(ClipType.Union, FillRule.NonZero, closed, open);

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.