Difference between revisions of "Gnuboy GX"

From WiiBrew
Jump to navigation Jump to search
 
(34 intermediate revisions by 17 users not shown)
Line 1: Line 1:
−
{{Infobox homebrewapp
+
{{Infobox homebrew
−
| image =  
+
| image       = [[File:Gnuboy.png ]]
−
| title = Gnuboy GX
+
| title       = Gnuboy GX
−
| description = Gameboy (Color) emulator
+
| type        = handheld emulator
−
| type = Emulation/Simulation
+
| author     = Eke-eke
−
| author = Eke-eke
+
| maintainer  =
−
| download =
+
| contributor =
−
[http://www.tehskeen.com/forums/showthread.php?t=4443 TehSkeen Thread]
+
| portedby    =
−
[http://wii.gx-mod.com/modules/mydownloads/visit.php?lid=25 wii.gx-mod.com]
+
| version    = 14/12/2008
−
| source = [https://gnuboy-gx.bountysource.com/svn/!tree/36 SVN]
+
| download   = http://code.google.com/p/gnuboy-gx/downloads/list
−
| peripherals = {{wiimote1}} {{ClassicController}}  {{GCNController}} {{FrontSD}} {{GCNMemoryCard}}  
+
| source      = http://code.google.com/p/gnuboy-gx Google
−
| hbc = 1
+
| website    = http://code.google.com/p/gnuboy-gx Google
 +
| peripherals = {{wiimote1}} {{Nunchuk}} {{ClassicController}}  {{GCNController}} {{DVD}} {{FrontSDHC}} {{USBMSD}} {{GCNMemoryCard}}  
 +
| hbb        = yes
 +
| osc        = yes
 
}}
 
}}
 +
'''Gnuboy GX''' is a port of the open-source [http://en.wikipedia.org/wiki/Gnuboy Gnuboy] emulator, originally coded by Laguna and Gilgamesh.
  
  
−
GnuboyGX is a port of the open-source Gnuboy emulator, originally coded by Laguna and Gilgamesh.
+
This port is based on the last [http://www.netaxs.com/~gevaryah/gnuboy-1.0.4pre.tar.bz2 1.0.4 CVS source], released by Joshua_ from {{EFnet|gameboy}}.
−
http://en.wikipedia.org/wiki/Gnuboy
 
−
 
 
−
This port is based on the last 1.0.4 CVS source, released by Joshua_ from EFNet #gameboy:
 
−
http://www.netaxs.com/~gevaryah/gnuboy-1.0.4pre.tar.bz2.
 
  
 
== Information ==
 
== Information ==
−
* Author: eke-eke.
 
−
* Accessories Needed: GameCube Controller or Wiimote and SD Card.
 
 
* Preferred PAL Mode: Any (automatic TV mode detection).
 
* Preferred PAL Mode: Any (automatic TV mode detection).
−
* Button to Return to Loader: '''Return to Loader''' from the main menu takes you back to the SD Loader or HB channel
 
 
* Display mode : 480p, 480i, 576i
 
* Display mode : 480p, 480i, 576i
−
* Loaders Usable: [[Twilight Hack]], [[Homebrew Channel]]...
 
−
* Installation for Zelda Chainloader: Install as Usual.
 
 
* Software Type: Emulation
 
* Software Type: Emulation
−
* Supports Zip compressed rom images.
+
* Support for zipped (.zip) roms
 +
* Gameboy and Gameboy Color emulation with sound
 +
* Freeze State support (load & save)
 +
* Automatic SRAM/FreezeState
 +
* SRAM/RTC support (load & save)
 +
* RTC synchro
 +
* Support for 8MB roms
 +
* Support for alternate Mono Gameboy palettes
 +
 
 +
== Installation ==
 +
# Rename gnuboy_wii.dol to boot.dol and place it on your SD card with included meta.xml and icon.png files (/apps/gnuboy)
 +
# Create the Directory '''/gnuboy''' at the root of your SD Card.
 +
# Create the directory '''/gnuboy/roms''' on your SD Card and copy your ROM files (.zip, .gb & .gbc) there. There's a limit of 1000 files per directory.
 +
## The ROMs can be placed on DVD-/+R (4.7GB max size) but need to install the [[DVDx]] on your  Wii. More infos on [http://hackmii.com/2008/08/libdi-and-the-dvdx-installer/ HackMii]
 +
# /gnuboy/saves is automatically created if it does not exist on your SD card.
 +
# Select Load New Game from the Main Menu to load a ROM.
 +
# Select Play Game from the Main Menu to begin playing the game.
 +
 
 +
== Controls ==
  
−
[[Category:Homebrew applications]]
+
=== In Menu ===
 +
{| class="wikitable" style="left;text-align:center;"
 +
|-
 +
| {{GCNController}} || {{WiimoteHorizontal}} || {{WiimoteHorizontal}}+{{Nunchuk}} || {{ClassicController}} || Action
 +
|-
 +
| {{GCDPadUp}} '''/''' {{GCDPadDown}} or {{GCControlStick}} || {{WiimoteDPadUp}} '''/''' {{WiimoteDPadDown}} || {{WiimoteDPadUp}} '''/''' {{WiimoteDPadDown}} or {{NunchuckControlStick‎}} || {{ClassicDPadUp}} '''/''' {{ClassicDPadDown}}  or {{ClassicLControlStick‎}} || Items selection Up/Down
 +
|-
 +
| {{GCAButton}} || {{WiimoteAButton}} or {{Wiimote2Button}} or {{WiimoteDPadRight}} || {{WiimoteAButton}} or {{Wiimote2Button}} or {{WiimoteDPadRight}} || {{ClassicAButton}} or {{ClassicDPadRight}} || Select a menu item
 +
|-
 +
| {{GCBButton}} || {{Wiimote1Button}} or {{WiimoteBButton}} || {{Wiimote1Button}} or {{WiimoteBButton}} || {{ClassicBButton}} || Previous menu
 +
|-
 +
|}
  
−
== Installation ==
+
=== File selector menu ===
−
* Rename gnuboy_wii.dol as boot.dol and place it on your sdcard with included meta.xml and icon.png files (/apps/gnuboy)
+
{| class="wikitable" style="left;text-align:center;"
−
* Create the Directory '''/gnuboy''' at the root of your SD Card.
+
|-
−
* Create the directory '''/gnuboy/roms''' on your SD Card and copy your ROM files there.
+
| {{GCNController}} || {{WiimoteHorizontal}} || {{WiimoteHorizontal}}+{{Nunchuk}} || {{ClassicController}} || Action
−
* /gnuboy/saves is automatically created if it does not exist.
+
|-
−
* Select Load New Game from the Main Menu to load a ROM.
+
| {{GCDPadLeft}} '''/''' {{GCDPadRight}} or {{GCControlStick}} || {{WiimoteDPadLeft}} '''/''' {{WiimoteDPadRight}} || {{WiimoteDPadLeft}} '''/''' {{WiimoteDPadRight}} or {{NunchuckControlStick‎}} || {{ClassicDPadLeft}} '''/''' {{ClassicDPadRight}} or {{ClassicLControlStick‎}} || Display the selected entry's full filename
−
* Select Play Game from the Main Menu to begin playing the game.
+
|-
 +
| {{GCDPadUp}} '''/''' {{GCDPadDown}} or {{GCControlStick}} || {{WiimoteDPadUp}} '''/''' {{WiimoteDPadDown}} || {{WiimoteDPadUp}} '''/''' {{WiimoteDPadDown}}  or {{NunchuckControlStick‎}} || {{ClassicDPadUp}} '''/''' {{ClassicDPadDown}}  or {{ClassicLControlStick‎}} || Select previous/next file
 +
|-
 +
| {{GCLTrigger}} '''/''' {{GCRTrigger}} || {{WiimoteMinusButton}} '''/''' {{WiimotePlusButton}} || {{WiimoteMinusButton}} '''/''' {{WiimotePlusButton}} || {{ClassicLTrigger}} '''/''' {{ClassicRTrigger}} || Down/Up one full page
 +
|-
 +
| {{GCZButton}} || {{WiimoteHomeButton}} || {{WiimoteHomeButton}} || {{ClassicHomeButton}} || Quit the file selection menu
 +
|-
 +
| {{GCBButton}} || {{Wiimote1Button}} or {{WiimoteBButton}} || {{Wiimote1Button}} or {{WiimoteBButton}} || {{ClassicBButton}} || Up one directory
 +
|-
 +
| {{GCAButton}} || {{Wiimote2Button}} or {{WiimoteAButton}} || {{Wiimote2Button}} or {{WiimoteAButton}} || {{ClassicAButton}} || Load the selected file or enter the selected directoy
 +
|-
 +
|}
 +
 
 +
=== Game Controls ===
 +
The controls can't be changed.
 +
 
 +
{| class="wikitable" style="left;text-align:center;"
 +
|-
 +
| {{GCNController}} || {{WiimoteHorizontal}} || {{Wiimote}}+{{Nunchuk}} || {{ClassicController}} || Action
 +
|-
 +
| {{GCControlStick}} or {{GCDPad}}|| {{WiimoteDPad}} || {{WiimoteDPad}} or {{NunchuckControlStick‎}} || {{ClassicDPad}} or {{ClassicLControlStick‎}} || Dpad of the Gameboy
 +
|-
 +
| {{GCAButton}} || {{Wiimote2Button}} || {{WiimoteAButton}} || {{ClassicAButton}} || A
 +
|-
 +
| {{GCBButton}} || {{Wiimote1Button}} || {{WiimoteBButton}} || {{ClassicBButton}} || B
 +
|-
 +
| {{GCStartButton}} || {{WiimotePlusButton}} || {{WiimotePlusButton}} || {{ClassicPlusButton}} || START
 +
|-
 +
| {{GCYButton}} || {{WiimoteMinusButton}} || {{WiimoteMinusButton}} || {{ClassicMinusButton}} || SELECT
 +
|-
 +
| {{GCZButton}} || {{WiimoteHomeButton}} || {{WiimoteHomeButton}} || {{ClassicHomeButton}} || Emulator Menu
 +
|-
 +
|}
 +
 
 +
== Credits ==
 +
*Original Gnuboy Sourcecode: Laguna & Gilgamesh
 +
*1.04 CVS fixes: Joshua_ from EFNet #gameboy
 +
*Generic LibOGC (GX,Sound,Inputs) & GUI display sourcecode: SoftDev
 +
*Gnuboy Porting Code, GUI & extra features: Eke-Eke
 +
*Mono Gameboy palettes addition: Askot
 +
*DevkitPPC from Dave Murphy (WinterMute)
 +
*LibOGC by Michael Wiedenbauer (shagkur),Dave Murphy (WinterMute) & others
 +
*ZLIB by Jean-loup Gailly
 +
 
 +
== History ==
 +
14/12/2008:
 +
 
 +
[NGC/Wii]
 +
* removed embedded font, (re)enabled IPL font support: now should works for Qoob users too (thanks to emukiddid)
 +
* patched libfat for faster SDCARD accesses (thanks to svpe)
 +
* various bugfixes, menu tweaks and code cleanup
 +
 
 +
[NGC only]
 +
* added 480p support in menu
 +
 
 +
[Wii only]
 +
* implemented fast scrolling in menu using Wiimote D-PAD
 +
* added "Power" button support
 +
* added USB Storage support
 +
* Widescreen menu fix
 +
* *new* libogc 1.7.0 features: SDHC support, Wiimote shutdown button support
 +
 
 +
17/09/2008:
 +
* fixed "Press Button A" issue with Wiimote controllers
 +
* added fast scroll using wiimote D-PAD
 +
 
 +
26/08/2008:
 +
*fixed Classic Controller buttons default map
 +
*added automatic alphabetical file sorting (Marty Disibio)
 +
*added ROM History for faster ROM access (Marty Disibio)
 +
*added DVD support in Wii Mode (no modchip required)
 +
 
 +
15/07/2008:
 +
* added Wii mode support
 +
* added wiimote/nunchuk/classic controller support (WII version)
 +
* added libfat support
 +
* added automatic SRAM & FreezeState option
 +
* added 50hz (576i) TV mode support (autodetected)
 +
* added Progressive (480p) TV mode support (autodetected)
 +
* added various display aspect ratio support (ORIGINAL, SCALED, STRECTH)
 +
 
 +
10/10/2007:
 +
* improved sound rendering
 +
 
 +
20/07/2007:
 +
 
 +
[GB/GBC]
 +
* added RTC Synchro: in-game RTC (Real Time Clock) is now synchronized with system RTC on SRAM load
 +
* added GBC/GBA palettes color for GB Mono [Askot]
 +
* fixed some palettes [Askot]
 +
 
 +
[NGC]
 +
* added user-transparent SRAM autoload (detection order is MCARD then SDCARD, SLOTA then SLOTB)
 +
* added 4.7GB DVD support for WII drives (the maximal allowed size for Gamecube DVD is still 1.35GB)
 +
* removed MPAL video timings, always use 60Hz NTSC: fix display problems for PAL wii users (no more PAL50 version needed)
 +
* added Console Reboot option in main menu (System Reboot), also used for SDLoad reboot
 +
* Freezestate & SRAM files are now compressed (using zlib)
 +
* FreezeState & SRAM files can now be saved/loaded to/from SDCARD: located in /gnuboy/saves/ from the root of your SDCARD
 +
* added user-transparent SRAM autoload (detection order is MCARD then SDCARD, SLOTA then SLOTB)
 +
* changed initial ROMS directory for SDCARD user: now looking for /gnuboy/roms/ from the root of your SDCARD
 +
* current emulator options can now be saved/loaded to/from SDCARD SlotA: the file is dev0:\\gnuboy\\gnuboyGX.cfg [Askot]
 +
* added L+R combo to save SRAM in MCARD SLOTB during gameplay [Askot]
 +
* added new font: now use original IPL font, extracted from Bootrom
 +
* modified controls when going into the rom selection menu (DVD or SDCARD):
 +
** use B button to go up one directory
 +
** use Z button to quit the file selection menu
 +
** use L/R triggers to go down/up one full page
 +
** use Left/Right buttons or Analog stick to scroll the selected entry's filename when it can't be full displayed
 +
* various menu rearrangment, minor bugfixes & sourcecode cleanup
  
  
−
== Controls ==
+
24/05/2007:
 +
* added a new option for display different palette colors in Mono GB Mode (most of them taken from GoombaColor)(Askot)
  
−
=== Menu Controls ===
+
23/04/2007:
−
* '''Up / Down:''' Move through the Menu System.
+
* corrected a little bug with SRAM/STATE saving
−
* '''A Button / Button 2:''' Select the current menu option.
+
* modified key config upon request: SELECT is now assignated to Y Button
−
* '''B Button / Button 1:''' Go back from the current menu.
 
  
−
=== In-Game Controls ===
+
17/04/2007: (eke-eke)
 +
* added SRAM, RTC & STATE load/save support
 +
* added GUI and configurable options menu
 +
* corrected Sound Samples conversion (thanks to Softdev)
 +
* changed Sound Buffering Technic(changed to "head/tail" technic used by Softdev in NeoCDredux)
  
−
* '''B Button / Button 2:''' Gameboy Button A.
+
13/04/2007: WIP1
−
* '''A Button / Button 1:''' Gameboy Button B.
+
* initial release by softdev
−
* '''START Button / Button PLUS:''' Gameboy START Button.
 
−
* '''Y Button / Button MINUS:''' Gameboy SELECT Button.
 
−
* '''Z Trigger/ Button HOME:''' Return to Menu.
 

Latest revision as of 18:49, 8 April 2021

Gnuboy GX
Gnuboy.png
General
Author(s)Eke-eke
TypeHandheld emulator
Version14/12/2008
Links
Download
Google Website
Google Source
Downloadable via the Homebrew Browser
Downloadable via the Open Shop Channel
Peripherals
Wiimote1.svg Nunchuck alternative.svg ClassicController.svg GameCube Controller DVD Loads files from SDHC cards in the Front SD slot USB mass storage device GameCube Memory Card

Gnuboy GX is a port of the open-source Gnuboy emulator, originally coded by Laguna and Gilgamesh.


This port is based on the last 1.0.4 CVS source, released by Joshua_ from #gameboy on EFnet.

Information

  • Preferred PAL Mode: Any (automatic TV mode detection).
  • Display mode : 480p, 480i, 576i
  • Software Type: Emulation
  • Support for zipped (.zip) roms
  • Gameboy and Gameboy Color emulation with sound
  • Freeze State support (load & save)
  • Automatic SRAM/FreezeState
  • SRAM/RTC support (load & save)
  • RTC synchro
  • Support for 8MB roms
  • Support for alternate Mono Gameboy palettes

Installation

  1. Rename gnuboy_wii.dol to boot.dol and place it on your SD card with included meta.xml and icon.png files (/apps/gnuboy)
  2. Create the Directory /gnuboy at the root of your SD Card.
  3. Create the directory /gnuboy/roms on your SD Card and copy your ROM files (.zip, .gb & .gbc) there. There's a limit of 1000 files per directory.
    1. The ROMs can be placed on DVD-/+R (4.7GB max size) but need to install the DVDx on your Wii. More infos on HackMii
  4. /gnuboy/saves is automatically created if it does not exist on your SD card.
  5. Select Load New Game from the Main Menu to load a ROM.
  6. Select Play Game from the Main Menu to begin playing the game.

Controls

In Menu

GameCube Controller WiimoteHorizontal.svg WiimoteHorizontal.svg+Nunchuck alternative.svg ClassicController.svg Action
Gamecube D-Pad Up / Gamecube D-Pad Down or GameCube Control Stick Wiimote D-Pad Up / Wiimote D-Pad Down Wiimote D-Pad Up / Wiimote D-Pad Down or Nunchuck Control Stick Classic D-Pad Up / Classic D-Pad Down or Classic Left Control Stick Items selection Up/Down
Gamecube A Button Wiimote A Button or Wiimote 2 Button or Wiimote D-Pad Right Wiimote A Button or Wiimote 2 Button or Wiimote D-Pad Right Classic a Button or Classic D-Pad Right Select a menu item
Gamecube B Button Wiimote 1 Button or Wiimote B Button Wiimote 1 Button or Wiimote B Button Classic b Button Previous menu

File selector menu

GameCube Controller WiimoteHorizontal.svg WiimoteHorizontal.svg+Nunchuck alternative.svg ClassicController.svg Action
Gamecube D-Pad Left / Gamecube D-Pad Right or GameCube Control Stick Wiimote D-Pad Left / Wiimote D-Pad Right Wiimote D-Pad Left / Wiimote D-Pad Right or Nunchuck Control Stick Classic D-Pad Left / Classic D-Pad Right or Classic Left Control Stick Display the selected entry's full filename
Gamecube D-Pad Up / Gamecube D-Pad Down or GameCube Control Stick Wiimote D-Pad Up / Wiimote D-Pad Down Wiimote D-Pad Up / Wiimote D-Pad Down or Nunchuck Control Stick Classic D-Pad Up / Classic D-Pad Down or Classic Left Control Stick Select previous/next file
GameCube L Trigger / GameCube R Trigger Wiimote - Button / Wiimote + Button Wiimote - Button / Wiimote + Button Classic L Trigger / Classic R Trigger Down/Up one full page
GameCube Z Button Wiimote HOME Button Wiimote HOME Button Classic HOME Button Quit the file selection menu
Gamecube B Button Wiimote 1 Button or Wiimote B Button Wiimote 1 Button or Wiimote B Button Classic b Button Up one directory
Gamecube A Button Wiimote 2 Button or Wiimote A Button Wiimote 2 Button or Wiimote A Button Classic a Button Load the selected file or enter the selected directoy

Game Controls

The controls can't be changed.

GameCube Controller WiimoteHorizontal.svg Wiimote.svg+Nunchuck alternative.svg ClassicController.svg Action
GameCube Control Stick or GameCube D-Pad Wiimote D-Pad Wiimote D-Pad or Nunchuck Control Stick Classic D-Pad or Classic Left Control Stick Dpad of the Gameboy
Gamecube A Button Wiimote 2 Button Wiimote A Button Classic a Button A
Gamecube B Button Wiimote 1 Button Wiimote B Button Classic b Button B
GameCube START Button Wiimote + Button Wiimote + Button Classic + Button START
Gamecube Y Button Wiimote - Button Wiimote - Button Classic - Button SELECT
GameCube Z Button Wiimote HOME Button Wiimote HOME Button Classic HOME Button Emulator Menu

Credits

  • Original Gnuboy Sourcecode: Laguna & Gilgamesh
  • 1.04 CVS fixes: Joshua_ from EFNet #gameboy
  • Generic LibOGC (GX,Sound,Inputs) & GUI display sourcecode: SoftDev
  • Gnuboy Porting Code, GUI & extra features: Eke-Eke
  • Mono Gameboy palettes addition: Askot
  • DevkitPPC from Dave Murphy (WinterMute)
  • LibOGC by Michael Wiedenbauer (shagkur),Dave Murphy (WinterMute) & others
  • ZLIB by Jean-loup Gailly

History

14/12/2008:

[NGC/Wii]

  • removed embedded font, (re)enabled IPL font support: now should works for Qoob users too (thanks to emukiddid)
  • patched libfat for faster SDCARD accesses (thanks to svpe)
  • various bugfixes, menu tweaks and code cleanup

[NGC only]

  • added 480p support in menu

[Wii only]

  • implemented fast scrolling in menu using Wiimote D-PAD
  • added "Power" button support
  • added USB Storage support
  • Widescreen menu fix
  • *new* libogc 1.7.0 features: SDHC support, Wiimote shutdown button support

17/09/2008:

  • fixed "Press Button A" issue with Wiimote controllers
  • added fast scroll using wiimote D-PAD

26/08/2008:

  • fixed Classic Controller buttons default map
  • added automatic alphabetical file sorting (Marty Disibio)
  • added ROM History for faster ROM access (Marty Disibio)
  • added DVD support in Wii Mode (no modchip required)

15/07/2008:

  • added Wii mode support
  • added wiimote/nunchuk/classic controller support (WII version)
  • added libfat support
  • added automatic SRAM & FreezeState option
  • added 50hz (576i) TV mode support (autodetected)
  • added Progressive (480p) TV mode support (autodetected)
  • added various display aspect ratio support (ORIGINAL, SCALED, STRECTH)

10/10/2007:

  • improved sound rendering

20/07/2007:

[GB/GBC]

  • added RTC Synchro: in-game RTC (Real Time Clock) is now synchronized with system RTC on SRAM load
  • added GBC/GBA palettes color for GB Mono [Askot]
  • fixed some palettes [Askot]

[NGC]

  • added user-transparent SRAM autoload (detection order is MCARD then SDCARD, SLOTA then SLOTB)
  • added 4.7GB DVD support for WII drives (the maximal allowed size for Gamecube DVD is still 1.35GB)
  • removed MPAL video timings, always use 60Hz NTSC: fix display problems for PAL wii users (no more PAL50 version needed)
  • added Console Reboot option in main menu (System Reboot), also used for SDLoad reboot
  • Freezestate & SRAM files are now compressed (using zlib)
  • FreezeState & SRAM files can now be saved/loaded to/from SDCARD: located in /gnuboy/saves/ from the root of your SDCARD
  • added user-transparent SRAM autoload (detection order is MCARD then SDCARD, SLOTA then SLOTB)
  • changed initial ROMS directory for SDCARD user: now looking for /gnuboy/roms/ from the root of your SDCARD
  • current emulator options can now be saved/loaded to/from SDCARD SlotA: the file is dev0:\\gnuboy\\gnuboyGX.cfg [Askot]
  • added L+R combo to save SRAM in MCARD SLOTB during gameplay [Askot]
  • added new font: now use original IPL font, extracted from Bootrom
  • modified controls when going into the rom selection menu (DVD or SDCARD):
    • use B button to go up one directory
    • use Z button to quit the file selection menu
    • use L/R triggers to go down/up one full page
    • use Left/Right buttons or Analog stick to scroll the selected entry's filename when it can't be full displayed
  • various menu rearrangment, minor bugfixes & sourcecode cleanup


24/05/2007:

  • added a new option for display different palette colors in Mono GB Mode (most of them taken from GoombaColor)(Askot)

23/04/2007:

  • corrected a little bug with SRAM/STATE saving
  • modified key config upon request: SELECT is now assignated to Y Button

17/04/2007: (eke-eke)

  • added SRAM, RTC & STATE load/save support
  • added GUI and configurable options menu
  • corrected Sound Samples conversion (thanks to Softdev)
  • changed Sound Buffering Technic(changed to "head/tail" technic used by Softdev in NeoCDredux)

13/04/2007: WIP1

  • initial release by softdev
Retrieved from "https://wiibrew.org/w/index.php?title=Gnuboy_GX&oldid=110317"