2009-12-04 16:39:34 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
< html xmlns = "http://www.w3.org/1999/xhtml" >
< head >
< meta content = "text/html; charset=utf-8" http-equiv = "Content-Type" / >
< title > FCEUX SDL Documentation< / title >
< link href = "fceux.css" rel = "stylesheet" type = "text/css" / >
2009-12-04 22:42:48 +00:00
< script type = "text/javascript" src = "Javascript/buttons.js" > < / script >
2009-12-04 16:39:34 +00:00
< / head >
2009-12-05 00:05:16 +00:00
< body onload = "FP_preloadImgs(/*url*/'assets/button67.jpg',/*url*/'assets/button68.jpg',/*url*/'assets/button80.jpg',/*url*/'assets/button81.jpg',/*url*/'assets/button87.jpg',/*url*/'assets/button88.jpg',/*url*/'assets/button92.jpg',/*url*/'assets/button93.jpg',/*url*/'assets/button98.jpg',/*url*/'assets/button99.jpg',/*url*/'assets/button4.jpg',/*url*/'assets/button5.jpg')" >
2009-12-04 22:42:48 +00:00
< div id = "masthead" >
< span class = "largerfont" > FCEUX< br / > < / span > The all in one NES/Famicom Emulator
< / div >
< div id = "top_nav" >
2009-12-05 00:05:16 +00:00
< a href = "home.html" > < img id = "img1" alt = "Home" height = "20" onmousedown = "FP_swapImg(1,0,/*id*/'img1',/*url*/'assets/button68.jpg')" onmouseout = "FP_swapImg(0,0,/*id*/'img1',/*url*/'assets/button66.jpg')" onmouseover = "FP_swapImg(1,0,/*id*/'img1',/*url*/'assets/button67.jpg')" onmouseup = "FP_swapImg(0,0,/*id*/'img1',/*url*/'assets/button67.jpg')" src = "assets/button66.jpg" style = "border: 0" width = "100" / > <!-- MSComment="ibutton" fp - style="fp - btn: Braided Row 5; fp - bgcolor: #B7B7B7" fp - title="Home" --> < / a >
< a href = "download.html" > < img id = "img2" alt = "Download" height = "20" onmousedown = "FP_swapImg(1,0,/*id*/'img2',/*url*/'assets/button81.jpg')" onmouseout = "FP_swapImg(0,0,/*id*/'img2',/*url*/'assets/button7F.jpg')" onmouseover = "FP_swapImg(1,0,/*id*/'img2',/*url*/'assets/button80.jpg')" onmouseup = "FP_swapImg(0,0,/*id*/'img2',/*url*/'assets/button80.jpg')" src = "assets/button7F.jpg" style = "border: 0" width = "100" / > <!-- MSComment="ibutton" fp - style="fp - btn: Braided Row 5; fp - bgcolor: #B7B7B7" fp - title="Download" --> < / a >
< a href = "documentation.html" > < img id = "img6" alt = "Documentation" height = "20" onmousedown = "FP_swapImg(1,0,/*id*/'img6',/*url*/'assets/button5.jpg')" onmouseout = "FP_swapImg(0,0,/*id*/'img6',/*url*/'assets/button3.jpg')" onmouseover = "FP_swapImg(1,0,/*id*/'img6',/*url*/'assets/button4.jpg')" onmouseup = "FP_swapImg(0,0,/*id*/'img6',/*url*/'assets/button4.jpg')" src = "assets/button3.jpg" style = "border: 0" width = "100" / > <!-- MSComment="ibutton" fp - style="fp - btn: Braided Row 5; fp - bgcolor: #B7B7B7" fp - title="Documentation" --> < / a >
< a href = "version.html" > < img id = "img3" alt = "Versions" height = "20" onmousedown = "FP_swapImg(1,0,/*id*/'img3',/*url*/'assets/button88.jpg')" onmouseout = "FP_swapImg(0,0,/*id*/'img3',/*url*/'assets/button86.jpg')" onmouseover = "FP_swapImg(1,0,/*id*/'img3',/*url*/'assets/button87.jpg')" onmouseup = "FP_swapImg(0,0,/*id*/'img3',/*url*/'assets/button87.jpg')" src = "assets/button86.jpg" style = "border: 0" width = "100" / > <!-- MSComment="ibutton" fp - style="fp - btn: Braided Row 5; fp - bgcolor: #B7B7B7" fp - title="Versions" --> < / a >
< a href = "contact.html" > < img id = "img4" alt = "Contact" height = "20" onmousedown = "FP_swapImg(1,0,/*id*/'img4',/*url*/'assets/button93.jpg')" onmouseout = "FP_swapImg(0,0,/*id*/'img4',/*url*/'assets/button91.jpg')" onmouseover = "FP_swapImg(1,0,/*id*/'img4',/*url*/'assets/button92.jpg')" onmouseup = "FP_swapImg(0,0,/*id*/'img4',/*url*/'assets/button92.jpg')" src = "assets/button91.jpg" style = "border: 0" width = "100" / > <!-- MSComment="ibutton" fp - style="fp - btn: Braided Row 5; fp - bgcolor: #B7B7B7" fp - title="Contact" --> < / a >
< a href = "links.html" > < img id = "img5" alt = "Links" height = "20" onmousedown = "FP_swapImg(1,0,/*id*/'img5',/*url*/'assets/button99.jpg')" onmouseout = "FP_swapImg(0,0,/*id*/'img5',/*url*/'assets/button97.jpg')" onmouseover = "FP_swapImg(1,0,/*id*/'img5',/*url*/'assets/button98.jpg')" onmouseup = "FP_swapImg(0,0,/*id*/'img5',/*url*/'assets/button98.jpg')" src = "assets/button97.jpg" style = "border: 0" width = "100" / > <!-- MSComment="ibutton" fp - style="fp - btn: Braided Row 5; fp - bgcolor: #B7B7B7" fp - title="Links" --> < / a > < / div >
2009-12-04 16:39:34 +00:00
< div id = "container" >
< div id = "left_col" >
< / div >
< div id = "page_content" >
< center > < h1 > FCEUX SDL Documentation< / h1 > < / center >
< center > < i > Last updated November 30, 2008< br / > Valid as of FCEUX 2.0.4< / i > < br >
< b > Please note that this document is INCOMPLETE and may be INACCURATE.
Contributions welcome.< / b > < / center >
< p >
< b > Table of Contents:< / b >
< ul >
< li / > < a href = "#intro" > Introduction< / a >
< li / > < a href = "#features-input" > Input< / a >
< li / > < a href = "#features-expansion-fds" > Famicom Disk System< / a >
< li / > < a href = "#features-expansion-genie" > Game Genie< / a >
< li / > < a href = "#features-expansion-vs" > VS Unisystem< / a >
< li / > < a href = "#features-ips" > Automatic IPS Patching< / a >
< li / > < a href = "#using" > Using FCEUX< / a >
< ul >
< li / > < a href = "#using-hotkeys" > Hotkey Assignments< / a >
< ul >
< li / > < a href = "#using-keys-vs" > VS Unisystem< / a >
< li / > < a href = "#using-keys-fds" > Famicom Disk System< / a >
< li / > < a href = "#using-keys-gamepad" > Game Pad< / a >
< li / > < a href = "#using-keys-powerpad" > Power Pad< / a >
< li / > < a href = "#using-keys-fkb" > Family Keyboard< / a >
< li / > < a href = "#using-cli" > Command-line options< / a >
< / ul >
< / ul >
< li / > < a href = "#credits" > Credits< / a >
< / ul >
< / p >
< hr width = "100%" >
< a name = "intro" > < h2 > Introduction< / h2 > < / a >
< p > FCEUX is a cross platform, NTSC and PAL Famicom/NES emulator that
is an evolution of the original FCE Ultra emulator. Over time FCE
Ultra had separated into many separate branches.
< / p >
< p > The concept behind FCEUX is to merge elements from FCE Ultra,
FCEU rerecording, FCEUXD, FCEUXDSP, and FCEU-mm into a single branch
of FCEU. As the X implies, it is an all-encompassing FCEU emulator
that gives the best of all worlds for the general player, the
ROM-hacking community, and the Tool-Assisted Speedrun Community.
< / p >
< / p >
< p >
FCEUX stores configuration, savestates, movies, screenshots, amount other things
in "~/.fceux". This is referred to as the "base directory".
< / p >
< hr width = "90%" >
< a name = "features-input" > < h2 > Input< / h2 > < / a >
< p >
FCEUX emulates the standard NES gamepad, the Four-Score multiplayer
adapter, the Zapper, the Power Pad, and the Arkanoid controller. The
Famicom version of the Arkanoid controller, the "Space Shadow" gun, the
Famicom 4-player adapter, and the Family Keyboard are also emulated.
< / p >
< h4 > Zapper< / h4 > < / a >
< p >
Most Zapper NES games expect the Zapper to be plugged into port 2.
and most VS Unisystem games expect the Zapper to be plugged
into port 1.
< / p > < p >
The left mouse button is the emulated trigger button for the
Zapper. The right mouse button is also emulated as the trigger,
but as long as you have the right mouse button held down, no color
detection will take place, which is effectively like pulling the
trigger while the Zapper is pointed away from the television screen.
Note that you must hold the right button down for a short
time to have the desired effect.
< / p >
< hr width = "90%" >
< a name = "features-expansion-fds" > < h4 > Famicom Disk System< / h4 > < / a >
< p >
You will need the FDS BIOS ROM image in the base FCEUX directory.
It must be named "disksys.rom". FCEUX will not load FDS games
without this file.
< / p >
Two types of FDS disk images are supported: disk images with the
FWNES-style header, and disk images with no header. The number
of sides on headerless disk images is calculated by the total file
size, so don't put extraneous data at the end of the file.
< p >
You should make backups of all of your FDS games you use with
FCEUX. This is because FCEUX will write the disk image back to
the storage medium, and the disk image in RAM might have been corrupted
because of inaccurate emulation(this case is not likely to occur, but
it could occur).
< / p >
< a name = "features-expansion-genie" > < h4 > Game Genie< / h4 > < / a >
< p >
The Game Genie ROM image is loaded from the file "gg.rom" in the
base directory the first time Game Genie emulation is enabled and
a ROM image is loaded since the time FCEUX has run.
< / p > < p >
The ROM image may either be the 24592 byte iNES-format image, or
the 4352 raw ROM image.
< / p > < p >
Remember that enabling/disabling Game Genie emulation will not take
effect until a new game is loaded(this statement shouldn't concern
any of the "run once" command-line driven ports).
< / p >
< a name = "features-expansion-vs" > < h4 > VS Unisystem< / h4 > < / a >
< p >
FCE Ultra currently only supports VS Unisystem ROM images in the
iNES format. DIP switches and coin insertion are both emulated.
The following games are supported, and have palettes provided(though not
necessarily 100% accurate or complete):
< ul >
< li / > Dr. Mario
< li / > VS Castlevania
< li / > VS Duck Hunt
< li / > VS Excitebike
< li / > VS Gradius
< li / > VS Golf
< li / > VS Hogan's Alley
< li / > VS Ice Climber
< li / > VS Pinball
< li / > VS Platoon
< li / > VS RBI Baseball
< li / > VS Sky Kid
< li / > VS Slalom
< li / > VS Star Luster
< li / > VS Stroke and Match Golf
< li / > VS Super Mario Bros
< li / > VS Tetris
< li / > VS The Goonies
< / ul >
< / p >
< a name = "features-ips" > < h3 > Automatic IPS Patching< / h3 > < / a >
< p >
Place the IPS file in the same directory as the file to load,
and name it filename.ips.
< / p >
< pre >
Examples: Boat.nes - Boat.nes.ips
Boat.zip - Boat.zip.ips
Boat.nes.gz - Boat.nes.gz.ips
Boat - Boat.ips
< / pre >
< p >
Some operating systems and environments will hide file extensions.
Keep this in mind if you are having trouble.
< / p >
< p >
Patching is supported for all supported formats(iNES, FDS, UNIF, and
NSF), but it will probably only be useful for the iNES format. It
can be used with the FDS format, but be warned that it will permanently
patch your disk image, as the disk image is written back to disk
when the game is unloaded(unless the disk image is in a zip file, in
which case it isn't written back to disk). UNIF files can't be
patched well with the IPS format because they are chunk-based with no
fixed offsets.
< / p >
< hr width = "100%" >
< a name = "using" > < h2 > Using FCEUX< / h2 > < / a >
< p >
< / p >
< a name = "using-hotkeys" > < h3 > Hotkey Assignments< / h3 > < / a >
< p >
< b > NOTE:< / b > There is not a GUI available to remap these hotkeys for SDL. If you really
want to remap the hotkeys, you can edit the config file manually and replace the values
with SDL keysyms. However, hotkey remapping is planned for gfceux in the near future.
< p >
< table border >
< tr > < th > Key:< / th > < th > Action:< / th > < / tr >
< tr > < td > F1< / td > < td > Cheat menu (command-line only).< / td > < / tr >
< tr > < td > F2< / td > < td > Toggles savestate binding to movies.< / td > < / tr >
< tr > < td > F3< / td > < td > Load lua script.< / td > < / tr >
< tr > < td > F4< / td > < td > Toggle background rendering.< / td > < / tr >
< tr > < td > F5< / td > < td > Save state.< / td > < / tr >
< tr > < td > F6< / td > < td > Toggle skipping lag in frame advance.< / td > < / tr >
< tr > < td > F7< / td > < td > Load state.< / td > < / tr >
< tr > < td > F8< / td > < td > Toggle lag counter display.< / td > < / tr >
< tr > < td > F9< / td > < td > Toggle movie frame counter.< / td > < / tr >
< tr > < td > F10< / td > < td > Toggle movie subtitles.< / td > < / tr >
< tr > < td > F11< / td > < td > Reset emulation.< / td > < / tr >
< tr > < td > F12< / td > < td > Save screen snapshot.< / td > < / tr >
< tr > < td > Shift + F5< / td > < td > Begin movie recording.< / td > < / tr >
< tr > < td > Shift + F7< / td > < td > Open a movie for playback.< / td > < / tr >
< tr > < td > 0-9< / td > < td > Select save state slot.< / td > < / tr >
< tr > < td > -< / td > < td > Decrease emulation speed.< / td > < / tr >
< tr > < td > =< / td > < td > Increase emulation speed.< / td > < / tr >
< tr > < td > Pause< / td > < td > Pause emulation.< / td > < / tr >
< tr > < td > \< / td > < td > Advance a single frame.< / td > < / tr >
< / table >
< / p >
< a name = "using-keys-vs" > < h4 > VS Unisystem< / h4 > < / a >
< p >
Could someone test this please?
< table border >
< tr > < th > Key:< / th > < th > Action:< / th > < / tr >
< tr > < td > F8< / td > < td > Insert coin.< / td > < / tr >
< tr > < td > F6< / td > < td > Show/Hide dip switches.< / td > < / tr >
< tr > < td > 1-8< / td > < td > Toggle dip switches(when dip switches are shown).< / td > < / tr >
< / table >
< / p >
< a name = "using-keys-fds" > < h4 > Famicom Disk System< / h4 > < / a >
< p >
Could someone test this please?
< table border >
< tr > < th > Key:< / th > < th > Action:< / th > < / tr >
< tr > < td > F6< / td > < td > Select disk and disk side.< / td > < / tr >
< tr > < td > F8< / td > < td > Eject or Insert disk.< / td > < / tr >
< / table >
< / p >
< a name = "using-keys-gamepad" > < h4 > Gamepad< / h4 > < / a >
< p > These are the default keys for the first player gamepad. These can
be remapped using the --inputcfg command line parameter or using gfceux.
< table border >
< tr > < th > Key:< / th > < th nowrap > Button on Emulated Gamepad:< / th > < / tr >
< tr > < td > K< / td > < td > B< / td > < / tr >
< tr > < td > J< / td > < td > A< / td > < / tr >
< tr > < td > Enter/Return< / td > < td > Start< / td > < / tr >
< tr > < td > Tab< / td > < td > Select< / td > < / tr >
< tr > < td > W< / td > < td > Up< / td > < / tr >
< tr > < td > A< / td > < td > Left< / td > < / tr >
< tr > < td > S< / td > < td > Down< / td > < / tr >
< tr > < td > D< / td > < td > Right< / td > < / tr >
< / table >
< / p >
< a name = "using-keys-powerpad" > < h4 > Power Pad< / h4 > < / a >
< p >
Could someone test this please?
< table border >
< tr > < th colspan = "4" > Side B< / th > < / tr >
< tr > < td width = "25%" > O< / td > < td width = "25%" > P< / td >
< td width = "25%" > [< / td > < td width = "25%" > ]< / td > < / tr >
< tr > < td > K< / td > < td > L< / td > < td > ;< / td > < td > '< / td > < / tr >
< tr > < td > M< / td > < td > ,< / td > < td > .< / td > < td > /< / td > < / tr >
< / table >
< br / >
< table border >
< tr > < th colspan = "4" > Side A< / th > < / tr >
< tr > < td width = "25%" > < / td > < td width = "25%" > P< / td >
< td width = "25%" > [< / td > < td width = "25%" > < / td > < / tr >
< tr > < td > K< / td > < td > L< / td > < td > ;< / td > < td > '< / td > < / tr >
< tr > < td > < / td > < td > ,< / td > < td > .< / td > < td > < / td > < / tr >
< / table >
< / p >
< a name = "using-keys-fkb" > < h4 > Family Keyboard< / h4 > < / a >
< p >
All emulated keys are mapped to the closest open key on the PC
keyboard, with a few exceptions. The emulated "@" key is
mapped to the "`"(grave) key, and the emulated "kana" key
is mapped to the "Insert" key(in the 3x2 key block above the
cursor keys).
< / p >
< p >
To enable or disable Family Keyboard input, press the "Scroll Lock" key.
When Family Keyboard input is enabled, FCE Ultra will also attempt
to prevent any key presses from being passed to the GUI or system.
< / p >
< a name = "using-cli" > < h3 > Command-line< / h3 > < / a >
< p >
FCEUX supports arguments passed on the command line. Arguments
are taken in the form of "--parameter value". Most arguments that have
both a parameter and a value will be saved in the configuration file.
< / p >
< b > NOTE: < / b > This list is incomplete! For a full list of options, run
fceux without any arguments.
< p >
< table border >
< tr > < th > Argument:< / th > < th > Value Type:< / th > < th > Default value:< / th > < th > Description:< / th > < / tr >
< tr > < td > --pal< / td > < td > 0|1< / td > < td > 0< / td > < td > Emulate a PAL NES. Otherwise emulate an NTSC NES.< / td > < / tr >
< tr > < td > --gamegenie< / td > < td > 0|1< / td > < td > 0< / td > < td > Emulate a gamie genie (gg.rom required).< / td > < / tr >
< tr > < td > --nospritelim< / td > < td > 0|1< / td > < td > 1< / td > < td > Disbales the 8 sprites per scanline limitation.< / td > < / tr >
< tr > < td > --frameskip< / td > < td > integer< / td > < td > 0< / td > < td > Sets number of frames to skip per emulated frame (must be built with frameskip support).< / td > < / tr >
< tr > < td > --palette< / td > < td > filename< / td > < td > 0< / td > < td > Load a custom global palette from given file. Specifying "0" will cause FCEUX to stop using the custom global palette.< / td > < / tr >
< tr > < td > --ntsccolor< / td > < td > 0|1< / td > < td > 0< / td > < td > Enable NTSC NES colors.< / td > < / tr >
< tr > < td > --sound< / td > < td > 0|1< / td > < td > 1< / td > < td > Enable sound< / td > < / tr >
< tr > < td > --soundvol x< / td > < td > integer< / td > < td > 100< / td > < td > Set sound volume.< / td > < / tr >
< tr > < td > --soundq x< / td > < td > 0|1< / td > < td > 1< / td > < td > Enable high-quality sound emulation.< / td > < / tr >
< tr > < td > --clipsides< / td > < td > 0|1< / td > < td > 0< / td > < td > Clip leftmost and rightmost 8 columns of pixels of the video output.< / td > < / tr >
< tr > < td > --slend < / td > < td > integer< / td > < td > 231< / td > < td > Last scanline to be rendered.< / td > < / tr >
< tr > < td > --slstart< / td > < td > integer< / td > < td > 0< / td > < td > First scanline to be rendered< / td > < / tr >
< / table >
< / p >
< / p >
< a name = "credits" > < h2 > Credits< / h2 > < / a >
< p >
< table border width = "100%" >
< tr > < th > Name:< / th > < th > Contribution(s):< / th > < / tr >
< tr > < td > < a href = "mailto:ltsmooth42 _at_ gmail _dot_ com" > punkrockguy318< / a > < / td >
< td > FCEUX SDL Documentation rewrite.< / td > < / tr >
< / table >
< / p >
< / div >
< / div >
< div id = "footer" >
< a href = "home.html" > Home< / a > | < a href = "download.html" > Download< / a > |
< a href = "documentation.html" > Documentation< / a > | < a href = "version.html" >
2009-12-04 17:01:40 +00:00
Version History< / a > | < a href = "contact.html" > Contact< / a > | < a href = "links.html" > Links< / a >
2009-12-05 00:05:16 +00:00
< br / > We are in no way affiliated or endorsed by Nintendo or Nintendo of America. "Nintendo" is a registered trademark of Nintendo of America Inc.
< br / > ©2009 adelikat
2009-12-04 16:39:34 +00:00
< / div >
< / body >
< / html >
