Index

  1. \setasign\SetaPDF2
    1. Core
      1. Document
      2. Document
        1. Page
        2. Page
          1. Annotation
            1. AdditionalActions
            2. Annotation
            3. AppearanceCharacteristics
            4. BorderEffect
            5. BorderStyle
            6. CaretAnnotation
            7. CircleAnnotation
            8. FileAttachmentAnnotation
            9. Flags
            10. FreeTextAnnotation
            11. HighlightAnnotation
            12. InkAnnotation
            13. LineAnnotation
            14. LineEndingStyle
            15. LinkAnnotation
            16. MarkupAnnotation
            17. PolyLineAnnotation
            18. PolygonAnnotation
            19. PopupAnnotation
            20. QuadPointsTrait
            21. ScreenAnnotation
            22. SquareAnnotation
            23. SquigglyAnnotation
            24. StampAnnotation
            25. StrikeOutAnnotation
            26. TextAnnotation
            27. TextMarkupAnnotation
            28. UnderlineAnnotation
            29. Widget
            30. WidgetAnnotation

setasign\SetaPDF2\Core\Document\Page\Annotation

PolygonAnnotation Class representing a polygon annotation

File: /SetaPDF v2/Core/Document/Page/Annotation/PolygonAnnotation.php
Old class name (alias): \SetaPDF_Core_Document_Page_Annotation_Polygon

See PDF 32000-1:2008 - 12.5.6.13

Class hierarchy

Summary

Static Methods

Methods

Properties

Constants

Constants

TYPE_3D

public const string Annotation::TYPE_3D = '3D'

Annotation type

TYPE_CARET

public const string Annotation::TYPE_CARET = 'Caret'

Annotation type

TYPE_CIRCLE

public const string Annotation::TYPE_CIRCLE = 'Circle'

Annotation type

TYPE_FILE_ATTACHMENT

public const string Annotation::TYPE_FILE_ATTACHMENT = 'FileAttachment'

Annotation type

TYPE_FREE_TEXT

public const string Annotation::TYPE_FREE_TEXT = 'FreeText'

Annotation type

TYPE_HIGHLIGHT

public const string Annotation::TYPE_HIGHLIGHT = 'Highlight'

Annotation type

TYPE_INK

public const string Annotation::TYPE_INK = 'Ink'

Annotation type

TYPE_LINE

public const string Annotation::TYPE_LINE = 'Line'

Annotation type

TYPE_LINK

public const string Annotation::TYPE_LINK = 'Link'

Annotation type

TYPE_MOVIE

public const string Annotation::TYPE_MOVIE = 'Movie'

Annotation type

TYPE_POLYGON

public const string Annotation::TYPE_POLYGON = 'Polygon'

Annotation type

TYPE_POLY_LINE

public const string Annotation::TYPE_POLY_LINE = 'PolyLine'

Annotation type

TYPE_POPUP

public const string Annotation::TYPE_POPUP = 'Popup'

Annotation type

TYPE_PRINTER_MARK

public const string Annotation::TYPE_PRINTER_MARK = 'PrinterMark'

Annotation type

TYPE_REDACT

public const string Annotation::TYPE_REDACT = 'Redact'

Annotation type

TYPE_SCREEN

public const string Annotation::TYPE_SCREEN = 'Screen'

Annotation type

TYPE_SOUND

public const string Annotation::TYPE_SOUND = 'Sound'

Annotation type

TYPE_SQUARE

public const string Annotation::TYPE_SQUARE = 'Square'

Annotation type

TYPE_SQUIGGLY

public const string Annotation::TYPE_SQUIGGLY = 'Squiggly'

Annotation type

TYPE_STAMP

public const string Annotation::TYPE_STAMP = 'Stamp'

Annotation type

TYPE_STRIKE_OUT

public const string Annotation::TYPE_STRIKE_OUT = 'StrikeOut'

Annotation type

TYPE_TEXT

public const string Annotation::TYPE_TEXT = 'Text'

Annotation type

TYPE_TRAP_NET

public const string Annotation::TYPE_TRAP_NET = 'TrapNet'

Annotation type

TYPE_UNDERLINE

public const string Annotation::TYPE_UNDERLINE = 'Underline'

Annotation type

TYPE_WATERMARK

public const string Annotation::TYPE_WATERMARK = 'Watermark'

