JX-Speccy

Java ZX-Spectrum emulator (GNU GPL)

::: MENU :::

Home

Documentation

::: DONATION :::

If you find JX-Speccy useful and want to support its future development, or if you use it on a commercial site, please make a donation.

::: Applet usage :::

For a quick example see the index.html file included in the binary distribution.
Include the following html code in your page:

<applet code="jxspectrum.class"
        name="jxspectrum"
        archive="JXSpeccy.jar"
        WIDTH="560" HEIGHT="432">
<param name="aspect" value="3">
<param name="snapshot" value="YourZipFile">
<param name="128k" value="1">
<param name="mapcursors" value="1">
</applet>

Put the files rom.zip and rom128.zip and YourZipFile (manicminer.zip for example) in the same directory of the html file. The .zip file must include one of the supported snapshot file (.SNA, .TAP or .Z80).

The mapcursors parameter enables the following keyboard mapping:

  Left arrow  = 5
  Down arrow  = 6
  Up arrow    = 7
  Right arrow = 8
  Space       = 0

The 128k parameter enables 128K spectrum emulation.

You can remap keys using the following parameter/syntax:

  <param name="keyboardremap"
         value="#pcchar=#zxchar+...#pcchar=#zxchar+">

For example if you want to remap the ZX keys Q, A, O, P characters to the cursors keys, and the ZX key 1 to the ENTER use:

  <param name="keyboardremap"
         value="133=#o+134=#p+131=#q+132=#a+10=#1">

If you want to remap the ZX keys 5,6,7,8,0 to A,S,W,D,G use:

  <param name="keyboardremap"
         value="#a=#5+#s=#6+#w=#7+#d=#9+#g=#0">

Note: this strange way to remap keys will probably change in the future versions of JX-Speccy

If you want to enable the kempston joystick emulation (the fire button is the TAB key on the PC keyboard) add this parameter:

  <param name="kempston" value="1">

If you want to run the emulator in a smaller window make this modification:

...
        WIDTH="280" HEIGHT="216">
<param name="aspect" value="0">
...

::: Source code documentation :::

... to be done ... (however, a lot of comments are present in the source code)

Please send comments/suggestions/bugs to: jxspeccy@gameszoo.net