[[Category:SDL]]

{{application
|name=SuperNES
|type=webOS
|version=Version: 0.0.5
|tag=Games
|screenshot=SuperNES_v0.0.2_MarioKart1.jpg
|description=
}}
=SuperNES=
[[Image:Snes9x_small.png]] 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 [http://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] 

== 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-supernes-snes-emulator.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.
 

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-supernes-snes-emulator.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 SuperNES. Sources of free open source and free homebrew roms are available all over the internet. Google is your friend :).

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 SuperNES can use. Those topics are outside the scope of this article.

===ROM File definitions===
SuperNES ROMs extensions indicate what device is being emulated. There are three valid extensions:
* .smc
* .zip

Note that a zip file needs to contain exactly *one* ROM, and not in a folder.

===Installing ROMS to the device===
Once you have installed SuperNES 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 "snes" (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 (.smc,.zip) in folders within the "roms" folder.''

SuperNES cannot create these folders for you due to the 1.4.5 fstab bug.

==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): 

{| border="1"
|'''Pre Button'''
|'''Emulator Function'''
|'''Notes'''
|-
|EWSD
|Up/left/down/right
|
|-
|k
|Y
|
|-
|l
|X
|
|-
|m
|B
|
|-
|, (comma)
|A
|
|-
|i
|L (trigger)
|
|-
|o
|R (trigger)
|
|-
|Backspace
|Start
|
|-
|Enter
|Select
|
|-
|Spacebar
|Toggle Turbo
|
|-
|1,2,3
|Save state number 1,2,3
|orange + "corresponding letter"
|-
|4,5,6
|Load state number 1,2,3
|orange + "corresponding letter"
|-
|back gesture/swipe
|In-game Menu.
|
|}

=== Custom Controls ===
==== Instructions ====
SupeNES 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==
<gallery>
Image:SuperNES_v0.0.2_RomLauncher.jpg|ROM Launcher
Image:SuperNES_v0.0.2_Options.jpg|Options Menu
Image:SuperNES_v0.0.2_InGameMenu.jpg|Ingame Menu
Image:SuperNES_v0.0.2_DrMario.jpg|Playing Dr. Mario
Image:SuperNES_v0.0.2_Zelda.jpg|Playing Zelda - LTTP
Image:SuperNES_v0.0.2_MarioKart2.jpg|Playing Super Mario Kart
Image:SuperNES_v0.0.2_Chrono.jpg|Chrono Trigger Intro
Image:SuperNES_v0.0.2_MarioRPG.jpg|Super Mario RPG TS
</gallery>
 
