Sulekha · Annotating

Ink on the page, kept in the PDF

Marking papers, grading, keeping notes on what you read. A stylus draws with pressure, a mouse draws at full width, and everything you write is saved into the document itself as annotations other readers can show.

A page of an article on the heat equation, with the equation circled in red, a handwritten note 'the whole story' in blue with an arrow in the margin, a red underline, and yellow highlights; the tool palette floats at the bottom.
A paper, read with a pen in hand. The palette at the bottom holds four instruments, each a complete pen, and the eraser.

Four instruments, each a whole pen

A slot is an instrument: kind, nib, width and colour together, so picking one is a single click rather than three. Each slot’s icon is the instrument itself, drawn in its own colour with its width in the corner. Right-click or long-press a slot to change it.

  • The nib decides what pressure means. A ballpoint varies a little, a felt tip barely at all, a pencil strongly and lighter on the page; a fountain nib is broad across and fine along, and thinner the faster it travels.
  • Smoothing is adjustable: steadier handwriting at the cost of a little lag.
  • The pointer hides while a stylus is in use, because an arrow sits just where you are trying to look.
The settings for one palette slot: pen or highlighter, a choice of nib, a width slider and a row of colours.
One slot’s settings: instrument, nib, width and colour.

Highlighting that leaves the text black

Highlighter ink is blended by multiplying, so black text stays black however strong the highlight and only the paper takes the tint. For a dark slide deck, where multiplying darkens instead, turn off Highlight Behind Text.

  • Text-snap highlights: select words and press Ctrl+Shift+H. The result is a real PDF highlight that other readers list and can delete.
  • Shapes: line, arrow, rectangle and ellipse, with whatever pen is in hand.
  • A lasso to move or resize ink, and an eraser that can rub out part of a stroke instead of all of it.
A table of thermal diffusivities with one value circled in red and the question '23 or 21?' written beside it, a blue bracket beside a definition and a green tick in the margin.
A value questioned, a definition bracketed, a tick in the margin.

Typed notes, and a list of everything

Press a, tap the page and type. The note takes the colour of the pen in hand and is saved as a /FreeText with its own appearance, so it looks the same in every reader. Tap it again to change it; empty it to delete it.

The sidebar’s Notes tab lists every note, highlight and mark in the document, page by page, and clicking one goes there.

A note is set in one of the fourteen fonts every PDF reader has, so nothing is embedded. The text of a note in Devanagari or Chinese is kept, but the picture drawn into the page shows ? until embedded fonts arrive.

Sulekha's Notes sidebar listing a typed note, a highlight and groups of ink marks by page, beside the page with the typed note 'Compare Fourier (1822), ch. 1' and a yellow highlight.
The Notes tab: the typed note, the highlight and the ink, page by page.

Never lose ink

  • Undo and redo for every kind of mark, and for page changes too.
  • Crash recovery: unsaved ink is kept aside and offered back the next time the document opens.
  • A question before anything would discard ink: opening another file, going to the library, switching modes.
  • Retroactive palm rejection, and a touch mode that decides what a finger does: draw, gesture only, or nothing.
b / xPen / eraser
g / lShape / lasso
s / aSelect text / type a note
Ctrl+Shift+HHighlight the selection
Ctrl+Z / Ctrl+Shift+ZUndo / redo
Ctrl+S / Ctrl+Shift+SSave / save a copy
Ctrl+MCycle the touch mode
Ctrl+Shift+MSwitch reading / annotating

Every shortcut with a modifier can be changed in Preferences.

How a stroke is stored

Each stroke is written three ways at once, because no single one does the whole job. A basic viewer gets a sensible line, a conforming viewer draws the exact outline, and Sulekha gets back the samples the stylus delivered.

Saving in place appends only what changed, so it costs what the edit cost rather than what the document weighs.

/InkListThe centreline
/AP /NThe variable-width outline, as drawn
/Sulekha_DataRaw pressure samples, for lossless editing
/BM /MultiplyHighlighters behind the text, in every reader

Ink, typed notes and highlights come with a licence. Undo and saving are never withdrawn, so ink drawn during the trial can always be undone and written out.