/usr/share/doc/mednafen/wswan.html is in mednafen 0.9.48+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Mednafen WonderSwan Documentation</title>
<link rel="stylesheet" type="text/css" media="screen, projection" href="mednafen.css">
</head>
<body>
<center><h1><img alt="Mednafen" src="mednafen.png" width="696" height="204"></h1></center>
<center><h1>WonderSwan Documentation</h1></center>
<center><i>Last updated September 16, 2017<br>Valid as of 0.9.48</i></center>
<p></p>
<b>Table of Contents:</b>
<ul><li><a href="#Section_intro">Introduction</a><ul></ul></li><li><a href="#Section_default_keys">Default Key Assignments</a><ul></ul></li><li><a href="#Section_hax">Game-specific Emulation Hacks</a><ul></ul></li><li><a href="#Settings+Reference">Settings Reference</a><ul></ul></li></ul><hr width="100%">
<h2><a name="Section_intro">Introduction</a></h2><p></p>
Mednafen's WonderSwan (Color) emulation is based off of <a href="http://cygne.emuunlim.com/">Cygne</a>, modified with bug fixes
and to add sound emulation.
<p>
WSR(WonderSwan sound rip format) playback is supported.
</p>
<hr width="100%">
<h2><a name="Section_default_keys">Default Key Assignments</a></h2><p></p>
The "X Cursor" buttons are usually used for directional control with horizontal-layout games,
while the "Y Cursor" buttons are usually used for directional control with vertical-layout games.
Additionally, the opposite buttons are often treated as action buttons...because of this,
<big><b>you must *NOT* configure the X cursor buttons and Y cursor buttons to the same real buttons or keys.</b></big> Games will not behave
well at all if you do.
</p>
<p>
<table border>
<tr><th>Key(s):</th><th>Action:</th><th>Configuration String:</th></tr>
<tr><td>ALT + SHIFT + 1</td><td>Activate in-game input configuration process for WonderSwan pad.</td><td>input_config1</td></tr>
</table>
</p>
<p>
<table border>
<tr><th>Key:</th><th nowrap>Action/Button:</th></tr>
<tr><td>Keypad 2</td><td>B</td></tr>
<tr><td>Keypad 3</td><td>A</td></tr>
<tr><td>Enter/Return</td><td>Start</td></tr>
<tr><td>W</td><td nowrap>Up, X Cursors</td></tr>
<tr><td>S</td><td nowrap>Down, X Cursors</td></tr>
<tr><td>A</td><td nowrap>Left, X Cursors</td></tr>
<tr><td>D</td><td nowrap>Right, X Cursors</td></tr>
<tr><td>UP</td><td nowrap>Up, Y Cursors</td></tr>
<tr><td>DOWN</td><td nowrap>Down, Y Cursors</td></tr>
<tr><td>LEFT</td><td nowrap>Left, Y Cursors</td></tr>
<tr><td>RIGHT</td><td nowrap>Right, Y Cursors</td></tr>
</table>
<hr width="100%">
<h2><a name="Section_hax">Game-specific Emulation Hacks</a></h2><p></p> <table border width="100%">
<tr><th>Title:</th><th>Description:</th><th>Source code files affected:</th></tr>
<tr><td>Detective Conan</td><td>Patch to work around lack of pipeline/prefetch emulation.</td><td>src/wswan/main.cpp</td></tr>
</table>
<hr width="100%">
<h2><a name="Settings+Reference">Settings Reference</a></h2><p></p><p>
<b>Caution:</b> 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).
</p>
<p></p><table border><tr class="TableHeader"><th>Setting:</th><th>Value Type:</th><th>Possible Values:</th><th>Default Value:</th><th>Description:</th></tr><tr class="RowA"><td class="ColA"><b>wswan.bday</b></td><td class="ColB">integer</td><td class="ColC">1 <i>through</i> 31</td><td class="ColD">23</td><td class="ColE"><a name="wswan.bday">Birth Day</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA"><b>wswan.blood</b></td><td class="ColB">enum</td><td class="ColC">a<br>b<br>o<br>ab</td><td class="ColD">O</td><td class="ColE"><a name="wswan.blood">Blood Type</a><ul><li><b>a</b> - A<br></li><br><li><b>b</b> - B<br></li><br><li><b>o</b> - O<br></li><br><li><b>ab</b> - AB<br></li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA"><b>wswan.bmonth</b></td><td class="ColB">integer</td><td class="ColC">1 <i>through</i> 12</td><td class="ColD">6</td><td class="ColE"><a name="wswan.bmonth">Birth Month</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA"><b>wswan.byear</b></td><td class="ColB">integer</td><td class="ColC">0 <i>through</i> 9999</td><td class="ColD">1989</td><td class="ColE"><a name="wswan.byear">Birth Year</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA"><b>wswan.input.builtin</b></td><td class="ColB">enum</td><td class="ColC">gamepad<br>gamepadraa</td><td class="ColD">gamepad</td><td class="ColE"><a name="wswan.input.builtin">Input device for Built-In</a><ul><li><b>gamepad</b> - Gamepad<br></li><br><li><b>gamepadraa</b> - Gamepad(Rotation Auto-Adjust)<br></li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA"><b>wswan.language</b></td><td class="ColB">enum</td><td class="ColC">japanese<br>english</td><td class="ColD">english</td><td class="ColE"><a name="wswan.language">Language games should display text in.</a><p>The only game this setting is known to affect is "Digimon Tamers - Battle Spirit".</p><ul><li><b>japanese</b> - Japanese<br></li><br><li><b>english</b> - English<br></li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA"><b>wswan.name</b></td><td class="ColB">string</td><td class="ColC"> </td><td class="ColD">Mednafen</td><td class="ColE"><a name="wswan.name">Name</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA"><b>wswan.sex</b></td><td class="ColB">enum</td><td class="ColC">male<br>female</td><td class="ColD">F</td><td class="ColE"><a name="wswan.sex">Sex</a><ul><li><b>male</b> - Male<br></li><br><li><b>female</b> - Female<br></li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
</table><p></p><table border><tr class="TableHeader"><th>Setting:</th><th>Value Type:</th><th>Possible Values:</th><th>Default Value:</th><th>Description:</th></tr><tr class="RowA"><td class="ColA">wswan.debugger.disfontsize</td><td class="ColB">enum</td><td class="ColC">5x7<br>6x9<br>6x12<br>6x13<br>9x18</td><td class="ColD">5x7</td><td class="ColE"><a name="wswan.debugger.disfontsize">Disassembly font size.</a><p>Note: Setting the font size to larger than the default may cause text overlap in the debugger.</p><ul><li><b>5x7</b> - 5x7<br></li><br><li><b>6x9</b> - 6x9<br></li><br><li><b>6x12</b> - 6x12<br></li><br><li><b>6x13</b> - 6x13. CJK support.<br></li><br><li><b>9x18</b> - 9x18; CJK support.<br></li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.debugger.memcharenc</td><td class="ColB">string</td><td class="ColC"> </td><td class="ColD">shift_jis</td><td class="ColE"><a name="wswan.debugger.memcharenc">Character encoding for the debugger's memory editor.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.enable</td><td class="ColB">boolean</td><td class="ColC">0<br>1</td><td class="ColD">1</td><td class="ColE"><a name="wswan.enable">Enable (automatic) usage of this module.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.forcemono</td><td class="ColB">boolean</td><td class="ColC">0<br>1</td><td class="ColD">0</td><td class="ColE"><a name="wswan.forcemono">Force monophonic sound output.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.scanlines</td><td class="ColB">integer</td><td class="ColC">-100 <i>through</i> 100</td><td class="ColD">0</td><td class="ColE"><a name="wswan.scanlines">Enable scanlines with specified opacity.</a><p>Opacity is specified in %; IE a value of "100" will give entirely black scanlines.<br>
<br>
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.</p></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.shader</td><td class="ColB">enum</td><td class="ColC">none<br>autoip<br>autoipsharper<br>scale2x<br>sabr<br>ipsharper<br>ipxnoty<br>ipynotx<br>ipxnotysharper<br>ipynotxsharper<br>goat</td><td class="ColD">none</td><td class="ColE"><a name="wswan.shader">Enable specified OpenGL shader.</a><p>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 "<system>.videoip" setting is ignored.</p><ul><li><b>none</b> - None/Disabled<br></li><br><li><b>autoip</b> - Auto Interpolation<br>Will automatically interpolate on each axis if the corresponding effective scaling factor is not an integer.</li><br><li><b>autoipsharper</b> - Sharper Auto Interpolation<br>Same as "autoip", but when interpolation is done, it is done in a manner that will reduce blurriness if possible.</li><br><li><b>scale2x</b> - Scale2x<br></li><br><li><b>sabr</b> - SABR v3.0<br>GPU-intensive.</li><br><li><b>ipsharper</b> - Sharper bilinear interpolation.<br></li><br><li><b>ipxnoty</b> - Linear interpolation on X axis only.<br></li><br><li><b>ipynotx</b> - Linear interpolation on Y axis only.<br></li><br><li><b>ipxnotysharper</b> - Sharper version of "ipxnoty".<br></li><br><li><b>ipynotxsharper</b> - Sharper version of "ipynotx".<br></li><br><li><b>goat</b> - Simple approximation of a color TV CRT look.<br>Intended for fullscreen modes with a vertical resolution of around 1000 to 1500 pixels. Doesn't simulate halation and electron beam energy distribution nuances.</li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.shader.goat.fprog</td><td class="ColB">boolean</td><td class="ColC">0<br>1</td><td class="ColD">0</td><td class="ColE"><a name="wswan.shader.goat.fprog">Force interlaced video to be treated as progressive.</a><p>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.</p></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.shader.goat.hdiv</td><td class="ColB">real</td><td class="ColC">-2.00 <i>through</i> 2.00</td><td class="ColD">0.50</td><td class="ColE"><a name="wswan.shader.goat.hdiv">Constant RGB horizontal divergence.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.shader.goat.pat</td><td class="ColB">enum</td><td class="ColC">goatron<br>borg<br>slenderman</td><td class="ColD">goatron</td><td class="ColE"><a name="wswan.shader.goat.pat">Mask pattern.</a><ul><li><b>goatron</b> - Goatron<br>Brightest.</li><br><li><b>borg</b> - Borg<br>Darkest.</li><br><li><b>slenderman</b> - Slenderman<br>Spookiest?</li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.shader.goat.slen</td><td class="ColB">boolean</td><td class="ColC">0<br>1</td><td class="ColD">1</td><td class="ColE"><a name="wswan.shader.goat.slen">Enable scanlines effect.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.shader.goat.tp</td><td class="ColB">real</td><td class="ColC">0.00 <i>through</i> 1.00</td><td class="ColD">0.50</td><td class="ColE"><a name="wswan.shader.goat.tp">Transparency of otherwise-opaque mask areas.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.shader.goat.vdiv</td><td class="ColB">real</td><td class="ColC">-2.00 <i>through</i> 2.00</td><td class="ColD">0.50</td><td class="ColE"><a name="wswan.shader.goat.vdiv">Constant RGB vertical divergence.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.special</td><td class="ColB">enum</td><td class="ColC">none<br>hq2x<br>hq3x<br>hq4x<br>scale2x<br>scale3x<br>scale4x<br>2xsai<br>super2xsai<br>supereagle<br>nn2x<br>nn3x<br>nn4x<br>nny2x<br>nny3x<br>nny4x</td><td class="ColD">none</td><td class="ColE"><a name="wswan.special">Enable specified special video scaler.</a><p>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).</p><ul><li><b>none</b> - None/Disabled<br></li><br><li><b>hq2x</b> - hq2x<br></li><br><li><b>hq3x</b> - hq3x<br></li><br><li><b>hq4x</b> - hq4x<br></li><br><li><b>scale2x</b> - scale2x<br></li><br><li><b>scale3x</b> - scale3x<br></li><br><li><b>scale4x</b> - scale4x<br></li><br><li><b>2xsai</b> - 2xSaI<br></li><br><li><b>super2xsai</b> - Super 2xSaI<br></li><br><li><b>supereagle</b> - Super Eagle<br></li><br><li><b>nn2x</b> - Nearest-neighbor 2x<br></li><br><li><b>nn3x</b> - Nearest-neighbor 3x<br></li><br><li><b>nn4x</b> - Nearest-neighbor 4x<br></li><br><li><b>nny2x</b> - Nearest-neighbor 2x, y axis only<br></li><br><li><b>nny3x</b> - Nearest-neighbor 3x, y axis only<br></li><br><li><b>nny4x</b> - Nearest-neighbor 4x, y axis only<br></li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.stretch</td><td class="ColB">enum</td><td class="ColC">0<br>full<br>aspect<br>aspect_int<br>aspect_mult2</td><td class="ColD">aspect_mult2</td><td class="ColE"><a name="wswan.stretch">Stretch to fill screen.</a><ul><li><b>0</b> - Disabled<br></li><br><li><b>full</b> - Full<br>Full-screen stretch, disregarding aspect ratio.</li><br><li><b>aspect</b> - Aspect Preserve<br>Full-screen stretch as far as the aspect ratio(in this sense, the equivalent xscalefs == yscalefs) can be maintained.</li><br><li><b>aspect_int</b> - Aspect Preserve + Integer Scale<br>Full-screen stretch, same as "aspect" except that the equivalent xscalefs and yscalefs are rounded down to the nearest integer.</li><br><li><b>aspect_mult2</b> - Aspect Preserve + Integer Multiple-of-2 Scale<br>Full-screen stretch, same as "aspect_int", but rounds down to the nearest multiple of 2.</li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.tblur</td><td class="ColB">boolean</td><td class="ColC">0<br>1</td><td class="ColD">0</td><td class="ColE"><a name="wswan.tblur">Enable video temporal blur(50/50 previous/current frame by default).</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.tblur.accum</td><td class="ColB">boolean</td><td class="ColC">0<br>1</td><td class="ColD">0</td><td class="ColE"><a name="wswan.tblur.accum">Accumulate color data rather than discarding it.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.tblur.accum.amount</td><td class="ColB">real</td><td class="ColC">0 <i>through</i> 100</td><td class="ColD">50</td><td class="ColE"><a name="wswan.tblur.accum.amount">Blur amount in accumulation mode, specified in percentage of accumulation buffer to mix with the current frame.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.videoip</td><td class="ColB">enum</td><td class="ColC">0<br>1<br>x<br>y</td><td class="ColD">0</td><td class="ColE"><a name="wswan.videoip">Enable (bi)linear interpolation.</a><ul><li><b>0</b> - Disabled<br></li><br><li><b>1</b> - Bilinear<br></li><br><li><b>x</b> - Linear (X)<br>Interpolation only on the X axis.</li><br><li><b>y</b> - Linear (Y)<br>Interpolation only on the Y axis.</li></ul></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.xres</td><td class="ColB">integer</td><td class="ColC">0 <i>through</i> 65536</td><td class="ColD">0</td><td class="ColE"><a name="wswan.xres">Full-screen horizontal resolution.</a><p>A value of "0" will cause the desktop horizontal resolution to be used.</p></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.xscale</td><td class="ColB">real</td><td class="ColC">0.01 <i>through</i> 256</td><td class="ColD">4.000000</td><td class="ColE"><a name="wswan.xscale">Scaling factor for the X axis in windowed mode.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.xscalefs</td><td class="ColB">real</td><td class="ColC">0.01 <i>through</i> 256</td><td class="ColD">1.000000</td><td class="ColE"><a name="wswan.xscalefs">Scaling factor for the X axis in fullscreen mode.</a><p>For this settings to have any effect, the "<system>.stretch" setting must be set to "0".</p></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.yres</td><td class="ColB">integer</td><td class="ColC">0 <i>through</i> 65536</td><td class="ColD">0</td><td class="ColE"><a name="wswan.yres">Full-screen vertical resolution.</a><p>A value of "0" will cause the desktop vertical resolution to be used.</p></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowA"><td class="ColA">wswan.yscale</td><td class="ColB">real</td><td class="ColC">0.01 <i>through</i> 256</td><td class="ColD">4.000000</td><td class="ColE"><a name="wswan.yscale">Scaling factor for the Y axis in windowed mode.</a></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
<tr class="RowB"><td class="ColA">wswan.yscalefs</td><td class="ColB">real</td><td class="ColC">0.01 <i>through</i> 256</td><td class="ColD">1.000000</td><td class="ColE"><a name="wswan.yscalefs">Scaling factor for the Y axis in fullscreen mode.</a><p>For this settings to have any effect, the "<system>.stretch" setting must be set to "0".</p></td></tr><tr><td class="RowSpacer" colspan="5"> </td></tr>
</table><hr width="100%">
</body>
</html>
|