0.3.0

0.3.0

Works with Image Annotation 0.2, where a region is a note.

• An image note's annotations property links the notes of the regions Image Annotation drew on the image: [[Regions/Eyes|Eyes]]. Selecting such a region offers Open region note, and an image extracted from one records the note as region_note.
• A new image note is never named exactly as the note its picture came from, which read as the article itself in note search. A snapshot Image Annotation named <source note> - image - d857 gives its note the same name; another picture with a known source note is <source note> - image - b2df.
• A note's name is now set once. Each load renamed every image note to the naming rule's current answer, so a note could change its name without anyone renaming it. Only notes in the old _Image Graph/Images folder are still moved. Loading no longer reads every image note's properties to decide this.

Image Annotation 0.1 attachments are no longer read. With Image Annotation 0.1, regions still show, without links to notes.

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.