Annotation type

TYPE_WIDGET

public const string Annotation::TYPE_WIDGET = 'Widget'

Annotation type


Properties

$_additionalActions

protected AdditionalActions Annotation::$_additionalActions

$_annotationDictionary

protected \setasign\SetaPDF2\Core\Type\PdfDictionary Annotation::$_annotationDictionary

The annotation dictionary

$_borderStyle

protected BorderStyle PolygonAnnotation::$_borderStyle

$_indirectReference

protected \setasign\SetaPDF2\Core\Type\IndirectObjectInterface Annotation::$_indirectReference

$_rect

protected \setasign\SetaPDF2\Core\DataStructure\Rectangle Annotation::$_rect

The rectangle


Static Methods

_createAnnotationDictionary()

protected static Annotation::_createAnnotationDictionary (): \setasign\SetaPDF2\Core\Type\PdfDictionary

Creates an annotation dictionary with default values.

Parameters
$rect : \setasign\SetaPDF2\Core\DataStructure\Rectangle|array
 
$subtype : string
 

byObjectOrDictionary()

public static Annotation::byObjectOrDictionary (): Annotation

Creates an annotation object by an annotation dictionary or its parent object.

Parameters
$objectOrDictionary : \setasign\SetaPDF2\Core\Type\PdfDictionary|\setasign\SetaPDF2\Core\Type\IndirectObjectInterface
 
Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

Throws \InvalidArgumentException

createAnnotationDictionary()

public static PolygonAnnotation::createAnnotationDictionary (): \setasign\SetaPDF2\Core\Type\PdfDictionary

Creates a polygon annotation dictionary.

Parameters
$rect : \setasign\SetaPDF2\Core\DataStructure\Rectangle|array
 
Exceptions

Throws \InvalidArgumentException


Methods

__construct()

public PolygonAnnotation::__construct ()

The constructor.

Parameters
$objectOrDictionary : array|\setasign\SetaPDF2\Core\Type\AbstractType|\setasign\SetaPDF2\Core\Type\PdfDictionary|\setasign\SetaPDF2\Core\Type\IndirectObjectInterface
 
Exceptions

Throws \InvalidArgumentException

Throws \setasign\SetaPDF2\Core\Type\Exception

_getReplies()

private MarkupAnnotation::_getReplies (
\setasign\SetaPDF2\Core\Document\Page\Annotations $annotations,
bool $onlyCheckForExistance
): array|bool

Get all replies or checks for their existence.

Parameters
$annotations : \setasign\SetaPDF2\Core\Document\Page\Annotations
 
$onlyCheckForExistance : bool
 
Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

addReply()

public MarkupAnnotation::addReply (
MarkupAnnotation $annotation
): void

Adds a reply to this annotation.

Parameters
$annotation : MarkupAnnotation
 

cleanUp()

public PolygonAnnotation::cleanUp (
void
): void

Release memory/cycled references.

createPopup()

public MarkupAnnotation::createPopup (
int|float $offsetX = 30,
int|float $offsetY = 20,
int|float $width = 150,
int|float $height = 100
): PopupAnnotation

Create a popup annotation object for this annotation.

If the x-offset value is less than zero the popup will be created on the left side of the main annotation otherwise on the right side. If the y-offset value is less than zero the popup will be created down below the main annotation otherwise above.

You need to re-add this new popup annotation to its origin annotation by passing it to the addPopup() method after assigning it to the page object.

Parameters
$offsetX : int|float
 
$offsetY : int|float
 
$width : int|float
 
$height : int|float
 
Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getAdditionalActions()

public Annotation::getAdditionalActions (
void
): AdditionalActions

Gets the additional actions object instance for this annotation.

getAnnotationDictionary()

WARNING: This method is marked as deprecated!

public Annotation::getAnnotationDictionary (
void
): \setasign\SetaPDF2\Core\Type\PdfDictionary

Get the annotation dictionary.

getAppearance()

public Annotation::getAppearance (
string $type = 'N',
?string $subName = null
): ?\setasign\SetaPDF2\Core\XObject\Form

Get the annotation appearance stream.

Parameters
$type : string
 
$subName : ?string
 
Exceptions

Throws \InvalidArgumentException

getBorderEffect()

public PolygonAnnotation::getBorderEffect (
bool $create = false
): ?BorderEffect

