Advanced Use
All Modes
- Ctrl + Shift + O: Invoke Image Occlusion Enhanced
- Alt + M: Switch focus to Masks Editor
- Alt + F: Switch focus to Fields Tab
- Ctrl + Tab: Switch Tabs
- Ctrl + 1..9: Focus fields 1..9 respectively
- Ctrl + Shift + T: Focus tags entry
- Ctrl + R: Reset all fields aside from sticky fields
- Ctrl + Shift + R: Reset all fields
- Alt + I: Change image
- Alt + C: Close dialog
Adding Mode
The alternate hotkeys also close the window after adding the cards.
- Alt + A or Ctrl + Return: Create "Hide All, Reveal One" notes
- Alt + R or Ctrl + Alt + Return+ : Create "Hide All, Reveal One" notes
- Alt + O or Ctrl + Shift + Return: Create "Hide One, Reveal All" notes
Editing Mode
- Alt + E or Ctrl + Return: Edit Cards
- Alt + A: Add New Cards
You can refer to the following tutorial video for a general overview of the topics covered in this Wiki section:
Please understand that some of the points in the video might be out of date. You will always find the most recent information in this Wiki.
- + / - to zoom in/out
- MMB-drag or Space + LMB-drag to pan the canvas
- Shift+LMB-click to select multiple separate shapes
- Shift + LMB-drag to draw a selection rectangle
- A to select all items in the current layer
- Shift + S to activate grid-snapping
- W to toggle wireframe mode (great for looking beneath your masks)
- F or Ctrl + F to fit the image to the canvas
- N to reset the canvas, deleting all masks and labels
- CTRL + Z/Y to undo/redo
- S for the selection tool
- Q for the panning tool
- R for the rectangle tool
- E for the ellipse tool
- P for the path tool
- V for the line tool
- T for the text tool
- G to group/ungroup items
- X to show the layers side panel
- Ctrl + Shift + L to switch to the Labels layer
- Ctrl + Shift + M to switch to the Masks layer
In some cases you might want to occlude multiple labels at once. This is where grouping comes into play:
- Select the items you want group together (you can use Shift + click to select multiple non-adjacent items)
- Press the G key
The selected items should now form a single mask.
To ungroup items simply repeat the steps above on a grouped mask.
You don't have to dissolve groups in order to edit the shapes within. Here's what you can do instead:
- Double-click on the group in question
- A new indicator should appear in the top-left corner of your screen, confirming that you are now in an in-group editing mode
- You can now modify each individual shape in whatever way you wish. Any shapes you draw in this mode will be part of the group.
- As soon as you are done editing the group, click on "Masks" in the top-left corner to go back to the regular canvas
Editing groups in this fashion also holds the advantage of preserving scheduling information when editing existing image occlusion notes.
You can use the Layers dialog to create custom labels:
- Click on the right-sided labels side pane in the Masks Editor; a panel with all active layers will appear
- Select the Labels layer by left-clicking on it in the labels list
- Anything you draw while this layer is active will appear above your image, but below the occlusion mask
- When you're done simply re-select the Masks layer to go back to drawing masks
It doesn't always have to be rectangles and lines. There are quite a few more advanced shapes available in the mask editor's arsenal:
- Arrows: Draw a line using the line tool and select it. A drop-down box labeled arrows should appear in the top bar. Choose the arrow head you want or use the markers tool beside it for a larger variety of decorations
- Shape Library: Click on the cylinder-like tool in the tools pane. A drawer with a variety of predefined shapes will appear. You can use any of these to draw your masks or labels.
Image Occlusion Enhanced comes with four new fields, Remarks, Sources, Extra 1 and Extra 2. In total, you now have six different fields to choose from when adding additional information to your IO notes.
So what should you use these fields for? Well, you can customize and rename them however you please, but here are some suggestions:
- Header field: appears both on the front and back of your cards. I would use this for short titles that put your image in the right context. Notes in the browser can be sorted by this field, so make sure to choose a descriptive title.
- Footer: appears both on the front and back of your cards. You could use this for hints, mnemonics, recall prompts, etc.
- Remarks fields: Only appears on the back. Best suited for additional information, trivia, etc. Use this to nourish a big-picture understanding of the subject.
- Sources: Only appears on the back. The best place to put references, links to your sources, lecturers etc. Very important if you ever want to go back and read up on the topic at hand.
- Extra 1 / Extra 2: These are card-specific and can be used to add information about a specific label.
The add-on provides a way to sync a defined list of fields between Anki's regular Editor window and the IO Editor. This can be useful when regularly switching between note types that use identical fields. For instance, if you have a basic note type with a Sources field you might want the IO Editor to use the last value of that field in Anki and vice-versa.
This option is inactive by default, but you can enable it for a specific field by setting the Remember last input option for that field from Anki's "Fields" dialog. Alternatively you can use the Frozen Fields add-on to change this setting on the fly.
By default, all fields aside from Extra 1 and Extra 2 are available for batch-modifications in Editing mode. Changes to these fields will be synced across all sibling IO notes. Any note-specific content will be overwritten.
You can exclude fields from this by setting them to be ignored in Editing mode. For detailed instructions on how to do this, check out the Miscellaneous Settings section of the Options Wiki.
This is also covered in the following tutorial video:
