zoom_inset — ANNOTATE compose op

• Data kinds: image2d → image2d

• Call: import fullseye as fs; fs.ledger.zoom_inset(img, src_rect, dst_xy, factor=3, color='emphasis', width=2, connect=True, scheme='okabe_ito', style=None) (to call the implementation directly, import annotate; annotate.zoom_inset(img, src_rect, dst_xy, factor=3, color='emphasis', width=2, connect=True, scheme='okabe_ito', style=None); from the registry, opsannotate.get("zoom_inset"))

Usage

A magnified inset — adds a frame and a leader line to the original figure.

Magnification is np.repeat nearest neighbour (integer multiples). It does not interpolate, in order to guarantee that the inset is "the original pixels themselves" (smoothing would make it look as if structure appeared that was not there).

Parameters

src_rect : (x, y, w, h)

Source region to magnify.

dst_xy : (x, y)

Top-left of the inset destination.

factor : int

Integer magnification (>= 1).

connect : bool

If True, connects corresponding corners of the source frame and the inset frame with 2 lines.

Raises

ValueError

factor below 1 or non-integer, source frame/inset sticks out of the image.

Detailed usage guide

• figure_annotation family guide

Background guides (the physics and conventions behind this op)

• dataset_conventions — Training-dataset conventions — COCO / YOLO / VOC and pitfalls in visual inspection

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• annotate_gallery — py -3.11 examples/annotate_gallery.py

• poc_diabolo_model_and_vision — py -3.11 examples/poc_diabolo_model_and_vision.py

• poc_food_cutting_measure — py -3.11 examples/poc_food_cutting_measure.py

Ops the type connects to (they accept image2d as input)

text_box · arrow · leader_line · label_points · crosshair · legend_box · color_bar · scale_bar

Same category (compose)

compare_frame · panel_grid

*Provenance: annotate.py — ANNOTATE operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.