Examples

The configurations worth knowing.

Spotlight configurations for a room, a stream, and a bright projector, with what each changes.

The preview deck is built by this site with the first of these. A spotlight is a thing that moves, so the deck is the only place any of this can be judged: open it and hold the mouse button down.

A spotlight for a recording

format:
  revealjs:
    spotlight:
      size: 90
      presentingCursor: "default"
revealjs-plugins:
  - spotlight

A larger radius reads better once a slide is scaled down into a video frame, and keeping an ordinary cursor visible means the audience can follow the pointer even when the spotlight is off.

A coloured pointer for a bright room

format:
  revealjs:
    spotlight:
      useAsPointer: true
      pointerColor: "#b22222"
      size: 30

Dimming works badly on a washed-out projector. useAsPointer draws a coloured dot instead, which survives the room.

Triggered by a key rather than the mouse

format:
  revealjs:
    spotlight:
      toggleSpotlightOnMouseDown: false
      spotlightOnKeyPressAndHold: 73

Useful with a presenter remote that sends a key rather than a click. The value is a legacy keyCode, so 73 is I; false disables the behaviour. The deck still has to be in presentation mode for the key to reach the plugin.

Keeping the pointer on the slide

format:
  revealjs:
    spotlight:
      lockPointerInsideCanvas: true

Holds the pointer inside the presentation on a multi-monitor setup, through the Pointer Lock API. A browser may refuse it without a user gesture first.

Turning off the fade

format:
  revealjs:
    spotlight:
      fadeInAndOut: 0

The spotlight then appears and disappears at once, which some find easier to follow than a fade.

Source

The repository ships a short, standalone starting point you can copy: example.qmd.

Back to top