'''Videos of latest SuperNES (v0.0.3):'''
* [http://www.youtube.com/watch?v=sQ5rEK8Z8SI SMW, Zelda, Bomberman] (@500Mhz) 
* [http://www.youtube.com/watch?v=oK2C6CQoDeA Chrono Trigger Intro] (@500Mhz) 

[http://www.youtube.com/watch?v=kplA9zgdKgE[Snes emulator(Palm Pre) ]-running on uberkernel 1G

==Known issues==
* Touchscreen Controls slow emulation down. Controlling with Pre Keyboard is faster.
* Donkey Kong Country doesn't work, fails its copy protection check. (The sequels work, however).

==TODO==
* Reset button
* Verify image-scaling-preserving-apect-ratio code, someone claims that it isn't filling the area as expected.
* Add new skins (rpg2, misc others) from forum.
* In-game documentation of skins, etc. (wiki documentation of skins?)
* possible crash when pausing game by going to card mode, then returning to rom-selector. investigate.
* pause when in card mode--add delay for those who flick to check time and back. See how/if this is possible.

===TODO/Tentative===
* See if the app can be a 'portrait' game so the menus/rom selector maintain proper perspective when in card view.
* Investigate some kind of behavior improved d-pad behavior with respect to sliding finger off the area and acting as expected. So if you hold finger down with-in the dpad and slide out it doesn't release. Play with some ideas on that front.
* Investigate cheap support, game genie, etc. Figure out a good UI model for the functionality that is possible, and make this happen. Try to gracefully handle things like bad cheats (both in the UI and corrupted games), as possible.
* Portrait skins?

===User-editied===
Add your TODO list here!!
* Example item (feel free to delete)

== Changelog ==
* '''0.0.5''' Added jjcitron's landscape skin
* '''0.0.4''' Added (transparent!) skin support
* '''0.0.3''' Fixed save states/menu issue.
* '''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 
{| border="1" class="wikitable"
! rowspan="2" | '''Title'''
! colspan="2" | '''Speed @500 Mhz'''
! colspan="2" | '''Speed @800 Mhz'''
! rowspan="2" | '''SuperNES Version'''
! rowspan="2" | '''Notes'''
|-
! '''Sound'''
! '''No Sound'''
! '''Sound'''
! '''No Sound'''
|-
|BS Dr. Mario (NTSC/J)
|bgcolor="lightgreen"|46/50
|bgcolor="lightgreen"|50/50
|bgcolor="lightgreen"|50/50
|bgcolor="lightgreen"|50/50
|0.0.3
|No need for overclocking!
|-
|Zelda - A Link to the past (Pal/G)
|bgcolor="lightgreen"|45/50
|bgcolor="lightgreen"|49/50
|bgcolor="lightgreen"|50/50
|bgcolor="lightgreen"|50/50
|0.0.3
|No need for overclocking!
|-
|Arkanoid Doh It Again
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|45/60
|0.0.6
|Very playable speed averages 50-55 @ 1GHz(UK-92)
|-
|Arcade's Greatest Hits(Defender, Defender II, Joust, Robotron, Sinistar)
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|55/60
|bgcolor="lightgreen"|55/60
|0.0.6
|Sound doesn't work (all crackily) very close to steady 60/60 @ 1GHz(UK-92)
|-
|Arcade's Greatest Hits - The Atari Years(Asteroids, Battlezone, Centipede, Missle Command, Super Breakout, Tempest)
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|45/50
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|45/60
|0.0.6
|Fully playable, the speeds spiked over 100/60 but still playable no matter what the speed up to 1GHz(UK-92)
|-
|B.O.B (U)[!]
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|48/60
|bgcolor="lightgreen"|48/60
|0.0.6
|Average 55/60 @1GHz(UK-92)
|-
|Bust-A-Move (U)[h1]
|bgcolor="lightgreen"|35/60
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|45/60
|0.0.6
|Average 50/60 1GHz (UK-92)
|-
|Choplifter III (U)(54553)
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|50/60
|0.0.6
|53/60 sound on 58/60 sound off 1GHz (UK-92)
|-
|Dragon's Lair (E)
|bgcolor="lightgreen"|30/50
|bgcolor="lightgreen"|30/50
|bgcolor="lightgreen"|35/50
|bgcolor="lightgreen"|40/50
|0.0.6
|Average 50/60 1GHz(UK-92) sound on&off
|-
|Dungeon Master
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|50/60
|0.0.6
|No difference with 1GHz (UK-92)
|-
|Lemmings 2 - the Tribes
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|55/60
|0.0.6
|This games a little hard to play due to the "mouse-like controls" (UK-92 average 50-60)
|-
|Mr.Do!
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|55/60
|0.0.6
|Average 55/60 (UK-92)
|-
|Ninja Gaiden Trilogy
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|45/60
|0.0.6
|55-60/60 @ 1GHz (UK-92)
|-
|Pitfall - The Mayan Adventure (U)
|bgcolor="lightgreen"|35/60
|bgcolor="lightgreen"|35/60
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|45/60
|0.0.6
|No noticeable difference with UK-92 1GHz
|-
|Populous
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|50/60
|0.0.6
|Average 55/60 (UK-92) 1GHz
|-
|Space Ace
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|40/60
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|45/60
|0.0.6
|50/60 1GHz (UK-92)
|-
|Super Castlevania 4
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|45/60
|bgcolor="lightgreen"|50/60
|bgcolor="lightgreen"|50/60
|0.0.6
|

|}

Application:SuperNES

2010-09-06T05:47:50Z

DtzWill: /* TODO/Tentative */

Application:SuperNES

2010-09-06T05:28:22Z

DtzWill: /* Known issues */ added TODO list

2010-04-09T06:19:11Z

DtzWill: uploaded a new version of "Image:X11-xchat.png"

Application:X

2010-04-09T06:16:13Z

DtzWill: /* X Window System Server */

=X Window System Server=

[http://forums.precentral.net/webos-internals/240926-x-server-pre.html Precentral Thread]

==Screenshots==

[[Image:X11-lxde.png]] [[Image:X11-xchat.png]]

[[Image:X11-Ice.png]] [[Image:X11-menu.png]]

==Video==

[http://www.youtube.com/watch?v=2JsulCV4nEQ OpenOffice on the Pre]

==Keyboard Support==

Extra keys:

{|border=1
! Key
! What you press
|-
|Control
|Gesture Area
|-
|"\" (backslash)
|sym+q
|-
|"`" (backtick)
|sym+l ("L")
|-
|"{"
|sym+y
|-
|"}"
|sym+u
|-
|"|" Pipe
|shift+.
|-
|">"
|sym+.
|-
|"<"
|shift+sym+.
|-
|Escape
|shift+space
|-
|Tab
|Control-i
|}

==Screenshots==

==Known Issues/TODO==
* tab symbol
* arrow keys
* xrdb (Xdefaults, etc, support)
* xinitrc support
* (maybe?) rotation support
* "sticky" modiifiers

Application:X

2010-04-09T06:12:12Z

2010-03-23T22:44:21Z

DtzWill: /* Keyboard Support */ fix 'pipe' character

Application:X

2010-03-23T22:41:25Z

DtzWill: /* Keyboard Support */

Application:X

2010-03-20T09:38:23Z

DtzWill: /* Keyboard Support */

Application:X

2010-03-20T05:57:28Z

DtzWill: /* X Window System Server */

=X Window System Server=

==Keyboard Support==

Extra keys:

{|border=1
! Key
! What you press
|-
|"\" (backslash)
|sym+q
|-
|"`" (backtick)
|sym+l ("L")
|-
|"{"
|sym+y
|-
|"}"
|sym+u
|-
|"|"
|shift+.
|-
|">"
|sym+.
|-
|"<"
|shift+sym+.
|-
|Escape
|shift+space
|}

==Screenshots==

==HOWTO==

Application talk:X

2010-03-17T20:05:41Z

DtzWill: /* Window Managers */

Would you like me to list a step-by-step guide here to using X on the pre via debian chroot and sdlvnc? Or were you planning on getting X running via sdl directly? ~zonyl

Zonyl: I had different plans than a sdlvnc+debian chroot+Xvfb. More integration with webOS (see below), integration into Preware (not reliant on apt-get in the chroot), native apps (potentially faster), and perhaps a more accelerated server (lots of opportunities to make this better, including potentially glx but we'll see :D). Thanks for offering to write it up though, that is useful and should probably go up somewhere.

=Packaging Proposal=

I don't know the best place to put this, but I want this to be publicish so throwing it here.

===xlib===

Contains all the X libraries that are used. Iff the library is listed http://www.x.org/releases/X11R7.5/src/lib/ it's included.

==Core==

===xorg-server===
Contains the X server, no front-end.
Depends on xlib

===x11===
Just a launcher script for xorg-server.
Depends on xorg-server

==Applications==
Each application could be separated into two packages.
This allows the user to have the icons they want in the launcher,
but also allows them to install many applications without cluttering the pre's launcher.
A good example here is 'xterm'.

===app-bin===
Contains the binary for the application "app", and app-specific libraries, resources, etc.
No icon/front-end.
Depends on xlib

===app-launcher===
Launcher script for the app "app". Spawns additional X server for each application.
Depends on xorg-server, and app-bin.

==Libraries==

Each additional library not part of 'xlib' (gtk, etc) can go into it's own package, with no front-end.

==Window Managers==
Each window manager would be an application. One thought is it might not make sense to have a wm-bin package--does that really make sense?
But maybe it should for consistency's sake.

Anyway, this WM would have an icon, and would automatically be populated with all the installed applications (all the app-bin packages installed). This means one use case is installing a nice wm and a bunch of app-bins (or a metapackage containing a bunch of apps), and the pre's launcher would only have one icon to launch the whole experience.

==Meta packages==
We could introduce meta-packages for commonly installed applications/etc to save people from having to install a large number of applications manually, and just say "give me a good experience and a button to launch it!".

Application talk:X

2010-03-17T20:01:12Z

DtzWill: /* Packaging Proposal */ libraries

Would you like me to list a step-by-step guide here to using X on the pre via debian chroot and sdlvnc? Or were you planning on getting X running via sdl directly? ~zonyl

Zonyl: I had different plans than a sdlvnc+debian chroot+Xvfb. More integration with webOS (see below), integration into Preware (not reliant on apt-get in the chroot), native apps (potentially faster), and perhaps a more accelerated server (lots of opportunities to make this better, including potentially glx but we'll see :D). Thanks for offering to write it up though, that is useful and should probably go up somewhere.

=Packaging Proposal=

I don't know the best place to put this, but I want this to be publicish so throwing it here.

===xlib===

Contains all the X libraries that are used. Iff the library is listed http://www.x.org/releases/X11R7.5/src/lib/ it's included.

==Core==

===xorg-server===
Contains the X server, no front-end.
Depends on xlib

===x11===
Just a launcher script for xorg-server.
Depends on xorg-server

==Applications==
Each application could be separated into two packages.
This allows the user to have the icons they want in the launcher,
but also allows them to install many applications without cluttering the pre's launcher.
A good example here is 'xterm'.

===app-bin===
Contains the binary for the application "app", and app-specific libraries, resources, etc.
No icon/front-end.
Depends on xlib

===app-launcher===
Launcher script for the app "app". Spawns additional X server for each application.
Depends on xorg-server, and app-bin.

==Libraries==

Each additional library not part of 'xlib' (gtk, etc) can go into it's own package, with no front-end.

==Window Managers==
Each window manager would be an application. One thought is it might not make sense to have a wm-bin package--does that really make sense?
But maybe it should for consistency's sake.

==Meta packages==
We could introduce meta-packages for commonly installed applications/etc to save people from having to install a large number of applications manually, and just say "give me a good experience and a button to launch it!".

Application talk:X

2010-03-17T19:59:57Z

DtzWill:

Would you like me to list a step-by-step guide here to using X on the pre via debian chroot and sdlvnc? Or were you planning on getting X running via sdl directly? ~zonyl

Zonyl: I had different plans than a sdlvnc+debian chroot+Xvfb. More integration with webOS (see below), integration into Preware (not reliant on apt-get in the chroot), native apps (potentially faster), and perhaps a more accelerated server (lots of opportunities to make this better, including potentially glx but we'll see :D). Thanks for offering to write it up though, that is useful and should probably go up somewhere.

=Packaging Proposal=

I don't know the best place to put this, but I want this to be publicish so throwing it here.

===xlib===

Contains all the X libraries that are used. Iff the library is listed http://www.x.org/releases/X11R7.5/src/lib/ it's included.

==Core==

===xorg-server===
Contains the X server, no front-end.
Depends on xlib

===x11===
Just a launcher script for xorg-server.
Depends on xorg-server

==Applications==
Each application could be separated into two packages.
This allows the user to have the icons they want in the launcher,
but also allows them to install many applications without cluttering the pre's launcher.
A good example here is 'xterm'.

===app-bin===
Contains the binary for the application "app", and app-specific libraries, resources, etc.
No icon/front-end.
Depends on xlib

===app-launcher===
Launcher script for the app "app". Spawns additional X server for each application.
Depends on xorg-server, and app-bin.

==Window Managers==
Each window manager would be an application. One thought is it might not make sense to have a wm-bin package--does that really make sense?
But maybe it should for consistency's sake.

==Meta packages==
We could introduce meta-packages for commonly installed applications/etc to save people from having to install a large number of applications manually, and just say "give me a good experience and a button to launch it!".