Get the border effect object.

Parameters
$create : bool
 
Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getBorderStyle()

public PolygonAnnotation::getBorderStyle (
void
): ?BorderStyle

Get the border style object.

getColor()

public Annotation::getColor (
void
): ?\setasign\SetaPDF2\Core\DataStructure\Color\AbstractColor

Get the color of the annotation.

getContents()

public Annotation::getContents (
string $encoding = 'UTF-8'
): ?string

Get the contents of the annotation.

Parameters
$encoding : string
 

getCreationDate()

public MarkupAnnotation::getCreationDate (
bool $asString = true
): null|mixed|\setasign\SetaPDF2\Core\DataStructure\Date

Get the creation date.

The date and time when the annotation was created.
Parameters
$asString : bool

Whether receive the value as a string (PDF date string) or as a \setasign\SetaPDF2\Core\DataStructure\Date instance.

Exceptions

Throws \Exception

See

getDictionary()

public Annotation::getDictionary (
void
): \setasign\SetaPDF2\Core\Type\PdfDictionary

Get the annotation dictionary.

getHeight()

public Annotation::getHeight (
void
): float|int

Get the height of the annotation.

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getHiddenFlag()

public Annotation::getHiddenFlag (
void
): bool

Checks for the "Hidden" flag.

PDF 32000-1:2008 - Table 165: "If set, do not display or print the annotation or allow it to interact with the user, regardless of its annotation type or whether an annotation handler is available."

getInReplyTo()

public MarkupAnnotation::getInReplyTo (
void
): ?Annotation

Get the in reply to annotation (if available).

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

See

getIndirectObject()

public Annotation::getIndirectObject (): \setasign\SetaPDF2\Core\Type\IndirectObjectInterface

Get the indirect object of this annotation.

Parameters
$document : ?\setasign\SetaPDF2\Core\Document
 

getInteriorColor()

public PolygonAnnotation::getInteriorColor (
void
): ?\setasign\SetaPDF2\Core\DataStructure\Color\AbstractColor

Get the interior color.

getInvisibleFlag()

public Annotation::getInvisibleFlag (
void
): bool

Checks for the "Invisible" flag.

PDF 32000-1:2008 - Table 165: "If set, do not display the annotation if it does not belong to one of the standard annotation types and no annotation handler is available. If clear, display such an unknown annotation using an appearance stream specified by its appearance dictionary, if any"

getLockedContents()

public Annotation::getLockedContents (
void
): bool

Checks for the "LockedContents" flag.

PDF 32000-1:2008 - Table 165: "If set, do not allow the contents of the annotation to be modified by the user. This flag does not restrict deletion of the annotation or changes to other annotation properties, such as position and size."

getLockedFlag()

public Annotation::getLockedFlag (
void
): bool

Checks the "Locked" flag.

PDF 32000-1:2008 - Table 165: "If set, do not allow the annotation to be deleted or its properties (including position and size) to be modified by the user. However, this flag does not restrict changes to the annotation’s contents, such as the value of a form field."

getModificationDate()

public Annotation::getModificationDate (
bool $asString = true
): mixed|null|\setasign\SetaPDF2\Core\DataStructure\Date

Get the modification date.

Parameters
$asString : bool
 
Exceptions

Throws \Exception

getName()

public Annotation::getName (
string $encoding = 'UTF-8'
): ?string

Get the name of the annotation.

Parameters
$encoding : string
 

getNoRotateFlag()

public Annotation::getNoRotateFlag (
void
): bool

Checks fo the "NoRotate" flag.

PDF 32000-1:2008 - Table 165: "If set, do not rotate the annotation’s appearance to match the rotation of the page. The upper-left corner of the annotation rectangle shall remain in a fixed location on the page, regardless of the page rotation."

getNoViewFlag()

public Annotation::getNoViewFlag (
void
): bool

Checks for the "NoView" flag.

PDF 32000-1:2008 - Table 165: "If set, do not display the annotation on the screen or allow it to interact with the user. The annotation may be printed (depending on the setting of the Print flag) but should be considered hidden for purposes of on-screen display and user interaction."

getNoZoomFlag()

public Annotation::getNoZoomFlag (
void
): bool

Checks fo the "NoZoom" flag.

