Package 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	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	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)) 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)) 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 Details

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 Details

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)) 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)) 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.