Skip to content

2.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 26 Jun 01:13

Decks 2.3.0 Release Notes

🖼️ Interactive image occlusion

Decks 2.3.0 adds interactive image occlusion — hide regions of an image by drawing boxes right on it,
then recall what's underneath. Run "Create image occlusion at cursor", pick an image, and a studio opens
where you drag to draw masks, type an answer per box (Markdown/LaTeX), or leave a box empty to simply hide a
label baked into the image. Everything is saved in a single self-contained decks-occlusion code block, so
your coordinates and answers can never fall out of sync — and because they're stored as percentages, masks
scale on any device.

This runs side by side with the classic numbered-list occlusion; nothing about existing cards changes.

How it works

  • Draw, don't type coordinates. The studio is a split view — image on the left, a box list and answer
    editor on the right. Drag to draw, drag/resize to adjust, and delete with the box's red ×.
  • One box, one card. Each mask becomes its own card. On review the box is hidden on the front (with the
    active one highlighted) and revealed on the back along with its answer; deletion-only boxes just uncover the
    region.
  • Labeled diagram in reading view. Outside review, the block renders the fully answered diagram — boxes
    with answers show their text, deletion-only boxes reveal the image — with an Edit button to reopen the
    studio.
  • Edits keep your progress. A card's identity is tied to its box, so moving, resizing, or rewriting a
    box's answer preserves its scheduling history, and editing one box never disturbs the others.
  • Edit from anywhere. Reopen the studio from the block's Edit button or straight from the flashcard
    manager. Works with your deck's cloze "show context" setting for hide-all vs. show-the-rest review.
  • Fully localized. The command, studio, and messages are translated across all supported languages.

Upgrading: existing decks and the classic numbered-list occlusion are unaffected — the new interactive
method is purely additive. Cloze must be enabled on the profile, and the block sits under a parsed header,
just like other cards.