Index

  1. \SetaPDF
    1. Core
    2. Core
      1. Document
      2. Document
        1. Page
        2. Page
          1. Annotation
          2. Annotation
            1. Widget
            2. Widget
            3. AdditionalActions
            4. AppearanceCharacteristics
            5. BorderEffect
            6. BorderStyle
            7. Caret
            8. Circle
            9. FileAttachment
            10. Flags
            11. FreeText
            12. Highlight
            13. Ink
            14. Line
            15. LineEndingStyle
            16. Link
            17. Markup
            18. PolyLine
            19. Polygon
            20. Popup
            21. QuadPointsTrait
            22. Screen
            23. Square
            24. Squiggly
            25. Stamp
            26. StrikeOut
            27. Text
            28. TextMarkup
            29. Underline

SetaPDF_Core_Document_Page_Annotation_Polygon Class representing a polygon annotation

File: /SetaPDF v2/Core/Document/Page/Annotation/Polygon.php

See PDF 32000-1:2008 - 12.5.6.13

Class hierarchy

Summary

Static Methods

Methods

Properties

Constants

Constants

TYPE_3D

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

Annotation type

TYPE_CARET

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_CARET = 'Caret'

Annotation type

TYPE_CIRCLE

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_CIRCLE = 'Circle'

Annotation type

TYPE_FILE_ATTACHMENT

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_FILE_ATTACHMENT = 'FileAttachment'

Annotation type

TYPE_FREE_TEXT

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_FREE_TEXT = 'FreeText'

Annotation type

TYPE_HIGHLIGHT

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_HIGHLIGHT = 'Highlight'

Annotation type

TYPE_INK

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_INK = 'Ink'

Annotation type

TYPE_LINE

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_LINE = 'Line'

Annotation type

TYPE_LINK

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_LINK = 'Link'

Annotation type

TYPE_MOVIE

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_MOVIE = 'Movie'

Annotation type

TYPE_POLYGON

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_POLYGON = 'Polygon'

Annotation type

TYPE_POLY_LINE

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_POLY_LINE = 'PolyLine'

Annotation type

TYPE_POPUP

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_POPUP = 'Popup'

Annotation type

TYPE_PRINTER_MARK

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_PRINTER_MARK = 'PrinterMark'

Annotation type

TYPE_REDACT

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_REDACT = 'Redact'

Annotation type

TYPE_SCREEN

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_SCREEN = 'Screen'

Annotation type

TYPE_SOUND

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_SOUND = 'Sound'

Annotation type

TYPE_SQUARE

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_SQUARE = 'Square'

Annotation type

TYPE_SQUIGGLY

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_SQUIGGLY = 'Squiggly'

Annotation type

TYPE_STAMP

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_STAMP = 'Stamp'

Annotation type

TYPE_STRIKE_OUT

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_STRIKE_OUT = 'StrikeOut'

Annotation type

TYPE_TEXT

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_TEXT = 'Text'

Annotation type

TYPE_TRAP_NET

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_TRAP_NET = 'TrapNet'

Annotation type

TYPE_UNDERLINE

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_UNDERLINE = 'Underline'

Annotation type

TYPE_WATERMARK

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_WATERMARK = 'Watermark'

Annotation type

TYPE_WIDGET

public const string SetaPDF_Core_Document_Page_Annotation::TYPE_WIDGET = 'Widget'

Annotation type


Properties

$_additionalActions

protected SetaPDF_Core_Document_Page_Annotation_AdditionalActions SetaPDF_Core_Document_Page_Annotation::$_additionalActions

$_annotationDictionary

protected SetaPDF_Core_Type_Dictionary SetaPDF_Core_Document_Page_Annotation::$_annotationDictionary

The annotation dictionary

$_borderStyle

protected SetaPDF_Core_Document_Page_Annotation_BorderStyle SetaPDF_Core_Document_Page_Annotation_Polygon::$_borderStyle

$_indirectReference

protected SetaPDF_Core_Type_IndirectObjectInterface SetaPDF_Core_Document_Page_Annotation::$_indirectReference

$_rect

protected SetaPDF_Core_DataStructure_Rectangle SetaPDF_Core_Document_Page_Annotation::$_rect

The rectangle


Static Methods

_createAnnotationDictionary()

protected static SetaPDF_Core_Document_Page_Annotation::_createAnnotationDictionary (
$rect, $subtype
):

Creates an annotation dictionary with default values.

