Mednafen

Super Nintendo Entertainment System/Super Famicom Documentation

Last updated September 16, 2017
Valid as of 0.9.48

Table of Contents:

Introduction

The "snes_faust" emulation module is experimental, and not used automatically by default except for SPC playback. To use this module rather than the "snes" module, you must either set the "snes.enable" setting to "0", or pass "-force_module snes_faust" to Mednafen each time it is invoked.

Special cart chips are not supported, and the only input devices currently emulated are the standard SNES gamepad and multitap. Timing is approximate, so some games may exhibit timing-related issues.

A unique feature to this module(at the current time) is optional 1-frame speculative execution, disabled by default, controlled by the snes_faust.spex setting. Enabling it will reduce input(controller)->output(video) latency by 1 video frame(~16.7ms), with no deleterious effects on most games tested(though it will increase CPU usage a bit). Combine it with the setting changes recommended here for a better netplay experience.


Settings Reference

Caution: Any settings that change emulation behavior as seen from the emulated game are shown with the setting name bolded in the table. One should be conscious of these settings if one has changed them from the default values when using network play or movies, as they can cause desychronizations if not set the same among hosts(or between the recording emulator and the playing emulator).

Setting:Value Type:Possible Values:Default Value:Description:
snes_faust.correct_aspectboolean0
1
1Correct aspect ratio.
 
snes_faust.input.port1enumnone
gamepad
gamepadInput device for Virtual Port 1
  • none - none

  • gamepad - Gamepad
 
snes_faust.input.port2enumnone
gamepad
gamepadInput device for Virtual Port 2
  • none - none

  • gamepad - Gamepad
 
snes_faust.input.port3enumnone
gamepad
gamepadInput device for Virtual Port 3
  • none - none

  • gamepad - Gamepad
 
snes_faust.input.port4enumnone
gamepad
gamepadInput device for Virtual Port 4
  • none - none

  • gamepad - Gamepad
 
snes_faust.input.port5enumnone
gamepad
gamepadInput device for Virtual Port 5
  • none - none

  • gamepad - Gamepad
 
snes_faust.input.port6enumnone
gamepad
gamepadInput device for Virtual Port 6
  • none - none

  • gamepad - Gamepad
 
snes_faust.input.port7enumnone
gamepad
gamepadInput device for Virtual Port 7
  • none - none

  • gamepad - Gamepad
 
snes_faust.input.port8enumnone
gamepad
gamepadInput device for Virtual Port 8
  • none - none

  • gamepad - Gamepad
 
snes_faust.input.sport1.multitapboolean0
1
0Enable multitap on SNES port 1.
 
snes_faust.input.sport2.multitapboolean0
1
0Enable multitap on SNES port 2.
 
snes_faust.resamp_qualityinteger0 through 53Sound quality.

Higher values correspond to better SNR and better preservation of higher frequencies("brightness"), at the cost of increased computational complexity and a negligible increase in latency.

