English
This addon allows you to add image occlusion cards to Anki. Image occlusion cards are like cloze deletions with graphics. In general, you hide parts of an image, and during the repetitions you must guess what the hidden part is.
Image Occlusions are discussed in the supermemo [website](http:/www.supermemo.com/articles/flow.htm#Occlusion test).
In practice, you will often have an image with labels, and you will hide the labels which you want to guess during the repetitions. Because an image is worth 1000 words:
TODO: upload images
The addon is very simple. In the note editor, a new button has appeared, containing the text Image Occlusion (ignore the cute panda, the lightning bolt icon and the grey snowflakes near the fields; they are from some of my (tmbb's) other addons. If you are curious, please see check these: panda, lightning bolt, snowflakes).
To add new Image Occlusion cards to your collection, click that button. You will be asked to choose an image file to generate cards from it. Choose the file, and a new window will appear, with an image editor containing the image ready for you to edit. You generate Image Occlusion cards by drawing shapes (or masks) over the original image. There are several shapes you can draw, and you can group shapes together to cover non-contiguous parts of the image. In the vast majority of cases you will want to use rectangles.
Open the note editor (by clicking Add in the deck browser, for example)
Click the Image Occlusion button
Choose the image file you want to use (I chose an image from Netter's atlas, depicting a deep dissection of the muscles of the thigh). You can also use an image from the clipboard.
An image editor will appear.
You can now start to draw rectangles over the labels you want to hide in your image.
The initial tool is the rectangle tool, so you can start drawing rectangles right away. The rectangles are initially set to white, but the color can be changed in the color panel in the bottom of the screen. The rectangle tool is marked with an arrow in the following screenshot:
Repeat for all labels
You may want to add a Header to your image. It is completely optional. If supplied, the header will be displayed above the images when reviewing the cards. It will also be used to sort the cards in the browser.
You may also want to add a Footer to your image. It also optional. If supplied, the footer will be displayed bellow the images when reviewing the cards. It will also be used to sort the cards in the browser.
Finally, you can add some tags to your cards.
Now that all labels are hidden, you must add the cards to Anki. To add the cards, you click one of the following buttons (their meaning will be discussed later):
A tooltip will appear indicating how many notes have been added. If you generate lots of notes from the same image, it might take some time untill the tooltip appears.
Congratulations: you have added your first set of image occlusion notes.
Don't close the editor window! A bug in Qt means that if you close the editor window, you have to restart Anki to add more Image Occlusion cards. As long as you keep this window open, you should be able to add Image Occlusion cards from any number of images. You just have to restart from step 1.
For documentation on how to use the editor, see the official website.
As of the current version, you can change:
- the default color of the rectangles in the editor [default value is white]. Please note that you can also change the rectangle color in the editor itself.
- the color of the rectangle that appears in the question [default value is red, as in the examples shown]. You can't change this option in the editor.
To change configure this options, go to the Tools > Image Occlusion 2.0 (options) menu, as shown in the picture:
