



               =---------------------------------------=
                SuperGCube - Nintendo Gamecube emulator
               =---------------------------------------=
												 


SuperGCube is a continuation of the now-dead gamecube emulator GCube.
It is (for now at least) Windows-only, but there is another similar
project called TuxCube for Linux.

Compatibility is still fairly low, so don't expect the stars.



Software requirements:
----------------------
* SDL library 1.2.7 or newer (won't work with older versions):
  www.libsdl.org
* zlib library 1.2.3 or newer (not tested with older versions):
  www.zlib.org
* GNU C compiler (preferably MinGW32 on CYGWIN)


Hardware requirements:
----------------------
* Something good. I'm developing it on Athlon64 with 2.0GB ram and
  GeForce 6600 GT, and that barely enough to run Pong at full speed :)
* Video card must support at least the follwing extensions:
  - GL_EXT_texture_rectangle or GL_NV_texture_rectangle
  - GL_IBM_texture_mirrored_repeat
  - GL_ARB_imaging
  - GL_EXT_texture_lod_bias
  - GL_EXT_texture_filter_anisotropic


Building SuperGCube:
---------------
* Before compiling check Makefile for options.
* To compile just type 'make' or 'make release' (optimized)


Usage tips:
-----------
* The easiest way to use it on windows is to make a shortcut to gcube
  on the desktop and then just drop your GameCube files on it. You can
  also associate SuperGCube with .dol & .gcm files.


A few notes:
----------------------------------------
* In order to work properly, savestates must be placed in the same directory
  as the game they were created with.
* Some games will need specific settings to run. If a game doesn't work, try
  starting it with hle enabled or bigger refresh delay (-r value, eg. 900000).
* GCM's can be 'shrunk' with the supplied isopack utility. Shrinking removes
  blank space from the image (very few games use the full disk). For example,
  the size of 'The Legend Of Zelda - Four Swords' decreases from 1.4GB to
  255MB. Other images might or might not compress that well, depending on the
  contents.
* Only interpreter is implemented at the moment. That means it is rather slow.
  Plans for re-compiled emulation are in progress. Even using the current
  interpreted emulation mode, SuperGCube still runs many games faster than
  Dolphin, which has a re-compiler feature.
* Configuration file is kept in users' home directories:
	 e.g.: "/documents and settings/username/.gcube-0.4"
* Default GameCube => Keyboard mappings are:
	D-pad	=> Arrow keys
	Stick	=> Numpad (keys: 8,5,4,6)
	C-stick	=> keys: home,end,delete,page down
	A		=> q
	B		=> w
	L		=> a
	R		=> s
	X		=> z
	Y		=> x
	Z		=> c
	Start	=> Enter

  F1 will disable/enable texture caching (slow workaround until correct texture
     caching will be implemented).
  F2 will switch wireframe mode on / off.
  F3 switches between old and new rendering engine. The new one is at a early
     stage. Some games will look better with it, and others will look worse.
	F4 forces linear filtering on all textures.
	F5 makes all textures transparent. use if one texture occludes the view.
  F7 fixes dark textures in custom robo.
  F8 enables/disables opengl generated mipmaps. By default, gcube will use
     mipmaps supplied by emulated program.
	F9 will create a screenshot.
  F11 creates a savestate. Savestates must reside in the same directory
     as the game they were created with.
  F12 loads a savestate.


Credits...
----------
Big thanks goes to:
* GCube author, monk, for his great work, and for releasing his
  source.
* Dolwin authors, org and hotquick. If they wouldn't release
  sources of their emulator, GCube wouldn't exist.
* gropeaz / hitmen for Yet Another Gamecube Documentation,
  also to everyone who contributed to it in any way.
* Frank Willie (phx) for PowerPC disassembler.
* Every GC homebrew developer releasing sources.
* Metalmurphy for GCube homepage and EXEmu.net staff for hosting it.
* Adam Green for helping me out with the Mac OS X port.
* Dolphin authors, F|RES, ector and schibo, for the Dolphin sources. It helped
  me improve the emu, as well as kill some ugly bugs.

* Great icons by rodimus:
  www.rodimusconvoy.com


  Keep in mind this is a beta-quality product. It hasn't been thoroughly
tested and may contain bugs. Patches and suggestions are always welcome.

  If you want to report a bug, ask a question or share a solution to a
common problem, check out SuperGCube homepage at http://supergcube.sourceforge.net/

spartan11-7@users.sourceforge.net

spartan11-7
