PDFiumAnnotation

@scaryterry/pdfium

Defined in: src/document/annotation.ts:95

Represents a single annotation on a PDF page.

Extends

Disposable

Implements

Annotation

Accessors

attachmentPointCount

Get Signature

get attachmentPointCount(): number

Defined in: src/document/annotation.ts:748

Gets the number of attachment point sets (quad points) for this markup annotation.

Returns

number

author

Get Signature

get author(): string | undefined

Defined in: src/document/annotation.ts:482

The author (‘T’ key) of this annotation.

Returns

string | undefined

Set Signature

set author(value): void

Defined in: src/document/annotation.ts:486

Parameters

Parameter	Type
`value`	`string`

Returns

void

bounds

Get Signature

get bounds(): Rect

Defined in: src/document/annotation.ts:144

Gets the bounding rectangle of this annotation.

Returns a zero-rect if the annotation has no rectangle set. Use getRect to distinguish between “no rect” (null) and a valid rect.

This getter satisfies the Annotation interface.

Returns

Rect

The bounding rectangle in page coordinates.

Implementation of

Annotation.bounds

colour

Get Signature

get colour(): Colour | null

Defined in: src/document/annotation.ts:155

Gets the stroke colour of this annotation, if set.

This value is cached at construction time and invalidated by setColour.

This getter satisfies the Annotation interface.

Returns

Colour | null

The annotation colour, or null if not set.

Implementation of

Annotation.colour

Get Signature

get contents(): string | undefined

Defined in: src/document/annotation.ts:473

The ‘Contents’ dictionary value (e.g. text body of a note).

Returns

string | undefined

Set Signature

set contents(value): void

Defined in: src/document/annotation.ts:477

Parameters

Parameter	Type
`value`	`string`

Returns

void

disposed

Get Signature

get disposed(): boolean

Defined in: src/core/disposable.ts:74

Whether this resource has been disposed.

Returns

boolean

Inherited from

Disposable.disposed

flags

Get Signature

get flags(): AnnotationFlags

Defined in: src/document/annotation.ts:191

Gets the annotation flags.

Returns

AnnotationFlags

index

Get Signature

get index(): number

Defined in: src/document/annotation.ts:164

Gets the zero-based index of this annotation on its page.

This value is cached at construction time.

Returns

number

Zero-based index of the annotation on its page.

Implementation of

Annotation.index

inkPathCount

Get Signature

get inkPathCount(): number

Defined in: src/document/annotation.ts:679

Gets the number of ink paths in this ink annotation.

Returns

number

objectCount

Get Signature

get objectCount(): number

Defined in: src/document/annotation.ts:183

Gets the number of page objects in this annotation.

Only ink and stamp annotations typically have objects.

Returns

number

subject

Get Signature

get subject(): string | undefined

Defined in: src/document/annotation.ts:491

The subject of this annotation.

Returns

string | undefined

Set Signature

set subject(value): void

Defined in: src/document/annotation.ts:495

Parameters

Parameter	Type
`value`	`string`

Returns

void

type

Get Signature

get type(): AnnotationType

Defined in: src/document/annotation.ts:130

Gets the annotation subtype (e.g. Text, Highlight, Ink, Link).

Returns

AnnotationType

The annotation subtype.

Implementation of

Annotation.type

Methods

[dispose]()

[dispose](): void

Defined in: src/core/disposable.ts:163

Dispose of this resource, freeing WASM memory.

This method is idempotent - calling it multiple times has no effect after the first call.

Returns

void

Inherited from

Disposable.[dispose]

addInkStroke()

addInkStroke(points): number

Defined in: src/document/annotation.ts:721

Adds an ink stroke to this ink annotation.

Parameters

Parameter	Type	Description
`points`	readonly `Point`[]	Array of points defining the ink stroke

Returns

number

The index of the added stroke, or -1 on failure

appendAttachmentPoints()

appendAttachmentPoints(quadPoints): boolean

Defined in: src/document/annotation.ts:813

Appends attachment points (quad points) to this markup annotation.

Parameters

Parameter	Type	Description
`quadPoints`	`QuadPoints`	The quad points to append

Returns

boolean

True if successful

appendObject()

appendObject(object): boolean

Defined in: src/document/annotation.ts:843

Appends a page object to this annotation.

Only ink and stamp annotations support object manipulation.

Parameters

Parameter	Type	Description
`object`	`PDFiumPageObject`	The page object to append

Returns

boolean

True if successful

dispose()

dispose(): void

Defined in: src/core/disposable.ts:179

Alias for Symbol.dispose for explicit calls.

Returns

void

Example

document.dispose();

Inherited from