Parameters
$rect
 
$subtype
 

byObjectOrDictionary()

public static SetaPDF_Core_Document_Page_Annotation::byObjectOrDictionary (
SetaPDF_Core_Type_AbstractType $objectOrDictionary
):

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

Parameters
$objectOrDictionary : SetaPDF_Core_Type_AbstractType
 
Exceptions

Throws InvalidArgumentException

createAnnotationDictionary()

public static SetaPDF_Core_Document_Page_Annotation_Polygon::createAnnotationDictionary (
$rect
):

Creates a polygon annotation dictionary.

Parameters
$rect
 
Exceptions

Throws InvalidArgumentException


Methods

__construct()

public SetaPDF_Core_Document_Page_Annotation_Polygon::__construct (
$objectOrDictionary
)

The constructor.

Parameters
$objectOrDictionary
 
Exceptions

Throws InvalidArgumentException

_getReplies()

private SetaPDF_Core_Document_Page_Annotation_Markup::_getReplies (
SetaPDF_Core_Document_Page_Annotations $annotations, $onlyCheckForExistance
):

Get all replies or checks for their existance.

Parameters
$annotations : SetaPDF_Core_Document_Page_Annotations
 
$onlyCheckForExistance
 

addReply()

public SetaPDF_Core_Document_Page_Annotation_Markup::addReply (): void

Adds a reply to this annotation.

Parameters
$annotation : SetaPDF_Core_Document_Page_Annotation_Markup
 

cleanUp()

public SetaPDF_Core_Document_Page_Annotation_Polygon::cleanUp (
void
): void

Release memory/cycled references.

createPopup()

public SetaPDF_Core_Document_Page_Annotation_Markup::createPopup (
[ $offsetX = 30 [, $offsetY = 20 [, $width = 150 [, $height = 100 ]]]]
):

Create a popup annotation object for this annotation.

If the x-offset value is less than zero the popup will be created at 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 create 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
 
$offsetY
 
$width
 
$height
 

getAdditionalActions()

public SetaPDF_Core_Document_Page_Annotation::getAdditionalActions (
void
):

Gets the additional actions object instance for this annotation.

getAnnotationDictionary()

public SetaPDF_Core_Document_Page_Annotation::getAnnotationDictionary (
void
):

Get the annotation dictionary.

getAppearance()

public SetaPDF_Core_Document_Page_Annotation::getAppearance (
[ $type = 'N' [, $subName = null ]]
):

Get the annotation appearance stream.

Parameters
$type
 
$subName
 
Exceptions

Throws InvalidArgumentException

getBorderEffect()

public SetaPDF_Core_Document_Page_Annotation_Polygon::getBorderEffect (
[ $create = false ]
):

Get the border effect object.

Parameters
$create
 

getBorderStyle()

public SetaPDF_Core_Document_Page_Annotation_Polygon::getBorderStyle (
void
):

Get the border style object.

getColor()

public SetaPDF_Core_Document_Page_Annotation::getColor (
void
):

Get the color of the annotation.

getContents()

public SetaPDF_Core_Document_Page_Annotation::getContents (
[ $encoding = 'UTF-8' ]
):

Get the contents of the annotation.

Parameters
$encoding
 

getCreationDate()

public SetaPDF_Core_Document_Page_Annotation_Markup::getCreationDate (
[ $asString = true ]
):

Get the creation date.

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

Whether receive the value as a string (PDF date string) or as a SetaPDF_Core_DataStructure_Date instance.

See

getDictionary()

public SetaPDF_Core_Document_Page_Annotation::getDictionary (
void
):

Get the annotation dictionary.

getHeight()

public SetaPDF_Core_Document_Page_Annotation::getHeight (
void
):

Get the height of the annotation.

getHiddenFlag()

public SetaPDF_Core_Document_Page_Annotation::getHiddenFlag (
void
):

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 SetaPDF_Core_Document_Page_Annotation_Markup::getInReplyTo (
void
):

Get the in reply to annotation (if available).

See

getIndirectObject()

public SetaPDF_Core_Document_Page_Annotation::getIndirectObject (
[ SetaPDF_Core_Document|null $document = null ]
):

Get the indirect object of this annotation.

Parameters
$document : SetaPDF_Core_Document|null
 

getInteriorColor()

public SetaPDF_Core_Document_Page_Annotation_Polygon::getInteriorColor (
void
):

Get the interior color.

getInvisibleFlag()

