Différences

Ci-dessous, les différences entre deux révisions de la page.

--- ressource:logiciel:gb_studio:start [2025/04/10 23:02]
emoc [Utilisation : scripting]
+++ ressource:logiciel:gb_studio:start [2025/04/15 10:52] (Version actuelle)
emoc [Émulateur intégré]
@@ Ligne 63: / Ligne 63: @@
   * https://gbstudiocentral.com/tips/basics-the-sprite-editor/
   * https://gbstudiocentral.com/tips/managing-sprite-tiles/
+Exemple d'un sprite d'acteur animé à 6 positions (fichier .PNG de 96x16 pixels) : \\
+{{:ressource:logiciel:gb_studio:frogue_x10_grille.png?direct|}} \\
+Positions : 2 frames «de face en mouvement», 2 frames «avançant vers le haut», 2 frames «avançant à droite» (dont seront déduites les positions «avançant à gauche»). Le vert vif clair correspond à la couleur transparente.
 ==== Images de fond (backgrounds) ====
@@ Ligne 134: / Ligne 139: @@
 A chaque scène, on peut associer un arrière plan, un type, une feuille de sprite au personnage et des scripts à l'initialisation (par exemple : changer la musique)
+Les acteurs sont soit des personnages, soit des objets avec lesquels le joueur interagit
 ==== Scenes ====
@@ Ligne 186: / Ligne 193: @@
 ===== Utilisation : build & export =====
-TODO
+Le jeu peut être «buildé» à tout moment avec le bouton «play» en haut à droite, il s'ouvrira alors dans un [[ressource:gameboy#emulation|émulateur]] (qui a quelques difficultés avec le son). \\
+On peut aussi l'exporter sous différente forme depuis le menu «jeu/exporter sous» :
+  * Encapsulé dans un fichier HTML, ce qui permet d'y jouer dans n'importe quel navigateur et de le mettre sur le web. Dans ce cas un dossier «web» est créé dans le dossier «build» du projet. Le dossier inclut l'émulateur BinjGB.
+  * Sous forme de ROM qui peut ensuite être jouée dans un émulateur ou mis sur cartouche ou sous forme de ROM pour console Analogue Pocket.
+Pour jouer au jeu créé, on peut utiliser :
+  * sur ordi : [[ressource:gameboy#emulation|émulateur]], navigateur web
+  * sur mobile : [[ressource:gameboy#emulation|émulateur]], navigateur web
+  * sur console : cartouche (cf. [[materiel:gbxcart|GBxCart RW]]), cartouche à carte microSD (cf. [[materiel:everdrive_gb_x5|Krikkz EverDrive-GB X5]])
+==== Émulateur intégré ====
+Quand on «build» le jeu, il s'affiche dans une fenêtre d'émulation. C'est [[ressource:gameboy#emulation|BinjGB]] qui assure l'émulation.
+**Haut, Bas, Gauche, Droite** : flèches directionnelles \\
+**Bouton A** : <key>Z</key> \\
+**Bouton B** : <key>X</key> \\
+**Bouton Start** : <key>Enter</key> \\
+**Bouton Select** : <key>Shift</key> \\
+==== Export HTML ====
+Quand on **exporte un jeu en html**, il faut lancer un serveur pour le tester en local (et ne pas se confronter aux règles CORS du navigateur), par exemple en utilisant le serveur intégré à python
+  * se placer dans le dossier du jeu (où se trouve le fichier index.html)
+  * ''python3 -V'' (si python 3.x), ou ''python -V'' (si python 2.x)
+  * ''python3 -m http.server'' (si python 3.x) ou ''python -m SimpleHTTPServer'' (si python 2.x)
+Pour publier sur itch.io :
+  * exporter en html, puis
+  * zipper le dossier build/web, uploader sur itch.io comme un jeu HTML, taille de viewport recommandée : 480px x 432px.
+===== FAQ / Tips =====
+**Jouer de la musique une seule fois** \\
+Apparemment le player n'est pas fait pour ça, il faut créer un pattern vide et à la fin de celui-ci renvoyer vers le pattern vide, cf. https://github.com/chrismaltby/gb-studio/issues/1191#issuecomment-1284881468
+**Représenter des sprites sur une grille** \\
+Utile d'un point de vue pédagogique! Les images des sprites sont très petites (16x16px), il faut les agrandir et ajouter une grille (avec le script [[http://www.fmwconcepts.com/imagemagick/grid/index.php|grid]] de Fred Weinhaus)
+<code bash>
+convert frogue.png -filter point -resize 1000% f1.png           # multiplier la définition par 10 sans interpolation
+convert f1.png -background '#65ff00' -layers flatten f2.png     # ajouter un fond vert
+sh ./grid -s 10 -c white -o 0.8 f2.png f3.png                   # ajouter une grille blanche autour de chaque pixel
+sh ./grid -s 160 -c black f3.png frogue_x10_grille.png          # ajouter une grille noire autour de chaque frame
+</code>
+Original
+{{:ressource:logiciel:gb_studio:frogue.png?direct|}}
+Résultat
+{{:ressource:logiciel:gb_studio:frogue_x10_grille.png?direct&480|}}
 ===== Advanced mode =====
-Explaining VRAM and tile limits in GB Studio. https://gbstudiolab.neocities.org/guides/vram-tile-limits
+Explaining VRAM and tile limits in GB Studio. https://gbstudiolab.neocities.org/guides/vram-tile-limits \\
+Game size checker : https://gbstudiolab.neocities.org/resources/game-size-checker (utile avant optimisation)
 ==== Détails techniques croustillants sur GB Studio ====