Package com.pdftools.toolbox.pdf.annotations

Class PolygonAnnotation

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

public class PolygonAnnotation
extends DrawingAnnotation

A polygon annotation

Method Summary

Modifier and Type	Method	Description
static PolygonAnnotation	create(Document targetDocument, Path path, Stroke stroke, Paint fill)	Create a polygon annotation.
Paint	getFill()	The filling paint (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 PolygonAnnotation create(Document targetDocument,
                                       Path path,
                                       Stroke stroke,
                                       Paint fill)
                                throws ConformanceException,
                                       UnsupportedFeatureException

Create a polygon annotation.

The returned polygon 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 polygon.

stroke - The stroking parameters used for stroking the polygon. The stroking paint is used as the annotation's main paint. If null then the polygon is not filled.

fill - The paint used for filling the polygon. If null then the polygon is not filled.

Returns:

The newly created polygon 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 path argument has not been constructed with a toolbox.pdf.content.PathGenerator

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 stroke and fill arguments are both null

java.lang.IllegalArgumentException - if the stroke argument is not associated with 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

java.lang.IllegalArgumentException - if the fill has a toolbox.pdf.content.Paint.getColorSpace other than a device color space

java.lang.IllegalArgumentException - if the fill 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 fill argument is not associated with the targetDocument

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

getFill

public Paint getFill()

The filling paint (Getter)

Throws:

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