public SetaPDF_Core_Document_Page_Annotation::getInvisibleFlag (
void
):

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 SetaPDF_Core_Document_Page_Annotation::getLockedContents (
void
):

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 SetaPDF_Core_Document_Page_Annotation::getLockedFlag (
void
):

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 SetaPDF_Core_Document_Page_Annotation::getModificationDate (
[ $asString = true ]
):

Get the modification date.

Parameters
$asString
 

getName()

public SetaPDF_Core_Document_Page_Annotation::getName (
[ $encoding = 'UTF-8' ]
):

Get the name of the annotation.

Parameters
$encoding
 

getNoRotateFlag()

public SetaPDF_Core_Document_Page_Annotation::getNoRotateFlag (
void
):

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 SetaPDF_Core_Document_Page_Annotation::getNoViewFlag (
void
):

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 SetaPDF_Core_Document_Page_Annotation::getNoZoomFlag (
void
):

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 SetaPDF_Core_Document_Page_Annotation_Markup::getOpacity (
void
):

Get the constant opacity value.

getPopup()

public SetaPDF_Core_Document_Page_Annotation_Markup::getPopup (
void
):

Get the associated popup object if available.

getPrintFlag()

public SetaPDF_Core_Document_Page_Annotation::getPrintFlag (
void
):

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 SetaPDF_Core_Document_Page_Annotation::getReadOnlyFlag (
void
):

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 SetaPDF_Core_Document_Page_Annotation::getRect (
void
):

Get the rectangle object of this annotation.

getReplies()

public SetaPDF_Core_Document_Page_Annotation_Markup::getReplies ():

Get all annotations which refer this annotation as an reply.

Parameters
$annotations : SetaPDF_Core_Document_Page_Annotations
 

getSubject()

public SetaPDF_Core_Document_Page_Annotation_Markup::getSubject (
[ $encoding = 'UTF-8' ]
):

Get the subject.

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

getTextLabel()

public SetaPDF_Core_Document_Page_Annotation_Markup::getTextLabel (
[ $encoding = 'UTF-8' ]
):

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
 
See

getToggleNoView()

public SetaPDF_Core_Document_Page_Annotation::getToggleNoView (
void
):

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 SetaPDF_Core_Document_Page_Annotation::getType (
void
):

Get the action type specified in the S key.

getVertices()

public SetaPDF_Core_Document_Page_Annotation_Polygon::getVertices (
void
):

Get the vertices.

getWidth()

public SetaPDF_Core_Document_Page_Annotation::getWidth (
void
):

Get the width of the annotation.

hasReplies()

public SetaPDF_Core_Document_Page_Annotation_Markup::hasReplies ():

Check whether this annotation has a reply or not.

Parameters
$annotations : SetaPDF_Core_Document_Page_Annotations
 

isAnnotationFlagSet()

public SetaPDF_Core_Document_Page_Annotation::isAnnotationFlagSet (
$flag
):

Checks if a specific annotation flag is set.

Parameters
$flag
 

isReplyTo()

public SetaPDF_Core_Document_Page_Annotation_Markup::isReplyTo (
void
):

Checks if this annotation is a reply to another annotation.

setAnnotationFlags()

public SetaPDF_Core_Document_Page_Annotation::setAnnotationFlags (
$flags [, $set = true ]
): void

Sets an annotation flag.

Parameters
$flags
 
$set

Set or unset

setAppearance()

public SetaPDF_Core_Document_Page_Annotation::setAppearance (
SetaPDF_Core_XObject_Form $xObject [, $type = 'N' [, $subState = null ]]
): void

Set the annotation appearance stream.

Parameters
$xObject : SetaPDF_Core_XObject_Form
 
$type
 
$subState
 

setColor()

public SetaPDF_Core_Document_Page_Annotation::setColor (
$color
): void

Set the color of the annotation.

Parameters
$color
 

setContents()

public SetaPDF_Core_Document_Page_Annotation::setContents (
$contents [, $encoding = 'UTF-8' ]
): void

Set the contents of the annotation.

Parameters
$contents
 
$encoding
 

setCreationDate()

public SetaPDF_Core_Document_Page_Annotation_Markup::setCreationDate (
[ $date = true ]
): void

Set the creation date.

Parameters
$date
 
See

setHiddenFlag()

public SetaPDF_Core_Document_Page_Annotation::setHiddenFlag (
[ $hidden = true ]
): void

Set the "Hidden" flag.

