com.itextpdf.pdfcleanup

Class PathOffsetApproximationProperties

java.lang.Object

com.itextpdf.pdfcleanup.PathOffsetApproximationProperties

public class PathOffsetApproximationProperties
extends Object

Contains properties for ClipperOffset operations.

Constructor Summary

Constructors

Constructor and Description
PathOffsetApproximationProperties() Creates new PathOffsetApproximationProperties instance.

Method Summary

Modifier and Type	Method and Description
boolean	calculateOffsetMultiplierDynamically() Checks whether floatMultiplier should be calculated dynamically.
PathOffsetApproximationProperties	calculateOffsetMultiplierDynamically(boolean calculateDynamically) Specifies if floatMultiplier should be calculated dynamically.
double	getArcTolerance() Gets arc tolerance which is the maximum difference between the true and the faceted representation of curves (arcs) in units.
PathOffsetApproximationProperties	setArcTolerance(double arcTolerance) Sets arc tolerance which is the maximum difference between the true and the faceted representation of curves (arcs) in units.

Methods inherited from class java.lang.Object

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

Constructor Detail

PathOffsetApproximationProperties

public PathOffsetApproximationProperties()

Creates new PathOffsetApproximationProperties instance.

Method Detail

calculateOffsetMultiplierDynamically

public PathOffsetApproximationProperties calculateOffsetMultiplierDynamically(boolean calculateDynamically)

Specifies if floatMultiplier should be calculated dynamically. Default value is false.

When a document with line arts is being cleaned up, there are a lot of calculations with floating point numbers. All of them are translated into fixed point numbers by multiplying by this floatMultiplier coefficient. It is possible to dynamically adjust the preciseness of the calculations.

Parameters:

calculateDynamically - true if floatMultiplier should be calculated dynamically, false for default value specified by ClipperBridge.ClipperBridge()

Returns:

this PathOffsetApproximationProperties instance

calculateOffsetMultiplierDynamically

public boolean calculateOffsetMultiplierDynamically()

Checks whether floatMultiplier should be calculated dynamically.

When a document with line arts is being cleaned up, there are a lot of calculations with floating point numbers. All of them are translated into fixed point numbers by multiplying by this floatMultiplier coefficient. It is possible to dynamically adjust the preciseness of the calculations.

Returns:

true if floatMultiplier should be calculated dynamically, false for default value

getArcTolerance

public double getArcTolerance()

Gets arc tolerance which is the maximum difference between the true and the faceted representation of curves (arcs) in units. Used as the criterion of a good approximation of rounded line joins and line caps.

Since flattened paths can never perfectly represent arcs, this field/property specifies a maximum acceptable imprecision (tolerance) when arcs are approximated in an offsetting operation. Smaller values will increase smoothness up to a point though at a cost of performance and in creating more vertices to construct the arc.

Returns:

arc tolerance specifying maximum difference between the true and the faceted representation of arcs

setArcTolerance

public PathOffsetApproximationProperties setArcTolerance(double arcTolerance)

Sets arc tolerance which is the maximum difference between the true and the faceted representation of curves (arcs) in units. Used as the criterion of a good approximation of rounded line joins and line caps.

Since flattened paths can never perfectly represent arcs, this field/property specifies a maximum acceptable imprecision (tolerance) when arcs are approximated in an offsetting operation. Smaller values will increase smoothness up to a point though at a cost of performance and in creating more vertices to construct the arc.

Parameters:

arcTolerance - maximum difference between the true and the faceted representation of arcs

Returns:

this PathOffsetApproximationProperties instance