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

Class ClipperBridge

java.lang.Object

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

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

Constructor Summary

Constructors

Constructor and Description
ClipperBridge()

Method Summary

Modifier and Type	Method and Description
static void	addContour(Path path, List<Point.LongPoint> contour, Boolean close) Deprecated. close will be boolean. Visibility will be changed to internal.
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 void	addRectToClipper(IClipper clipper, Point[] rectVertices, IClipper.PolyType polyType)
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.

Constructor Detail

ClipperBridge

public ClipperBridge()

Method Detail

convertToPath

public static Path convertToPath(PolyTree result)

Converts Clipper library PolyTree abstraction into iText 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.

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.

convertToLongPoints

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

Converts list of Point objects into 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.

addContour

@Deprecated
public static void addContour(Path path,
                                          List<Point.LongPoint> contour,
                                          Boolean close)

Deprecated. close will be boolean. Visibility will be changed to internal.

addRectToClipper

public static void addRectToClipper(IClipper clipper,
                                    Point[] rectVertices,
                                    IClipper.PolyType polyType)