PDF 32000-1:2008 - Table 165: "If set, do not scale the annotation’s appearance to match the magnification of the page. The location of the annotation on the page (defined by the upper- left corner of its annotation rectangle) shall remain fixed, regardless of the page magnification."

getOpacity()

public MarkupAnnotation::getOpacity (
void
): float|mixed

Get the constant opacity value.

getPopup()

public MarkupAnnotation::getPopup (
void
): ?PopupAnnotation

Get the associated popup object if available.

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getPrintFlag()

public Annotation::getPrintFlag (
void
): bool

Checks for the "Print" flag.

PDF 32000-1:2008 - Table 165: "If set, print the annotation when the page is printed. If clear, never print the annotation, regardless of whether it is displayed on the screen."

getReadOnlyFlag()

public Annotation::getReadOnlyFlag (
void
): bool

Checks the "ReadOnly" flag.

PDF 32000-1:2008 - Table 165: "If set, do not allow the annotation to interact with the user. The annotation may be displayed or printed (depending on the settings of the NoView and Print flags) but should not respond to mouse clicks or change its appearance in response to mouse motions.

This flag shall be ignored for widget annotations; its function is subsumed by the ReadOnly flag of the associated form field"

getRect()

public Annotation::getRect (
void
): \setasign\SetaPDF2\Core\DataStructure\Rectangle

Get the rectangle object of this annotation.

getReplies()

public MarkupAnnotation::getReplies (): array

Get all annotations which refer this annotation as a reply.

Parameters
$annotations : \setasign\SetaPDF2\Core\Document\Page\Annotations
 
Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

getSubject()

public MarkupAnnotation::getSubject (
string $encoding = 'UTF-8'
): ?string

Get the subject.

Text representing a short description of the subject being addressed by the annotation.
Parameters
$encoding : string
 
See

getTextLabel()

public MarkupAnnotation::getTextLabel (
string $encoding = 'UTF-8'
): ?string

Get the text label.

The text label that shall be displayed in the title bar of the annotation’s pop-up window when open and active. This entry shall identify the user who added the annotation.
Parameters
$encoding : string
 
See

getToggleNoView()

public Annotation::getToggleNoView (
void
): bool

Checks for the "ToggleNoView" flag.

PDF 32000-1:2008 - Table 165: "If set, invert the interpretation of the NoView flag for certain events."

getType()

public Annotation::getType (
void
): string

Get the annotation type specified in the Subtype entry.

getVertices()

public PolygonAnnotation::getVertices (
void
): array

Get the vertices.

getWidth()

public Annotation::getWidth (
void
): float|int

Get the width of the annotation.

Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

hasReplies()

public MarkupAnnotation::hasReplies (): bool

Check whether this annotation has a reply or not.

Parameters
$annotations : \setasign\SetaPDF2\Core\Document\Page\Annotations
 
Exceptions

Throws \setasign\SetaPDF2\Core\Type\Exception

isAnnotationFlagSet()

public Annotation::isAnnotationFlagSet (
int $flag
): bool

Checks if a specific annotation flag is set.

Parameters
$flag : int
 

isReplyTo()

public MarkupAnnotation::isReplyTo (
void
): bool

Checks if this annotation is a reply to another annotation.

setAnnotationFlags()

public Annotation::setAnnotationFlags (
int $flags,
bool $set = true
): void

Sets an annotation flag.

Parameters
$flags : int
 
$set : bool

Set or unset

setAppearance()

public Annotation::setAppearance (
\setasign\SetaPDF2\Core\XObject\Form $xObject,
string $type = 'N',
?string $subState = null
): void

Set the annotation appearance stream.

Parameters
$xObject : \setasign\SetaPDF2\Core\XObject\Form
 
$type : string
 
$subState : ?string
 

setColor()

public Annotation::setColor (
null|bool|int|float|string|array|\setasign\SetaPDF2\Core\DataStructure\Color\AbstractColor $color
): void

Set the color of the annotation.

Parameters
$color : null|bool|int|float|string|array|\setasign\SetaPDF2\Core\DataStructure\Color\AbstractColor
 

setContents()

public Annotation::setContents (
?string $contents,
string $encoding = 'UTF-8'
): void

Set the contents of the annotation.

Parameters
$contents : ?string
 
$encoding : string
 

setCreationDate()

public MarkupAnnotation::setCreationDate (): void

Set the creation date.

