Difference between revisions of "Application:SuperNES"
m (Application:Snes9x moved to Application:SuperNES: renamed the app) |
(first draft, WIP. saving so I don't lose my work :)) |
||
Line 1: | Line 1: | ||
− | + | [[Category:SDL]] | |
+ | |||
+ | {{application | ||
+ | |name=SuperNES | ||
+ | |type=webOS | ||
+ | |version=Version: 0.0.2 | ||
+ | |tag=Games | ||
+ | |screenshot= | ||
+ | |description= | ||
+ | }} | ||
+ | =SuperNES= | ||
+ | [[Image:Snes9x_small.png]] SuperNES is an emulator for the Super Nintendo Entertainment System (SNES). | ||
+ | |||
+ | ==Credit== | ||
+ | Ported by Will Dietz Aug 2010. <br> | ||
+ | Thanks to Sonic-NKT for beta testing, art, and videos!!!<br/> | ||
+ | Thanks to #webos-internals for being awesome!<br/> | ||
+ | Icon created by [ttp://www.deleket.com Deleket] (Used with Permission) | ||
+ | |||
+ | ==License== | ||
+ | All source is under the GPLv2 license AND the Snes9x license, and where there are conflicts the Snes9x license is the one to follow. | ||
+ | Basically the code this was based on is under their special license, and that's that. My additions/modifictions are as GPL as they can be without infringing on their original license. | ||
+ | MAJOR kudos to the wonderful people who created Snes9x, and to the authors of DrNokSNES, and DrPocketSNES (and the various ports that went into THAT). | ||
+ | |||
+ | And the latest SuperNES source is available on git [http://git.webos-internals.org/?p=games/snes9x.git here] <br /> | ||
+ | |||
+ | == Donate == | ||
+ | Lots of work has gone into making this a great game for you to enjoy! | ||
+ | |||
+ | If you like it, please download it from the App Catalog (when it hits!) | ||
+ | |||
+ | Alternatively please consider purchasing VBA from the [http://developer.palm.com/appredirect/?packageid=org.webosinternals.visualboyadvance.beta App Catalog]. A percentage of the proceeds go to WebOS Internals, and helps me keep working on these things. | ||
+ | |||
+ | Alternatively you might wish to donate. See [http://forums.precentral.net/webos-internals/260717-snes9x.html official thread] for the paypal link if you're interested. | ||
+ | |||
+ | == Installing SuperNES == | ||
+ | Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "superNES" (no quotes). SuperNES should show up. If not, make sure your feeds are up to date. Click on SuperNES and then click install. | ||
+ | <br/> | ||
+ | |||
+ | Now you are ready to add ROMs(games)! | ||
+ | |||
+ | ==Support== | ||
+ | For support, please: | ||
+ | * Check this wiki for information | ||
+ | * Check the [http://forums.precentral.net/webos-internals/260717-snes9x.html official SuperNES thread], and post if you want to. This way your problems are something others can see (and knowledgeable users can help when I'm not available). | ||
+ | * Email webos@wdtz.org | ||
+ | |||
+ | ==Adding ROMS== | ||
+ | ===Rom Availability=== | ||
+ | Many games are available for VBA. Sources of free open source and free homebrew roms are listed [http://www.webos-internals.org/wiki/Application:VBA#Free_Roms at the end of this article]. | ||
+ | |||
+ | There exist sources of copyright game ROMS on the interent which webos-internals will not link to. There also exist explanations of how to copy roms you own into files which VBA can use. Those topics are outside the scope of this article. | ||
+ | |||
+ | ===ROM File definitions=== | ||
+ | VBA ROMs extensions indicate what device is being emulated. There are three valid extensions: | ||
+ | * .gba (Game Boy Advance) | ||
+ | * .gbc (Game Boy Color) | ||
+ | * .gb (Game Boy) | ||
+ | |||
+ | If you find a ROM image which has a ".bin" extension just rename it to the proper extension (for example, rename a gameboy advance game to end with ''.gba'' without quotes). | ||
+ | |||
+ | ===Installing ROMS to the device=== | ||
+ | Once you have installed VBA on your Pre, click on it from the launcher to see short instructions on how to install ROMs, which we'll explain in more detail here. | ||
+ | |||
+ | Now connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", and "ringtones" folders. Create a folder called "vba" (no caps). Click on that and inside that create a folder called "roms" (again, no caps). Copy the ROMs from your computer and move them here. ''DO NOT put the ROMs (.gb, .gbc, .gba) in folders within the "roms" folder.'' | ||
+ | |||
+ | VBA cannot create these folders for you due to the 1.4.5 fstab bug. | ||
+ | |||
+ | ===Notes:=== | ||
+ | VBA can also handle rom files stored inside a zip files. | ||
+ | |||
+ | ==Controls== | ||
+ | To select a rom, just tap on it in the rom selector.<br> | ||
+ | Note that if you have more roms than fit on the screen, simply scroll to them.<br> | ||
+ | Hit a letter key to jump to that letter in the rom list (useful when you have lots of roms)<br> | ||
+ | |||
+ | These are the current controls (while playing):<br> | ||
+ | |||
+ | {| border="1" | ||
+ | |'''Pre Button''' | ||
+ | |'''Emulator Function''' | ||
+ | |'''Notes''' | ||
+ | |- | ||
+ | |WASD | ||
+ | |Up/left/down/right | ||
+ | | | ||
+ | |- | ||
+ | |k | ||
+ | |B | ||
+ | | | ||
+ | |- | ||
+ | |l | ||
+ | |A | ||
+ | | | ||
+ | |- | ||
+ | |q | ||
+ | |L (trigger) | ||
+ | | | ||
+ | |- | ||
+ | |p | ||
+ | |R (trigger) | ||
+ | | | ||
+ | |- | ||
+ | |Enter | ||
+ | |Start | ||
+ | | | ||
+ | |- | ||
+ | |Spacebar | ||
+ | |Select | ||
+ | | | ||
+ | |- | ||
+ | |@ | ||
+ | |Turbo | ||
+ | | | ||
+ | |- | ||
+ | |. (period) | ||
+ | |Screenshot | ||
+ | | | ||
+ | |- | ||
+ | |t | ||
+ | |Start/Select/a/b All at Once | ||
+ | |Useful for Resets (or saving in zelda) | ||
+ | |- | ||
+ | |orange+s (minus) | ||
+ | |Toggle Displaying Emulation Speed | ||
+ | | | ||
+ | |- | ||
+ | |orange+l (apostrophe) | ||
+ | |Change Scaling Filter | ||
+ | | | ||
+ | |- | ||
+ | |orange+@ | ||
+ | |Change Screen Orientation | ||
+ | | | ||
+ | |- | ||
+ | |orange+z (or y for qwertz pre) | ||
+ | |Toggle Sound | ||
+ | |Boosts (GBA) Performance | ||
+ | |- | ||
+ | |1,2,3 | ||
+ | |Save state number 1,2,3 | ||
+ | |orange + "corresponding letter" | ||
+ | |- | ||
+ | |4,5,6 | ||
+ | |Load state number 1,2,3 | ||
+ | |orange + "corresponding letter" | ||
+ | |- | ||
+ | |orange+ w('+') | ||
+ | |Toggle overlay (touchscreen) controls | ||
+ | |Only works in the landscape orientation with keyboard on RIGHT | ||
+ | |- | ||
+ | |orange+a (ampersand) | ||
+ | |Toggle 'autosave'/'autoresume' functionality | ||
+ | | | ||
+ | |- | ||
+ | |orange+q (slash) | ||
+ | |Cycle skins | ||
+ | | | ||
+ | |- | ||
+ | |back gesture/swipe | ||
+ | |In-game Menu. | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | === Custom Controls === | ||
+ | ==== Instructions ==== | ||
+ | VBA also allows you to customize the controls to fit what you find most useful! | ||
+ | |||
+ | To start customizing, while running a game, hit '=' (orange+p), or '?' (orange+n). | ||
+ | |||
+ | Then follow the on-screen instructions, hitting the keys you want the various buttons bound to. | ||
+ | |||
+ | To stop the binding and cancel, hit '=' or '?' again. | ||
+ | |||
+ | '''Note''' Due to the pre's keyboard limitations, some keys cannot be detected when pressed down at same time (j/k is an example of such a pair). Keep this in mind, it is not a bug in SuperNES. Also the pre likes to ignore adjacent key presses as an attempt to aid in typing accuracy. | ||
+ | |||
+ | |||
+ | ==Screenshots / Videos== | ||
+ | |||
+ | == Feature Requests/TODO == | ||
+ | Here's a list of feature requests I'm aware of and/or things I plan to do. | ||
+ | |||
+ | ==Known issues== | ||
+ | * Touchscreen Controls slow emulation down. Controlling with Pre Keyboard is faster. | ||
+ | |||
+ | == Changelog == | ||
+ | * '''0.0.2''' Rename Snes9x->SuperNES. | ||
+ | * '''0.0.1''' Initial release (testing feed). | ||
+ | |||
+ | == Compatibility List== | ||
+ | This is a list of games and how well they run. | ||
+ | PLEASE include a version number (on rom selector) when adding entries! | ||
+ | To see the emulation speed percentage, enabled "Show speed" in the menu! | ||
+ | All Entries please in Portrait Mode without Touchscreen Control! | ||
+ | |||
+ | Orange: Not Playable/Very Slow<br/> | ||
+ | Yellow: Semi-Playable<br/> | ||
+ | Green: Playable<br/> | ||
+ | {| border="1" class="wikitable" | ||
+ | ! rowspan="2" | '''Title''' | ||
+ | ! colspan="2" | '''Speed @500 Mhz''' | ||
+ | ! colspan="2" | '''Speed @800 Mhz''' | ||
+ | ! rowspan="2" | '''VBA Version''' | ||
+ | ! rowspan="2" | '''Notes''' | ||
+ | |- | ||
+ | ! '''Sound''' | ||
+ | ! '''No Sound''' | ||
+ | ! '''Sound''' | ||
+ | ! '''No Sound''' | ||
+ | |- | ||
+ | |} |
Revision as of 23:48, 27 August 2010
SuperNES - Version: 0.0.2
SuperNES
SuperNES is an emulator for the Super Nintendo Entertainment System (SNES).
Credit
Ported by Will Dietz Aug 2010.
Thanks to Sonic-NKT for beta testing, art, and videos!!!
Thanks to #webos-internals for being awesome!
Icon created by [ttp://www.deleket.com Deleket] (Used with Permission)
License
All source is under the GPLv2 license AND the Snes9x license, and where there are conflicts the Snes9x license is the one to follow. Basically the code this was based on is under their special license, and that's that. My additions/modifictions are as GPL as they can be without infringing on their original license. MAJOR kudos to the wonderful people who created Snes9x, and to the authors of DrNokSNES, and DrPocketSNES (and the various ports that went into THAT).
And the latest SuperNES source is available on git here
Donate
Lots of work has gone into making this a great game for you to enjoy!
If you like it, please download it from the App Catalog (when it hits!)
Alternatively please consider purchasing VBA from the App Catalog. A percentage of the proceeds go to WebOS Internals, and helps me keep working on these things.
Alternatively you might wish to donate. See official thread for the paypal link if you're interested.
Installing SuperNES
Install Preware, and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "superNES" (no quotes). SuperNES should show up. If not, make sure your feeds are up to date. Click on SuperNES and then click install.
Now you are ready to add ROMs(games)!
Support
For support, please:
- Check this wiki for information
- Check the official SuperNES thread, and post if you want to. This way your problems are something others can see (and knowledgeable users can help when I'm not available).
- Email webos@wdtz.org
Adding ROMS
Rom Availability
Many games are available for VBA. Sources of free open source and free homebrew roms are listed at the end of this article.
There exist sources of copyright game ROMS on the interent which webos-internals will not link to. There also exist explanations of how to copy roms you own into files which VBA can use. Those topics are outside the scope of this article.
ROM File definitions
VBA ROMs extensions indicate what device is being emulated. There are three valid extensions:
- .gba (Game Boy Advance)
- .gbc (Game Boy Color)
- .gb (Game Boy)
If you find a ROM image which has a ".bin" extension just rename it to the proper extension (for example, rename a gameboy advance game to end with .gba without quotes).
Installing ROMS to the device
Once you have installed VBA on your Pre, click on it from the launcher to see short instructions on how to install ROMs, which we'll explain in more detail here.
Now connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", and "ringtones" folders. Create a folder called "vba" (no caps). Click on that and inside that create a folder called "roms" (again, no caps). Copy the ROMs from your computer and move them here. DO NOT put the ROMs (.gb, .gbc, .gba) in folders within the "roms" folder.
VBA cannot create these folders for you due to the 1.4.5 fstab bug.
Notes:
VBA can also handle rom files stored inside a zip files.
Controls
To select a rom, just tap on it in the rom selector.
Note that if you have more roms than fit on the screen, simply scroll to them.
Hit a letter key to jump to that letter in the rom list (useful when you have lots of roms)
These are the current controls (while playing):
Pre Button | Emulator Function | Notes |
WASD | Up/left/down/right | |
k | B | |
l | A | |
q | L (trigger) | |
p | R (trigger) | |
Enter | Start | |
Spacebar | Select | |
@ | Turbo | |
. (period) | Screenshot | |
t | Start/Select/a/b All at Once | Useful for Resets (or saving in zelda) |
orange+s (minus) | Toggle Displaying Emulation Speed | |
orange+l (apostrophe) | Change Scaling Filter | |
orange+@ | Change Screen Orientation | |
orange+z (or y for qwertz pre) | Toggle Sound | Boosts (GBA) Performance |
1,2,3 | Save state number 1,2,3 | orange + "corresponding letter" |
4,5,6 | Load state number 1,2,3 | orange + "corresponding letter" |
orange+ w('+') | Toggle overlay (touchscreen) controls | Only works in the landscape orientation with keyboard on RIGHT |
orange+a (ampersand) | Toggle 'autosave'/'autoresume' functionality | |
orange+q (slash) | Cycle skins | |
back gesture/swipe | In-game Menu. |
Custom Controls
Instructions
VBA also allows you to customize the controls to fit what you find most useful!
To start customizing, while running a game, hit '=' (orange+p), or '?' (orange+n).
Then follow the on-screen instructions, hitting the keys you want the various buttons bound to.
To stop the binding and cancel, hit '=' or '?' again.
Note Due to the pre's keyboard limitations, some keys cannot be detected when pressed down at same time (j/k is an example of such a pair). Keep this in mind, it is not a bug in SuperNES. Also the pre likes to ignore adjacent key presses as an attempt to aid in typing accuracy.
Screenshots / Videos
Feature Requests/TODO
Here's a list of feature requests I'm aware of and/or things I plan to do.
Known issues
- Touchscreen Controls slow emulation down. Controlling with Pre Keyboard is faster.
Changelog
- 0.0.2 Rename Snes9x->SuperNES.
- 0.0.1 Initial release (testing feed).
Compatibility List
This is a list of games and how well they run. PLEASE include a version number (on rom selector) when adding entries! To see the emulation speed percentage, enabled "Show speed" in the menu! All Entries please in Portrait Mode without Touchscreen Control!
Orange: Not Playable/Very Slow
Yellow: Semi-Playable
Green: Playable
Title | Speed @500 Mhz | Speed @800 Mhz | VBA Version | Notes | ||
---|---|---|---|---|---|---|
Sound | No Sound | Sound | No Sound |