Gnuboy GX Wii

Gnuboy GX
Gnuboy GX
General
Author	eke-eke
Type	Handheld
Version	14/12/2008
License	Mixed
Last Updated	2008/12/14
Links
	Download
	Website
	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.

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

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

Installation

Requirements:

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

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. Once installed, rename gnuboy_wii.dol as boot.dol and copy this file on your SD card, 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 the Wii, no modchip is required but you will need to install the DI Stub before you can access DVD-/+R. More info on HackMii. 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 SD card, it is recommended to use subdirectories as there is a limit of 1000 files per directory.

User guide

Menu options

Play Game - Run the game you just loaded or return to game.
Game Info - Some informations about the ROM.
Hard Reset - Reset emulator.
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).

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 series).
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 notes:

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.

Controls

GameCube Controller

Menu:

D-Pad Up/Down or Control Stick - Items selection Up/Down

A - Select a menu item

B - Previous menu

File selector menu:

D-Pad Left/Right or Control Stick - Display the selected entry's full filename

D-Pad Up/Down or Control Stick - Select previous/next file

L/R - Down/Up one full page

Z - Quit the file selection menu

B - Up one directory

A - Load the selected file or enter the selected directory

In game:

The controls can't be changed.

Control Stick or D-Pad - D-Pad of the Gameboy

A - A

B - B

Start - Start

Y - Select

Z - Emulator Menu

Wiimote

Menu:

D-Pad Up/Down - Items selection Up/Down

2/A or D-Pad Right - Select a menu item

1/B - Previous menu

File selector menu:

D-Pad Left/Right - Display the selected entry's full filename

D-Pad Up/Down - Select previous/next file

Minus/Plus - Down/Up one full page

Home - Quit the file selection menu

1/B - Up one directory

2/A - Load the selected file or enter the selected directory

In game:

The controls can't be changed.

D-Pad - D-Pad of the Gameboy

2 - A

1 - B

Plus - Start

Minus - Select

Home - Emulator Menu

Wiimote & Nunchuck

Menu:

D-Pad Up/Down or Nunchuck Analog - Items selection Up/Down

2/A or D-Pad Right - Select a menu item

1/B - Previous menu

File selector menu:

D-Pad Left/Right or Nunchuck Analog - Display the selected entry's full filename

D-Pad Up/Down or Nunchuck ANalog - Select previous/next file

Minus/Plus - Down/Up one full page

Home - Quit the file selection menu

1/B - Up one directory

2/A - Load the selected file or enter the selected directoy

In game:

The controls can't be changed.

D-Pad or Nunchuck Analog - D-Pad of the Gameboy

A - A

B - B

Plus - Start

Minus - Select

Home - Emulator Menu

Classic Controller

Menu:

D-Pad Up/Down or Left Analog - Items selection Up/Down

A or D-Pad Right - Select a menu item

B - Previous menu

File selector menu:

D-Pad Left/Right or Left Analog - Display the selected entry's full filename

D-Pad Up/Down or Left Analog - elect previous/next file

L/R - Down/Up one full page

Home - Quit the file selection menu

B - Up one directory

A - Load the selected file or enter the selected directoy

In game:

The controls can't be changed.

D-Pad or Left Analog - D-Pad of the Gameboy

A - A

B - B

Plus - Start

Minus - Select

Home - Emulator Menu

Screenshots

Changelog

2008/12/14

[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.

2008/09/17

Fixed "Press Button A" issue with Wiimote controllers.
Added fast scroll using wiimote D-PAD.

2008/08/26

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

2008/07/15

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

2007/10/10

Improved sound rendering.

2007/07/20

[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.

2007/05/24

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

2007/04/23

Corrected a little bug with SRAM/STATE saving.
Modified key config upon request: SELECT is now assignated to Y Button.

2007/04/17 (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).

2007/04/13 WIP1

Initial release by softdev.

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 Code - https://code.google.com/archive/p/gnuboy-gx/
TehSkeen - http://www.tehskeen.com/forums/showthread.php?t=4443