Mise à jour de README.md

This commit is contained in:
Jérôme Henry-Barnaudière - GeeHB 2024-02-09 15:15:01 +01:00
parent 85be2f9e03
commit 71d9f0f245
8 changed files with 37 additions and 11 deletions

View File

@ -7,7 +7,6 @@ find_package(Gint 2.9 REQUIRED)
set(SOURCES
src/main.cpp
#src/tests.cpp
src/sudoSolver.cpp
src/shared/bFile.cpp
src/shared/keyboard.cpp

View File

@ -8,18 +8,18 @@
L'application est organisée autour d'une barre de menu horizontale; la navigation s'effectuant en appuyant sur les touches de contrôle situées "sous" les items.
* *File* permet d'accéder au sous-menu de gestion des fichiers
* *Edit* permet de modifier une grille
* *Solve* donne accès aufonction de recherche des solutions
* *Solve* donne accès aux fonctions de recherche automatisée des solutions et permet aussi à l'utilisateur de chercher par lui même une solution.
* *Quit* sort de l'application
### Informations de version
| Dépôt  | https://gitea.planet-casio.com/Jhb/sudoSolv |
|----- |-------------------------------------|
| **Date** | 25 janvier 2024 |
| **Version stable** | **0\.2.1** - branche `master` |
| **Date** | 9 février 2024 |
| **Version stable** | **0\.3.2** - branche `master` |
### Gestion des fichiers
Le menu *File* permet de gérer les grilles de sodoku : création d'une nouvelle grillen navigation dans le dossier, sauvegarde, suppression.
Le menu *File* permet de gérer les grilles de sodoku : création d'une nouvelle grille, navigation dans le dossier, sauvegarde, suppression.
Les grilles sont toutes enregistrées et chargées à partir du dossier `fls0\grids`. Si le dossier n'existe pas, il sera crée au lancement de l'application.
@ -41,13 +41,38 @@ Le menu propose les options suivantes:
### Modification d'une grille
Le menu *Edit* permet de modifier une grille existante ou de générer une nouvelle grille à partir d'une matrice vierge.
Les touches
Il suffit d'appueyer sur une touche pour mettre la valeur à la position cournate; si cela est possible en l'étât.
Les touches de navigation déplacent le curseur dans la grille.
Et il suffit d'appuyer sur une des touches comprises entre '1' et '9' pour mettre la valeur associée à la position courante; si cela est possible en l'étât.
La touche '0' supprime la valeur en place.
![Edit](assets/edit.png)
### Résolution
Enfin le menu *Solve* donne accès aux fonctions de recherche des valeurs évidentes (obvious values) ou d'une solution complête.
Le menu *Solve* permet, au choix, de rechercher par soi même une solution ou de demander au programme d'en trouver une.
#### Résolution manuelle
L'item *Manual* permet à l'utilisateur de chercher une solution par lui même. Dans ce cas les éléments "posés" sur la grille sont ajoutés avec la couleur noire.
Le système offre néanmoins la possiblité de poser des hypothèses. Cela passe par le choix d'une couleur. Dès lors qu'une couleur est choisie, tous les éléments liés sont affichés avec une pastille colorée. Cela permet d'un coup d'oeil de voir tous les éléments liés à une hypothèse.
La couleur utilisée est aussi reprise dans l'affichage du menu.
Par exemple, avec le choix de la couleur verte :
![Hypothèse](assets/hypothese.png)
Le sous-menu offre les possiblités suivantes :
* *Col.* : Choix d'une hypothèse, marquée par une couleur.
En choisissant cette option, un sous menu-menu est affiché (encore un ...) permettant de choisir une couleur en cochant la case associée. Lorsque toutes les cases sont décochées (position par défaut), aucune hypothèse n'est en place.
* *Accept* : Tous les éléments d'une hypothèse (ie. tous les éléments marqués par la couleur) sont intégrés à la grille et donc se voient retirer leur couleur,
* 'Reject' : Tous les éléments d'une hypothèse sont rejetés. Ces éléments sont donc retirés de la grille.
* *End* permet de sortir du mode résolution manuelle et de retourner au msous-menu *Solve*.
![Couelurs](assets/chooseCol.png)
#### Résolution automatique
*Obvious* recherche les valeurs évidentes pour la grille. Il s'agit des valeurs que l'on peut mettre sans effectuer aucune hypothèse.
@ -63,4 +88,4 @@ La résolution est bien plus rapide lorsque l'on a recherché les valeurs évide
*Revert* retire les éléments trouvés et retourne à la grille d'origine.
*back* permet de revenir au menu principal.
*back* permet de revenir au menu principal.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 21 KiB

BIN
assets/chooseCol.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.4 KiB

BIN
assets/hypothese.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 KiB

BIN
assets/resolve.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.4 KiB

View File

@ -175,9 +175,9 @@ void sudoSolver::run(void)
// Activate or deactivate screen capture
case KEY_CODE_CAPTURE:
if (MOD_SHIFT == (action.modifier & MOD_SHIFT)){
//if (MOD_SHIFT == (action.modifier & MOD_SHIFT)){
_onCapture();
}
//}
break;
default:

View File

@ -477,6 +477,7 @@ bool sudoku::edit(uint8_t mode){
reDraw = false;
}
/*
if (modified){
dprint_opt(CASIO_WIDTH - 100, CASIO_HEIGHT - 12 - MENUBAR_DEF_HEIGHT,
C_BLACK, SCREEN_BK_COLOUR,
@ -484,6 +485,7 @@ bool sudoku::edit(uint8_t mode){
" Elements : %d ", elements);
dupdate();
}
*/
} // while (cont)