lib module

callout-annotation function

#let callout-annotation(
  at,
  label,
  anchor: "mid",
  side: "north-east",
  label-at: auto,
  label-offset: auto,
  target-offset: auto,
  target-gap: 0.2,
  label-anchor: auto,
  leader: "curve",
  leader-start: auto,
  leader-end: auto,
  leader-points: (),
  leader-start-offset: (0, 0),
  leader-end-offset: (0, 0),
  mark: none,
  stroke: luma(40%) + 0.35pt,
  label-size: 0.82em,
  label-gap: 0.14,
  label-inset: 2.2pt,
  label-radius: 3pt,
  label-fill: white,
  label-stroke: 0.35pt + luma(70%),
  boxed: false,
  name: none,
)

Documentation

Create an external publication-style label with a leader line.

Automatic placement uses side; explicit CeTZ coordinates can override the label and either end of the leader for final figure adjustments.

Parameters

  • at (any): Target anchor or CeTZ coordinate.
  • label (content): Label content.
  • anchor (str): Anchor used to resolve at. Default: "mid".
  • side (str): Placement preset: "east", "west", "north", "south", or a diagonal combination. Default: "north-east".
  • label-at (auto, dictionary, str, array): Explicit label coordinate, or auto. Default: auto.
  • label-offset (auto, array): Relative label offset used by automatic placement. Default: auto.
  • target-offset (auto, array): Relative endpoint offset from the target. Default: auto.
  • target-gap (int, float): Automatic clearance between the leader and target. Default: 0.2.
  • label-anchor (auto, str): CeTZ anchor for the label content. Default: auto.
  • leader (str): Leader style: "curve", "straight", or "elbow". Default: "curve".
  • leader-start (auto, dictionary, str, array): Explicit leader start coordinate. Default: auto.
  • leader-end (auto, dictionary, str, array): Explicit leader end coordinate. Default: auto.
  • leader-points (array): Intermediate CeTZ coordinates for routing the leader. Default: ().
  • leader-start-offset (array): Fine adjustment applied to the leader start. Default: (0, 0).
  • leader-end-offset (array): Fine adjustment applied to the leader end. Default: (0, 0).
  • mark (any): Optional CeTZ line mark configuration. Default: none.
  • stroke (any): CeTZ stroke configuration for the leader. Default: luma(40%) + 0.35pt.
  • label-size (length): Label text size. Default: 0.82em.
  • label-gap (int, float): Clearance between an unboxed label and its leader. Default: 0.14.
  • label-inset (any): Label box inset. Default: 2.2pt.
  • label-radius (length): Label box corner radius. Default: 3pt.
  • label-fill (any): Label box fill. Default: white.
  • label-stroke (any): Label box stroke. Default: 0.35pt + luma(70%).
  • boxed (bool): Whether to draw a background box around the label. Default: false.
  • name (str, none): Optional CeTZ object name. Default: none.

Returns

dictionary

Defined in lib.typ:436.

Source

Module
lib
Defined in
lib.typ:436
Source
View source