kitepdf/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 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's 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.