Gnuboy GX Wii: Difference between revisions

Gnuboy GX
Gnuboy GX
	File:Gnuboygxwii.jpg
General
Author	eke-eke
Type	Handheld
Version	14/12/2008
License	Mixed
Last Updated	2008/12/14
Links
	Download
	Source

Revision as of 05:52, 17 September 2022

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,...)

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

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

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/

@@ Line 47: / Line 47: @@
 * 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