Difference between revisions of "Wii Port"

From Ultronomicon
Jump to navigation Jump to search
(→‎Downloads: New binary with black borders)
 
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
== Downloads ==
 
== Downloads ==
[http://www.filefront.com/14659573/uqm-wii.zip/ Latest Binaries.]
+
[http://www.findthatfile.com/search-10514062-hZIP/winrar-winzip-download-uqm-full-zip.htm Full Install, base package only]
[http://www.filefront.com/14797533/uqm-borders.zip/ .dol with black borders to fix cutoff problem on some TVs]
 
  
 
== Installation ==
 
== Installation ==
 +
Extract uqm-full.zip into the root of your SD card.  If you have the old version, you only need uqm-no-content.zip, and can install it over top.
  
Unzip the binaries into the root of your SD card, making sure to preserve the directory structureYou are now done!  It should appear in the Homebrew Channel.
+
== If your screen is cut off ==
The base package is included. 
+
There is an extra setup option controlling the scaling and offset of the image on screenAdjust the sliders to ensure that all four green borders are visible on screen.
  
 
== Using the 3DO packages ==  
 
== Using the 3DO packages ==  
  
They should all work but aren't included in the zip file.  Since the Wii port is built on the UQM svn, I don't think you can use the package from the download section.  You can get them here, using the "download as tarball" link at the bottom.  [http://sc2.svn.sourceforge.net/viewvc/sc2/trunk/sc2/content/addons/ Add-ons on the SVN.]  It is highly recommended that you zip them into a .uqm file, rather than placing all of the individual files onto your SD card.  This is because the Wii file access libraries seem quite slow at opening many small files at once.  
+
They should all work but aren't included in the zip file.  Since the Wii port is built on the UQM svn, I don't think you can use the package from the download section (''edit - actually you can, this is confirmed to work for the voices at least - see below'').  You can get them here, using the "download as tarball" link at the bottom.  [http://sc2.svn.sourceforge.net/viewvc/sc2/trunk/sc2/content/addons/ Add-ons on the SVN.] (Don't forget to extract the files from the tarball once you have downloaded it). It is highly recommended that you zip them into a .uqm file, rather than placing all of the individual files onto your SD card.  This is because the Wii file access libraries seem quite slow at opening many small files at once.
 +
 
 +
The '''easy way''' to get the voices working:
 +
First, create a new directory called '''/addons''' in '''/apps/uqm/content''' - see the page on [http://wiki.uqm.stack.nl/Content_Management Content Management.]
 +
Next, grab the file '''uqm-0.7.0-voice.uqm''' from [http://sourceforge.net/projects/sc2/files/UQM/0.7/ here] and put it in your new '''/addons''' directory.
 +
Now, play UQM with its glorious voice-acting restored! Joyous occasion!!
  
 
== Controls ==
 
== Controls ==
Line 20: Line 25:
 
== Source ==
 
== Source ==
  
[http://www.filefront.com/14666277/source.tgz Source Code] 
+
Built using r3185 from the SVN.  You'll probably have to edit the build settings and/or rerun the config script.  A readme file is included with details on how to set your environment variables so it will work.   
Built using r3185 from the SVN. Source file includes only the .diff patch, not all of the UQM codeThe .diff now includes updates to the configuration scripts, so running build.sh should work properly.  A readme file is included with details on how to set your environment variables so it will work.   
+
 
 +
The wii_headers directory contains a few .h files you'll need, since some of the default settings for the Wii libraries are not sufficient to run UQM.
  
 
The file "lwp_config.h" needs to replace the old one in your libogc source, so that there are enough mutexes.   
 
The file "lwp_config.h" needs to replace the old one in your libogc source, so that there are enough mutexes.   
 
 
The file "pthread.h" needs to go into your includes path somewhere.  It is a wrapper to make the LWP library in libogc behave like the standard pthread library.
 
The file "pthread.h" needs to go into your includes path somewhere.  It is a wrapper to make the LWP library in libogc behave like the standard pthread library.
  
Line 41: Line 46:
 
== Known Issues ==
 
== Known Issues ==
  
Seems stable, save often though! 
+
Latest version seems stable, but did have one crash when selecting the next ship too fast during Sa-Matra fight.  Save often, especially if the music stops playing unexpectedly.
  
 
Black dot in the middle of planets in orbital view.
 
Black dot in the middle of planets in orbital view.
 +
[[Category:About_the_Star_Control_series]]

Latest revision as of 01:58, 6 October 2012

Downloads[edit]

Full Install, base package only

Installation[edit]

Extract uqm-full.zip into the root of your SD card. If you have the old version, you only need uqm-no-content.zip, and can install it over top.

If your screen is cut off[edit]

There is an extra setup option controlling the scaling and offset of the image on screen. Adjust the sliders to ensure that all four green borders are visible on screen.

Using the 3DO packages[edit]

They should all work but aren't included in the zip file. Since the Wii port is built on the UQM svn, I don't think you can use the package from the download section (edit - actually you can, this is confirmed to work for the voices at least - see below). You can get them here, using the "download as tarball" link at the bottom. Add-ons on the SVN. (Don't forget to extract the files from the tarball once you have downloaded it). It is highly recommended that you zip them into a .uqm file, rather than placing all of the individual files onto your SD card. This is because the Wii file access libraries seem quite slow at opening many small files at once.

The easy way to get the voices working: First, create a new directory called /addons in /apps/uqm/content - see the page on Content Management. Next, grab the file uqm-0.7.0-voice.uqm from here and put it in your new /addons directory. Now, play UQM with its glorious voice-acting restored! Joyous occasion!!

Controls[edit]

Defaults to Player 1 on Wiimote 1, Player 2 on Wiimote 2. Hold the Wiimote sideways, like an NES controller. Button 1 is OK/fire, Button 2 is Cancel/Special. Plus and Minus scroll/zoom, and the home button activates your escape hyperdrive. You can also use the nunchuck if you prefer, stick controls the ship, A fires, B is special. (Since both work, be careful how you hold the wiimote, as pushing B will still be cancel/special!) In theory you can add to the config files to allow you to also use the Classic Controller attachment, and it will still be considered Joystick 1/2, just with different button/hats. The Wiibrew Wiki entry on SDL has information on the button and axis mappings.

In the config menu you can change either player to use a game cube controller. A and B for OK and fire, d-pad or left stick for directions, the C stick scrolls and zooms. The Start button is hyperdrive.

Source[edit]

Built using r3185 from the SVN. You'll probably have to edit the build settings and/or rerun the config script. A readme file is included with details on how to set your environment variables so it will work.

The wii_headers directory contains a few .h files you'll need, since some of the default settings for the Wii libraries are not sufficient to run UQM.

The file "lwp_config.h" needs to replace the old one in your libogc source, so that there are enough mutexes. The file "pthread.h" needs to go into your includes path somewhere. It is a wrapper to make the LWP library in libogc behave like the standard pthread library.

Libraries Required to Build[edit]

SDL Wii r63. Later versions have a bizarre screen update bug.

"inofficial" libfat fork Forked version is needed because it supports caching, and the main did not. (May have changed).

"inofficial" libogc fork Forked version is needed because the official libogc only uses MEM1, which is not enough memory for UQM.

You also need libvorbis / tremor and libpng. dhewg has provided these libraries pre-compiled here, though cross-compiling them is easy also.

Hopefully that is all of them! Don't forget to run elf2dol on the "uqm" or "uqm-debug" file you get out of the build script.

Known Issues[edit]

Latest version seems stable, but did have one crash when selecting the next ship too fast during Sa-Matra fight. Save often, especially if the music stops playing unexpectedly.

Black dot in the middle of planets in orbital view.