0.2.3

0.2.3

Explore a selection, and a graph that holds still.

• Explore acts on every selected image. With several starting images none is anchored, so all of them can be moved and pinned: a smaller space to arrange and draw connections in. The status line traces a path from whichever starting image reached the image you select.
• Drawing a connection while exploring moves nothing. The view rebuilds on every change, and before this every image of a multi-image exploration moved by hundreds of pixels each time; an anchored exploration re-seeded every unpinned image when one new image arrived. A rebuild now holds every placed image and places only newcomers; changing the depth or expanding an image lets unpinned images settle again from where they were.
• The exploration layout settles. Its force pass cools over its last third and stops when nothing moves; at a fixed step it never settled at all. A multi-image exploration puts the starting images on the inner ring and their neighbours around them.
• A selection of more images than the exploration limit is capped and says so, like a neighbourhood that size.

The file explorer follows the selection.

• Select one image and the file explorer highlights its file, and scrolls to it if auto-reveal is on, as it does for the open note. Focus stays on the canvas.

Right-click menus, keys and the toolbar agree.

• A right-click on one of several selected images keeps the selection, so the menu acts on all of them. It used to collapse the selection to that image, and the multi-image items could only be reached from the empty canvas beside them.
• One menu, in sections: the thing under the pointer, the view, undo and redo, export, and delete last. A right-click on an image, a region or a connection shows only that thing; the empty canvas, the Actions button and Shift+F10 show the view too. Every item has an icon. Example connections is a command, not a menu item.
• X and P expand and pin the whole selection, as the menu does. Pin over a set is one state: all pinned becomes all free, anything else becomes all pinned.
• The Actions menu offers Back to the vault, Fit everything, Zoom to the selection and Move images, which were keyboard-only.

The properties panel is one line per property.

• Name, format, value and a small × on one line, as in Obsidian's own Properties. Lists and groups open beneath their row. Placeholders replace the repeated captions and the help paragraphs; a reserved name is reported on its row as it is typed.
• The panel names what is chosen: an image with its thumbnail, name and folder; a connection's two ends; a region's label. Save stays in view at the bottom.

Fixed:

• Some cards in the whole-vault view stayed blank until you zoomed in. Their atlas tiles had been saved fully transparent: a page that inherited its canvas from the previous layout was resized, and resizing clears a canvas. Tiles are no longer wiped, a blank tile in a saved page is decoded again, and the vault repairs itself on the next open.
• On the first paint after a plugin reload the vault was sometimes at 0% in the top-left corner, or at 100% on the origin. The first fit now waits for both the images and a laid-out pane, whichever arrives last.

0.2.2

Regions from the Image Annotation plugin.

• Regions drawn in Image Annotation appear on their images with a dashed outline. The graph reads that plugin's index and never writes to it.
• Select one to see the notes it is attached to. Open it in Image Annotation, or open that plugin's editor on any image, while it is loaded.
• Connections can reach a foreign region. Remove connections to deleted Image Annotation regions clears the ones whose region is gone, and undo restores them.
• Extracted images are named after their region and source, Dark water · Harbour at dusk.png, instead of an id.
• An extracted image's companion links to the notes its Image Annotation region was attached to. Companion notes that already exist carry an annotations property with the same links.
• A web image Image Annotation saved gets a companion named after the note it was clipped from, with source_url and source_note.

Snapshots and note embeds draw what the workspace draws.

Also in this release:

• Labels on the canvas are set in the theme's font. They were a generic family; exports and embeds had already been corrected.

• TIFF images the catalog holds are now offered by Explore the active image, Find the active image and the file menu, and a change to one refreshes the graph.

• A companion note with Windows line endings is read by the extraction backfill, as the store already read it.

• Internal: the graph's traversal, force layout, edge endpoints and region-shape algebra are four modules (they were one file); one Palette for both renderers; the route limits declared once; the decode-slot count and the two cache budgets named once; the property editor reads the input it holds rather than re-finding it; focusing an image uses the one fit.

• Labels and captions in exports and embeds used a font string the canvas cannot parse, so they were drawn at 10px in the default face. They now use the interface font at the intended size.

• Connections in a snapshot go around the images between their ends, as they do in the workspace, instead of cutting through them.

• A missing image is painted in the error colour in a snapshot, as in the workspace, instead of looking like an ordinary card.

• Regions from Image Annotation are dashed in a snapshot, as in the workspace.

• A recording canvas in the tests holds the still renderer to what the workspace draws.

0.2.1

A clearer exploration graph.

• Images occupy hop-based bands around the starting image. Fit connections centers the starting image.
• Relevant connections stand out. Other connections and region outlines stay faint.
• Selection and hover reveal relation labels. Labels avoid images, captions, and other labels.
• Extracted images use their region names as captions. Full filenames remain in Properties.
• Connections route around unrelated images where a short route is available.
• Layout spacing reserves room for captions and keeps manually pinned images fixed.

Checked in Image vault with 20,005 images and a 16-image, three-hop exploration.
All 76 behavior tests and the release-script test pass.
Physical mobile interaction and multi-device synchronization remain unverified.

0.2.0

Canvas interaction, after a study of Penpot's workspace.

• One selection replaces three fields that were kept in step by hand. Two states
  the old model could reach are now unrepresentable: an image ringed while a
  connection was edited, and a region edited while its image was deselected.
• The wheel scrolls the canvas and Ctrl or ⌘ with the wheel zooms, which is
  what Obsidian's own canvas does. A plain scroll no longer zooms. A
  trackpad can now pan, which it could not before.
• The pointer names what it is over before you press: a ring on the image or
  region under it, a thicker connection, and a cursor that says which.
• Shift-drag selects every image the band touches. Dragging one image of a
  selection carries all of them. Arrow keys move the selection one grid step,
  five with Shift.
• A selected region carries grips. Dragging one resizes it; before this a region
  could only be redrawn or typed as numbers.
• ? lists every shortcut. Shift with 0, 1 or 2 zooms to 100%, to
  everything, or to the selection.
• A spatial index backs the renderer and the hit test, so both cost the viewport
  rather than the vault.

Verified against the same vault of 20,005 generated images with trusted input:
band selection, a region grip resizing and saving, several images moving
together, and hover naming an image against a region. See
performance
and verification.

0.1.0

First release.

• Open every image in the vault as one workspace, with thumbnails at each zoom level.
• Draw rectangle and polygon regions that stay inside their parent image.
• Connect images, regions, or both, and label each connection through its relation property.
• Describe any selection with named properties in Text, Number, List, or group form. No YAML is required.
• Explore one image through one, two, or three connection steps, expand single neighbors, pin images, and trace the shortest path between two of them.
• Create a new image from a region, with a companion note recording its source image and source region.
• Export the current graph, the selection, or the whole vault as an editable Canvas, or the viewport as a visual snapshot.

Image properties and tags live in ordinary companion Markdown notes, so they stay readable with the plugin disabled. See the storage guide.

Verified on desktop against a vault of 20,000 generated 2048 × 2048 images. Physical mobile interaction, multi-device synchronization, and performance for other image formats and sizes are not verified. See development verification.