Parameters
$hidden
 
See

setInReplyTo()

public SetaPDF_Core_Document_Page_Annotation_Markup::setInReplyTo (): void

Set the in reply to annotation object.

Parameters
$annotation : SetaPDF_Core_Document_Page_Annotation_Markup
 
Exceptions

Throws InvalidArgumentException

See

setIndirectObject()

public SetaPDF_Core_Document_Page_Annotation::setIndirectObject (): void

Set the indirect object of this annotation.

Parameters
$indirectReference : SetaPDF_Core_Type_IndirectObjectInterface
 

setInteriorColor()

public SetaPDF_Core_Document_Page_Annotation_Polygon::setInteriorColor (
$color
): void

Set the interior color.

Parameters
$color
 

setInvisibleFlag()

public SetaPDF_Core_Document_Page_Annotation::setInvisibleFlag (
[ $invisible = true ]
): void

Set the "Invisible" flag.

Parameters
$invisible
 
See

setLocked()

public SetaPDF_Core_Document_Page_Annotation::setLocked (
[ $locked = true ]
): void

Set the "Locked" flag.

Parameters
$locked
 
See

setLockedContents()

public SetaPDF_Core_Document_Page_Annotation::setLockedContents (
[ $lockedContents = true ]
): void

Set the "LockedContents" flag.

Parameters
$lockedContents
 
See

setModificationDate()

public SetaPDF_Core_Document_Page_Annotation::setModificationDate (
[ $date = true ]
): void

Set the modification date.

Parameters
$date

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

setName()

public SetaPDF_Core_Document_Page_Annotation::setName (
$name [, $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
 
$encoding
 

setNoRotateFlag()

public SetaPDF_Core_Document_Page_Annotation::setNoRotateFlag (
[ $noRotate = true ]
): void

Set the "NoRotate" flag.

Parameters
$noRotate
 
See

setNoViewFlag()

public SetaPDF_Core_Document_Page_Annotation::setNoViewFlag (
[ $noView = true ]
): void

Set the "NoView" flag.

Parameters
$noView
 
See

setNoZoomFlag()

public SetaPDF_Core_Document_Page_Annotation::setNoZoomFlag (
[ $noZoom = true ]
): void

Set the "NoZoom" flag.

Parameters
$noZoom
 
See

setOpacity()

public SetaPDF_Core_Document_Page_Annotation_Markup::setOpacity (
$opacity
): void

Set the constant opacity value.

Parameters
$opacity
 

setPopup()

public SetaPDF_Core_Document_Page_Annotation_Markup::setPopup (): void

Set the pop-up annotation object.

Parameters
$annotation : SetaPDF_Core_Document_Page_Annotation_Popup
 
Exceptions

Throws InvalidArgumentException

setPrintFlag()

public SetaPDF_Core_Document_Page_Annotation::setPrintFlag (
[ $print = true ]
): void

Set the "Print" flag.

Parameters
$print
 
See

setReadOnlyFlag()

public SetaPDF_Core_Document_Page_Annotation::setReadOnlyFlag (
[ $readOnly = true ]
): void

Set the "ReadOnly" flag.

Parameters
$readOnly
 
See

setRect()

public SetaPDF_Core_Document_Page_Annotation::setRect (): void

Set the rectangle object.

Parameters
$rect : SetaPDF_Core_DataStructure_Rectangle
 

setSubject()

public SetaPDF_Core_Document_Page_Annotation_Markup::setSubject (
$subject [, $encoding = 'UTF-8' ]
): void

Get the subject.

Parameters
$subject
 
$encoding
 
See

setTextLabel()

public SetaPDF_Core_Document_Page_Annotation_Markup::setTextLabel (
$textLabel [, $encoding = 'UTF-8' ]
): void

Set the text label.

Parameters
$textLabel
 
$encoding
 
See

setToggleNoView()

public SetaPDF_Core_Document_Page_Annotation::setToggleNoView (
[ $toggleNoView = true ]
): void

Set the "ToggleNoView" flag.

Parameters
$toggleNoView
 
See

setVertices()

public SetaPDF_Core_Document_Page_Annotation_Polygon::setVertices (
array $vertices
): void

Set the vertices.

Parameters
$vertices : array
 

unsetAnnotationFlags()

public SetaPDF_Core_Document_Page_Annotation::unsetAnnotationFlags (
$flags
): void

Removes a field flag.

Parameters
$flags
 

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