====== add on anki occlusion ======
====== Anki – Image Occlusion (IO) : des cartes “à trous” sur des images ======

===== 1) À quoi ça sert ? =====
L’**Image Occlusion** (IO) sert à mémoriser des infos **visuelles** en masquant des zones d’une image, puis en te testant sur ce qui est caché. ([Anki Manual][1])
Cas typiques :

* anatomie / schémas (ex. cœur, cycle de Krebs)
* cartes (géographie)
* diagrammes, figures, tableaux

===== 2) “Add-on” ou fonctionnalité native ? =====
Aujourd’hui, il y a **2 réalités** :

* **IO natif (recommandé)** : depuis **Anki 23.10+**, IO est intégré directement dans Anki comme un type de note “Image Occlusion”. ([Anki Manual][1])
* **IO via add-on (historique)** : l’add-on **Image Occlusion Enhanced** existe toujours et transforme des images en cloze-tests (occlusions). ([GitHub][2])

  * Attention : comme tout add-on, il peut casser après une mise à jour d’Anki (compatibilité). ([Anki Manual][3])

> **Conseil simple** : si tu es sur une version récente d’Anki Desktop, utilise le **IO natif**. ([Anki Manual][1])
> Si tu dois absolument suivre un workflow “add-on” (par habitude/compat), alors IO Enhanced peut être pertinent, mais garde en tête le risque de maintenance. ([Anki Manual][3])

===== 3) Créer des cartes Image Occlusion (méthode native Anki 23.10+) =====
**Étapes :**

* Ouvre l’écran **Ajouter**.
* Clique sur **Type** → choisis **Image Occlusion** (type de note intégré). ([Anki Manual][1])
* Ajoute une image :

  * **Select Image** (fichier sur disque)
  * ou **Paste image from clipboard** (image copiée). ([Anki Manual][1])
* L’éditeur IO s’ouvre : place des masques (voir section suivante).
* Clique **Add** : Anki crée **une carte par masque** (ou par groupe, si tu groupes). ([Anki Manual][1])

===== 4) Masques : formes disponibles et modes =====
==== Formes ====
Tu peux créer des masques avec :

* Rectangle
* Ellipse
* Polygon ([Anki Manual][1])

==== Deux modes importants ====

* **Hide All, Guess One** : toutes les zones sont cachées, Anki te fait deviner **une zone à la fois** (peu d’indices). ([Anki Manual][1])
* **Hide One, Guess One** : une seule zone est cachée à la fois, le reste de l’image est visible (plus d’indices). ([Anki Manual][1])

**Quel mode choisir ?**

* Schémas où tu veux “zéro indice” → *Hide All, Guess One*
* Schémas où le contexte est utile (carte, diagramme) → *Hide One, Guess One*

===== 5) Champs utiles (à ne pas oublier) =====
Le type de note IO natif inclut des champs standards : ([Anki Manual][1])

* **Header** : affiché au-dessus de l’image (recto + verso)
* **Back Extra** : affiché sous l’image (verso)
* **Comments** : non affiché sur les cartes (notes perso)

Astuce pratique :

* Mets une **consigne claire** dans *Header* (ex. “Nommer la structure en rouge”).
* Mets une **explication** ou un mémo dans *Back Extra* (ex. “Fonction + pièges”).

===== 6) Éditer et organiser tes IO (très important) =====
Tu peux modifier une IO :

* depuis **Review** → bouton **Edit**
* ou depuis le **Browser**. ([Anki Manual][1])

Outils utiles dans l’éditeur IO : ([Anki Manual][1])

* **Select** : déplacer/redimensionner/supprimer/grouper des masques
* **Zoom** : zoom + déplacement libre
* **Text** : ajouter du texte sur l’image (⚠️ ça **ne crée pas** de carte)
* **Group / Ungroup** : grouper plusieurs masques → **1 seule carte** pour le groupe
* **Toggle Translucency** : voir temporairement les zones cachées
* **Alignment** : aligner proprement

⚠️ Point piégeux (suppression) :
Si tu **supprimes un masque**, la carte associée n’est pas forcément supprimée automatiquement ; il faut parfois faire **Tools → Empty Cards** ensuite. ([Anki Manual][1])

===== 7) Bonnes pratiques (pour des cartes vraiment efficaces) =====

* **Découpe** : préfère 10 masques “propres” plutôt que 50 micro-masques illisibles.
* **1 idée par carte** : si une figure est dense, fais plusieurs images / plusieurs IO.
* **Nommer** : utilise *Header* pour rappeler le contexte (cours / chapitre / objectif).
* **Cohérence** : choisis une logique de masquage stable (toujours structures, ou toujours légendes, etc.).
* **Qualité d’image** : prends des captures nettes (sinon tu révises… des pixels).

===== 8) Si tu es sur AnkiDroid =====
Bonne nouvelle : depuis **AnkiDroid 2.17.0**, l’app intègre directement du code Anki Desktop et annonce **Image Occlusion “natif”** aussi. ([ankidroid.org][4])
(Selon ton usage, la création peut passer par l’écran d’ajout ou via le menu Android “Partager” depuis une image.) ([ankidroid.org][4])

---



[1]: https://docs.ankiweb.net/editing.html "Adding/Editing - Anki Manual"
[2]: https://github.com/glutanimate/image-occlusion-enhanced "GitHub - glutanimate/image-occlusion-enhanced: Anki add-on that transforms images into cloze tests"
[3]: https://docs.ankiweb.net/addons.html "Add-ons - Anki Manual"
[4]: https://ankidroid.org/changelog.html "AnkiDroid Changelog"