Higher values will also slightly increase the probability of sample clipping(relevant if Mednafen's volume control settings are set too high), due to increased (time-domain) ringing.

 
snes_faust.resamp_rate_errorreal0.0000001 through 0.00150.000035Sound output rate tolerance.

Lower values correspond to better matching of the output rate of the resampler to the actual desired output rate, at the expense of increased RAM usage and poorer CPU cache utilization.

 
snes_faust.spexboolean0
1
0Enable 1-frame speculative execution for video output.

Hack to reduce input->output video latency by 1 frame. Enabling will increase CPU usage, and may cause video glitches(such as "jerkiness") in some oddball games, but most commercially-released games should be fine.

 
snes_faust.spex.soundboolean0
1
1Enable speculative execution for sound output too.

Only has an effect when speculative-execution for video output is enabled. Will cause minor sound glitches in some games.

 

Setting:Value Type:Possible Values:Default Value:Description:
snes_faust.enableboolean0
1
1Enable (automatic) usage of this module.
 
snes_faust.forcemonoboolean0
1
0Force monophonic sound output.
 
snes_faust.scanlinesinteger-100 through 1000Enable scanlines with specified opacity.

Opacity is specified in %; IE a value of "100" will give entirely black scanlines.

Negative values are the same as positive values for non-interlaced video, but for interlaced video will cause the scanlines to be overlaid over the previous(if the video.deinterlacer setting is set to "weave", the default) field's lines.

 
snes_faust.shaderenumnone
autoip
autoipsharper
scale2x
sabr
ipsharper
ipxnoty
ipynotx
ipxnotysharper
ipynotxsharper
goat
noneEnable specified OpenGL shader.

Obviously, this will only work with the OpenGL "video.driver" setting, and only on cards and OpenGL implementations that support shaders, otherwise you will get a black screen, or Mednafen may display an error message when starting up. When a shader is enabled, the ".videoip" setting is ignored.

  • none - None/Disabled

  • autoip - Auto Interpolation
    Will automatically interpolate on each axis if the corresponding effective scaling factor is not an integer.

  • autoipsharper - Sharper Auto Interpolation
    Same as "autoip", but when interpolation is done, it is done in a manner that will reduce blurriness if possible.

  • scale2x - Scale2x

  • sabr - SABR v3.0
    GPU-intensive.

  • ipsharper - Sharper bilinear interpolation.

  • ipxnoty - Linear interpolation on X axis only.

  • ipynotx - Linear interpolation on Y axis only.

  • ipxnotysharper - Sharper version of "ipxnoty".

  • ipynotxsharper - Sharper version of "ipynotx".

  • goat - Simple approximation of a color TV CRT look.
    Intended for fullscreen modes with a vertical resolution of around 1000 to 1500 pixels. Doesn't simulate halation and electron beam energy distribution nuances.
 
snes_faust.shader.goat.fprogboolean0
1
0Force interlaced video to be treated as progressive.

When disabled, the default, the "video.deinterlacer" setting is effectively ignored with respect to what appears on the screen. When enabled, it may be prudent to disable the scanlines effect controlled by the *.goat.slen setting, or else the scanline effect may look objectionable.

 
snes_faust.shader.goat.hdivreal-2.00 through 2.000.50Constant RGB horizontal divergence.
 
snes_faust.shader.goat.patenumgoatron
borg
slenderman
goatronMask pattern.
  • goatron - Goatron
    Brightest.

  • borg - Borg
    Darkest.

  • slenderman - Slenderman
    Spookiest?
 
snes_faust.shader.goat.slenboolean0
1
1Enable scanlines effect.
 
snes_faust.shader.goat.tpreal0.00 through 1.000.50Transparency of otherwise-opaque mask areas.
 
snes_faust.shader.goat.vdivreal-2.00 through 2.000.50Constant RGB vertical divergence.
 
snes_faust.specialenumnone
hq2x
hq3x
hq4x
scale2x
scale3x
scale4x
2xsai
super2xsai
supereagle
nn2x
nn3x
nn4x
nny2x
nny3x
nny4x
noneEnable specified special video scaler.

The destination rectangle is NOT altered by this setting, so if you have xscale and yscale set to "2", and try to use a 3x scaling filter like hq3x, the image is not going to look that great. The nearest-neighbor scalers are intended for use with bilinear interpolation enabled, at high resolutions(such as 1280x1024; nn2x(or nny2x) + bilinear interpolation + fullscreen stretching at this resolution looks quite nice).

  • none - None/Disabled

  • hq2x - hq2x

  • hq3x - hq3x

  • hq4x - hq4x

  • scale2x - scale2x

  • scale3x - scale3x

  • scale4x - scale4x

  • 2xsai - 2xSaI

  • super2xsai - Super 2xSaI

  • supereagle - Super Eagle

  • nn2x - Nearest-neighbor 2x

  • nn3x - Nearest-neighbor 3x

  • nn4x - Nearest-neighbor 4x

  • nny2x - Nearest-neighbor 2x, y axis only

  • nny3x - Nearest-neighbor 3x, y axis only

  • nny4x - Nearest-neighbor 4x, y axis only
 
snes_faust.stretchenum0
full
aspect
aspect_int
aspect_mult2
aspect_mult2Stretch to fill screen.
  • 0 - Disabled

  • full - Full
    Full-screen stretch, disregarding aspect ratio.

  • aspect - Aspect Preserve
    Full-screen stretch as far as the aspect ratio(in this sense, the equivalent xscalefs == yscalefs) can be maintained.

  • aspect_int - Aspect Preserve + Integer Scale
    Full-screen stretch, same as "aspect" except that the equivalent xscalefs and yscalefs are rounded down to the nearest integer.

  • aspect_mult2 - Aspect Preserve + Integer Multiple-of-2 Scale
    Full-screen stretch, same as "aspect_int", but rounds down to the nearest multiple of 2.
 
snes_faust.tblurboolean0
1
0Enable video temporal blur(50/50 previous/current frame by default).
 
snes_faust.tblur.accumboolean0
1
0Accumulate color data rather than discarding it.
 
snes_faust.tblur.accum.amountreal0 through 10050Blur amount in accumulation mode, specified in percentage of accumulation buffer to mix with the current frame.
 
snes_faust.videoipenum0
1
x
y
1Enable (bi)linear interpolation.
  • 0 - Disabled

  • 1 - Bilinear

  • x - Linear (X)
    Interpolation only on the X axis.

  • y - Linear (Y)
    Interpolation only on the Y axis.
 
snes_faust.xresinteger0 through 655360Full-screen horizontal resolution.

A value of "0" will cause the desktop horizontal resolution to be used.

 
snes_faust.xscalereal0.01 through 2563.000000Scaling factor for the X axis in windowed mode.
 
snes_faust.xscalefsreal0.01 through 2561.000000Scaling factor for the X axis in fullscreen mode.

For this settings to have any effect, the ".stretch" setting must be set to "0".

 
snes_faust.yresinteger0 through 655360Full-screen vertical resolution.

A value of "0" will cause the desktop vertical resolution to be used.

 
snes_faust.yscalereal0.01 through 2563.000000Scaling factor for the Y axis in windowed mode.
 
snes_faust.yscalefsreal0.01 through 2561.000000Scaling factor for the Y axis in fullscreen mode.

For this settings to have any effect, the ".stretch" setting must be set to "0".