Disposable.dispose

focus()

focus(): boolean

Defined in: src/document/annotation.ts:1101

Sets this annotation as the focused annotation in the form.

Returns

boolean

True if successful

getAppearance()

getAppearance(mode): string | undefined

Defined in: src/document/annotation.ts:575

Gets the appearance stream of this annotation.

Parameters

Parameter	Type	Description
`mode`	`AnnotationAppearanceMode`	The appearance mode to retrieve

Returns

string | undefined

The appearance stream string, or undefined if not available

getAttachmentPoints()

getAttachmentPoints(quadIndex): QuadPoints | null

Defined in: src/document/annotation.ts:759

Gets attachment points (quad points) for this markup annotation.

Parameters

Parameter	Type	Description
`quadIndex`	`number`	Zero-based quad points index

Returns

QuadPoints | null

Quad points, or null if not available

getBorder()

getBorder(): AnnotationBorder | null

Defined in: src/document/annotation.ts:508

Gets the border properties of this annotation.

Returns

AnnotationBorder | null

Border properties, or null if not available

getColour()

getColour(colourType): Colour | null

Defined in: src/document/annotation.ts:276

Gets the colour of this annotation.

Parameters

Parameter	Type	Default value	Description
`colourType`	`AnnotationColourType`	`'stroke'`	Which colour channel: `'stroke'` (default) or `'interior'`

Returns

Colour | null

The colour, or null if not available

getFontSize()

getFontSize(): number | null

Defined in: src/document/annotation.ts:913

Gets the font size for a free text annotation.

Returns

number | null

The font size, or null if not available

getFormAdditionalActionJavaScript()

getFormAdditionalActionJavaScript(event): string | undefined

Defined in: src/document/annotation.ts:1051

Gets JavaScript associated with a form field additional action event.

Form fields can have JavaScript actions triggered by events like keystroke, format, validate, or calculate. This method retrieves the JavaScript for a specific event type.

Parameters

Parameter	Type	Description
`event`	`FormFieldActionEvent`	The form field action event type

Returns

string | undefined

The JavaScript source string, or undefined if no JS for this event

getFormControlCount()

getFormControlCount(): number

Defined in: src/document/annotation.ts:932

Gets the number of form controls for this form field annotation.

Returns

number

getFormControlIndex()

getFormControlIndex(): number

Defined in: src/document/annotation.ts:943

Gets the form control index for this form field annotation.

Returns

number

The form control index, or -1 if not found

getFormFieldAlternateName()

getFormFieldAlternateName(): string | undefined

Defined in: src/document/annotation.ts:1033

Gets the alternate (tooltip) name for this form field widget annotation.

Returns

string | undefined

The alternate name, or undefined if not available

getFormFieldExportValue()

getFormFieldExportValue(): string | undefined

Defined in: src/document/annotation.ts:958

Gets the export value of this form field annotation.

Returns

string | undefined

The export value, or undefined if not available

getFormFieldFlags()

getFormFieldFlags(): FormFieldFlags

Defined in: src/document/annotation.ts:994

Gets the form field flags for this widget annotation.

Returns

FormFieldFlags

The form field flags bitmask, or FormFieldFlags.None if not a widget

getFormFieldName()

getFormFieldName(): string | undefined

Defined in: src/document/annotation.ts:1007

Gets the form field name for this widget annotation.

Returns

string | undefined

The field name, or undefined if not available

getFormFieldOptions()

getFormFieldOptions(): WidgetOption[] | undefined

Defined in: src/document/annotation.ts:1070

Gets the options for a combo box or list box widget annotation.

Returns

WidgetOption[] | undefined

Array of options, or undefined if not a combo/list box or no options

getFormFieldType()

getFormFieldType(): FormFieldType

Defined in: src/document/annotation.ts:982

Gets the form field type for this widget annotation.

Returns

FormFieldType

The form field type, or FormFieldType.Unknown if not a widget

getFormFieldValue()

getFormFieldValue(): string | undefined

Defined in: src/document/annotation.ts:1020

Gets the current value of this form field widget annotation.

Returns

string | undefined

The field value, or undefined if not available

getInkPath()

getInkPath(pathIndex): Point[] | null

Defined in: src/document/annotation.ts:690

Gets the points in an ink path.

Parameters

Parameter	Type	Description
`pathIndex`	`number`	Zero-based path index

Returns

Point[] | null

Array of points, or null if not available

getLine()

getLine(): LinePoints | null

Defined in: src/document/annotation.ts:612

Gets the line endpoints for a line annotation.

Returns

LinePoints | null

Line endpoints, or null if not a line annotation

getLink()

getLink(): PDFLink | null

