[[Vorlage(Getestet, bionic, focal)]] {{{#!vorlage Wissen [:Pakete_installieren: Installation von Programmen] [:Terminal: Ein Terminal öffnen] [:Editor: Einen Editor öffnen] }}} [[Inhaltsverzeichnis(1)]] [[Bild(./Logo.png, 64, align=left)]] Gngb ist ein [wikipedia:Game_Boy:Nintendo® GameBoy™]-Emulator, welcher in der [:Programmiersprache:Programmiersprache C] geschrieben wurde. Das Programm nutzt [wikipedia:Simple_DirectMedia_Layer:SDL] und [wikipedia:Opengl:OpenGL]. Die meisten Nintendo® GameBoy™ Classic und Nintendo® GameBoy™ Color [wikipedia:Spielmodul#Spielkonsolen_und_Homecomputer.2C_die_die_Modultechnik_nutzen_.28sortiert_nach_Jahren.29:Spielmodul] - im weiteren ROM genannt - werden unterstützt. Die Spielsteuerung erfolgt über die [#Tastatur Tastatur] und/oder einem [:Joysticks:Joystick]. Die [#Menue Speicherung] des aktuellen Spielstandes ist zu jedem Zeitpunkt möglich. = Installation = Folgendes Paket muss installiert [1] werden: {{{#!vorlage Paketinstallation gngb, universe }}} [[Vorlage(Bildunterschrift, gngb.png, , "[http://pdroms.de/files/gameboy/gb-flyer GB-Flyer] {en}", right,)]] = Bedienung = Um nun ein Spiel in gngb zu spielen benötigt man ein ROM. Das ROM öffnet man über das Terminal [2]: {{| {{{#!vorlage Befehl gngb -f -s -C -a ROMNAME.gb # Spiel ROMNAME wird im Vollbildmodus gestartet gngb -s -C -a /media/Disk/ROMNAME.gbc # Spiel ROMNAME wird in Orner /media/Disk gestartet }}} |}} Weitere Startoptionen können verwendet werden: {{{#!vorlage Tabelle <-2 tablestyle="width: 95%;" rowclass="titel"> Optionen +++ Parameter Beschreibung +++ `-h` Hilfe +++ `-a` Autoframeskip +++ `-f` Vollbild +++ `-G` GameBoy Classic +++ `-C` GameBoy Color +++ `-j` Joystick nutzen }}} Eine detaillierte Auflistung findet man in den [:man:Manpages]. Um die Parameter nicht immer von Hand einzugeben kann man diese auch in der [#Konfiguration Konfigurationsdatei] hinterlegen. Nach dem Start des Emulators wird der Ordner '''~/.gngb''' im Heimatverzeichnis angelegt. Hier werden die [#Menue Spielstände] abgelegt. {{{#!vorlage Hinweis Die ROMs müssen in den Formaten '''.gb''' (Nintendo® GameBoy™ Classic) und '''.gbc''' (Nintendo® GameBoy™ Color) vorliegen. }}} == Tastatur == Das jeweilige Spiel kann mit den folgenden Tasten gesteuert werden: {{{#!vorlage Tabelle <-2 tablestyle="width: 95%;" rowclass="titel"> Tastenkürzel +++ Taste Tastenentsprechung auf dem GameBoy +++ [[Vorlage(Tasten, Enter)]] Start +++ [[Vorlage(Tasten, Shift)]] Select +++ [[Vorlage(Tasten, X)]] A +++ [[Vorlage(Tasten, W)]] B +++ [[Vorlage(Tasten, links)]][[Vorlage(Tasten, hoch)]][[Vorlage(Tasten, rechts)]][[Vorlage(Tasten, runter)]] Steuerung der Spielfigur }}} ## == Joystick == ## === Konfiguration === ## {{{!Text ## Joystick configuration ## order : AXE_UP,AXE_DOWN,AXE_LEFT,AXE_RIGHT,A,B,START,SELECT ## ## map_joy 1,1,0,0,3,2,0,1 ## }}} [[Bild(./Menue.png, align=right, "alt='i'")]] = Menü = Über [[Vorlage(Tasten, TAB)]] erreicht man im laufenden Programm das Menü. Mit den Tasten [[Vorlage(Tasten, up)]][[Vorlage(Tasten, down)]] navigiert man durch dieses. [[Vorlage(Tasten, Esc)]] führt immer zum vorherigen Menüpunkt zurück. Mit [[Vorlage(Tasten, Enter)]] bestätigt man die Auswahl. Dem Benutzer stehen verschiedene Punkte zur Auswahl: {{{#!vorlage Tabelle <-2 tablestyle="width: 95%;" rowclass="titel"> Menü +++ Text Beschreibung +++ ''"Load state..."'' Spielstand laden +++ ''"Save state..."'' Spiel abspeichern +++ ''"Video..."'' Vollbildmodus (de)aktivieren / Filter ändern +++ ''"Frameskip..."'' Bildeinstellungen verändern +++ ''"Sound"'' Sound (de)aktivieren +++ ''"Reset"'' Spiel zurücksetzen. }}} = Konfiguration = Um die Einstellungen des Emulators zu verändern öffnet man im Ordner '''~/.gngb''' die Datei '''gngbrc''' mit einem Editor [3] und bearbeitet diese. Sollte diese nicht existieren eine Datei dieses Titels erstellen und den Inhalt der [attachment:gngb/sample_gngbrc:Vorlage] hineinkopieren. == Tastatur == Für Änderungen an der Steuerung per Tastatur vorzunehmen den folgenden Abschnitt suchen: {{{# Key configuration # order : AXE_UP,AXE_DOWN,AXE_LEFT,AXE_RIGHT,A,B,START,SELECT # please see SDL_keysym.h for key definition # or push F12 during game and the keysym code of # the key you press will be printed # (you can do the same for the joystick) map_key 273,274,276,275,120,119,13,303 }}} Die [#Tastatur Basissteuerung] kann man verändern, indem man den Emulator startet und [[Vorlage(Tasten, F12)]] drückt. Nun erscheint die Meldung: ``Show Keysym Code: on`` - beim drücken der einer Taste wird nun der entsprechende Tastencode ausgegeben. Für [[Vorlage(Tasten, Space)]] erscheint z.B. die ``13``. Nun die Codes den eigenen Wünschen entsprechend abändern z.B.: {{{map_key 273,274,276,275,121,120,13,32 }}} Das ergibt nach dem Neustart des Emulators folgende individuelle Steuerung: {{{#!vorlage Tabelle <-2 tablestyle="width: 95%;" rowclass="titel">Tastenkürzel +++ Taste Tastenentsprechung auf dem GameBoy +++ [[Vorlage(Tasten, Enter)]] Start +++ [[Vorlage(Tasten, leer)]] Select +++ [[Vorlage(Tasten, X)]]||B +++ [[Vorlage(Tasten, Y)]] A +++ [[Vorlage(Tasten, links)]][[Vorlage(Tasten, hoch)]][[Vorlage(Tasten, rechts)]][[Vorlage(Tasten, runter)]] Steuerung der Spielfigur }}} == Vollbild == Um den Emulator im Vollbild zu starten die ursprünglichen Zeilen von ``0`` (Deaktiviert) auf ``1`` (Aktiviert) ändern: {{{# Play in fullscreen? fullscreen 0 }}} == Sound == Um den Sound zu (de)aktivieren den Wert in der Zeile anpassen - ``0`` (Deaktiviert) / ``1`` (Aktiviert): {{{# Have sound? sound 1 }}} ## == Joystick == ## {{{!Text ## Joystick configuration ## order : AXE_UP,AXE_DOWN,AXE_LEFT,AXE_RIGHT,A,B,START,SELECT ## ## map_joy 1,1,0,0,3,2,0,1 ## }}} [[Anker(Tasten)]] = Tastenkürzel = {{{#!vorlage Tabelle <-2 tablestyle="width: 95%;" rowclass="titel">Tastenkürzel +++ Taste Beschreibung +++ [[Vorlage(Tasten, TAB)]] [#Menue Menü] öffnen +++ [[Vorlage(Tasten, F9)]] Vollbild ein/aus +++ [[Vorlage(Tasten, F10)]] fps anzeigen +++ [[Vorlage(Tasten, F11)]] Reset +++ [[Vorlage(Tasten, F12)]] Tastencodes anzeigen/verbergen +++ [[Vorlage(Tasten, 1)]][[Vorlage(Tasten, 2)]][[Vorlage(Tasten, 3)]][[Vorlage(Tasten, 4)]][[Vorlage(Tasten, 5)]] Farbpalette +++ [[Vorlage(Tasten, 6)]] Farbfilter wechseln +++ [[Vorlage(Tasten, Esc)]] Wechsel der [#Menue Menüebene] / Spiel beenden }}} = Links = * [http://m.peponas.free.fr/gngb Projektseite] {en} * [https://pdroms.de/ PDRoms – Homebrew 4 you] {en} * [http://pdroms.de/files/gameboy/gb-flyer GB-Flyer] (GBC) {en} {dl} * [github:AntonioND/ucity:µCity] (GBC) {en} {dl} * [https://benjelter.itch.io/unearthed Unearthed] {dl} {en} -WINNER of the GBCOMPO21 Game Jam!- * [https://maithonis.itch.io/interblocked INTERBLOCKED] {dl} {en} Game Boy Competition 2021 # tag: Emulation und Virtualisierung, Spiele, Nintendo, Game Boy