Gnuboy GX Wii: Difference between revisions

From GameBrew
(Created page with "{{#seo: |title=Wii Homebrew Emulators (Handheld) - GameBrew |title_mode=append |image=gnuboygxwii.jpg |image_alt=Gnuboy GX }} {{Infobox Wii Homebrews |title=Gnuboy GX |image=g...")
 
No edit summary
Line 15: Line 15:
|license=Mixed
|license=Mixed
|download=https://dlhb.gamebrew.org/wiihomebrews/gnuboygxwii.7z
|download=https://dlhb.gamebrew.org/wiihomebrews/gnuboygxwii.7z
|website=#LNF
|website=
|source=#LNF
|source=https://code.google.com/archive/p/gnuboy-gx/
}}
}}
https://wiibrew.org/wiki/Gnuboy_GX
GnuboyGX is a port for the Nintendo Gamecube and Nintendo Wii (running in GC mode)
of the open-source Gnuboy emulator, originally coded by Laguna and Gilgamesh.
More infos about Gnuboy here: http://en.wikipedia.org/wiki/Gnuboy
 
This has nothing to do with the previous GX port for GCLinux, this is a full standalone
port using LibOGC API (GX, Audio, Inputs...)
 
==FEATURES==
*Gameboy and Gameboy Color emulation with sound
*DVD, USB (Wii only) & SDCARD support for ROM files loading
*Freeze State support (load & save)
*SRAM/RTC support (load & save)
*support for 8MB roms
*support for zipped (.zip) roms
*support for alternate Mono Gameboy palettes
*RTC synchro
*Load/Save SRAM and FreezeState files (compressed) from/to Memory Card & SDCARD
*SDLOAD or IPL reboot option
*Wiimote/Nunchuk/Classic controller support (Wii version only)
*Automatic SRAM/FreezeState
*Video mode supported: 480i,480p & 576i (automatic detection)
 
==Requirements==
* SoftMod and/or HardMod (to boot the dol/elf)
* Zipped or not (.gb & .gbc) ROMS
 
==User Notes==
* gnuboy_cube.dol is the Gamecube version of this program. You only need to load and run
this DOL on your GC or WII (in GC compatibility mode) using various methods (Bootable DVD, SDLOAD,...)
If you have no idea on how to load&run a DOL, please go here on follow the available guides:
http://modyawii.tehskeen.com/  (Booting Homebrew Section)
 
