GnuBoy GX Channel *always Up-2-Date!

Pictures:

Icon


Banner


GnuBoyGX:

¸,ø¤°`°¤ø,¸¸,ø¤°`°¤ø,¸,ø¤°`°¤ø,¸¸,ø¤°`°¤ø,¸,ø¤°`°¤ø,¸¸,ø¤°`°¤ø,¸,ø¤°`°¤ø,¸¸,ø¤

GnuboyGX 1.4

¸,ø¤°`°¤ø,¸¸,ø¤°`°¤ø,¸,ø¤°`°¤ø,¸¸,ø¤°`°¤ø,¸,ø¤°`°¤ø,¸¸,ø¤°`°¤ø,¸,ø¤°`°¤ø,¸¸,ø¤

-=[ INTRODUCTION ]=-

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: [url="http://en.wikipedia.org/wiki/Gnuboy"]http://en.wikipedia.org/wiki/Gnuboy[/url]

This port is based on the last 1.0.4 CVS source, released by Joshua_ from EFNet #gameboy
[url="http://www.netaxs.com/~gevaryah/gnuboy-1.0.4pre.tar.bz2"]http://www.netaxs.com/~gevaryah/gnuboy-1.0.4pre.tar.bz2[/url].

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

If you have any questions about this, please contact us on the official GnuboyGX thread:
[url="http://www.tehskeen.com/forums/showthread.php?t=4443"]http://www.tehskeen.com/forums/showthread.php?t=4443[/url]

-=[ FEATURES ]=-

. Gameboy and Gameboy Color emulation with sound
. DVD & SDCARD support for rom 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:
[url="http://modyawii.tehskeen.com/"]http://modyawii.tehskeen.com/[/url] (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 (currently, ONLY the Gamecube version support DVD loading) and you obviously
need a modchip. 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 B (CLASSIC)
- Gamenoy Button B is Button 1 (WIIMOTE only), B (WIIMOTE+NUNCHUK) or A (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.


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 from DVD: DVD must be ISO9660 (GC mode only)
. Load from Front SD: Wii mode only
. Load from SDCARD (SLOTA or SLOTB): You have to use a SD adapter in a MC Slot

When using SDCARD, roms must be initially placed in the /gnuboy/roms/ subdirectory

In both cases, the maximum number of files per directory is 1000
It is recommended to use subdirectories.
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: SDCARD 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 SDCARD, the directory /gnuboy/saves is automatically created


The following options differ between WIi & GC version:

*** GC version ***

Stop DVD Motor:
-----------------------------------------------------------------------------------
Stop the the disc from spinning during playtime (GC mode only)


SD/PSO RELOAD:
-----------------------------------------------------------------------------------
go back to SD/PSO Loader

SYSTEM REBOOT
-----------------------------------------------------------------------------------
reboot the console.

*** Wii version ***

Return to Loader:
-----------------------------------------------------------------------------------
go back to TP Loader or Homebrew Channel

System menu
-----------------------------------------------------------------------------------
return to Wii System menu.

-=[ DEV NOTES ]=-

According to the GNU status of this project, the sourcecode MUST be included in any binary releases you made.
To recompile the sourcecode, you will need to have installed:
. DevkitPPC environment
. libOGC last sources

The sourcecode is maintaned under SVN and can be obtained from here: [url="https://gnuboy-gx.bountysource.com/"]https://gnuboy-gx.bountysource.com/[/url]

If you have no idea on how to compile DOLs , please refer to this thread:
[url="http://www.tehskeen.com/forums/showthread.php?t=2968"]http://www.tehskeen.com/forums/showthread.php?t=2968[/url].

-=[ 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
[/spoiler]

History:

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

NFO:


Link:
http://rapidshare.com/files/130321631/GnuBoyGX_Wii-CBT.rar