Parameters
$date : null|bool|string|\DateTime|\setasign\SetaPDF2\Core\Type\PdfString|\setasign\SetaPDF2\Core\DataStructure\Date
 
Exceptions

Throws \Exception

See

setHiddenFlag()

public Annotation::setHiddenFlag (
bool $hidden = true
): void

Set the "Hidden" flag.

Parameters
$hidden : bool
 
See

setInReplyTo()

public MarkupAnnotation::setInReplyTo (
MarkupAnnotation $annotation
): void

Set the in reply to annotation object.

Parameters
$annotation : MarkupAnnotation
 
Exceptions

Throws \InvalidArgumentException

See

setInteriorColor()

public PolygonAnnotation::setInteriorColor (): void

Set the interior color.

Parameters
$color : null|int|array|\setasign\SetaPDF2\Core\DataStructure\Color\AbstractColor
 

setInvisibleFlag()

public Annotation::setInvisibleFlag (
bool $invisible = true
): void

Set the "Invisible" flag.

Parameters
$invisible : bool
 
See

setLocked()

public Annotation::setLocked (
bool $locked = true
): void

Set the "Locked" flag.

Parameters
$locked : bool
 
See

setLockedContents()

public Annotation::setLockedContents (
bool $lockedContents = true
): void

Set the "LockedContents" flag.

Parameters
$lockedContents : bool
 
See

setModificationDate()

public Annotation::setModificationDate (): void

Set the modification date.

Parameters
$date : \setasign\SetaPDF2\Core\DataStructure\Date|\DateTime|string|bool

If true is passed, the current date and time will be used.

Exceptions

Throws \Exception

setName()

public Annotation::setName (
?string $name,
string $encoding = 'UTF-8'
): void

Set the name of the annotation.

The annotation name, a text string uniquely identifying it among all the annotations on its page.

Parameters
$name : ?string
 
$encoding : string
 

setNoRotateFlag()

public Annotation::setNoRotateFlag (
bool $noRotate = true
): void

Set the "NoRotate" flag.

Parameters
$noRotate : bool
 
See

setNoViewFlag()

public Annotation::setNoViewFlag (
bool $noView = true
): void

Set the "NoView" flag.

Parameters
$noView : bool
 
See

setNoZoomFlag()

public Annotation::setNoZoomFlag (
bool $noZoom = true
): void

Set the "NoZoom" flag.

Parameters
$noZoom : bool
 
See

setOpacity()

public MarkupAnnotation::setOpacity (
?float $opacity
): void

Set the constant opacity value.

Parameters
$opacity : ?float
 

setPopup()

public MarkupAnnotation::setPopup (
PopupAnnotation $annotation
): void

Set the pop-up annotation object.

Parameters
$annotation : PopupAnnotation
 
Exceptions

Throws \InvalidArgumentException

setPrintFlag()

public Annotation::setPrintFlag (
bool $print = true
): void

Set the "Print" flag.

Parameters
$print : bool
 
See

setReadOnlyFlag()

public Annotation::setReadOnlyFlag (
bool $readOnly = true
): void

Set the "ReadOnly" flag.

Parameters
$readOnly : bool
 
See

setRect()

public Annotation::setRect (): void

Set the rectangle object.

Parameters
$rect : \setasign\SetaPDF2\Core\DataStructure\Rectangle
 

setSubject()

public MarkupAnnotation::setSubject (
?string $subject,
string $encoding = 'UTF-8'
): void

Get the subject.

Parameters
$subject : ?string
 
$encoding : string
 
See

setTextLabel()

public MarkupAnnotation::setTextLabel (
?string $textLabel,
string $encoding = 'UTF-8'
): void

Set the text label.

Parameters
$textLabel : ?string
 
$encoding : string
 
See

setToggleNoView()

public Annotation::setToggleNoView (
bool $toggleNoView = true
): void

Set the "ToggleNoView" flag.

Parameters
$toggleNoView : bool
 
See

setVertices()

public PolygonAnnotation::setVertices (
float[] $vertices
): void

Set the vertices.

Parameters
$vertices : float[]
 

unsetAnnotationFlags()

public Annotation::unsetAnnotationFlags (
int $flags
): void

Removes a field flag.

Parameters
$flags : int
 

© 2025 Setasign GmbH & Co. KG · Contact / Imprint · Data Privacy Statement (German)