Defined in: src/document/annotation.ts:883

Gets the link associated with this link annotation.

Returns

PDFLink | null

The link, or null if not found

getNumberValue()

getNumberValue(key): number | undefined

Defined in: src/document/annotation.ts:458

Gets a numeric value from this annotation’s dictionary.

Parameters

Parameter	Type	Description
`key`	`DictionaryKey`	The dictionary key

Returns

number | undefined

The number value, or undefined if not available

getRect()

getRect(): Rect | null

Defined in: src/document/annotation.ts:205

Gets the bounding rectangle of this annotation.

Returns

Rect | null

The bounding rectangle, or null if not available

getStringValue()

getStringValue(key): string | undefined

Defined in: src/document/annotation.ts:426

Gets a string value from this annotation’s dictionary.

Parameters

Parameter	Type	Description
`key`	`DictionaryKey`	The dictionary key

Returns

string | undefined

The string value, or undefined if not available

getVertices()

getVertices(): Point[] | null

Defined in: src/document/annotation.ts:647

Gets the vertices of a polygon or polyline annotation.

Returns

Point[] | null

Array of points, or null if not a polygon/polyline annotation

hasKey()

hasKey(key): boolean

Defined in: src/document/annotation.ts:412

Checks if this annotation has a specific key in its dictionary.

Parameters

Parameter	Type	Description
`key`	`DictionaryKey`	The key name to check

Returns

boolean

True if the key exists

isWidget()

isWidget(): boolean

Defined in: src/document/annotation.ts:973

Returns true if this annotation is a valid form widget (Widget subtype with a known field type).

Returns

boolean

removeObject()

removeObject(objectIndex): boolean

Defined in: src/document/annotation.ts:869

Removes a page object from this annotation.

Only ink and stamp annotations support object manipulation.

Parameters

Parameter	Type	Description
`objectIndex`	`number`	The zero-based index of the object to remove

Returns

boolean

True if successful

setAppearance()

setAppearance(mode, value): boolean

Defined in: src/document/annotation.ts:590

Sets the appearance stream of this annotation.

Parameters

Parameter	Type	Description
`mode`	`AnnotationAppearanceMode`	The appearance mode to set
`value`	`string` \| `undefined`	The appearance stream value, or undefined to remove

Returns

boolean

True if successful

setAttachmentPoints()

setAttachmentPoints(quadIndex, quadPoints): boolean

Defined in: src/document/annotation.ts:789

Sets attachment points (quad points) for this markup annotation.

Parameters

Parameter	Type	Description
`quadIndex`	`number`	Zero-based quad points index
`quadPoints`	`QuadPoints`	The quad points to set

Returns

boolean

True if successful

setBorder()

setBorder(border): boolean

Defined in: src/document/annotation.ts:533

Sets the border of this annotation.

Parameters

Parameter	Type	Description
`border`	`AnnotationBorder`	The border properties

Returns

boolean

True if successful

setColour()

setColour(colour, colourType): boolean

Defined in: src/document/annotation.ts:328

Sets the colour of this annotation.

Parameters

Parameter	Type	Default value	Description
`colour`	`Colour`	`undefined`	The colour to set
`colourType`	`AnnotationColourType`	`'stroke'`	Which colour channel: `'stroke'` (default) or `'interior'`

Returns

boolean

True if successful

setFlags()

setFlags(flags): boolean

Defined in: src/document/annotation.ts:397

Sets the flags of this annotation.

Parameters

Parameter	Type	Description
`flags`	`AnnotationFlags`	The annotation flags to set

Returns

boolean

True if successful

setRect()

setRect(bounds): boolean

Defined in: src/document/annotation.ts:235

Sets the bounding rectangle of this annotation.

Parameters

Parameter	Type	Description
`bounds`	`Rect`	The new bounding rectangle

Returns

boolean

True if successful

setStringValue()

setStringValue(key, value): boolean

Defined in: src/document/annotation.ts:441

Sets a string value in this annotation’s dictionary.

Parameters

Parameter	Type	Description
`key`	`DictionaryKey`	The dictionary key
`value`	`string`	The string value to set

Returns

boolean

True if successful

setURI()

setURI(uri): boolean

Defined in: src/document/annotation.ts:896

Sets the URI for this link annotation.

Parameters

Parameter	Type	Description
`uri`	`string`	The URI to set

Returns

boolean

True if successful

updateObject()

updateObject(object): boolean

Defined in: src/document/annotation.ts:856

Updates a page object in this annotation.

The object must already be in the annotation.

Parameters

Parameter	Type	Description
`object`	`PDFiumPageObject`	The page object to update

Returns

boolean

True if successful