Difference between revisions of "Gcube"
Samthehacker (talk | contribs) (→CEASE) |
Randomdude (talk | contribs) (Undo revision 88040 by Cease and Desist (Talk)) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{cleanup}} | |
| + | '''Gcube''' is a GameCube emulator. It allows GameCube games to be run on a Windows PC, Linux PC or a Mac. Gcube was written by Monk, but as of 24/01/2005 Monk has not been able to continue development. | ||
| − | + | == Download == | |
| − | + | Gcube is a part of [[devkitPro]]. Packages are available [http://sourceforge.net/project/showfiles.php?group_id=114505&package_id=265125 to download here.] 0.4 is the latest version. | |
| − | + | The source code for Gcube is available [http://sourceforge.net/project/showfiles.php?group_id=114505&package_id=265125 to download,] again part of the DevkitPro software suite. | |
| − | + | The source code is also available [http://devkitpro.cvs.sourceforge.net/devkitpro/emulators/gcube/ via CVS]. | |
| − | + | The old homepage for Gcube is at [http://gcube.exemu.net/ http://gcube.exemu.net/]. The old homepage has outdated binaries and source code. | |
| − | + | ||
| − | + | == Use == | |
| + | |||
| + | Gcube is useful to Wii homebrew as it allows developers to test their code on a PC before running the code on the Wii. However, as Gcube was designed for the GameCube, it does not support all the features of the Wii. | ||
| + | To run a Wii homebrew application on Gcube, first compile in Gcube mode. If using the template code provided by [http://sourceforge.net/project/showfiles.php?group_id=114505&package_id=273886 Wii examples], modify the Makefile. Replace the following: | ||
| + | <source lang="bash"> | ||
| + | include $(DEVKITPPC)/wii_rules | ||
| + | </source> | ||
| + | with: | ||
| + | <source lang="bash"> | ||
| + | include $(DEVKITPPC)/gamecube_rules | ||
| + | </source> | ||
| + | Also, the homebrew application can not use any of the Wii specific libraries. Replace the following: | ||
| + | <source lang="bash"> | ||
| + | LIBS := -lwiiuse -lbte -logc -lm | ||
| + | </source> | ||
| + | with: | ||
| + | <source lang="bash"> | ||
| + | LIBS := -logc -lm | ||
| + | </source> | ||
| + | Recompile the Wii homebrew application. If the Wii homebrew application is based on the template this is achieved by: | ||
| + | <source lang="bash"> | ||
| + | make clean | ||
| + | make | ||
| + | </source> | ||
| + | Run the emulator: | ||
| + | <source lang="bash"> | ||
| + | gcube the_application_name.elf | ||
| + | </source> | ||
| + | |||
| + | == Wii == | ||
| + | |||
| + | Gcube stopped working in Wii mode with [[DevkitPro]] a few versions ago<sup>[[#Devkitppc_setup|1]]</sup>. The latest version, [[libogc]] 20080602, does not work. This is because libogc contains new features that are present on the Wii, but not on the GameCube. tehpola believes Gcube doesn't work because of the [[IOS]] support added to libogc<sup>[[#tehpola|2]]</sup>. Attempting to a run a Wii mode homebrew application in Gcube will result in Gcube appearing to 'hang'. No display or output will be produced. Gcube is actually spinning in 'idle_func' before any code from main() is executed. Suggestions on why this is happening are welcome. | ||
| + | |||
| + | == References == | ||
| + | # <span id="Devkitppc_setup">[[Devkitppc setup#Compile the Hello World Example|Devkitppc setup]] | ||
Latest revision as of 21:43, 7 August 2010
 |
This article may require cleanup to meet WiiBrew's quality standards.
Reason: Needs cleanup |
Gcube is a GameCube emulator. It allows GameCube games to be run on a Windows PC, Linux PC or a Mac. Gcube was written by Monk, but as of 24/01/2005 Monk has not been able to continue development.
Download
Gcube is a part of devkitPro. Packages are available to download here. 0.4 is the latest version.
The source code for Gcube is available to download, again part of the DevkitPro software suite. The source code is also available via CVS.
The old homepage for Gcube is at http://gcube.exemu.net/. The old homepage has outdated binaries and source code.
Use
Gcube is useful to Wii homebrew as it allows developers to test their code on a PC before running the code on the Wii. However, as Gcube was designed for the GameCube, it does not support all the features of the Wii. To run a Wii homebrew application on Gcube, first compile in Gcube mode. If using the template code provided by Wii examples, modify the Makefile. Replace the following:
include $(DEVKITPPC)/wii_ruleswith:
include $(DEVKITPPC)/gamecube_rulesAlso, the homebrew application can not use any of the Wii specific libraries. Replace the following:
LIBS := -lwiiuse -lbte -logc -lmwith:
LIBS := -logc -lmRecompile the Wii homebrew application. If the Wii homebrew application is based on the template this is achieved by:
make clean
makeRun the emulator:
gcube the_application_name.elfWii
Gcube stopped working in Wii mode with DevkitPro a few versions ago1. The latest version, libogc 20080602, does not work. This is because libogc contains new features that are present on the Wii, but not on the GameCube. tehpola believes Gcube doesn't work because of the IOS support added to libogc2. Attempting to a run a Wii mode homebrew application in Gcube will result in Gcube appearing to 'hang'. No display or output will be produced. Gcube is actually spinning in 'idle_func' before any code from main() is executed. Suggestions on why this is happening are welcome.