Package limn.graphics

Class Path2D

java.lang.Object

limn.graphics.Path2D

public final class Path2D
extends Object

Mutable 2D path: move/line/quadratic/cubic segments and closed subpaths, in logical points. Curves are consumed via flatten(float, limn.graphics.Path2D.Flattened), which subdivides them adaptively into line segments within a given tolerance; backends never see curves.

V1 limitations (documented, revisited with the widget set): filling uses each closed subpath independently, with no even-odd/non-zero interaction between subpaths, so paths with holes render as overlapping fills; self-intersecting subpaths are unsupported.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	Path2D.Flattened	Receives the flattened (curve-free) form of a path.
static interface	Path2D.Visitor	Receives a path as it was built: its moves, lines, curves and closes, in order and in the path's own coordinates.

Constructor Summary

Constructors

Constructor	Description
Path2D()

Method Summary

Modifier and Type	Method	Description
Path2D	close()	Closes the current subpath (straight line back to its starting point).
Path2D	copy()	A path of its own with the same segments: what a caller that keeps a path past the call it was handed in takes, since the one it was handed may be reset and reused for the next frame.
Path2D	cubicTo(float c1x, float c1y, float c2x, float c2y, float x, float y)	Cubic Bézier to (x,y) with control points (c1x,c1y) and (c2x,c2y).
void	flatten(float tolerance, Path2D.Flattened out)	Replays this path with curves adaptively subdivided so that no flattened segment deviates from the true curve by more than tolerance (same units as the path coordinates).
void	forEach(Path2D.Visitor out)	Replays this path as it was built, curves as curves.
boolean	isEmpty()	Whether the path has nothing to draw.
Path2D	lineTo(float x, float y)	Extends the current subpath; a no-op before the first moveTo(float, float).
Path2D	moveTo(float x, float y)	Starts a new subpath at a point, in logical points.
Path2D	quadTo(float cx, float cy, float x, float y)	Quadratic Bézier to (x,y) with control point (cx,cy).
void	reset()	Clears every subpath, keeping the allocated capacity so the path can be reused per frame.

Methods inherited from class java.lang.Object

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

Constructor Details

Path2D

public Path2D()

Method Details

moveTo

public Path2D moveTo(float x,
 float y)

Starts a new subpath at a point, in logical points.

lineTo

public Path2D lineTo(float x,
 float y)

Extends the current subpath; a no-op before the first moveTo(float, float).

quadTo

public Path2D quadTo(float cx,
 float cy,
 float x,
 float y)

Quadratic Bézier to (x,y) with control point (cx,cy).

cubicTo

public Path2D cubicTo(float c1x,
 float c1y,
 float c2x,
 float c2y,
 float x,
 float y)

Cubic Bézier to (x,y) with control points (c1x,c1y) and (c2x,c2y).

close

public Path2D close()

Closes the current subpath (straight line back to its starting point).

isEmpty

public boolean isEmpty()

Whether the path has nothing to draw.

reset

public void reset()

Clears every subpath, keeping the allocated capacity so the path can be reused per frame.

forEach

public void forEach(Path2D.Visitor out)

Replays this path as it was built, curves as curves.

Parameters:

out - receives each segment in order

copy

public Path2D copy()

A path of its own with the same segments: what a caller that keeps a path past the call it was handed in takes, since the one it was handed may be reset and reused for the next frame.

Returns:

the copy

flatten

public void flatten(float tolerance,
 Path2D.Flattened out)

Replays this path with curves adaptively subdivided so that no flattened segment deviates from the true curve by more than tolerance (same units as the path coordinates).