com.itextpdf.kernel.pdf.canvas.parser.clipper

Class ClipperBridge

java.lang.Object

com.itextpdf.kernel.pdf.canvas.parser.clipper.ClipperBridge

public final class ClipperBridge
extends Object

This class contains variety of methods allowing to convert iText abstractions into the abstractions of the Clipper library and vise versa.

For example:

• PolyTree to Path
• Point to Point.LongPoint
• Point.LongPoint to Point

Field Summary

Fields

Modifier and Type	Field and Description
static double	floatMultiplier Since the clipper library uses integer coordinates, we should convert our floating point numbers into fixed point numbers by multiplying by this coefficient.

Method Summary

Modifier and Type	Method and Description
static List<Subpath>	addPath(ClipperOffset offset, Path path, IClipper.JoinType joinType, IClipper.EndType endType) Adds all iText Subpaths of the iText Path to the ClipperOffset object with one note: it doesn't add degenerate subpaths.
static void	addPath(IClipper clipper, Path path, IClipper.PolyType polyType) Adds iText Path to the given IClipper object.
static boolean	addPolygonToClipper(IClipper clipper, Point[] polyVertices, IClipper.PolyType polyType) Adds polygon path based on array of Point (internally converting them by convertToLongPoints(java.util.List<com.itextpdf.kernel.geom.Point>)) and adds this path to IClipper instance, treating the path as a closed polygon.
static boolean	addPolylineSubjectToClipper(IClipper clipper, Point[] lineVertices) Adds polyline path based on array of Point (internally converting them by convertToLongPoints(java.util.List<com.itextpdf.kernel.geom.Point>)) and adds this path to IClipper instance, treating the path as a polyline (an open path in terms of clipper library).
static List<Point>	convertToFloatPoints(List<Point.LongPoint> points) Converts list of Point.LongPoint objects into list of Point objects.
static List<Point.LongPoint>	convertToLongPoints(List<Point> points) Converts list of Point objects into list of Point.LongPoint objects.
static Path	convertToPath(PolyTree result) Converts Clipper library PolyTree abstraction into iText Path object.
static IClipper.EndType	getEndType(int lineCapStyle) Converts iText line cap style constant into the corresponding constant of the Clipper library.
static IClipper.PolyFillType	getFillType(int fillingRule) Converts iText filling rule constant into the corresponding constant of the Clipper library.
static IClipper.JoinType	getJoinType(int lineJoinStyle) Converts iText line join style constant into the corresponding constant of the Clipper library.

Methods inherited from class java.lang.Object

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

Field Detail

floatMultiplier

public static double floatMultiplier

Since the clipper library uses integer coordinates, we should convert our floating point numbers into fixed point numbers by multiplying by this coefficient. Vary it to adjust the preciseness of the calculations.

Method Detail

convertToPath

public static Path convertToPath(PolyTree result)

Converts Clipper library PolyTree abstraction into iText Path object.

Parameters:

result - PolyTree object to convert

Returns:

resultant Path object

addPath

public static void addPath(IClipper clipper,
                           Path path,
                           IClipper.PolyType polyType)

Adds iText Path to the given IClipper object.

Parameters:

clipper - The IClipper object.

path - The Path object to be added to the IClipper.

polyType - See IClipper.PolyType.

addPath

public static List<Subpath> addPath(ClipperOffset offset,
                                    Path path,
                                    IClipper.JoinType joinType,
                                    IClipper.EndType endType)

Adds all iText Subpaths of the iText Path to the ClipperOffset object with one note: it doesn't add degenerate subpaths.

Parameters:

offset - the ClipperOffset object to add all iText Subpaths that are not degenerated.

path - Path object, containing the required Subpaths

joinType - IClipper join type. The value could be IClipper.JoinType.BEVEL, IClipper.JoinType.ROUND, IClipper.JoinType.MITER

endType - IClipper end type. The value could be IClipper.EndType.CLOSED_POLYGON, IClipper.EndType.CLOSED_LINE, IClipper.EndType.OPEN_BUTT, IClipper.EndType.OPEN_SQUARE, IClipper.EndType.OPEN_ROUND

Returns:

List consisting of all degenerate iText Subpaths of the path.

convertToFloatPoints

public static List<Point> convertToFloatPoints(List<Point.LongPoint> points)

Converts list of Point.LongPoint objects into list of Point objects.

Parameters:

points - the list of Point.LongPoint objects to convert

Returns:

the resultant list of Point objects.

convertToLongPoints

public static List<Point.LongPoint> convertToLongPoints(List<Point> points)

Converts list of Point objects into list of Point.LongPoint objects.

Parameters:

points - the list of Point objects to convert

Returns:

the resultant list of Point.LongPoint objects.

getJoinType

public static IClipper.JoinType getJoinType(int lineJoinStyle)

Converts iText line join style constant into the corresponding constant of the Clipper library.

Parameters:

lineJoinStyle - iText line join style constant. See PdfCanvasConstants

Returns:

Clipper line join style constant.

getEndType

public static IClipper.EndType getEndType(int lineCapStyle)

Converts iText line cap style constant into the corresponding constant of the Clipper library.

Parameters:

lineCapStyle - iText line cap style constant. See PdfCanvasConstants

Returns:

Clipper line cap (end type) style constant.

getFillType

public static IClipper.PolyFillType getFillType(int fillingRule)

Converts iText filling rule constant into the corresponding constant of the Clipper library.

Parameters:

fillingRule - Either PdfCanvasConstants.FillingRule.NONZERO_WINDING or PdfCanvasConstants.FillingRule.EVEN_ODD.

Returns:

Clipper fill type constant.

addPolygonToClipper

public static boolean addPolygonToClipper(IClipper clipper,
                                          Point[] polyVertices,
                                          IClipper.PolyType polyType)

Adds polygon path based on array of Point (internally converting them by convertToLongPoints(java.util.List<com.itextpdf.kernel.geom.Point>)) and adds this path to IClipper instance, treating the path as a closed polygon.

The return value will be false if the path is invalid for clipping. A path is invalid for clipping when:

• it has less than 3 vertices;
• the vertices are all co-linear.

Parameters:

clipper - IClipper instance to which the created polygon path will be added.

polyVertices - an array of Point which will be internally converted to clipper path and added to the clipper instance.

polyType - either IClipper.PolyType.SUBJECT or IClipper.PolyType.CLIP denoting whether added path is a subject of clipping or a part of the clipping polygon.

Returns:

true if polygon path was successfully added, false otherwise.

addPolylineSubjectToClipper

public static boolean addPolylineSubjectToClipper(IClipper clipper,
                                                  Point[] lineVertices)

Adds polyline path based on array of Point (internally converting them by convertToLongPoints(java.util.List<com.itextpdf.kernel.geom.Point>)) and adds this path to IClipper instance, treating the path as a polyline (an open path in terms of clipper library). This path is added to the subject of future clipping. Polylines cannot be part of clipping polygon.

The return value will be false if the path is invalid for clipping. A path is invalid for clipping when:

• it has less than 2 vertices;

Parameters:

clipper - IClipper instance to which the created polyline path will be added.

lineVertices - an array of Point which will be internally converted to clipper path and added to the clipper instance.

Returns:

true if polyline path was successfully added, false otherwise.