kitepdf-pdf/io.github.yuroyami.kitepdf/PdfAnnotation

PdfAnnotation

data class PdfAnnotation(val subtype: PdfAnnotation.Subtype, val rect: Rectangle, val contents: String, val color: RgbColor?, val uri: String?, val action: PdfAction?, val rawDestination: PdfObject?, val appearanceStream: PdfStream?, val flags: Int = 0, val quadPoints: List<Double>? = null, val inkLists: List<List<Double>>? = null, val vertices: List<Double>? = null, val interiorColor: RgbColor? = null, val borderWidth: Double? = null, val raw: PdfDictionary)

One PDF annotation (ISO 32000-1 §12.5).

The subtype discriminates between the 20+ annotation types defined in the spec. First-class support is provided for:

Subtype.Link: URL or named-destination hyperlinks
Subtype.Highlight: text highlight (yellow overlay)
Subtype.Underline: underline marker
Subtype.StrikeOut: strikethrough marker
Subtype.Text: sticky-note popup

Other subtypes are parsed into Subtype.Other and exposed in raw so callers can pattern-match. The rectangle and contents are always there.

For rendering, appearanceStream (the /AP /N stream when present) is the canonical way to draw the annotation. It is a Form XObject the spec mandates "shall be used as the visual representation." We expose it as a raw stream so PageRenderer can recursively render it.

Constructors

PdfAnnotation

constructor(subtype: PdfAnnotation.Subtype, rect: Rectangle, contents: String, color: RgbColor?, uri: String?, action: PdfAction?, rawDestination: PdfObject?, appearanceStream: PdfStream?, flags: Int = 0, quadPoints: List<Double>? = null, inkLists: List<List<Double>>? = null, vertices: List<Double>? = null, interiorColor: RgbColor? = null, borderWidth: Double? = null, raw: PdfDictionary)

Types

Companion

object Companion

Subtype

enum Subtype : Enum<PdfAnnotation.Subtype>

Properties

action

val action: PdfAction?

Parsed /A action (typed). null when the annotation has no action dict.

appearanceStream

val appearanceStream: PdfStream?

/AP /N appearance Form XObject, or null.

borderWidth

val borderWidth: Double?

Declared border width in points, from /BS /W or the third element of /Border, or null when the annotation declares neither and the §12.5.4 default of 1 applies.

color

val color: RgbColor?

Border / highlight / underline colour, or null when /C is omitted.

contents

val contents: String

flags

val flags: Int

Annotation flags (/F): bit 2 = Hidden, bit 6 = NoView, etc. (§12.5.3).

inkLists