* gnuboy_wii.dol is the Wii version of the program. It has been compiled to work in Wii mode, featuring extra feature
such as Wiimote/Nunchuk & Classic controller support. To run this on your Wii, you will need to install the
Homebrew Channel (http://hbc.hackmii.com/). Once installed, rename gnuboy_wii.dol as boot.dol and copy this file on your sdcard, in /apps/gnuboy for example. Icon.png and meta.xml should also be placed in the same directory.
 
ROMS can be loaded from a SDCARD, either through a SD-adapter in MCARD slot (Gamecube version only), or through the
native Wii SD slot (WIi version only). ROMS must be copied on your SDCARD in the following directory: /gnuboy/roms
 
ROMS can also be loaded from a ISO9660 DVD. A modchip is required in gameCube mode. On teh Wii, no modchip is required but you will
need to install the DI Stub before you can access DVD-/+R. More infos on HackMii: http://hackmii.com/2008/08/libdi-and-the-dvdx-installer/
The maximal readable size is 1.35GB on Gamecube and 4.7GB on Wii (in GC compatible mode).
 
IMPORTANT: When putting roms either on DVD or SDCARD, it is recommended to use subdirectories as there is a limit of 1000 files per directory.
 
==Controls==
===Gamecube Pad===
* Z Button let you come back to the menu when playing a game
* A is Gameboy Button A
* B is Gamenoy Button B
* START is Gameboy START Button
* Y is Gameboy SELECT Button
 
===Wiimote/Nunchuk/Classic===
* HOME Button let you come back to the menu when playing a game
* Gameboy Button A is Button 2 (WIIMOTE only), A (WIIMOTE+NUNCHUK) or A (CLASSIC)
* Gamenoy Button B is Button 1 (WIIMOTE only), B (WIIMOTE+NUNCHUK) or B (CLASSIC)
* Gameboy START Button is Button PLUS
* Gameboy SELECT Button is Button MINUS
 
===Menu===
* Press A (or 1) or to select a menu item.
* Press B (or 2) to go back from a sub-menu.


==Screenshots==
==Media==
==Media==
<youtube></youtube>
<youtube>GHVfU9ZJVgg</youtube>
 
*Play Game :    Run the game you just loaded or return to game
*Game Info :    Some informations about the ROM
*Hard Reset:    Reset emulator
 
Load New Game:
* Load Recent let you browse a ROM history list with the ten last opened ROM files. This is only available for ROM files previously loaded from SDCARD.
*Load from SD let you browse the SDCARD.
*Load from USB let you browse the USB strorage device.
*Load from DVD let you browse the DVD.
*Stop DVD Motor will stop the DVD motor and the disc from spinning during playtime
*Pressing B will make you going up one directory while navigating.
 
==Emulator Options==
*Aspect: let you modify the display aspect ratio:
**ORIGINAL: original ratio (1.11:1) & resolution
**SCALED: the original aspect ratio is maintaned but display is scaled to fit screen vertical height (default)
**STRETCH: display is stretched to fill the screen (640x480)
*Filtering: Gnuboy can filter screen colors to make them look more washed out or faded like on a real GBC. You can also allow this for Mono GB games by setting the value to "ALL"
*Sprite Sorting: Enable/Disable sprites to be sorted and prioritized according to their x-coordinate when in DMG (Mono GB) mode.
*Force Mono : For GBC games to run in Mono GB mode.
*GBA Features: Unlock gba-only features in some cgb games (See Zelda Oracle's serie)
*Palette: Display some colors in Mono GB (Try Kirby's palette)
*RTC Synchro: enable RTC synchronization with current system clock on SRAM load
*Auto SRAM: automatically load & save SRAM file when loading a new game or leaving application
*Auto Freeze: automatically load & save FreezeState file when loading a new game or leaving application
 
==Memory Manager==
*SRAM Manager:  Let you load/save SRAM and RTC data from/to the selected device
*STATE Manager: Let you load/save Savestate data from/to the selected device
*Device: Let you choose the device to use: FAT (automatically detected) or MCARD
The size of the created files is variable and depends on the ROM type.
 
==Important==
# when using NGC Memory Card in SLOTA, some mounting errors may occur. In this case, remove and insert the Memory Card again before trying to save/load anything.
# when using FAT device, the directory /gnuboy/saves is automatically created
 
==Return to Loader==
* go back to SDLOAD/PSOLOAD (Gamecube) or TP Loader/Homebrew Channel (Wii)
 
==System Reboot==
* reset the console (Gamecube) or return to System menu (Wii)
 
== Changelog ==
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
 
==Dev Notes==
According to the GNU status of this project, the source code MUST be made available to anyone as soon
as you have modified it and released a binary.
To recompile the source code, you will need to be familiar with development environment setup.
If you don't, you might look at wiibrew or tehskeen's forum.
 
First, you will have to download and install the following tools/libraries:
#the last version of Devkitpro and DevkitPPC. Windows user should directly run the AutoInstaller version
#the CVS version of libogc.
#the last version of libfat.
 
You can also get and compile the current source from CVS repository
 
#the last libDI source code.
 
Once you are done, grab the current gnuboy-gx source code from SVN (http://code.google.com/p/gnuboy-gx/source/checkout)
then launch compile_all.bat from msys (installed with devkitpro)
 
==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
 
== External links ==
* Wiibrew - https://wiibrew.org/wiki/Gnuboy_GX
* Google Source - https://code.google.com/archive/p/gnuboy-gx/

Revision as of 05:52, 17 September 2022

Gnuboy GX
File:Gnuboygxwii.jpg
General
Authoreke-eke
TypeHandheld
Version14/12/2008
LicenseMixed
Last Updated2008/12/14
Links
Download
Source

GnuboyGX is a port for the Nintendo Gamecube and Nintendo Wii (running in GC mode) of the open-source Gnuboy emulator, originally coded by Laguna and Gilgamesh. More infos about Gnuboy here: http://en.wikipedia.org/wiki/Gnuboy

This has nothing to do with the previous GX port for GCLinux, this is a full standalone port using LibOGC API (GX, Audio, Inputs...)

FEATURES

  • Gameboy and Gameboy Color emulation with sound
  • DVD, USB (Wii only) & SDCARD support for ROM files loading
  • Freeze State support (load & save)
  • SRAM/RTC support (load & save)
  • support for 8MB roms
  • support for zipped (.zip) roms
  • support for alternate Mono Gameboy palettes
  • RTC synchro
  • Load/Save SRAM and FreezeState files (compressed) from/to Memory Card & SDCARD
  • SDLOAD or IPL reboot option
  • Wiimote/Nunchuk/Classic controller support (Wii version only)
  • Automatic SRAM/FreezeState
  • Video mode supported: 480i,480p & 576i (automatic detection)

Requirements

  • SoftMod and/or HardMod (to boot the dol/elf)
  • Zipped or not (.gb & .gbc) ROMS

User Notes

  • gnuboy_cube.dol is the Gamecube version of this program. You only need to load and run

this DOL on your GC or WII (in GC compatibility mode) using various methods (Bootable DVD, SDLOAD,...) If you have no idea on how to load&run a DOL, please go here on follow the available guides: http://modyawii.tehskeen.com/ (Booting Homebrew Section)

  • gnuboy_wii.dol is the Wii version of the program. It has been compiled to work in Wii mode, featuring extra feature

such as Wiimote/Nunchuk & Classic controller support. To run this on your Wii, you will need to install the Homebrew Channel (http://hbc.hackmii.com/). Once installed, rename gnuboy_wii.dol as boot.dol and copy this file on your sdcard, in /apps/gnuboy for example. Icon.png and meta.xml should also be placed in the same directory.

ROMS can be loaded from a SDCARD, either through a SD-adapter in MCARD slot (Gamecube version only), or through the native Wii SD slot (WIi version only). ROMS must be copied on your SDCARD in the following directory: /gnuboy/roms

ROMS can also be loaded from a ISO9660 DVD. A modchip is required in gameCube mode. On teh Wii, no modchip is required but you will need to install the DI Stub before you can access DVD-/+R. More infos on HackMii: http://hackmii.com/2008/08/libdi-and-the-dvdx-installer/ The maximal readable size is 1.35GB on Gamecube and 4.7GB on Wii (in GC compatible mode).

IMPORTANT: When putting roms either on DVD or SDCARD, it is recommended to use subdirectories as there is a limit of 1000 files per directory.

Controls

Gamecube Pad

  • Z Button let you come back to the menu when playing a game
  • A is Gameboy Button A
  • B is Gamenoy Button B
  • START is Gameboy START Button
  • Y is Gameboy SELECT Button

Wiimote/Nunchuk/Classic

  • HOME Button let you come back to the menu when playing a game
  • Gameboy Button A is Button 2 (WIIMOTE only), A (WIIMOTE+NUNCHUK) or A (CLASSIC)
  • Gamenoy Button B is Button 1 (WIIMOTE only), B (WIIMOTE+NUNCHUK) or B (CLASSIC)
  • Gameboy START Button is Button PLUS
  • Gameboy SELECT Button is Button MINUS

Menu

  • Press A (or 1) or to select a menu item.
  • Press B (or 2) to go back from a sub-menu.

Media

  • Play Game : Run the game you just loaded or return to game
  • Game Info : Some informations about the ROM
  • Hard Reset: Reset emulator

Load New Game:

  • Load Recent let you browse a ROM history list with the ten last opened ROM files. This is only available for ROM files previously loaded from SDCARD.
  • Load from SD let you browse the SDCARD.
  • Load from USB let you browse the USB strorage device.
  • Load from DVD let you browse the DVD.
  • Stop DVD Motor will stop the DVD motor and the disc from spinning during playtime
  • Pressing B will make you going up one directory while navigating.

Emulator Options

  • Aspect: let you modify the display aspect ratio:
    • ORIGINAL: original ratio (1.11:1) & resolution
    • SCALED: the original aspect ratio is maintaned but display is scaled to fit screen vertical height (default)
    • STRETCH: display is stretched to fill the screen (640x480)
  • Filtering: Gnuboy can filter screen colors to make them look more washed out or faded like on a real GBC. You can also allow this for Mono GB games by setting the value to "ALL"
  • Sprite Sorting: Enable/Disable sprites to be sorted and prioritized according to their x-coordinate when in DMG (Mono GB) mode.
  • Force Mono : For GBC games to run in Mono GB mode.
  • GBA Features: Unlock gba-only features in some cgb games (See Zelda Oracle's serie)
  • Palette: Display some colors in Mono GB (Try Kirby's palette)
  • RTC Synchro: enable RTC synchronization with current system clock on SRAM load
  • Auto SRAM: automatically load & save SRAM file when loading a new game or leaving application
  • Auto Freeze: automatically load & save FreezeState file when loading a new game or leaving application

Memory Manager

  • SRAM Manager: Let you load/save SRAM and RTC data from/to the selected device
  • STATE Manager: Let you load/save Savestate data from/to the selected device
  • Device: Let you choose the device to use: FAT (automatically detected) or MCARD

The size of the created files is variable and depends on the ROM type.

Important

  1. when using NGC Memory Card in SLOTA, some mounting errors may occur. In this case, remove and insert the Memory Card again before trying to save/load anything.
  2. when using FAT device, the directory /gnuboy/saves is automatically created

Return to Loader

  • go back to SDLOAD/PSOLOAD (Gamecube) or TP Loader/Homebrew Channel (Wii)

System Reboot

  • reset the console (Gamecube) or return to System menu (Wii)

Changelog

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

Dev Notes

According to the GNU status of this project, the source code MUST be made available to anyone as soon as you have modified it and released a binary. To recompile the source code, you will need to be familiar with development environment setup. If you don't, you might look at wiibrew or tehskeen's forum.

First, you will have to download and install the following tools/libraries:

  1. the last version of Devkitpro and DevkitPPC. Windows user should directly run the AutoInstaller version
  2. the CVS version of libogc.
  3. the last version of libfat.

You can also get and compile the current source from CVS repository

  1. the last libDI source code.

Once you are done, grab the current gnuboy-gx source code from SVN (http://code.google.com/p/gnuboy-gx/source/checkout) then launch compile_all.bat from msys (installed with devkitpro)

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

External links

Retrieved from ‘https://www.gamebrew.org/index.php?title=Gnuboy_GX_Wii&oldid=85286’

Advertising: