Package com.pdftools.toolbox.pdf.annotations

Class PolyLineAnnotation

java.lang.Object

com.pdftools.toolbox.internal.NativeBase

com.pdftools.toolbox.internal.NativeObject

com.pdftools.toolbox.pdf.annotations.Annotation

com.pdftools.toolbox.pdf.annotations.MarkupAnnotation

com.pdftools.toolbox.pdf.annotations.DrawingAnnotation

com.pdftools.toolbox.pdf.annotations.PolyLineAnnotation

public class PolyLineAnnotation
extends DrawingAnnotation

A drawing annotation that consists of several line segments

Method Summary

Modifier and Type	Method	Description
static PolyLineAnnotation	create(Document targetDocument, Path path, Stroke stroke)	Create a poly-line annotation.
LineEnding	getEndStyle()	The ending point's style (Getter)
Paint	getLineEndingFill()	The line ending filling paint for both start and end (Getter)
LineEnding	getStartStyle()	The starting point's style (Getter)

Methods inherited from class com.pdftools.toolbox.pdf.annotations.DrawingAnnotation

getPaint, getPopup

Methods inherited from class com.pdftools.toolbox.pdf.annotations.MarkupAnnotation

getInfo, getLocked, getReplies

Methods inherited from class com.pdftools.toolbox.pdf.annotations.Annotation

copy, getBoundingBox, getHidden, getId, getNoPrint, getNoRotate, getNoZoom

Methods inherited from class com.pdftools.toolbox.internal.NativeObject

equals, hashCode

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static PolyLineAnnotation create(Document targetDocument,
                                        Path path,
                                        Stroke stroke)
                                 throws ConformanceException,
                                        UnsupportedFeatureException

Create a poly-line annotation.

The returned poly-line annotation is not yet part of any page. It can be added to a page's list of annotations.

Parameters:

targetDocument - The output document with which the returned object is associated.

path - The path of the poly line.

stroke - The stroking parameters used for stroking the poly-line. The stroking paint is used as the annotation's main paint.

Returns:

The newly created poly-line annotation.

Throws:

java.lang.IllegalArgumentException - if the targetDocument has already been closed

java.lang.IllegalArgumentException - if the targetDocument is read-only

java.lang.IllegalArgumentException - if the targetDocument's conformance is not PDF 2.0 and the path argument contains curve-to operations

java.lang.IllegalArgumentException - if the path argument contains close-subpath or rectangle operations

UnsupportedFeatureException - if the targetDocument's conformance is PDF 2.0 and the path argument contains curve-to operations

java.lang.IllegalArgumentException - if the path argument has not been constructed with a toolbox.pdf.content.PathGenerator

java.lang.IllegalArgumentException - if the stroke argument is not associated with the targetDocument

java.lang.IllegalArgumentException - if the stroke's toolbox.pdf.content.Stroke.getPaint has a toolbox.pdf.content.Paint.getColorSpace other than a device color space

java.lang.IllegalArgumentException - if the stroke's toolbox.pdf.content.Stroke.getPaint has a non-nulltoolbox.pdf.content.Paint.getTransparency with toolbox.pdf.content.Transparency.getBlendMode other than toolbox.pdf.content.BlendMode.NORMAL

java.lang.IllegalArgumentException - if the stroke argument's toolbox.pdf.content.Stroke.getLineCapStyle is other than toolbox.pdf.content.LineCapStyle.BUTT

java.lang.IllegalArgumentException - if the stroke argument's toolbox.pdf.content.Stroke.getLineJoinStyle is other than toolbox.pdf.content.LineJoinStyle.MITER

java.lang.IllegalArgumentException - if the stroke argument's toolbox.pdf.content.Stroke.getMiterLimit is other than 10

java.lang.IllegalArgumentException - if the stroke argument's toolbox.pdf.content.Stroke.getDashPhase is other than 0

ConformanceException - if the explicitly requested PDF conformance is smaller than PDF 1.5

java.lang.IllegalArgumentException - if targetDocument is null

java.lang.IllegalArgumentException - if path is null

java.lang.IllegalArgumentException - if stroke is null

getStartStyle

public LineEnding getStartStyle()

The starting point's style (Getter)

Throws:

java.lang.IllegalStateException - if the object has already been closed

getEndStyle

public LineEnding getEndStyle()

The ending point's style (Getter)

Throws:

java.lang.IllegalStateException - if the object has already been closed

getLineEndingFill

public Paint getLineEndingFill()

The line ending filling paint for both start and end (Getter)

Throws:

java.lang.IllegalStateException - if the object has already been closed