Update readme.md

This commit is contained in:
Darks 2018-08-19 17:03:13 +02:00
parent db4850e0f4
commit f088b88edb
1 changed files with 37 additions and 3 deletions

View File

@ -1,13 +1,47 @@
# Sprite Optimizer
Génère du code pour Multi DrawStat à partir d'une image source.
Le Sprite Optimizer est un outil permettant de générer le code Multi DrawStat optimisé d'une image.
La sortie est destinée à être copiée-collée dans un éditeur de programmes.
Attention, l'algorithme est en `O(N²)`, au delà de 150 pixels à traiter, l'exécution peut être très
La solution est optimisée et peut ne pas être optimale. En pratique, elle est très souvent utilisable telle quelle.
L'algorithme a une complexité quadratique : au delà de 150 pixels à traiter, l'exécution peut être très
lente.
## Options d'utilisation
Par défaut, le code est généré pour un origine `(0, 0)` en haut à gauche, ce qui correspond au `ViewWindow 0, 126, 0, 62, 0, 0`.
### Inversion du ViewWindow
Pour inverser le ViewWindow et avoir une origine `(0, 0)` en bas à gauche, utilisez l'option `--flip`. Correspond au `ViewWindow 0, 126, 0, 0, 62, 0`.
Il est possible d'utiliser cette option en même temps que `--offset`.
### Décalage du ViewWindow
Pour décaler l'origine du ViewWindow et avoir une origine `(a, b)` dans un coin, utiliser l'option `--offset a, b`. Correspond au `ViewWindow a, 126+a, 0, 62+b, b, 0`.
Il est possible d'utiliser cette option en même temps que `--flip`.
### Affichage des statistiques et de la progression
Utilisez les options `--info` et `--progress`.
### Export visuel du résulat
Pour exporter le résultat visuellement, utilisez les options `--show` pour afficher l'image et `--draw` pour l'enregistrer dans un fichier `<nom>_gen.png`.
Cela permet de vérifier l'optimisation effectuée par l'outil.
## Installation
Installez Python 3 ainsi que les dépendances citées dans le fichier `requirements.txt`.
## Exemples d'utilisation
```
```bash
# Affiche le code uniquement
./sprite-optimizer image.png