1fuse(1) Emulators fuse(1)
2
3
4
6 fuse — Sinclair ZX Spectrum emulator
7
9 fuse [options]
10
12 Fuse is a Sinclair ZX Spectrum emulator. It supports several models
13 (including the 128), with quite faithful emulation of the display and
14 sound.
15
16 The emulator can load any of the formats supported by libspectrum(3) —
17 this includes Z80, SNA and SZX snapshots, and PZX, TAP and TZX virtual-
18 tape files. Saving to SZX, Z80 and SNA snapshots and TZX and TAP tape
19 files is supported. The SLT extension to the Z80 format is partly sup‐
20 ported (enough for multi-load games); however, loading of the old DAT-
21 file variant is not.
22
23 DSK, UDI, FDI, TD0, MGT, IMG, D40, D80, SAD, TRD, SCL and OPD disk
24 images are supported when a disk interface is being emulated, including
25 the integrated disk drives on +3, Pentagon or Scorpion machines as well
26 as the +D, DISCiPLE, Opus Discovery, Beta 128 and Didaktik 80 inter‐
27 faces. DCK cartridge images are supported when emulating a Timex 2068
28 variant. Interface 2 ROM cartridges are also supported.
29
30 Finally, there is also support for reading and writing the RZX input
31 recording format.
32
33 See the COMPRESSED FILES section for details on reading files com‐
34 pressed with bzip2(3), gzip(3) or zip(3).
35
37 --accelerate-loader
38 Specify whether Fuse should attempt to accelerate tape loaders
39 by “short circuiting” the loading loop. This will in general
40 speed up loading, but may cause some loaders to fail. (Enabled
41 by default, but you can use `--no-accelerate-loader' to dis‐
42 able). The same as the Media Options dialog's Accelerate loaders
43 option.
44
45 --aspect-hint
46 Specify whether the GTK+ and Xlib user interfaces should `hint'
47 to the window manager about the preferred aspect ratio for the
48 graphics window, thus preventing resizing to non-square sizes
49 which lead to Fuse not displaying correctly. This option has
50 been observed to cause problems with some window managers when
51 using the GTK+ UI which can prevent the window from being
52 resized or moved at all. (Enabled by default, but you can use
53 `--no-aspect-hint' to disable). See also the
54 `--strict-aspect-hint' option.
55
56 --autosave-settings
57 Specify whether Fuse's current settings should be automatically
58 saved on exit. The same as the General Options dialog's Auto-
59 save settings option.
60
61 --auto-load
62 Specify whether tape and disk files should be automatically
63 loaded when they are opened using the File, Open... menu
64 option. In the case of TRD/SCL disk images, inserts also a boot
65 loader file when none is available. (Enabled by default, but you
66 can use `--no-auto-load' to disable). Same as the Media Options
67 dialog's Auto-load media option.
68
69 --beta128
70 Emulate a Beta 128 interface. Same as the Disk Peripherals
71 Options dialog's Beta 128 interface option.
72
73 --beta128-48boot
74 When a Beta 128 interface is used in 48K or TC2048 emulation the
75 option additionally controls whether the machine boots directly
76 into the TR-DOS system. Same as the Disk Peripherals Options
77 dialog's Beta 128 auto-boot in 48K machines option.
78
79 --betadisk file
80 Insert the specified file into the emulated Beta disk inter‐
81 face's drive A: and select Pentagon mode on startup.
82
83 --bw-tv
84 Specify whether the display should simulate a colour or black
85 and white television. This option is effective under the GTK+,
86 Win32, Xlib and SDL user interfaces: the others will always sim‐
87 ulate a colour TV. The same as the General Options dialog's
88 Black and white TV option.
89
90 --cmos-z80
91 This option specifies that Fuse should emulate a CMOS Z80, as
92 opposed to an NMOS Z80. Same as the General Options dialog's Z80
93 is CMOS option.
94
95 --competition-code code
96 Specify the code to be written to competition mode RZX files.
97 The same as the RZX Options dialog's Competition code option.
98
99 --competition-mode
100 Specify whether input recordings should be made in `competition
101 mode'. The same as the RZX Options dialog's Competition mode
102 option.
103
104 --compress-rzx
105 Specify whether RZX files should be written out compressed.
106 (Enabled by default, but you can use `--no-compress-rzx' to dis‐
107 able). Same as the RZX Options dialog's Compress RZX data
108 option.
109
110 --confirm-actions
111 Specify whether `dangerous' actions (those which could cause
112 data loss, for example resetting the Spectrum) require confirma‐
113 tion before occurring. (Enabled by default, but you can use
114 `--no-confirm-actions' to disable). This option is the same as
115 the General Options dialog's Confirm actions option.
116
117 --covox
118 Emulate a Covox sound interface for Pentagon/Scorpion. Same as
119 the General Peripherals Options dialog's Covox option.
120
121 --debugger-command string
122 Specify a debugger command to be run before emulator startup.
123 This can be used to set breakpoints or the like. Currently, this
124 is the only method to input multi-line debugger commands. (See
125 the MONITOR/DEBUGGER section for more information).
126
127 --detect-loader
128 Specify whether Fuse should attempt to detect when the tape is
129 being accessed and start and stop the virtual tape playing auto‐
130 matically. (Enabled by default, but you can use
131 `--no-detect-loader' to disable). Same as the Media Options dia‐
132 log's Detect loaders option.
133
134 --disciple
135 Emulate a DISCiPLE interface. Same as the Disk Peripherals
136 Options dialog's DISCiPLE interface option.
137
138 --discipledisk file
139 Insert the specified file into the emulated DISCiPLE's drive 1.
140
141 --didaktik80
142 Emulate a Didaktik 80 (or Didaktik 40) disk interface. Same as
143 the Disk Peripherals Options dialog's Didaktik 80 interface
144 option.
145
146 --didaktik80disk file
147 Insert the specified file into the emulated Didaktik 80 (or
148 Didaktik 40)'s drive A.
149
150 --disk-ask-merge
151 Prompt the user to confirm whether Fuse should try to merge the
152 `B' side of a disk image from a separate file when opening a new
153 single-sided disk image.
154
155 --disk-try-merge mode
156 Select whether Fuse should try to merge a separate file for the
157 `B' side of a disk image separate file when opening a new disk
158 image. Most double sided disk images are dumped as two single
159 sided disk images e.g. `Golden Axe - Side A.dsk' and `Golden
160 Axe - Side B.dsk'. So, if we want to play Golden Axe, first we
161 have to insert the first disk image and when the game asks to
162 insert side B, we have to find and open the second disk image,
163 instead of just `flip'-ing the disk inside the drive. If
164 enabled, Fuse will try to open the second image too and create a
165 double sided disk image (merging the two one sided disk images)
166 and insert this merged virtual disk into the disk drive. The
167 function detects whether the file is one side of a double-sided
168 image if the filename matches a pattern like [Ss]ide[
169 _][abAB12][ _.] in the file name of a disk that is being opened.
170 If found, Fuse will try to open the other side of the disk too
171 substituting the appropriate characters in the filename e.g.
172 1→2, a→b, A→B. If successful then it will merge the two images
173 and now we have a double sided disk in drive. This means that if
174 we open `Golden Axe - Side A.dsk', then Fuse will try to open
175 `Golden Axe - Side B.dsk' too. Now, we can just `flip' the disk
176 if Golden Axe asks for `Side B'. The available options are
177 Never, With single-sided drives and Always.
178
179 --divide
180 Emulate the DivIDE interface. The same as the Disk Peripherals
181 Options dialog's DivIDE interface option.
182
183 --divide-masterfile file
184 --divide-slavefile file
185 Specify an IDE image to be loaded into the DivIDE's emulated
186 master and slave drives respectively.
187
188 --divide-write-protect
189 Specify that the emulated DivIDE's write protect jumper should
190 be considered set. The same as the Disk Peripherals Options dia‐
191 log's DivIDE write protect option.
192
193 --divmmc
194 Emulate the DivMMC interface. The same as the Disk Peripherals
195 Options dialog's DivMMC interface option.
196
197 --divmmc-file file
198 Specify an HDF image to be loaded into the DivMMC's emulated
199 memory card.
200
201 --divmmc-write-protect
202 Specify that the emulated DivMMC's write protect jumper that
203 protects EEPROM should be considered set. The same as the Disk
204 Peripherals Options dialog's DivMMC write protect option.
205
206 --dock file
207 Insert the specified file into the emulated Timex 2068 variant
208 dock; also select the TC2068 on startup if available.
209
210 -D mode
211 --doublescan-mode mode
212 Specify whether to use doublescan modes in the FB UI. Available
213 values for mode are 0, 1 and 2. 0 means `never doublescan' (use
214 640×480 at either 72 Hz or 60 Hz), whereas 1 and 2 both mean
215 `try to use doublescan' and will fall back on the 640×480 modes.
216 1 selects 72 Hz modes (the same size and shape as your typical
217 640×480), and 2 selects 60 Hz modes (overscan).
218
219 If your monitor displays a blank screen when using 1 or 2, press
220 F10 then try a different option or say `--fbmode 640'.
221
222 --drive-plus3a-type type
223 --drive-plus3b-type type
224 --drive-beta128a-type type
225 --drive-beta128b-type type
226 --drive-beta128c-type type
227 --drive-beta128d-type type
228 --drive-plusd1-type type
229 --drive-plusd2-type type
230 --drive-didaktik80a-type type
231 --drive-didaktik80b-type type
232 --drive-disciple1-type type
233 --drive-disciple2-type type
234 --drive-opus1-type type
235 --drive-opus2-type type
236 Specify a disk drive type to emulate with the associated inter‐
237 face. The available options are Disabled, Single-sided 40
238 track, Double-sided 40 track, Single-sided 80 track and Dou‐
239 ble-sided 80 track. See the Disk Options dialog for more infor‐
240 mation. The Disabled option is not supported for Drive 1 or
241 Drive A of any interface.
242
243 --drive-40-max-track count
244 --drive-80-max-track count
245 Specify the maximum number of tracks for 40 and 80 track physi‐
246 cal drives respectively.
247
248 --embed-snapshot
249 Specify whether a snapshot should be embedded in an RZX file
250 when recording is started from an existing snapshot. (Enabled by
251 default, but you can use `--no-embed-snapshot' to disable). Same
252 as the RZX Options dialog's Always embed snapshot option.
253
254 --fastload
255 Specify whether Fuse should run at the fastest possible speed
256 when the virtual tape is playing. (Enabled by default, but you
257 can use `--no-fastload' to disable). The same as the Media
258 Options dialog's Fastloading option.
259
260 -v mode
261 --fbmode mode
262 Specify which mode to use for the FB UI. Available values for
263 mode are `320' (which corresponds to a 320×240×256 mode), the
264 default and `640' (a 640×480×256 mode).
265
266 --fuller
267 Emulate a Fuller Box interface. Same as the General Peripherals
268 Options dialog's Fuller Box option.
269
270 --full-screen
271 Specify whether Fuse should run in full screen mode. This
272 option is effective only under the SDL UI.
273
274 -g filter
275 --graphics-filter mode
276 Specify which graphics filter to use if available. The default
277 is normal, which uses no filtering. The available options are
278 2x, 2xsai, 3x, advmame2x, advmame3x, dotmatrix, half, halfskip,
279 hq2x, hq3x, normal, super2xsai, supereagle, timex15x, timextv,
280 tv2x, paltv, paltv2x, and paltv3x. See the GRAPHICS FILTERS
281 section for more details.
282
283 --graphicsfile file
284 Set the filename used for graphical output from the emulated
285 ZX Printer. See the PRINTER EMULATION section for more details.
286
287 -h
288 --help
289 Give brief usage help, listing available options.
290
291 --if2cart file
292 Insert the specified file into the emulated Interface 2.
293
294 --interface1
295 Emulate a Sinclair Interface 1. Same as the General Peripherals
296 Options dialog's Interface 1 option.
297
298 --interface2
299 Emulate a Sinclair Interface 2. (Enabled by default, but you can
300 use `--no-interface2' to disable). Same as the General Peripher‐
301 als Options dialog's Interface 2 option.
302
303 --issue2
304 Emulate an issue 2 keyboard. Same as the General Options dia‐
305 log's Issue 2 keyboard option.
306
307 -j device
308 --joystick-1 device
309 Read from device to emulate the first joystick. Fuse will use
310 either `/dev/input/js0' or `/dev/js0' by default.
311
312 --joystick-2 device
313 As for --joystick-1 but for the second joystick; the default
314 here is either `/dev/input/js1' or `/dev/js1'.
315
316 --joystick-1-output type
317 --joystick-2-output type
318 --joystick-keyboard-output type
319 Select which joystick interface to attach for the first two real
320 joysticks and the keyboard joystick. The default is 0, which is
321 no output. The available options are 1 (cursor), 2 (kempston), 3
322 (Sinclair 1), 4 (Sinclair 2), 5 (Timex 1), 6 (Timex 2), and 7
323 (Fuller). Same as the Joysticks Options dialog's Joystick type
324 option.
325
326 --joystick-1-fire-1 code
327 --joystick-1-fire-2 code
328 --joystick-1-fire-3 code
329 --joystick-1-fire-4 code
330 --joystick-1-fire-5 code
331 --joystick-1-fire-6 code
332 --joystick-1-fire-7 code
333 --joystick-1-fire-8 code
334 --joystick-1-fire-9 code
335 --joystick-1-fire-10 code
336 --joystick-1-fire-11 code
337 --joystick-1-fire-12 code
338 --joystick-1-fire-13 code
339 --joystick-1-fire-14 code
340 --joystick-1-fire-15 code
341 --joystick-2-fire-1 code
342 --joystick-2-fire-2 code
343 --joystick-2-fire-3 code
344 --joystick-2-fire-4 code
345 --joystick-2-fire-5 code
346 --joystick-2-fire-6 code
347 --joystick-2-fire-7 code
348 --joystick-2-fire-8 code
349 --joystick-2-fire-9 code
350 --joystick-2-fire-10 code
351 --joystick-2-fire-11 code
352 --joystick-2-fire-12 code
353 --joystick-2-fire-13 code
354 --joystick-2-fire-14 code
355 --joystick-2-fire-15 code
356 Select which Fuse key code should be triggered by the applicable
357 real joystick button press. The codes are the Fuse keyboard
358 codes corresponding to the keys. The default value is 4096 which
359 corresponds to the virtual joystick fire button. Same as the
360 Joysticks Options dialog's Joystick fire options.
361
362 --joystick-keyboard-up code
363 --joystick-keyboard-down code
364 --joystick-keyboard-left code
365 --joystick-keyboard-right code
366 --joystick-keyboard-fire code
367 Select which Fuse key code should correspond with each direction
368 and fire for the keyboard virtual joystick. The same as the Key‐
369 board Joysticks Options dialog's Button for UP, Button for DOWN,
370 Button for LEFT, Button for RIGHT and Button for FIRE options
371 respectively.
372
373 --joystick-prompt
374 If this option is specified, then Fuse will prompt you which
375 form of joystick emulation you wish to use when loading a snap‐
376 shot. No prompt will be issued if the configuration in the snap‐
377 shot matches what you are currently using. The same as the Gen‐
378 eral Options dialog's Snap joystick prompt option.
379
380 --kempston
381 Emulate a Kempston joystick. Same as the General Peripherals
382 Options dialog's Kempston joystick option.
383
384 --kempston-mouse
385 Emulate a Kempston mouse. Same as the General Peripherals
386 Options dialog's Kempston mouse option.
387
388 --keyboard-arrows-shifted
389 Treat the keyboard arrow keys as shifted like the ZX Spectrum+
390 keyboard's arrow keys or as unshifted like a cursor joystick
391 that maps to the 5, 6, 7 and 8 keys. (Enabled by default, but
392 you can use `--no-keyboard-arrows-shifted' to disable). Same as
393 the General Peripherals Options dialog's Use shift with arrow
394 keys option.
395
396 --late-timings
397 It has been observed that some real Spectrums run such that the
398 screen is rendered one tstate later than on other real hardware.
399 This option specifies that Fuse should emulate such a machine.
400 Same as the General Options dialog's Late timings option.
401
402 --loading-sound
403 Specify whether the sound made while tapes are loading should be
404 emulated. (Enabled by default, but you can use `--no-load‐
405 ing-sound' to disable). Same as the Sound Options dialog's Load‐
406 ing sound option.
407
408 -m type
409 --machine type
410 Specify machine type to emulate initially. The default is 48, a
411 48K Spectrum. The available options are 16, 48, 48_ntsc, 128,
412 plus2, plus2a, plus3, 2048, 2068, ts2068, pentagon, pentagon512,
413 pentagon1024, scorpion and se.
414
415 --melodik
416 Emulate a Melodik AY interface for 16/48k Spectrums. Same as the
417 General Peripherals Options dialog's Melodik option.
418
419 --mdr-len length
420 This option controls the number of blocks in a new Microdrive
421 cartridge. Same as the Media Options dialog's MDR cartridge len
422 option.
423
424 --mdr-random-len
425 If this option is set, Fuse will use a random Microdrive car‐
426 tridge length. Same as the Media Options dialog's Random length
427 MDR cartridge option.
428
429 --microdrive-file file
430 --microdrive-2-file file
431 --microdrive-3-file file
432 --microdrive-4-file file
433 --microdrive-5-file file
434 --microdrive-6-file file
435 --microdrive-7-file file
436 --microdrive-8-file file
437 Specify Interface 1 Microdrive cartridge files to open.
438
439 --mouse-swap-buttons
440 Swap the left and right mouse buttons when emulating the Kemp‐
441 ston mouse. The same as the General Peripherals dialog's Swap
442 mouse buttons option.
443
444 --movie-compr level
445 This option sets the compression level used when creating
446 movies. Same as the Movie Options dialog's Movie compression
447 option. The available options are None, Lossless, and High
448 (lossy). The default option is Lossless. See also the MOVIE
449 RECORDING section.
450
451 --movie-start filename
452 With this command line option, Fuse will start movie recording
453 as soon as the emulator is started. See also the MOVIE RECORDING
454 section.
455
456 --movie-stop-after-rzx
457 With this command line option, Fuse will stop movie recording
458 when RZX playback or RZX recording ends. Same as the Movie
459 Options dialog's Stop recording after RZX ends option. (Enabled
460 by default, but you can use `--no-movie-stop-after-rzx' to dis‐
461 able). See also the MOVIE RECORDING section.
462
463 --multiface1
464 Emulate a Romantic Robot Multiface One interface. Same as the
465 General Peripherals Options dialog's Multiface One option.
466
467 --multiface128
468 Emulate a Romantic Robot Multiface 128 interface. Same as the
469 General Peripherals Options dialog's Multiface 128 option.
470
471 --multiface3
472 Emulate a Romantic Robot Multiface 3 interface. Same as the Gen‐
473 eral Peripherals Options dialog's Multiface 3 option.
474
475 --multiface1-stealth
476 Set Multiface One stealth/invisible mode. Same as the General
477 Peripherals Options dialog's Stealth Multiface One option.
478
479 --opus
480 Emulate an Opus Discovery interface. Same as the Disk Peripher‐
481 als Options dialog's Opus Discovery interface option.
482
483 --opusdisk file
484 Insert the specified file into the emulated Opus Discovery's
485 drive 1.
486
487 --pal-tv2x
488 Specify whether the PAL TV 2x and PAL TV 3x scalers should also
489 produce scanlines along the lines of the TV 2x and Timex TV
490 scalers. The same as the General Options dialog's PAL-TV use
491 TV2x effect option.
492
493 --phantom-typist-mode mode
494 Specify the keystroke sequence that the "phantom typist" should
495 use when starting a program loading. The available options are
496 Auto, Keyword, Keystroke, Menu, Plus 2A and Plus 3. The same as
497 the Media Options dialog's Phantom typist mode option.
498
499 -p file
500 --playback file
501 Specify an RZX file to begin playback from.
502
503 --plus3disk file
504 Insert the specified file into the emulated +3's A: drive; also
505 select the +3 on startup if available.
506
507 --plus3-detect-speedlock
508 Specify whether the +3 drives try to detect Speedlock protected
509 disks, and emulate `weak' sectors. If the disk image file (EDSK
510 or UDI) contains weak sector data, than Speedlock detection is
511 automatically omitted. See also the WEAK DISK DATA section.
512 Same as the Disk Options dialog's +3 Detect Speedlock option.
513
514 --plusd
515 Emulate a +D interface. Same as the Disk Peripherals Options
516 dialog's +D interface option.
517
518 --plusddisk file
519 Insert the specified file into the emulated +D's drive 1.
520
521 --printer
522 Specify whether the emulation should include a printer. Same as
523 the General Peripherals Options dialog's Emulate printers
524 option.
525
526 --rate frame
527 Specify the frame rate, the ratio of spectrum frame updates to
528 real frame updates. Same as the General Options dialog's Frame
529 rate option.
530
531 -r file
532 --record file
533 Specify an RZX file to begin recording to.
534
535 --recreated-spectrum
536 Enable the use of a Recreated ZX Spectrum in `Layer A' (game)
537 mode. This is a Bluetooth keyboard that can be paired to the
538 device where Fuse is running. The same as the General Options
539 dialog's Recreated ZX Spectrum option.
540
541 --rom-16 file
542 --rom-48 file
543 --rom-128-0 file
544 --rom-128-1 file
545 --rom-plus2-0 file
546 --rom-plus2-1 file
547 --rom-plus2a-0 file
548 --rom-plus2a-1 file
549 --rom-plus2a-2 file
550 --rom-plus2a-3 file
551 --rom-plus3-0 file
552 --rom-plus3-1 file
553 --rom-plus3-2 file
554 --rom-plus3-3 file
555 --rom-plus3e-0 file
556 --rom-plus3e-1 file
557 --rom-plus3e-2 file
558 --rom-plus3e-3 file
559 --rom-tc2048 file
560 --rom-tc2068-0 file
561 --rom-tc2068-1 file
562 --rom-ts2068-0 file
563 --rom-ts2068-1 file
564 --rom-pentagon-0 file
565 --rom-pentagon-1 file
566 --rom-pentagon-2 file
567 --rom-pentagon512-0 file
568 --rom-pentagon512-1 file
569 --rom-pentagon512-2 file
570 --rom-pentagon512-3 file
571 --rom-pentagon1024-0 file
572 --rom-pentagon1024-1 file
573 --rom-pentagon1024-2 file
574 --rom-pentagon1024-3 file
575 --rom-scorpion-0 file
576 --rom-scorpion-1 file
577 --rom-scorpion-2 file
578 --rom-scorpion-3 file
579 --rom-spec-se-0 file
580 --rom-spec-se-1 file
581 Specify the file to be used for ROM(s) used for each machine.
582 The options respectively refer to the 16K Spectrum (48.rom),
583 48K Spectrum (48.rom), the two ROMs for the 128K Spectrum
584 (128-0.rom and 128-1.rom), the two ROMs for the +2 (plus2-0.rom
585 and plus2-1.rom), the four ROMs for the +2A (plus3-0.rom,
586 plus3-1.rom, plus3-2.rom and plus3-3.rom), the four ROMs for the
587 +3 (plus3-0.rom, plus3-1.rom, plus3-2.rom and plus3-3.rom), the
588 four enhanced ROMs for the +3e (plus3e-0.rom, plus3e-1.rom,
589 plus3e-2.rom and plus3e-3.rom), the TC2048 ROM (tc2048.rom), the
590 two ROMs for the TC2068 (tc2068-0.rom and tc2068-1.rom), the two
591 ROMs for the TS2068 (tc2068-0.rom and tc2068-1.rom), the two
592 main ROMs and the TR-DOS ROM for the Pentagon 128K (128p-0.rom,
593 128p-1.rom and trdos.rom), the two main ROMs, the TR-DOS ROM and
594 a reset service ROM for the Pentagon 512K and 1024K (128p-0.rom,
595 128p-1.rom, trdos.rom and gluck.rom), the four ROMs for the
596 Scorpion 256 (256s-0.rom, 256s-1.rom, 256s-2.rom and
597 256s-3.rom), and the two ROMs for the Spectrum SE (se-0.rom and
598 se-1.rom).
599
600 The names in brackets denote the defaults. Note that not all
601 these ROMs are supplied with Fuse — you must supply your own
602 copies of those which are not.
603
604 --rom-interface-1 file
605 --rom-beta128 file
606 --rom-plusd file
607 --rom-didaktik80 file
608 --rom-disciple file
609 --rom-multiface1 file
610 --rom-multiface128 file
611 --rom-multiface3 file
612 --rom-opus file
613 --rom-speccyboot file
614 --rom-usource file
615 Specify the file to be used for ROM(s) used for each peripheral.
616 The options respectively refer to the Interface 1 ROM
617 (if1-2.rom), the TR-DOS ROM for Beta 128 emulation with the 48K,
618 TC2048, 128K or +2 (trdos.rom), the +D ROM (plusd.rom), the
619 Didaktik 80 ROM (didaktik80.rom), the DISCiPLE ROM (disci‐
620 ple.rom), the Multiface One ROM (mf1.rom), the Multiface 128 ROM
621 (mf128.rom), the Multiface 3 ROM (mf3.rom), the Opus Discovery
622 ROM (opus.rom), the SpeccyBoot ROM (speccyboot-1.4.rom), and the
623 µSource ROM (usource.rom).
624
625 The names in brackets denote the defaults. Note that not all
626 these ROMs are supplied with Fuse — you must supply your own
627 copies of those which are not.
628
629 --no-rs232-handshake
630 This option makes Fuse's Interface 1 emulation assume that the
631 RS-232 line other end is live when you connect the communication
632 channels. See also the `--rs232-rx' and `--rs232-tx' options.
633
634 --rs232-rx
635 --rs232-tx
636 Specify the communication channels (FIFO or file) to be used for
637 Interface 1 RS-232 emulation as RxD and TxD wire. See also the
638 `--rs232-handshake' options.
639
640 --rzx-autosaves
641 Specify that, while recording an RZX file, Fuse should automati‐
642 cally add a snapshot to the recording stream every 5 seconds.
643 (Default to on, but you can use `--no-rzx-autosaves' to dis‐
644 able). Same as the RZX Options dialog's Create autosaves option;
645 see there for more details.
646
647 --sdl-fullscreen-mode mode
648 Select a screen resolution for full screen mode. Available val‐
649 ues for mode are listed in a table, when Fuse is called with
650 --sdl-fullscreen-mode list command line option. This option is
651 effective only under the SDL UI.
652
653 --separation type
654 Give stereo separation of the 128's AY sound channels. Same as
655 the General Options dialog's AY stereo separation option. The
656 available options are None, ACB, and ABC. The default option is
657 None.
658
659 --simpleide
660 Specify whether Fuse will emulate the simple 8-bit IDE interface
661 as used by the Spectrum +3e. Same as the Disk Peripherals
662 Options dialog's Simple 8-bit IDE option.
663
664 --simpleide-masterfile file
665 Specify a HDF file to connect to the emulated Simple 8-bit IDE
666 interface's master channel.
667
668 --simpleide-slavefile file
669 Specify a HDF file to connect to the emulated Simple 8-bit IDE
670 interface's slave channel.
671
672 --slt
673 Support the SLT trap instruction. (Enabled by default, but you
674 can use `--no-slt' to disable). Same as the Media Options dia‐
675 log's Use .slt traps option.
676
677 -s file
678 --snapshot file
679 Specify a snapshot file to load. The file can be in any snapshot
680 format supported by libspectrum(3).
681
682 --sound
683 Specify whether Fuse should produce sound. (Enabled by default,
684 but you can use `--no-sound' to disable). Same as the Sound
685 Options dialog's Sound enabled option.
686
687 -d device
688 --sound-device device
689 Specify the sound output device to use and any options to give
690 that device. If you are not using the SDL UI or using libao or
691 libasound (ALSA) for sound output, then the device parameter
692 just specifies the device to be used for sound output.
693
694 If you are using the SDL UI, the device parameter allows you to
695 specify the audio driver to be used (e.g. dsp, alsa, dma, esd
696 and arts).
697
698 If you are using libao for sound output, the device parameter
699 allows you to specify the device used for sound output (either
700 `live' to a speaker or to a file) and the parameters to be used
701 for that device. In general, the device parameter has the form
702 driver[:param[=value][,param[=value][,...]]. driver selects the
703 libao driver to be used, either one of the `live' drivers (aixs,
704 alsa, alsa09, arts, esd, irix, macosx, nas, oss or sun) or a
705 file driver (au, raw, wav or null). The available parameter and
706 value pairs for each device are:
707
708 · aixs: AIX audio system
709
710 · dev=device
711 `device' gives the AIX sound device.
712
713 · alsa: Advanced Linux Sound Architecture version 0.5.x
714
715 · card=num
716 `num' gives the ALSA card number.
717
718 · dev=num
719 `num' gives the ALSA device number.
720
721 · buf_size=num
722 `num' gives the ALSA buffer size in bytes.
723
724 · alsa09: Advanced Linux Sound Architecture version 0.9+
725
726 · dev=string
727 `string' specifies the ALSA device e.g. hw:1.2
728
729 · buffer_time=num
730 `num' gives the ALSA buffer time in microseconds.
731
732 · period_time=num
733 `num' gives the ALSA period time in microseconds.
734
735 · use_mmap=yes|y|true|t|1
736 specifies that libao use memory mapped transfer.
737
738 · arts: aRts soundserver: no parameters.
739
740 · esd: Enlightened Sound Daemon.
741
742 · host=string
743 `string' gives the ESD host specification.
744
745 · irix: IRIX Audio Library: no parameters.
746
747 · macosx: MacOS X CoreAudio: no parameters.
748
749 · nas: Network Audio System.
750
751 · host=string
752 `string' gives the NAS host specification.
753
754 · buf_size=num
755 `num' gives the buffer size on the server.
756
757 · oss: Open Sound System.
758
759 · dsp=string
760 `string' gives the OSS device to be used e.g.
761 /dev/sound/dsp1
762
763 · sun: SUN audio system.
764
765 · dev=string
766 `string' gives the audio device to be used.
767
768 · au: SUN Sparc audio file: no parameters.
769
770 · raw: raw file.
771
772 · byteorder=string
773 `string' can be any of native (host native byte‐
774 order), big (big endian) or little (little
775 endian).
776
777 · wav: Microsoft audio file: no parameters.
778
779 · null: null output: no parameters.
780
781 · debug: for debugging libao.
782
783 Finally, each of the file output types (au, raw and wav) have an
784 extra option `file=filename' where `filename' gives the file
785 output will be directed to. This defaults to `fuse-sound.ao' if
786 it is not specified.
787
788 Some examples of use:
789
790 fuse -d alsa09:dev=hw:1
791
792 causes Fuse to use ALSA 0.9+ output with the second (#1) sound
793 card.
794
795 fuse -d raw:byteorder=little,file=enigma.raw
796
797 causes Fuse to save little endian words to `enigma.raw'.
798
799 See the `DEVICE' section of ogg123(1) for up to date information
800 of devices and options (except for the `file' option which is
801 provided by Fuse itself).
802
803 If you are using libasound or ALSA for sound output, the device
804 parameter allows you to specify the device used for sound output
805 and some parameters to be used for that device. In general, the
806 device parameter has the form
807 devstr or
808 param[=value][,param[=value][,...][,devstr].
809
810 · devstr: selects the ALSA device used, it can be any com‐
811 plex or simple ALSA device name. e.g.: default or hw:0 or
812 tee:plughw:0,'/tmp/out.raw',raw. See the alsa-lib pcm
813 api reference at
814 http://www.alsa-project.org/alsa-doc/alsa-lib/pcm.html
815 for further explanation.
816
817 · param and values:
818
819 · buffer=nnnn: set the ALSA buffer in frames,
820 smaller value cause smaller sound delay but may
821 more buffer underrun (pops and clicks), larger
822 value cause longer delay but fewer underrun. By
823 default Fuse determine the buffer size based on
824 the actual sound frequency.
825
826 If you use some special plugin for your pcm device
827 (e.g.: dmix) or your card not support some needed
828 parameter (e.g. cannot play other only 48 kHz
829 stereo sound like some AC97 sound card) may cause
830 Fuse unable to set the needed buffer size, appro‐
831 priate sound frequency, channels and so on, there‐
832 fore you cannot get optimal result or not hear the
833 sound at all. In this case try the plughw:#,
834 (where # mean your card number counted from 0) for
835 ALSA device.
836
837 · verbose : if given, fuse report ALSA buffer under‐
838 runs to stderr.
839
840 Some examples of use:
841
842 fuse -d verbose,buffer=2000
843
844 causes Fuse to use the default ALSA device with 2000 frame
845 length buffer and report ALSA buffer underruns on stderr.
846
847 fuse -d tee:plughw:0,'/tmp/aufwm.raw',raw
848
849 causes Fuse to use the first card and parallel save the raw
850 audio samples into /tmp/aufwm.raw file.
851
852 --sound-force-8bit
853 Force the use of 8-bit sound, even if 16-bit is possible. Same
854 as the Sound Options dialog's Force 8-bit option.
855
856 -f frequency
857 --sound-freq frequency
858 Specify what frequency Fuse should use for the sound device, the
859 default is 44.1 kHz, but some devices only support a single fre‐
860 quency or a limited range (e.g. 48 kHz or up to 22 kHz).
861
862 --speaker-type type
863 Select the output speaker emulation, type can be TV speaker,
864 Beeper or Unfiltered. Same as the Sound Options dialog's Speaker
865 type option.
866
867 --speccyboot
868 Emulate a SpeccyBoot Ethernet interface. Same as the General
869 Peripherals Options dialog's SpeccyBoot option. See the Speccy‐
870 Boot web page at http://patrikpersson.github.io/speccyboot/ for
871 full details on the SpeccyBoot.
872
873 --speccyboot-tap device
874 Specify the TAP device to use for SpeccyBoot emulation.
875
876 --specdrum
877 Emulate a SpecDrum interface. Same as the General Peripherals
878 Options dialog's SpecDrum option. See the World of Spectrum
879 Infoseek web page at http://www.worldofspectrum.org/infos‐
880 eekid.cgi?id=1000062 for manuals, software and more.
881
882 --spectranet
883 Specify whether Fuse will emulate the Spectranet Ethernet inter‐
884 face. Same as the General Peripherals Options dialog's Spec‐
885 tranet option. See the SPECTRANET EMULATION section for more
886 details.
887
888 --spectranet-disable
889 This option controls the state of the Spectranet automatic page-
890 in jumper (J2). Same as the General Peripherals Options dialog's
891 Spectranet disable option. See the SPECTRANET EMULATION section
892 for more details.
893
894 --speed percentage
895 Specify the speed (as a percentage of real Spectrum speed) at
896 which emulation should attempt to proceed. Same as the General
897 Options dialog's Emulation speed option.
898
899 --statusbar
900 For the GTK+ and Win32 UI, enables the statusbar beneath the
901 display. For the Xlib and SDL UI, enables the status icons show‐
902 ing whether the disk and tape are being accessed. Same as the
903 General Options dialog's Show statusbar option.
904
905 --strict-aspect-hint
906 For the GTK+ UI, use stricter limits for the aspect ratio limits
907 set by the `--aspect-hint' option. This can cause some window
908 managers (for example, metacity(1)) to not allow the window to
909 be resized and moved, but is necessary to prevent others (for
910 example, fvwm(1)) from being able resize the window away from
911 square.
912
913 --svga-modes mode1,mode2,mode3
914 Specify which SVGA mode to use for the SVGAlib UI at different
915 screen sizes. Available values for mode1, mode2 and mode3 are
916 listed in a table, when Fuse called with --svga-modes list com‐
917 mand line option. When user select a not available mode for a
918 size, Fuse just ignore and try to find the best mode for it.
919 e.g. with --svga-modes 0,0,12 Fuse use the specified
920 1024×768×256 SVGA mode for triple size filters, but select SVGA
921 modes automatically for normal or double size filters. The
922 above mode number is just an example, and mode numbers and their
923 meanings may vary graphics card by graphics card.
924
925 -t file
926 --tape file
927 Specify a virtual tape file to use. It must be in PZX, TAP or
928 TZX format.
929
930 --textfile file
931 Set the filename used for text output from the emulated print‐
932 ers. See the PRINTER EMULATION section below for more details.
933
934 --traps
935 Support traps for ROM tape loading/saving. (Enabled by default,
936 but you can use `--no-traps' to disable). Same as the Media
937 Options dialog's Use tape traps option.
938
939 --unittests
940 This option runs a testing framework that automatically checks
941 portions of code, comparing actual results with expected ones.
942 It is meant to detect broken code before a release. There is not
943 graphical mode, the program just ends with exit code 0 if all
944 tests are good or prints error messages to stdout and ends with
945 exit code greater than 0 if there are failed tests.
946
947 --usource
948 Emulate a µSource interface. Same as the General Peripherals
949 Options dialog's µSource option.
950
951 -V
952 --version
953 Show which version of Fuse is being used.
954
955 --volume-ay volume
956 Sets the relative volume of the AY-3-8912 chip from a range of
957 0–100%. Same as the Sound Options dialog's AY volume option.
958
959 --volume-beeper volume
960 Sets the relative volume of the beeper from a range of 0–100%.
961 Same as the Sound Options dialog's Beeper volume option.
962
963 --volume-covox volume
964 Sets the relative volume of the Covox from a range of 0–100%.
965 Same as the Sound Options dialog's Covox volume option.
966
967 --volume-specdrum volume
968 Sets the relative volume of the SpecDrum from a range of 0–100%.
969 Same as the Sound Options dialog's SpecDrum volume option.
970
971 --writable-roms
972 Allow Spectrum programs to overwrite the ROM(s). The same as the
973 General Options dialog's Allow writes to ROM option.
974
975 --zxatasp
976 Specify whether Fuse emulate the ZXATASP interface. Same as the
977 Disk Peripherals Options dialog's ZXATASP interface option.
978
979 --zxatasp-upload
980 Specify the state of the ZXATASP upload jumper. Same as the Disk
981 Peripherals Options dialog's ZXATASP upload option.
982
983 --zxatasp-write-protect
984 Specify the state of the ZXATASP write protect jumper. Same as
985 the Disk Peripherals Options dialog's ZXATASP write protect
986 option.
987
988 --zxatasp-masterfile file
989 Specify a HDF file to connect to the emulated ZXATASP inter‐
990 face's master channel.
991
992 --zxatasp-slavefile file
993 Specify a HDF file to connect to the emulated ZXATASP inter‐
994 face's slave channel.
995
996 --zxcf
997 Specify whether Fuse emulate the ZXCF interface. Same as the
998 Disk Peripherals Options dialog's ZXCF interface option.
999
1000 --zxcf-upload
1001 Specify the state of the ZXCF upload jumper. Same as the Disk
1002 Peripherals Options dialog's ZXCF upload option.
1003
1004 --zxcf-cffile file
1005 Specify a HDF file to connect to the emulated ZXCF interface.
1006
1007 --zxmmc
1008 Emulate the ZXMMC interface. The same as the Disk Peripherals
1009 Options dialog's ZXMMC interface option.
1010
1011 --zxmmc-file file
1012 Specify an HDF image to be loaded into the ZXMMC's emulated mem‐
1013 ory card.
1014
1015 --zxprinter
1016 Emulate the ZX Printer. Same as the General Peripherals Options
1017 dialog's ZX Printer option.
1018
1019 All long options which control on/off settings can be disabled using
1020 `--no-foo' (for an option `--foo'). For example, the opposite of
1021 `--issue2' is `--no-issue2'. These options can also be modified while
1022 the emulator is running, using the options dialogs — see the documenta‐
1023 tion for the Options menu in the MENUS AND KEYS section for details.
1024
1026 Fuse supports various front-ends, or UIs (user interfaces). The usual
1027 one is GTK+-based, but there are also SDL, Win32, Xlib, SVGAlib and
1028 framebuffer ones.
1029
1030 The important difference to note is that GTK+ and Win32 versions uses
1031 `native' dialog boxes etc. (behaving like a fairly normal GUI-based
1032 program) while the others use an alternative, Fuse-specific `widget
1033 UI'. This latter front-end is easily spotted by the way it uses the
1034 main Fuse window/screen for menus and dialogs, and uses the Spectrum's
1035 own font.
1036
1038 Since many of the keys available are devoted to emulation of the Spec‐
1039 trum's keyboard, the primary way of controlling Fuse itself (rather
1040 than the emulated machine) is via the menus. There are also function
1041 key shortcuts for some menu options.
1042
1043 In the GTK+ and Win32 version, the menu bar is always visible at the
1044 top of the Fuse window. You can click on a menu name to pop it up.
1045 Alternatively, you can press F1 to display a pop-up version of the menu
1046 bar, which you can then navigate with the cursor keys or mouse.
1047
1048 In the widget UI pressing F1 is the only way to get the main menu; and
1049 unlike the GTK+ version, the emulator pauses while the menus are being
1050 navigated. The menus show which key to press for each menu option in
1051 brackets. Pressing Esc exits a menu, and pressing Enter exits the menu
1052 system entirely (as well as `confirming' any current dialog).
1053
1054 Here's what the menu options do, along with the function key mappings
1055 for those items which have them:
1056
1057 F3
1058 File, Open...
1059 Open a Spectrum file. Snapshots will be loaded into memory; tape
1060 images will be inserted into the emulated tape deck, and if the
1061 Auto-load media option is set will being loading. Opening a disk
1062 image or a Timex dock image will cause the appropriate machine
1063 type (+3, Pentagon or TC2068) to be selected with the image
1064 inserted, and disks will automatically load if the Auto-load
1065 media option is set. See the FILE SELECTION section below for
1066 details on how to choose the file. Note that this behaviour is
1067 different from previous versions of Fuse, when this option would
1068 open only snapshots.
1069
1070 F2
1071 File, Save Snapshot...
1072 Save a snapshot (machine state, memory contents, etc.) to file.
1073 You can select the filename to be saved to. If it has a .szx,
1074 .z80 or .sna extension, the snapshot will be saved in that for‐
1075 mat. Otherwise, it will be saved as a .szx file.
1076
1077 File, Recording, Record...
1078 Start recording input to an RZX file, initialised from the cur‐
1079 rent emulation state. You will be prompted for a filename to
1080 use.
1081
1082 File, Recording, Record from snapshot...
1083 Start recording input to an RZX file, initialised from a snap‐
1084 shot. You will first be asked for the snapshot to use and then
1085 the file to save the recording to.
1086
1087 File, Recording, Continue recording...
1088 Continue recording input into an existing RZX file from the last
1089 recorded state. Finalised recordings cannot be resumed. You will
1090 be prompted for the recording to continue.
1091
1092 Insert
1093 File, Recording, Insert snapshot
1094 Inserts a snapshot of the current state into the RZX file. This
1095 can be used at a later point to roll back to the inserted state
1096 by using one of the commands below.
1097
1098 Delete
1099 File, Recording, Rollback
1100 Rolls back the recording to the point at which the previous
1101 snapshot was inserted. Recording will continue from that point.
1102
1103 File, Recording, Rollback to...
1104 Roll back the recording to any snapshot which has been inserted
1105 into the recording.
1106
1107 File, Recording, Play...
1108 Playback recorded input from an RZX file. This lets you replay
1109 keypresses recorded previously. RZX files generally contain a
1110 snapshot with the Spectrum's state at the start of the record‐
1111 ing; if the selected RZX file doesn't, you'll be prompted for a
1112 snapshot to load as well.
1113
1114 File, Recording, Stop
1115 Stop any currently-recording/playing RZX file.
1116
1117 File, Recording, Finalise...
1118 Compact a RZX file. Any interspersed snapshot will be removed
1119 and the recording cannot be continued. All action replays sub‐
1120 mitted to the RZX Archive should be finalised.
1121
1122 File, AY Logging, Record...
1123 Start recording the bytes output via the AY-3-8912 sound chip to
1124 a PSG file. You will be prompted for a filename to save the
1125 recording to.
1126
1127 File, AY Logging, Stop
1128 Stop any current AY logging.
1129
1130 File, Screenshot, Open SCR Screenshot...
1131 Load an SCR screenshot (essentially just a binary dump of the
1132 Spectrum's video memory) onto the current screen. Fuse supports
1133 screenshots saved in the Timex hi-colour and hi-res modes as
1134 well as `normal' Spectrum screens, and will make a simple con‐
1135 version if a hi-colour or hi-res screenshot is loaded onto a
1136 non-Timex machine.
1137
1138 File, Screenshot, Save Screen as SCR...
1139 Save a copy of whatever's currently displayed on the Spectrum's
1140 screen as an SCR file. You will be prompted for a filename to
1141 save the screenshot to.
1142
1143 File, Screenshot, Open MLT Screenshot...
1144 Load an MLT screenshot onto the current screen. The MLT format
1145 is similar to the SCR format but additionally supports capturing
1146 images that use techniques to display more than two colours in
1147 each Spectrum attribute square. Fuse will only load the bitmap
1148 version of an image on a Sinclair machine but on a Timex clone
1149 it can show the full colour detail captured in the image by
1150 using the hi-colour mode.
1151
1152 File, Screenshot, Save Screen as MLT...
1153 Save a copy of whatever's currently displayed on the Spectrum's
1154 screen as an MLT file. You will be prompted for a filename to
1155 save the screenshot to.
1156
1157 File, Screenshot, Save Screen as PNG...
1158 Save the current screen as a PNG file. You will be prompted for
1159 a filename to save the screenshot to.
1160
1161 File, Scalable Vector Graphics, Start capture in line mode...
1162 Start trapping the video output functions present in ROM to copy
1163 the picture to SVG files, thus creating vectorized scalable pic‐
1164 ture; it is expected to be fully operational in BASIC only, but
1165 few machine code programs could work, if they use the ROM
1166 addresses to output text or graphics. The initial picture size
1167 is 256×176, but it is increased everytime a `scroll' happens. On
1168 every CLS a new file will be created, with an increasing
1169 sequence number. CIRCLEs will be described as a sequence of
1170 lines, so the original `imprecisions' will be still visible.
1171 The text output will be fully understood and decoded: normal
1172 ASCII characters will be converted into COURIER scalable fonts,
1173 UDG graphics into dot matrix areas, GRAPHICS blocky characters
1174 into small squares. A slightly transparent output permits to
1175 show a bit of the overlapped text and graphics elements. Lower
1176 portion of the screen (normally bound to stream #0 and #1) won't
1177 be captured.
1178
1179 File, Scalable Vector Graphics, Start capture in dot mode...
1180 As above, but line capture is disabled. A line will be rendered
1181 as a sequence of dots.
1182
1183 File, Scalable Vector Graphics, Stop capture
1184 Stop the SVG capture function.
1185
1186 File, Movie, Record...
1187 Fuse can record movie (video and audio) into a file with special
1188 format which can be converted later to a common video file for‐
1189 mat with the fmfconv(1) utility. You will be prompted for a
1190 filename to save video. Please see MOVIE RECORDING section.
1191
1192 File, Movie, Record from RZX...
1193 Start movie recording and RZX playback at the same time. You
1194 will be prompted for a filename to play from and a filename to
1195 save video.
1196
1197 File, Movie, Pause
1198 Pause movie recording which is currently in progress.
1199
1200 File, Movie, Continue
1201 Resume movie recording which has been previously paused.
1202
1203 File, Movie, Stop
1204 Stop movie recording which is currently in progress.
1205
1206 File, Load Binary Data...
1207 Load binary data from a file into the Spectrum's memory. After
1208 selecting the file to load data from, you can choose where to
1209 load the data and how much data to load.
1210
1211 File, Save Binary Data...
1212 Save an arbitrary chunk of the Spectrum's memory to a file.
1213 Select the file you wish to save to, followed by the location
1214 and length of data you wish to save.
1215
1216 F10
1217 File, Exit
1218 Exit the emulator. A confirmation dialog will appear checking
1219 you actually want to do this.
1220
1221 F4
1222 Options, General...
1223 Display the General Options dialog, letting you configure Fuse.
1224 (With the widget UI, the keys shown in brackets toggle the
1225 options, Enter confirms any changes, and Esc aborts). Note that
1226 any changed settings only apply to the currently-running Fuse.
1227
1228 The options available are:
1229
1230 Emulation speed
1231 Set how fast Fuse will attempt to emulate the Spectrum,
1232 as a percentage of the speed at which the real machine
1233 runs. If your machine isn't fast enough to keep up with
1234 the requested speed, Fuse will just run as fast as it
1235 can. Note that if the emulation speed is faster than
1236 500%, no sound output will be produced.
1237
1238 Frame rate
1239 Specify the frame rate, the ratio of spectrum frame
1240 updates to real frame updates. This is useful if your
1241 machine is having trouble keeping up with the spectrum
1242 screen updates.
1243
1244 Issue 2 keyboard
1245 Early versions of the Spectrum used a different value for
1246 unused bits on the keyboard input ports, and a few games
1247 depended on the old value of these bits. Enabling this
1248 option switches to the old value, to let you run them.
1249
1250 Recreated ZX Spectrum
1251 Enable the use of a Recreated ZX Spectrum in `Layer A'
1252 (game) mode. This is a Bluetooth keyboard that can be
1253 paired to the device where Fuse is running.
1254
1255 Use shift with arrow keys
1256 Treat the keyboard arrow keys as shifted like the ZX
1257 Spectrum+ keyboard's arrow keys or as unshifted like a
1258 cursor joystick that maps to the 5, 6, 7 and 8 keys.
1259
1260 Allow writes to ROM
1261 If this option is selected, Fuse will happily allow pro‐
1262 grams to overwrite what would normally be ROM. This prob‐
1263 ably isn't very useful in most circumstances, especially
1264 as the 48K ROM overwrites parts of itself.
1265
1266 Late timings
1267 If selected, Fuse will cause all screen-related timings
1268 (for example, when the screen is rendered and when memory
1269 contention occurs) to be one tstate later than “normal”,
1270 an effect which is present on some real hardware.
1271
1272 Z80 is CMOS
1273 If selected, Fuse will emulate a CMOS Z80, as opposed to
1274 an NMOS Z80. The undocumented `OUT (C),0' instruction
1275 will be replaced with `OUT (C),255' and emulation of a
1276 minor timing bug in the NMOS Z80's `LD A,I' and `LD A,R'
1277 instructions will be disabled.
1278
1279 RS-232 handshake
1280 If you turn this option off, Fuse assumes the RS-232 line
1281 other end is live when you connect the communication
1282 channels. See also the `--rs232-rx' and `--rs232-tx'
1283 options.
1284
1285 Black and white TV
1286 This option allows you to choose whether to simulate a
1287 colour or black and white television. This is effective
1288 only under the GTK+, Win32, Xlib and SDL user interfaces:
1289 the others will always simulate a colour TV.
1290
1291 PAL-TV use TV2x effect
1292 This option allows you to choose whether the PAL TV 2x
1293 and higher scalers also reproduce scanlines in the same
1294 way as the TV 2x, TV 3x and Timex TV scalers.
1295
1296 Show statusbar
1297 For the GTK+ and Win32 UI, enables the statusbar beneath
1298 the display. For the SDL UI, enables the status icons
1299 showing whether the disk and tape are being accessed.
1300 This option has no effect for the other user interfaces.
1301
1302 Snap joystick prompt
1303 If set, Fuse will prompt you which physical joystick or
1304 keyboard you want to connect to the joystick interface
1305 enabled in the snapshot unless it already matches your
1306 current configuration.
1307
1308 Confirm actions
1309 Specify whether `dangerous' actions (those which could
1310 cause data loss, for example resetting the Spectrum)
1311 require confirmation before occurring.
1312
1313 Auto-save settings
1314 If this option is selected, Fuse will automatically write
1315 its currently selected options to its configuration file
1316 on exit (either in xml format if libxml2 was available
1317 when Fuse was compiled or plain text). If this option is
1318 off, you'll have to manually use Options, Save afterwards
1319 to ensure that this setting gets written to Fuse's con‐
1320 figuration file. Note that if you turn this option on,
1321 loading a snapshot could enable peripherals that would be
1322 written permanently to the configuration file.
1323
1324 Options, Media...
1325 Display the Media Options dialog, letting you configure Fuse's
1326 tape and Microdrive options. (With the widget UI, the keys shown
1327 in brackets toggle the options, Enter confirms any changes, and
1328 Esc aborts). Note that any changed settings only apply to the
1329 currently-running Fuse.
1330
1331 Auto-load media
1332 On many occasions when you open a tape or disk file, it's
1333 because it's got a program in you want to load and run.
1334 If this option is selected, this will automatically hap‐
1335 pen for you when you open one of these files using the
1336 File, Open... menu option — you must then use the Media
1337 menu to use tapes or disks for saving data to, or for
1338 loading data into an already running program.
1339
1340 Detect loaders
1341 If this option is enabled, Fuse will attempt to detect
1342 when a loading routine is in progress, and then automati‐
1343 cally start the virtual tape to load the program in. This
1344 is done by using a heuristic to identify a loading rou‐
1345 tine, so is by no means infallible, but works in most
1346 cases.
1347
1348 Phantom typist mode
1349 Specify the keystroke sequence that the "phantom typist"
1350 should use when starting a program loading. Available
1351 options are
1352
1353 Auto
1354
1355 Keyword
1356
1357 Keystroke
1358
1359 Menu
1360
1361 Plus 2A
1362
1363 Plus 3
1364
1365 The first four of these correspond to automatic detection
1366 based on machine model, keyword based entry, keystroke
1367 based entry, and selection from a 128K style menu. Plus
1368 2A and Plus 3 also correspond to selection from a 128K
1369 style menu, but have special handling for games which
1370 need to be loaded with `LOAD ""CODE'. The most likely use
1371 for this option will be use Keystroke if you have changed
1372 the default 48K ROM for one with keystroke entry.
1373
1374 Fastloading
1375 If this option is enabled, then Fuse will run at the
1376 fastest possible speed when the virtual tape is playing,
1377 thus dramatically reducing the time it takes to load pro‐
1378 grams. You may wish to disable this option if you wish to
1379 stop the tape at a specific point.
1380
1381 Use tape traps
1382 Ordinarily, Fuse intercepts calls to the ROM tape-loading
1383 routine in order to load from tape files more quickly
1384 when possible. But this can (rarely) interfere with TZX
1385 loading; disabling this option avoids the problem at the
1386 cost of slower (i.e. always real-time) tape-loading.
1387 When tape-loading traps are disabled, you need to start
1388 tape playback manually, by pressing F8 or choosing the
1389 Media, Tape, Play menu item. Fuse also uses tape traps to
1390 intercept the tape-saving routine in the ROM to save tape
1391 files quickly, tapes can also be saved using the Media,
1392 Tape, Record Start menu item.
1393
1394 Accelerate loaders
1395 If this option is enabled, then Fuse will attempt to
1396 accelerate tape loaders by “short circuiting” the loading
1397 loop. This will in general speed up loading, but may
1398 cause some loaders to fail.
1399
1400 Use .slt traps
1401 The multi-load aspect of SLT files requires a trap
1402 instruction to be supported. This instruction is not gen‐
1403 erally used except for this trap, but since it's not
1404 inconceivable that a program could be wanting to use the
1405 real instruction instead, you can choose whether to sup‐
1406 port the trap or not.
1407
1408 MDR cartridge len
1409 This option controls the number of blocks in a new Micro‐
1410 drive cartridge. If the value smaller than 10 or greater
1411 than 254 Fuse assumes 10 or 254. Average real capacity
1412 is around 180 blocks (90 Kb).
1413
1414 Random length MDR cartridge
1415 If this option is enabled, Fuse will use a random Micro‐
1416 drive cartridge length (around 180 blocks) instead of the
1417 length specified in the MDR cartridge len option.
1418
1419 Options, Sound...
1420 Display the Sound Options dialog, letting you configure Fuse's
1421 sound output. (With the widget UI, the keys shown in brackets
1422 toggle the options, Enter confirms any changes, and Esc aborts).
1423 Note that any changed settings only apply to the currently-run‐
1424 ning Fuse.
1425
1426 Sound enabled
1427 Specify whether sound output should be enabled at all.
1428 When this option is disabled, Fuse will not make any
1429 sound.
1430
1431 Loading sound
1432 Normally, Fuse emulates tape-loading noise when loading
1433 from PZXs, TAPs or TZXs in real-time, albeit at a delib‐
1434 erately lower volume than on a real Spectrum. You can
1435 disable this option to eliminate the loading noise
1436 entirely.
1437
1438 AY stereo separation
1439 By default, the sound output is mono, since this is all
1440 you got from an unmodified Spectrum. But enabling this
1441 option gives you so-called ACB stereo (for sound from the
1442 128 and other clone's AY-3-8912 sound chip).
1443
1444 Force 8-bit
1445 Force the use of 8-bit sound even if 16-bit (the default)
1446 is available. Note that (when the option is enabled) if
1447 8-bit sound isn't available then there will be no sound
1448 at all, so it's best not to use this option unless you
1449 have a specific need for it.
1450
1451 Speaker type
1452 This option allows the emulation of the sound output sys‐
1453 tem to be modified. Different choices of speaker limit
1454 the bass and treble response that can be produced from
1455 the machine. Choose between a “TV” type speaker and a
1456 small “Beeper” type speaker that significantly limits
1457 bass and treble response. Choose “Unfiltered” to get
1458 unmodified (but less accurate) sound output.
1459
1460 AY volume
1461 Sets the relative volume of the AY-3-8912 chip from a
1462 range of 0–100%.
1463
1464 Beeper volume
1465 Sets the relative volume of the beeper from a range of
1466 0–100%.
1467
1468 Covox volume
1469 Sets the relative volume of the Covox from a range of
1470 0–100%.
1471
1472 SpecDrum volume
1473 Sets the relative volume of the SpecDrum from a range of
1474 0–100%.
1475
1476 Options, Peripherals, General...
1477 Display the General Peripherals Options dialog, letting you con‐
1478 figure the peripherals which Fuse will consider to be attached
1479 to the emulated machine. (With the widget UI, the keys shown in
1480 brackets toggle the options, Enter confirms any changes, and Esc
1481 aborts). Note that any changed settings only apply to the cur‐
1482 rently-running Fuse. Also note that any changes that enable and
1483 disable peripherals may result in a hard reset of the emulated
1484 machine.
1485
1486 Kempston joystick
1487 If this option is selected, Fuse will emulate a Kempston
1488 joystick interface (probably the most widely supported
1489 type on the Spectrum). Note that this option is basi‐
1490 cally equivalent to plugging the interface itself into a
1491 Spectrum, not to connecting a joystick; this affects how
1492 the Spectrum responds to a read of input port 31. To use
1493 a Kempston joystick in a game, this option must be
1494 enabled, and you must also select a Kempston joystick the
1495 Options, Joysticks menu.
1496
1497 Kempston mouse
1498 If this option is selected, Fuse will emulate a Kempston
1499 mouse interface.
1500
1501 If you're using Fuse full-screen, your mouse is automati‐
1502 cally used as if attached to the Kempston interface. Oth‐
1503 erwise, you'll need to click on the Spectrum display in
1504 order to tell Fuse to grab the pointer (and make it
1505 invisible); to tell Fuse to release it, click the middle
1506 button (or wheel) or press Escape.
1507
1508 With the framebuffer UI, Fuse prefers to use GPM; if this
1509 is not available, it will fall back to built-in PS/2
1510 mouse support. In this mode, it tries /dev/input/mice,
1511 /dev/mouse then /dev/psaux, stopping when it successfully
1512 opens one. The first of these is preferred since (at
1513 least on Linux, with a 2.6-series kernel) any type of
1514 mouse can be used and any connected mouse may be used.
1515
1516 Swap mouse buttons
1517 If this option is enabled, the left and right mouse but‐
1518 tons will be swapped when emulating a Kempston mouse.
1519
1520 Fuller Box
1521 If this option is selected, Fuse will emulate a Fuller
1522 Box AY sound and joystick interface. This emulation is
1523 only available for the 16k, 48k and TC2048 machines.
1524
1525 Melodik
1526 If this option is selected, Fuse will emulate a Melodik
1527 AY sound interface. These interfaces and many similar
1528 ones were produced to make the 48K Spectrum compatible
1529 with the same AY music as the 128K Spectrum. This emula‐
1530 tion is only available for the 16k, 48k and TC2048
1531 machines.
1532
1533 Interface 1
1534 If this option is selected, Fuse will emulate the simple
1535 Sinclair Interface 1, and allow Microdrive cartridges to
1536 be connected and disconnected via the Media, Interface 1,
1537 Microdrive menus. It also enables support for the Inter‐
1538 face 1 RS-232 interface.
1539
1540 Interface 2
1541 If this option is selected, Fuse will emulate a cartridge
1542 port as found on the Interface 2. Cartridges can then be
1543 inserted and removed via the Media, Cartridge, Inter‐
1544 face 2 menu. Note that the Pentagon, Scorpion, Inter‐
1545 face 2, ZXATASP and ZXCF all use the same hardware mecha‐
1546 nism for accessing some of their extended features, so
1547 only one of these should be selected at once or unpre‐
1548 dictable behaviour will occur.
1549
1550 Multiface One
1551 If this option is selected, Fuse will emulate the Roman‐
1552 tic Robot Multiface One. Available for 16K, 48K and
1553 Timex TC2048 machines.
1554
1555 Multiface 128
1556 If this option is selected, Fuse will emulate the Roman‐
1557 tic Robot Multiface 128. Available for 16K, 48K, Timex
1558 TC2048, 128K, +2 and SE machines.
1559
1560 Multiface 3
1561 If this option is selected, Fuse will emulate the Roman‐
1562 tic Robot Multiface 3. Available for +2A, +3 and +3e
1563 machines.
1564
1565 Stealth Multiface One
1566 This option controls the `invisible' or `stealth' mode of
1567 Multiface One, as the physical switch on the side of the
1568 interface.
1569
1570 Emulate printers
1571 If this option is selected, Fuse will emulate a printer.
1572 See the PRINTER EMULATION section for more details.
1573
1574 ZX Printer
1575 If this option is selected, Fuse will emulate the ZX
1576 Printer. See the PRINTER EMULATION section for more
1577 details.
1578
1579 SpeccyBoot interface
1580 If this option is selected, Fuse will emulate a Speccy‐
1581 Boot interface which allows booting a ZX Spectrum over an
1582 Ethernet network. See the SpeccyBoot web page at
1583 http://patrikpersson.github.io/speccyboot/ for more
1584 details.
1585
1586 SpecDrum interface
1587 If this option is selected, Fuse will emulate a Cheetah
1588 SpecDrum sound interface. See the World of Spectrum
1589 Infoseek web page at http://www.worldofspec‐
1590 trum.org/infoseekid.cgi?id=1000062 for manuals, software
1591 and more. This emulation is only available for the 48k,
1592 128k and TC2048 machines.
1593
1594 Spectranet
1595 If this option is selected, Fuse will emulate the Spec‐
1596 tranet interface, which provides an Ethernet interface
1597 for the Spectrum. See the SPECTRANET EMULATION section
1598 for more details.
1599
1600 Spectranet disable
1601 This option controls the state of the Spectranet auto‐
1602 matic page-in jumper (J2). See the SPECTRANET EMULATION
1603 section for more details.
1604
1605 µSource
1606 If this option is selected, Fuse will emulate a Currah
1607 µSource interface. See the World of Spectrum Infoseek
1608 web page at http://www.worldofspectrum.org/infos‐
1609 eekid.cgi?id=1000080 for the manual.
1610
1611 Covox interface
1612 If this option is selected, Fuse will emulate a Covox
1613 digital sound interface. This emulation is only available
1614 for the Pentagon, Pentagon 512k, Pentagon 1024k and Scor‐
1615 pion machines. The Pentagon variants use port 0xfb and
1616 the Scorpion version uses port 0xdd.
1617
1618 Options, Peripherals, Disk...
1619 Display the Disk Peripherals Options dialog, letting you config‐
1620 ure the disk interface peripherals which Fuse will consider to
1621 be attached to the emulated machine. (With the widget UI, the
1622 keys shown in brackets toggle the options, Enter confirms any
1623 changes, and Esc aborts). Note that any changed settings only
1624 apply to the currently-running Fuse. Also note that any changes
1625 that enable and disable peripherals may result in a hard reset
1626 of the emulated machine.
1627
1628 Simple 8-bit IDE
1629 If this option is selected, Fuse will emulate the simple
1630 8-bit IDE interface as used by the Spectrum +3e, and
1631 allow hard disks to be connected and disconnected via the
1632 Media, IDE, Simple 8-bit menu.
1633
1634 ZXATASP interface
1635 If this option is selected, Fuse will emulate the ZXATASP
1636 interface, which provides both additional RAM and an IDE
1637 interface. See the ZXATASP AND ZXCF section for more
1638 details.
1639
1640 ZXATASP upload
1641 This option controls the state of the ZXATASP upload
1642 jumper. See the ZXATASP AND ZXCF section for more
1643 details.
1644
1645 ZXATASP write protect
1646 This option controls the state of the ZXATASP write pro‐
1647 tect jumper. See the ZXATASP AND ZXCF section for more
1648 details.
1649
1650 ZXCF interface
1651 If this option is selected, Fuse will emulate the ZXCF
1652 interface, which provides both additional RAM and a Com‐
1653 pactFlash interface. See the ZXATASP AND ZXCF section for
1654 more details.
1655
1656 ZXCF upload
1657 This option controls the state of the ZXCF upload jumper.
1658 See the ZXATASP AND ZXCF section for more details.
1659
1660 ZXMMC interface
1661 If this option is selected, Fuse will emulate the ZXMMC
1662 interface. Available for +2A, +3 and +3e machines.
1663
1664 DivIDE interface
1665 If this option is selected, Fuse will emulate the DivIDE
1666 interface. See the DIVIDE section for more details.
1667
1668 DivIDE write protect
1669 This option controls the state of the DivIDE write pro‐
1670 tection jumper. See the DIVIDE section for more details.
1671
1672 DivMMC interface
1673 If this option is selected, Fuse will emulate the DivMMC
1674 interface. See the DIVMMC section for more details.
1675
1676 DivMMC write protect
1677 This option controls the state of the DivMMC write pro‐
1678 tection jumper that prevents flashing the EEPROM chip.
1679 See the DIVMMC section for more details.
1680
1681 +D interface
1682 If this option is selected, Fuse will emulate the +D
1683 interface. See the +D EMULATION section for more
1684 details.
1685
1686 Didaktik 80 interface
1687 If this option is selected, Fuse will emulate the Didak‐
1688 tik 80 (or Didaktik 40) interface. See the DIDAKTIK 80
1689 EMULATION section for more details.
1690
1691 DISCiPLE interface
1692 If this option is selected, Fuse will emulate the DISCi‐
1693 PLE interface. See the DISCIPLE EMULATION section for
1694 more details.
1695
1696 Beta 128 interface
1697 If this option is selected, Fuse will emulate the
1698 Beta 128 interface. See the BETA 128 EMULATION section
1699 for more details. Beta 128 emulation is enabled for the
1700 Pentagon and Scorpion machines regardless of this option.
1701
1702 Beta 128 auto-boot in 48K machines
1703 If this option is selected, then when a Beta 128 inter‐
1704 face is used in 48K or TC2048 emulation, the machine will
1705 boot directly into the TR-DOS system.
1706
1707 Opus Discovery interface
1708 If this option is selected, Fuse will emulate the Opus
1709 Discovery interface. See the OPUS DISCOVERY EMULATION
1710 section for more details.
1711
1712 Options, RZX...
1713 Display the RZX Options dialog, letting you configure how Fuse's
1714 deals with RZX input recordings. (With the widget UI, the keys
1715 shown in brackets toggle the options, Enter confirms any
1716 changes, and Esc aborts). Note that any changed settings only
1717 apply to the currently-running Fuse.
1718
1719 Create autosaves
1720 If this option is selected, Fuse will add a snapshot into
1721 the recording stream every 5 seconds while creating an
1722 RZX file, thus enabling the rollback facilities to be
1723 used without having to explicitly add snapshots into the
1724 stream. Older snapshots will be pruned from the stream to
1725 keep the file size and number of snapshots down: each
1726 snapshot up to 15 seconds will be kept, then one snapshot
1727 every 15 seconds until one minute, then one snapshot
1728 every minute until 5 minutes, and then one snapshot every
1729 5 minutes. Note that this “pruning” applies only to auto‐
1730 matically inserted snapshots: snapshots manually inserted
1731 into the stream will never be pruned.
1732
1733 Compress RZX data
1734 If this option is selected, and zlib was available when
1735 Fuse was compiled, any RZX files written by Fuse will be
1736 compressed. This is generally a good thing as it makes
1737 the files significantly smaller, and you probably want to
1738 turn it off only if you're debugging the RZX files or
1739 there's some other program which doesn't support com‐
1740 pressed RZX files.
1741
1742 Competition mode
1743 Any input recordings which are started when this option
1744 is selected will be made in `competition mode'. In
1745 essence, this means that Fuse will act just like a real
1746 Spectrum would: you can't load snapshots, pause the emu‐
1747 lation in any way, change the speed or anything that you
1748 couldn't do on the real machine. If any of these things
1749 are attempted, or if the emulated Fuse is running more
1750 than 5% faster or slower than normal Spectrum speed, then
1751 the recording will immediately be stopped.
1752
1753 If libgcrypt was available when Fuse was compiled, then
1754 recordings made with competition mode active will be dig‐
1755 itally signed, in theory to `certify' that it was made
1756 with the above restrictions in place. However, this pro‐
1757 cedure is not secure (and cannot be made so), so the
1758 presence of any signature on an RZX file should not be
1759 taken as providing proof that it was made with competi‐
1760 tion mode active. This feature is included in Fuse
1761 solely as it was one of the requirements for Fuse to be
1762 used in an on-line tournament.
1763
1764 Competition code
1765 The numeric code entered here will be written into any
1766 RZX files made in competition mode. This is another fea‐
1767 ture for on-line tournaments which can be used to `prove'
1768 that the recording was made after a specific code was
1769 released. If you're not playing in such a tournament, you
1770 can safely ignore this option.
1771
1772 Always embed snapshot
1773 Specify whether a snapshot should be embedded in an RZX
1774 file when recording is started from an existing snapshot.
1775
1776 Options, Movie...
1777 Display the Movie Options dialog, letting you configure how
1778 Fuse's deals with movie recordings.
1779
1780 Movie compression
1781 This option set the compression level to None, Lossless
1782 or High. (See the MOVIE RECORDING section for more infor‐
1783 mation).
1784
1785 Stop recording after RZX ends
1786 If this option is selected, Fuse will stop any movie
1787 recording after a RZX playback is finished.
1788
1789 Options, Joysticks
1790 Fuse can emulate many of the common types of joystick which were
1791 available for the Spectrum. The input for these emulated joy‐
1792 sticks can be taken from real joysticks attached to the emulat‐
1793 ing machine (configured via the Options, Joysticks, Joy‐
1794 stick 1... and Options, Joysticks, Joystick 2... options), or
1795 from the q, a, o, p, and Space keys on the emulating machines
1796 keyboard, configured via the Options, Joysticks, Keyboard...
1797 option. Note that when using the keyboard to emulate a joystick,
1798 the q, a, o, p, and Space keys will not have their normal effect
1799 (to avoid problems with games which do things like use p for
1800 pause when using a joystick).
1801
1802 Each of the joysticks (including the `fake' keyboard joystick)
1803 can be configured to emulate any one of the following joystick
1804 types:
1805
1806 None
1807 No joystick: any input will simply be ignored.
1808
1809 Cursor
1810 A cursor joystick, equivalent to pressing 5
1811 (left), 6 (down), 7 (up), 8 (right), and 0 (fire).
1812
1813 Kempston
1814 A Kempston joystick, read from input port 31. Note
1815 that the Options, Peripherals, General, Kempston
1816 interface option must also be set for the input to
1817 be recognised.
1818
1819 Sinclair 1
1820 Sinclair 2
1821 The `left' and `right' Sinclair joysticks, equiva‐
1822 lent to pressing 1 (left), 2 (right), 3 (down), 4
1823 (up), and 5 (fire), or 6 (left), 7 (right), 8
1824 (down), 9 (up), and 0 (fire) respectively.
1825
1826 Timex 1
1827 Timex 2
1828 The `left' and `right' joysticks as attached to
1829 the Timex 2068 variant's built-in joystick inter‐
1830 face.
1831
1832 For the real joysticks, it is also possible to configure what
1833 effect each button on the joystick will have: this can be Joy‐
1834 stick Fire, equivalent to pressing the emulated joystick's fire
1835 button, Nothing, meaning to have no effect, or any Spectrum key,
1836 meaning that pressing that button will be equivalent to pressing
1837 that Spectrum key.
1838
1839 Options, Select ROMs, Machine ROMs
1840 An individual dialog is available for each Spectrum variant emu‐
1841 lated by Fuse which allows selection of the ROM(s) used by that
1842 machine. Simply select the ROM you wish to use, and then reset
1843 the Spectrum for the change to take effect.
1844
1845 Options, Select ROMs, Peripheral ROMs
1846 The same as the Machine ROMs menu, but an individual dialog is
1847 available for peripherals that need a ROM. Simply select the ROM
1848 you wish to use, and then reset the Spectrum for the change to
1849 take effect.
1850
1851 Options, Filter...
1852 Select the graphics filter currently in use. See the GRAPHICS
1853 FILTERS section for more details.
1854
1855 F11
1856 Options, Full Screen
1857 Switch Fuse between full screen and windowed mode. This menu is
1858 only available under the SDL UI.
1859
1860 Options, Disk Options...
1861 When emulating disk drives, Fuse allows the specification of the
1862 physical drive units attached to the emulated interface. Each
1863 drive can be set to be one of the following types:
1864
1865 Disabled
1866
1867 Single-sided 40 track
1868
1869 Double-sided 40 track
1870
1871 Single-sided 80 track
1872
1873 Double-sided 80 track
1874
1875 The Disabled option is not supported for Drive 1 or Drive A of
1876 any interface.
1877
1878 The available options that can be set are:
1879
1880 +3 Drive A
1881 Defaults to a single-sided 40 track drive.
1882
1883 +3 Drive B
1884 Defaults to a double-sided 80 track drive.
1885
1886 +3 Detect Speedlock
1887 Specify whether the +3 drives try to detect Speedlock
1888 protected disks, and emulate `weak' sectors. If the disk
1889 image file (EDSK or UDI) contains weak sector data, than
1890 Speedlock detection is automatically omitted. See also
1891 the WEAK DISK DATA section.
1892
1893 Beta 128 Drive A
1894 Defaults to a double-sided 80 track drive.
1895
1896 Beta 128 Drive B
1897 Defaults to a double-sided 80 track drive.
1898
1899 Beta 128 Drive C
1900 Defaults to a double-sided 80 track drive.
1901
1902 Beta 128 Drive D
1903 Defaults to a double-sided 80 track drive.
1904
1905 +D Drive 1
1906 Defaults to a double-sided 80 track drive.
1907
1908 +D Drive 2
1909 Defaults to a double-sided 80 track drive.
1910
1911 Didaktik 80 Drive A
1912 Defaults to a double-sided 80 track drive.
1913
1914 Didaktik 80 Drive B
1915 Defaults to a double-sided 80 track drive.
1916
1917 DISCiPLE Drive 1
1918 Defaults to a double-sided 80 track drive.
1919
1920 DISCiPLE Drive 2
1921 Defaults to a double-sided 80 track drive.
1922
1923 Opus Drive 1
1924 Defaults to a single-sided 40 track drive.
1925
1926 Opus Drive 2
1927 Defaults to a single-sided 40 track drive.
1928
1929 Try merge 'B' side of disks
1930 This option prompts the user to confirm whether Fuse
1931 should try to merge the `B' side of a disk image from a
1932 separate file when opening a new single-sided disk image.
1933
1934 Confirm merge disk sides
1935 Select whether Fuse should try to merge a separate file
1936 for the `B' side of a disk image separate file when open‐
1937 ing a new disk image. Most double sided disk images are
1938 dumped as two single sided disk images e.g. `Golden Axe
1939 - Side A.dsk' and `Golden Axe - Side B.dsk'. So, if we
1940 want to play Golden Axe, first we have to insert the
1941 first disk image and when the game asks to insert side B,
1942 we have to find and open the second disk image, instead
1943 of just `flip'-ing the disk inside the drive. If enabled,
1944 Fuse will try to open the second image too and create a
1945 double sided disk image (merging the two one sided disk
1946 images) and insert this merged virtual disk into the disk
1947 drive. The function detects whether the file is one side
1948 of a double-sided image if the filename matches a pattern
1949 like [Ss]ide[ _][abAB12][ _.] in the file name of a disk
1950 that is being opened. If found, Fuse will try to open the
1951 other side of the disk too substituting the appropriate
1952 characters in the filename e.g. 1→2, a→b, A→B. If suc‐
1953 cessful then it will merge the two images and now we have
1954 a double sided disk in drive. This means that if we open
1955 `Golden Axe - Side A.dsk', then Fuse will try to open
1956 `Golden Axe - Side B.dsk' too. Now, we can just `flip'
1957 the disk if Golden Axe asks for `Side B'. The available
1958 options are Never, With single-sided drives and Always.
1959
1960 Options, Save
1961 This will cause Fuse's current options to be written to
1962 .fuserc in your home directory (Unix-like systems), or
1963 fuse.cfg in your %USERPROFILE% folder (Windows), from
1964 which they will be picked up again when Fuse is
1965 restarted. The best way to update this file is by using
1966 this option, but it's a simple XML file if libxml2 was
1967 available when Fuse was compiled (otherwise, plain text),
1968 and shouldn't be too hard to edit by hand if you really
1969 want to.
1970
1971 Pause
1972 Machine, Pause
1973 Pause or unpause emulation. This option is available only
1974 under the GTK+ and Win32 UIs; to pause the other user
1975 interfaces, simply press F1 to bring up the main menu.
1976
1977 F5
1978 Machine, Reset
1979 Reset the emulated Spectrum.
1980
1981 Machine, Hard reset
1982 Reset the emulated Spectrum. A hard reset is equivalent
1983 to turning the Spectrum's power off, and then turning it
1984 back on.
1985
1986 F9
1987 Machine, Select...
1988 Choose a type of Spectrum to emulate. An brief overview
1989 of the Sinclair, Amstrad and Timex can be found at
1990 http://www.nvg.ntnu.no/sinclair/computers/zxspec‐
1991 trum/zxspectrum.htm while more technical information can
1992 be found at http://www.worldofspectrum.org/faq/refer‐
1993 ence/reference.htm, and http://www.worldofspec‐
1994 trum.org/faq/reference/tmxreference.htm.
1995
1996 Spectrum 16K
1997 Spectrum 48K
1998 The original machines as released by Sinclair in
1999 1982 with 16 or 48K of RAM respectively.
2000
2001 Spectrum 48K (NTSC)
2002 The NTSC 48K machine released in limited numbers
2003 in parts of South America.
2004
2005 Spectrum 128K
2006 The 128K machine as released by Sinclair in
2007 1985 (Spain) or 1986 (UK).
2008
2009 Spectrum +2
2010 The first machine released by Amstrad, in 1986.
2011 From an emulation point of view, the +2 is virtu‐
2012 ally identical to the 128K.
2013
2014 Spectrum +2A
2015 Spectrum +3
2016 The two machines released by Amstrad in 1988.
2017 Technically very similar to each other, except
2018 that the +3 features a 3″ disk drive while the +2A
2019 does not.
2020
2021 Spectrum +3e
2022 A +3 with modified ROMs allowing access to IDE
2023 hard disks via the simple 8-bit interface, as
2024 activated from the Options, Peripherals, Disk...
2025 dialog. See http://www.worldofspec‐
2026 trum.org/zxplus3e/ for more details.
2027
2028 Timex TC2048
2029 Timex TC2068
2030 The variants of the Spectrum as released by Timex
2031 in Portugal.
2032
2033 Timex TS2068
2034 The variant of the Spectrum released by Timex in
2035 North America.
2036
2037 Pentagon 128K
2038 Russian clone of the Spectrum. There were many
2039 different machines called Pentagon from 1989 to
2040 2006, this machine corresponds to a 1991 era Pen‐
2041 tagon 128K with the optional AY sound chip and the
2042 integrated Beta 128 disk interface, and is the
2043 version of the machine most often emulated. More
2044 technical details can be found at
2045 http://www.worldofspectrum.org/rusfaq/index.html,
2046
2047 Pentagon 512K
2048 Pentagon 1024K
2049 Newer versions of the Pentagon Russian Spectrum
2050 clones which incorporate more memory and the “Mr
2051 Gluk Reset Service” ROM offering a more powerful
2052 firmware.
2053
2054 Scorpion ZS 256
2055 Another Russian clone of the Spectrum. Some
2056 details can be found at http://www.worldofspec‐
2057 trum.org/rusfaq/index.html. Like all the Russian
2058 clones, they have built in 3.5″ disk drives,
2059 accessed via the Beta 128 disk interface and TR-
2060 DOS (the Technology Research Disk Operating Sys‐
2061 tem). The most important distinction from the Pen‐
2062 tagon 128k and similar machines is the display
2063 timing details.
2064
2065 Spectrum SE
2066 A recent variant designed by Andrew Owen and Jarek
2067 Adamski, which is possibly best thought of as a
2068 cross between the 128K machine and the Timex vari‐
2069 ants, allowing 272K of RAM to be accessed. Some
2070 more details are available at http://www.worldof‐
2071 spectrum.org/faq/reference/sereference.htm and
2072 documentation of the extended BASIC is available
2073 at https://github.com/cheveron/sebasic4/wiki. The
2074 bug tracker for the BASIC is at
2075 https://github.com/cheveron/seba‐
2076 sic4/issues?state=open.
2077
2078 Machine, Debugger...
2079 Start the monitor/debugger. See the MONITOR/DEBUGGER sec‐
2080 tion for more information.
2081
2082 Machine, Poke Finder...
2083 Start the `poke finder'. See the POKE FINDER section for
2084 more information.
2085
2086 Machine, Poke Memory...
2087 Allow one to use multiface POKEs for things such as infi‐
2088 nite lives. See the POKE MEMORY section for more informa‐
2089 tion.
2090
2091 Machine, Memory Browser...
2092 Start the memory browser. It should be fairly obvious
2093 what this does; perhaps the only thing worth noting is
2094 that emulation is paused until you close the window.
2095
2096 Machine, NMI
2097 Sends a non-maskable interrupt to the emulated Spectrum.
2098 Due to a typo in the standard 48K ROM, this will cause a
2099 reset, but modified ROMs are available which make use of
2100 this feature. When the +D (or DISCiPLE) is emulated, this
2101 is used to access the +D (or DISCiPLE)'s screenshot and
2102 snapshot features (see the +D EMULATION and DISCIPLE EMU‐
2103 LATION sections below). For the DISCiPLE, Caps Shift
2104 must be held down whilst pressing the NMI button. For
2105 some UIs, this may be tricky, or even impossible to do.
2106 Note that GDOS on the DISCiPLE contains a bug which
2107 causes corruption of saved snapshots, and a failure to
2108 return from the NMI menu correctly. This bug is not
2109 present in G+DOS on the +D.
2110
2111 Machine, Multiface Red Button
2112 Presses the Multiface One/128/3 red button to active the
2113 interface.
2114
2115 Machine, Didaktik SNAP
2116 Presses the Didaktik 80 (or Didaktik 40)'s `SNAP' button.
2117
2118 F7
2119 Media, Tape, Open...
2120 Choose a PZX, TAP or TZX virtual-tape file to load from.
2121 See the FILE SELECTION section below for details on how
2122 to choose the file. If Auto-load media is set in the
2123 Media Options dialog (as it is by default), you may use
2124 the File, Open... menu option instead, and the tape will
2125 begin loading automatically. Otherwise, you have to
2126 start the load in the emulated machine (with LOAD "" or
2127 the 128's Tape Loader option, though you may need to
2128 reset first).
2129
2130 To guarantee that TZX files will load properly, you
2131 should select the file, make sure tape-loading traps are
2132 disabled in the Media Options dialog, then press F8 (or
2133 do Media, Tape, Play). That said, most TZXs will work
2134 with tape-loading traps enabled (often quickly loading
2135 partway, then loading the rest real-time), so you might
2136 want to try it that way first.
2137
2138 F8
2139 Media, Tape, Play
2140 Start playing the PZX, TAP or TZX file, if required.
2141 (Choosing the option (or pressing F8) again pauses play‐
2142 back, and a further press resumes). To explain — if tape-
2143 loading traps have been disabled (in the Media Options
2144 dialog), starting the loading process in the emulated
2145 machine isn't enough. You also have to `press play', so
2146 to speak :-), and this is how you do that. You may also
2147 need to `press play' like this in certain other circum‐
2148 stances, e.g. TZXs containing multi-load games may have a
2149 stop-the-tape request (which Fuse obeys).
2150
2151 Media, Tape, Browse
2152 Browse through the current tape. A brief display of each
2153 of the data blocks on the current tape will appear, from
2154 which you can select which block Fuse will play next.
2155 With the GTK+ UI, emulation will continue while the
2156 browser is displayed; double-clicking on a block will
2157 select it. In the other UIs, emulation is paused and you
2158 can use the cursor keys and press Enter to select it. If
2159 you decide you don't want to change block, just press
2160 Escape.
2161
2162 Media, Tape, Rewind
2163 Rewind the current virtual tape, so it can be read again
2164 from the beginning.
2165
2166 Media, Tape, Clear
2167 Clear the current virtual tape. This is particularly use‐
2168 ful when you want a `clean slate' to add newly-saved
2169 files to, before doing Media, Tape, Write... (or F6).
2170
2171 F6
2172 Media, Tape, Write...
2173 Write the current virtual-tape contents to a TZX file.
2174 You will be prompted for a filename. The virtual-tape
2175 contents are the contents of the previously-loaded tape
2176 (if any has been loaded since you last did a Media, Tape,
2177 Clear), followed by anything you've saved from the emu‐
2178 lated machine since. These newly-saved files are not
2179 written to any tape file until you choose this option!
2180
2181 Media, Tape, Record Start
2182 Starts directly recording the output from the emulated
2183 Spectrum to the current virtual-tape. This is useful when
2184 you want to record using a non-standard ROM or from a
2185 custom save routine. Most tape operations are disabled
2186 during recording. Stop recording with the Media, Tape,
2187 Write... menu option.
2188
2189 Media, Tape, Record Stop
2190 Stops the direct recording and places the new recording
2191 into the virtual-tape.
2192
2193 Media, Interface 1
2194 Virtual Microdrive images are accessible only when the
2195 Interface 1 is active from the Options, Peripherals, Gen‐
2196 eral... dialog. Note that any changes to the Microdrive
2197 image will not be written to the file on disk until the
2198 appropriate save option is used.
2199
2200 Media, Interface 1, Microdrive 1, Insert New
2201 Insert a new (unformatted) Microdrive cartridge into emu‐
2202 lated Microdrive 1.
2203
2204 Media, Interface 1, Microdrive 1, Insert...
2205 Insert an existing Microdrive cartridge image into emu‐
2206 lated Microdrive 1. You will be prompted for a filename.
2207
2208 Media, Interface 1, Microdrive 1, Eject
2209 Eject the Microdrive image in Microdrive 1. If the image
2210 has been modified, you will be asked as to whether you
2211 want any changes saved.
2212
2213 Media, Interface 1, Microdrive 1, Save
2214 Save the Microdrive image in Microdrive 1.
2215
2216 Media, Interface 1, Microdrive 1, Save as...
2217 Write the Microdrive image in Microdrive 1 to a file. You
2218 will be prompted for a filename.
2219
2220 Media, Interface 1, Microdrive 1, Write protect, Enable
2221 Enable the write protect tab for the image in Micro‐
2222 drive 1.
2223
2224 Media, Interface 1, Microdrive 1, Write protect, Disable
2225 Disable the write protect tab for the image in Micro‐
2226 drive 1.
2227
2228 Media, Interface 1, Microdrive 2, ...
2229 Media, Interface 1, Microdrive 3, ...
2230 Media, Interface 1, Microdrive 4, ...
2231 Media, Interface 1, Microdrive 5, ...
2232 Media, Interface 1, Microdrive 6, ...
2233 Media, Interface 1, Microdrive 7, ...
2234 Media, Interface 1, Microdrive 8, ...
2235 Equivalent options for the other emulated Microdrives.
2236
2237 Media, Interface 1, RS232, Plug RxD
2238 Media, Interface 1, RS232, Unplug RxD
2239 Media, Interface 1, RS232, Plug TxD
2240 Media, Interface 1, RS232, Unplug TxD
2241 Connect or disconnect a communication channels (FIFO or
2242 file) to use as the RS-232 TxD or RxD wire.
2243
2244 Media, Disk
2245 Virtual floppy disk images are accessible when emulating
2246 a +3, +3e, Pentagon or Scorpion, or when the Beta 128,
2247 Opus Discovery, +D, Didaktik or DISCiPLE interface
2248 options are enabled and a machine compatible with the
2249 chosen interface is selected. (See THE .DSK FORMAT,
2250 BETA 128 EMULATION, OPUS DISCOVERY EMULATION, +D EMULA‐
2251 TION, DIDAKTIK 80 EMULATION and DISCIPLE EMULATION sec‐
2252 tions below for notes on the file formats supported).
2253
2254 Once again, any changes made to a disk image will not
2255 affect the file which was `inserted' into the drive. If
2256 you do want to keep any changes, use the appropriate
2257 `eject and write' option before exiting Fuse.
2258
2259 Media, Disk, +3, Drive A:, Insert...
2260 Insert a disk-image file to read/write in the +3's emu‐
2261 lated drive A:.
2262
2263 Media, Disk, +3, Drive A:, Eject
2264 Eject the disk image currently in the +3's emulated
2265 drive A: — or from the emulated machine's perspective,
2266 eject it. Note that any changes made to the image will
2267 not be saved.
2268
2269 Media, Disk, +3, Drive A:, Save
2270 Save the disk image currently in the +3's drive A:.
2271
2272 Media, Disk, +3, Drive A:, Save as...
2273 Save the current state of the disk image currently in the
2274 +3's drive A: to a file. You will be prompted for a file‐
2275 name.
2276
2277 Media, Disk, +3, Drive B:, Insert...
2278 As above, but for the +3's drive B:. Fuse emulates
2279 drive B: as a second 3″ drive.
2280
2281 Media, Disk, +3, Drive B:, Eject
2282 As above, but for drive B:.
2283
2284 Media, Disk, +3, Drive B:, Save
2285 As above, but for drive B:.
2286
2287 Media, Disk, +3, Drive B:, Save as...
2288 As above, but for drive B:.
2289
2290 Media, Disk, Beta, Drive A:, Insert New
2291 Insert a new (unformatted) disk into the emulated Beta
2292 drive A:.
2293
2294 Media, Disk, Beta, Drive A:, Insert...
2295 Media, Disk, Beta, Drive A:, Eject
2296 Media, Disk, Beta, Drive A:, Save
2297 Media, Disk, Beta, Drive A:, Save as...
2298 As above, but for the emulated Beta disk drive A:.
2299
2300 Media, Disk, Beta, Drive A:, Write protect, Enable
2301 Enable the write protect tab for the image in Beta
2302 drive A:.
2303
2304 Media, Disk, Beta, Drive A:, Write protect, Disable
2305 Disable the write protect tab for the image in Beta
2306 drive A:.
2307
2308 Media, Disk, Beta, Drive B:, ...
2309 Media, Disk, Beta, Drive C:, ...
2310 Media, Disk, Beta, Drive D:, ...
2311 As above, but for the remaining emulated Beta disk inter‐
2312 face drives.
2313
2314 Media, Disk, Opus, Drive 1, Insert New
2315 Media, Disk, Opus, Drive 1, Insert...
2316 Media, Disk, Opus, Drive 1, Eject
2317 Media, Disk, Opus, Drive 1, Save
2318 Media, Disk, Opus, Drive 1, Save as...
2319 Media, Disk, Opus, Drive 1, Write protect, Enable
2320 Media, Disk, Opus, Drive 1, Write protect, Disable
2321 Media, Disk, Opus, Drive 2, ...
2322 As above, but for the emulated Opus Discovery drives.
2323
2324 Media, Disk, +D, Drive 1, Insert New
2325 Media, Disk, +D, Drive 1, Insert...
2326 Media, Disk, +D, Drive 1, Eject
2327 Media, Disk, +D, Drive 1, Save
2328 Media, Disk, +D, Drive 1, Save as...
2329 Media, Disk, +D, Drive 1, Write protect, Enable
2330 Media, Disk, +D, Drive 1, Write protect, Disable
2331 Media, Disk, +D, Drive 2, ...
2332 As above, but for the emulated +D drives.
2333
2334 Media, Disk, Didaktik 80, Drive A, Insert New
2335 Media, Disk, Didaktik 80, Drive A, Insert...
2336 Media, Disk, Didaktik 80, Drive A, Eject
2337 Media, Disk, Didaktik 80, Drive A, Save
2338 Media, Disk, Didaktik 80, Drive A, Save as...
2339 Media, Disk, Didaktik 80, Drive A, Write protect, Enable
2340 Media, Disk, Didaktik 80, Drive A, Write protect, Disable
2341 Media, Disk, Didaktik 80, Drive B, ...
2342 As above, but for the emulated Didaktik 80 drives.
2343
2344 Media, Disk, DISCiPLE, Drive 1, Insert New
2345 Media, Disk, DISCiPLE, Drive 1, Insert...
2346 Media, Disk, DISCiPLE, Drive 1, Eject
2347 Media, Disk, DISCiPLE, Drive 1, Save
2348 Media, Disk, DISCiPLE, Drive 1, Save as...
2349 Media, Disk, DISCiPLE, Drive 1, Write protect, Enable
2350 Media, Disk, DISCiPLE, Drive 1, Write protect, Disable
2351 Media, Disk, DISCiPLE, Drive 2, ...
2352 As above, but for the emulated DISCiPLE drives.
2353
2354 Media, Cartridge, Timex Dock, Insert...
2355 Insert a cartridge into the Timex 2068 dock. This will
2356 cause the emulated machine to be changed to the TC2068
2357 (if it wasn't already a 2068 variant) and reset.
2358
2359 Media, Cartridge, Timex Dock, Eject
2360 Remove the cartridge from the Timex 2068 dock. This will
2361 cause the emulated machine to be reset.
2362
2363 Media, Cartridge, Interface 2, Insert...
2364 Insert a cartridge into the Interface 2 cartridge slot.
2365 This will cause the emulated machine to be reset and the
2366 cartridge loaded.
2367
2368 Media, Cartridge, Interface 2, Eject...
2369 Remove the cartridge from the Interface 2 cartridge slot.
2370 This will cause the emulated machine to be reset.
2371
2372 Media, IDE, Simple 8-bit, Master, Insert...
2373 Connect an IDE hard disk to the simple 8-bit interface's
2374 master channel.
2375
2376 Media, IDE, Simple 8-bit, Master, Commit
2377 Cause any writes which have been done to virtual hard
2378 disk attached to the simple 8-bit interface's master
2379 channel to be committed to the real disk, such that they
2380 survive the virtual disk being ejected.
2381
2382 Media, IDE, Simple 8-bit, Master, Eject
2383 Eject the virtual hard disk from the simple 8-bit inter‐
2384 face's master channel. Note that any writes to the vir‐
2385 tual hard disk will be lost unless the Media, IDE, Simple
2386 8-bit, Master, Commit option is used before the disk is
2387 ejected.
2388
2389 Media, IDE, Simple 8-bit, Slave, Insert...
2390 Media, IDE, Simple 8-bit, Slave, Commit
2391 Media, IDE, Simple 8-bit, Slave, Eject
2392 The same as the Media, IDE, Simple 8-bit, Master entries
2393 above, but for the simple 8-bit interface's slave chan‐
2394 nel.
2395
2396 Media, IDE, ZXATASP, Master, Insert...
2397 Media, IDE, ZXATASP, Master, Commit
2398 Media, IDE, ZXATASP, Master, Eject
2399 Media, IDE, ZXATASP, Slave, Insert...
2400 Media, IDE, ZXATASP, Slave, Commit
2401 Media, IDE, ZXATASP, Slave, Eject
2402 The same as the Media, IDE, Simple 8-bit, Master entries
2403 above, but for the two channels of the ZXATASP interface.
2404
2405 Media, IDE, ZXCF CompactFlash, Insert...
2406 Media, IDE, ZXCF CompactFlash, Commit
2407 Media, IDE, ZXCF CompactFlash, Eject
2408 The same as the Media, IDE, Simple 8-bit, Master entries
2409 above, but for the ZXCF interface's CompactFlash slot.
2410
2411 Media, IDE, ZXMMC, Insert...
2412 Media, IDE, ZXMMC, Commit
2413 Media, IDE, ZXMMC, Eject
2414 The same as the Media, IDE, Simple 8-bit entries above,
2415 but for the memory card slot of the ZXMMC interface.
2416
2417 Media, IDE, DivIDE, Master, Insert...
2418 Media, IDE, DivIDE, Master, Commit
2419 Media, IDE, DivIDE, Master, Eject
2420 Media, IDE, DivIDE, Slave, Insert...
2421 Media, IDE, DivIDE, Slave, Commit
2422 Media, IDE, DivIDE, Slave, Eject
2423 The same as the Media, IDE, Simple 8-bit entries above,
2424 but for the two channels of the DivIDE interface.
2425
2426 Media, IDE, DivMMC, Insert...
2427 Media, IDE, DivMMC, Commit
2428 Media, IDE, DivMMC, Eject
2429 The same as the Media, IDE, Simple 8-bit entries above,
2430 but for the memory card slot of the DivMMC interface.
2431
2432 Help, Keyboard picture...
2433 Display a diagram showing the Spectrum keyboard, and the
2434 various keywords that can be generated with each key from
2435 (48K) BASIC. Under the GTK+ and Win32 UIs, this will
2436 appear in a separate window and emulation continues. With
2437 the other UIs, the picture remains onscreen (and the emu‐
2438 lator paused) until you press Esc or Enter.
2439
2441 When emulating the Spectrum, keys F1 to F10 are used as shortcuts for
2442 various menu items, as described above. The alphanumeric keys (along
2443 with Enter and Space) are mapped as-is to the Spectrum keys. The other
2444 key mappings are:
2445
2446 Shift emulated as Caps Shift
2447
2448 Control, Alt, and Meta
2449 emulated as Symbol Shift (most other modifiers are also mapped
2450 to this)
2451
2452 Backspace
2453 emulated as Caps–0 (Delete)
2454
2455 Esc emulated as Caps–1 (Edit)
2456
2457 Caps Lock
2458 emulated as Caps–2
2459
2460 Cursor keys
2461 emulated as Caps–5/6/7/8 (as appropriate)
2462
2463 Tab emulated as Caps Shift–Symbol Shift (Extended Mode)
2464
2465 Some further punctuation keys are supported, if they exist on your key‐
2466 board — `,', `.', `/', `;', `'', `#', `-', and `='. These are mapped
2467 to the appropriate symbol-shifted keys on the Spectrum.
2468
2469 A list of keys applicable when using the file selection dialogs is
2470 given in the FILE SELECTION section below.
2471
2473 Some of Fuse's UIs allow resizing of the emulated Spectrum's display.
2474 For the window-based ones (GTK+, Win32 and Xlib), you can resize the
2475 window by, well, resizing it. :-) Exactly how this works depends on
2476 your window manager; you may have to make the window over twice the
2477 width and height of the original size before it actually scales up.
2478 Fuse attempts to keep the window `square', but with some window man‐
2479 agers this can mean the window will never resize at all. If you experi‐
2480 ence this problem, the `--no-aspect-hint' option may help.
2481
2482 If you're using the SDL UI under X11 or GTK+, the window will automati‐
2483 cally resize to be the correct size for the graphics filter selected.
2484
2486 Fuse has the ability to apply essentially arbitrary filters between
2487 building its image of the Spectrum's screen, and displaying it on the
2488 emulating machine's monitor. These filters can be used to do various
2489 forms of smoothing, emulation of TV scanlines and various other possi‐
2490 bilities. Support for graphics filters varies between the different
2491 user interfaces, but there are two general classes: the GTK+, Win32,
2492 Xlib, SVGAlib and SDL user interfaces (and the saving of .png screen‐
2493 shots) support `interpolating' filters which use a palette larger than
2494 the Spectrum's 16 colours, while the framebuffer user interface cur‐
2495 rently does not support filters at all.
2496
2497 A further complication arises due to the fact that the Timex machines
2498 have their high-resolution video mode with twice the horizontal resolu‐
2499 tion. To deal with this, Fuse treats these machines as having a `nor‐
2500 mal' display size which is twice the size of a normal Spectrum's
2501 screen, leading to a different set of filters being available for these
2502 machines. Note that any of the double or triple-sizing filters are
2503 available for Timex machines only when using the SDL, Win32 or GTK+
2504 user interfaces.
2505
2506 The available filters, along with their short name used to select them
2507 from the command line, are:
2508
2509 Timex half (smoothed) (half)
2510 Timex half (skipping) (halfskip)
2511 Two Timex-machine specific filters which scale the screen down
2512 to half normal (Timex) size; that is, the same size as a normal
2513 Spectrum screen. The difference between these two filters is in
2514 how they handle the high-resolution mode: the `smoothed' version
2515 is an interpolating filter which averages pairs of adjacent pix‐
2516 els, while the `skipping' version is a non-interpolating filter
2517 which simply drops every other pixel.
2518
2519 Normal (normal)
2520 The simplest filter: just display one pixel for every pixel on
2521 the Spectrum's screen.
2522
2523 Double size (2x)
2524 Scale the displayed screen up to double size.
2525
2526 Triple size (3x)
2527 Scale the displayed screen up to triple size. Available only
2528 with the GTK+, Win32, Xlib and SDL user interfaces or when sav‐
2529 ing screenshots of non-Timex machines.
2530
2531 2xSaI (2xsai)
2532 Super 2xSaI (super2xsai)
2533 SuperEagle (supereagle)
2534 Three interpolating filters which apply successively more
2535 smoothing. All three double the size of the displayed screen.
2536
2537 AdvMAME2x (advmame2x)
2538 A double-sizing, non-interpolating filter which attempts to
2539 smooth diagonal lines.
2540
2541 AdvMAME3x (advmame3x)
2542 Very similar to AdvMAME2x, except that it triples the size of
2543 the displayed screen. Available only with the GTK+, Win32, Xlib
2544 and SDL user interfaces or when saving screenshots of non-Timex
2545 machines.
2546
2547 TV 2x (tv2x)
2548 TV 3x (tv3x)
2549 Timex TV (timextv)
2550 Three filters which attempt to emulate the effect of television
2551 scanlines. The first is a double-sizing filter for non-Timex
2552 machines, the second is a similar triple-sizing filter, while
2553 the last is a single-sizing filter for Timex machines (note that
2554 this means TV 2X and Timex TV produce the same size output).
2555
2556 PAL TV (paltv)
2557 PAL TV 2x (paltv2x)
2558 PAL TV 3x (paltv3x)
2559 Three filters which attempt to emulate the effect of the PAL TV
2560 system which layers a lower-resolution colour image over the top
2561 of a higher-resolution black-and-white image. The filters can
2562 also optionally add scanlines like the other TV series scalers.
2563
2564 Dot matrix (dotmatrix)
2565 A double-sizing filter which emulates the effect of a dot-matrix
2566 display.
2567
2568 Timex 1.5x (timex15x)
2569 An interpolating Timex-specific filter which scales the Timex
2570 screen up to 1.5× its usual size (which is therefore 3× the size
2571 of a `normal' Spectrum screen). Available only for the GTK+,
2572 Win32 and SDL user interfaces or when saving screenshots.
2573
2574 HQ 2x (hq2x)
2575 HQ 3x (hq3x)
2576 Two filters which do high quality (but slow) antialiasing. Dou‐
2577 bles and triples the size of the displayed screen respectively.
2578
2580 The emulated Spectrum is, by default, an unmodified 48K Spectrum with a
2581 tape player and ZX Printer attached. Oh, and apparently some magical
2582 snapshot load/save machine which is probably best glossed over for the
2583 sake of the analogy. :-)
2584
2585 To emulate different kinds of Spectrum, select the Machine, Select...
2586 menu option, or press F9.
2587
2588 The Spectrum emulation is paused when any dialogs appear. In the widget
2589 UI, it's also paused when menus or the keyboard picture are displayed.
2590
2592 The various models of Spectrum supported a range of ways to connect
2593 printers, three of which are supported by Fuse. Different printers are
2594 made available for the different models:
2595
2596 16, 48, TC2048, TC2068, TS2068
2597 ZX Printer
2598
2599 128/+2/Pentagon
2600 Serial printer (text-only)
2601
2602 +2A, +3
2603 Parallel printer (text-only)
2604
2605 If Opus Discovery, +D or DISCiPLE emulation is in use and printer emu‐
2606 lation is enabled, text-only emulation of the disk interface's parallel
2607 printer interface is provided.
2608
2609 Any printout is appended to one (or both) of two files, depending on
2610 the printer — these default to printout.txt for text output, and print‐
2611 out.pbm for graphics (PBM images are supported by most image viewers
2612 and converters). These names can be changed with the --textfile and
2613 --graphicsfile options from the command line or configuration file.
2614 While the ZX Printer can only output graphically, simulated text output
2615 is generated at the same time using a crude sort of OCR based on the
2616 current character set (a bit like using SCREEN$). There is currently no
2617 support for graphics when using the serial/parallel output, though any
2618 escape codes used will be `printed' faithfully. (!)
2619
2620 By the way, it's not a good idea to modify the printout.pbm file out‐
2621 side of Fuse if you want to continue appending to it. The header needs
2622 to have a certain layout for Fuse to be able to continue appending to
2623 it correctly, and the file will be overwritten if it can't be appended
2624 to.
2625
2627 The ZXATASP and ZXCF interfaces are two peripherals designed by Sami
2628 Vehmaa which significantly extend the capabilities of the Spectrum.
2629 More details on both are available from Sami's homepage,
2630 http://user.tninet.se/~vjz762w/, but a brief overview is given here.
2631
2632 The real ZXATASP comes with either 128K or 512K of RAM and the ability
2633 to connect an IDE hard disks and a CompactFlash card, while the ZXCF
2634 comes with 128K, 512K or 1024K of RAM and the ability to connect a Com‐
2635 pactFlash card. From an emulation point of view, the two interfaces are
2636 actually very similar as a CompactFlash card is logically just an IDE
2637 hard disk. Currently, Fuse's emulation is fixed at having 512K of RAM
2638 in the ZXATASP and 1024K in the ZXCF.
2639
2640 To activate the ZXATASP, simply select the ZXATASP interface option
2641 from the Options, Peripherals, Disk... dialog. The state of the upload
2642 and write protect jumpers is then controlled by the ZXATASP upload and
2643 ZXATASP write protect options. Similarly, the ZXCF is controlled by the
2644 ZXCF interface and ZXCF upload options (the ZXCF write protect is soft‐
2645 ware controlled).
2646
2647 If you're using either the ZXATASP or ZXCF, you almost certainly want
2648 to investigate ResiDOS, the operating system designed for use with the
2649 ZXATASP and ZXCF. ResiDOS provides facilities for using the extra RAM,
2650 accessing the mass storage devices and a task manager allowing virtu‐
2651 ally instant switching between programs on the Spectrum. See
2652 http://www.worldofspectrum.org/residos/ for more details.
2653
2655 The DivIDE is another IDE interface for the Spectrum, of which full
2656 details can be found at http://web.ar‐
2657 chive.org/web/20150302052256/http://baze.au.com/divide/. The interface
2658 can be activated via the DivIDE interface option from the Options,
2659 Peripherals, Disk... dialog, and the state of its write protect jumper
2660 controlled via the DivIDE write protect option. If you're going to be
2661 using the DivIDE, you'll probably want one of the firmwares available
2662 from the DivIDE homepage.
2663
2665 The DivMMC is a MMC interface for the Spectrum. Originally designed by
2666 Alessandro Dorigatti for the V6Z80P+ FPGA board as the fusion of DivIDE
2667 and ZXMMC+ interfaces, later assembled as an interface for real spec‐
2668 trums by Mario Prato. Currently there are variants with different RAM
2669 size, one/two memory cards slots, optional kempston jostick, etc.
2670
2671 The interface can be activated via the DivMMC interface option from the
2672 Options, Peripherals, Disk... dialog, and the state of its EEPROM
2673 write protect jumper controlled via the DivMMC write protect option.
2674 If you're going to be using the DivMMC, you'll need to load the ESXDOS
2675 firmware at http://www.esxdos.org/ or use the ZX Spectrum +3e ROMs by
2676 Garry Lancaster.
2677
2678 You'll also need a HDF image to store the contents of the memory card.
2679 There are several tools to create and manipulate this file format,
2680 e.g., hdfmonkey at https://github.com/gasman/hdfmonkey.
2681
2683 The Spectranet is an Ethernet network interface for the ZX Spectrum by
2684 Dylan Thomas. The interface can be activated via the Spectranet option
2685 on the Peripherals preferences dialog, and the state of its automatic
2686 page-in (disable) jumper controlled via the Spectranet disable option.
2687 If you're going to be using the Spectranet, you'll probably want one of
2688 the firmwares available from the Spectranet homepage (http://spec‐
2689 trum.alioth.net/doc/index.php) which is also where you can find more
2690 information on using the interface.
2691
2692 Installing the Spectranet firmware on Fuse is slightly more complicated
2693 than on a real machine, mostly because Fuse's emulation doesn't support
2694 DHCP. These instructions are correct as of 2012-01-26 — if you're using
2695 a later firmware than this, things may have changed slightly.
2696
2697 The first thing you will need to do is to obtain a copy of the Spec‐
2698 tranet installer as a .tap file (or similar). The installer is also
2699 available at the Spectranet site above.
2700
2701 Once you have a copy of the installer, start Fuse and tick the Spec‐
2702 tranet option from the Options, Peripherals, General... dialog, and
2703 the state of its write protect jumper controlled via the Spectranet
2704 disable option. Once that's done, open the installer file (use the
2705 Media, Tape, Open... command rather than File, Open... to prevent
2706 autoloading) and enter the following commands from BASIC:
2707
2708 CLEAR 26999
2709 LOAD "" CODE
2710 RANDOMIZE USR 27000
2711
2712 The screen should turn blue and you'll see around 20 lines of message
2713 appearing as the firmware is installed, starting with “Erasing sector
2714 0” and finishing with “Restoring page B”, and you'll get the familiar
2715 0 OK, 0: 1 at the bottom of the screen.
2716
2717 Now untick the Spectranet disable option from the Options, Peripherals,
2718 General... dialog and reset the Spectrum. You should see a very brief
2719 blue status screen, before the regular copyright screen appears with
2720 some Spectranet information at the top — there should be four status
2721 lines, starting with “Alioth Spectranet” and ending with the Spec‐
2722 tranet's IP address (which will be 255.255.255.255 at this stage).
2723
2724 Now trigger an NMI (the Machine / NMI menu option) and you should get a
2725 white on blue Spectranet NMI menu with five options.
2726
2727 Select [A] Configure network settings — this should lead you to another
2728 menu, which will scroll of the top of the screen; don't worry about
2729 this for now.
2730
2731 You'll now need to set various options:
2732
2733 [A] Enable/disable DHCP — select N
2734 [B] Change IP address — enter the IP address of the machine you are
2735 running Fuse on.
2736 [C] Change netmask — enter the appropriate netmask for the IP address
2737 you selected above. If that doesn't mean anything to you, try
2738 255.255.255.0
2739 [D] Change default gateway — enter the appropriate gateway address. If
2740 you don't know any better, enter the IP address of your router.
2741 [E] Change primary DNS — enter the address of your DNS server. If you
2742 don't know any better, use Google's public DNS server, 8.8.8.8.
2743
2744 There is no need to change options [F] or [G], but do select:
2745
2746 [H] Change hostname — enter a hostname for the Spectranet-enabled
2747 machine. It doesn't really matter what you enter here — it's mostly
2748 useful just to replace the junk default name so you can see what you've
2749 entered for the other settings.
2750
2751 Your screen should now look something like this:
2752
2753 Current configuration
2754 ───────────────────────────────────────
2755 Use DHCP : No
2756 IP address : 192.168.000.002
2757 Netmask : 255.255.255.000
2758 Default gateway : 192.168.000.001
2759 Primary DNS : 192.168.000.001
2760 Secondary DNS : 255.255.255.255
2761 Hardware address : FF:FF:FF:FF:FF:FF
2762 Hostname : fuse
2763 <menu options>
2764
2765 If everything looks correct, select [I] Save changes and exit (you'll
2766 see a brief “Saving configuration...” message) followed by [E] Exit, at
2767 which point you'll be returned to BASIC.
2768
2769 Now type the following commands:
2770
2771 %cfgnew
2772 %cfgcommit
2773
2774 Which will show the standard 0 OK, 0:1 at the bottom of the screen.
2775
2776 Reset the Spectrum again and you'll see the same four line status dis‐
2777 play, but this time with your IP address on the last line.
2778
2779 Congratulations! You have now installed the Spectranet firmware. To
2780 save having to go through all that every time you start Fuse, save a
2781 .szx snapshot at this point, and load that in every time you want to
2782 use the Spectranet.
2783
2785 The way you select a file (whether snapshot or tape file) depends on
2786 which UI you're using. So firstly, here's how to use the GTK+ file
2787 selector.
2788
2789 The selector shows the directories and files in the current directory
2790 in two separate subwindows. If either list is too big to fit in the
2791 window, you can use the scrollbar to see the rest (by dragging the
2792 slider, for example), or you can use Shift–Tab (to move the keyboard
2793 focus to a subwindow) and use the cursor keys. To change directory,
2794 double-click it.
2795
2796 To choose a file to load you can either double-click it, or click it
2797 then click Ok. Or click Cancel to abort.
2798
2799 If you're using the keyboard, probably the easiest way to use the
2800 selector is to just ignore it and type in the name. This isn't as irk‐
2801 some as it sounds, since the filename input box has filename completion
2802 — type part of a directory or file name, then press Tab. It should
2803 complete it. If it was a directory, it moves to that directory; if the
2804 completion was ambiguous, it completes as much as possible, and narrows
2805 the filenames shown to those which match. You should press Enter when
2806 you've finished typing the filename, or Esc to abort.
2807
2808 Now, if you're using the widget UI — the one using the Spectrum font —
2809 the selector works a bit differently. The files and directories are all
2810 listed in a single two-column-wide window (the directories are shown at
2811 the top, ending in `/') — the names may be truncated onscreen if
2812 they're too long to fit.
2813
2814 To move the cursor, you can either use the cursor keys, or the Spectrum
2815 equivalents 5/6/7/8, or (similarly) h/j/k/l. For faster movement, the
2816 Page Up, Page Down, Home, and End keys are supported and do what you'd
2817 expect. To select a file or directory, press Enter. To abort, press
2818 Esc.
2819
2820 With both selectors, do bear in mind that all files are shown, whether
2821 Fuse would be able to load them or not.
2822
2824 Firstly, note that the vast majority of this section applies only if
2825 you're using the GTK+ user interface; if you're using one of the widget
2826 user interfaces, you'll get a very basic monitor which shows the cur‐
2827 rent values of the registers and allows you to single step through exe‐
2828 cution or continue.
2829
2830 If you are using the GTK+ user interface, Fuse features a moderately
2831 powerful, completely transparent monitor/debugger, which can be acti‐
2832 vated via the Machine, Debugger... menu option. A debugger window will
2833 appear, showing the current state of the emulated machine: the top-left
2834 `pane' shows the current state of the Z80 and the last bytes written to
2835 any emulated peripherals. The bottom-left pane lists any active break‐
2836 points. Moving right, the next pane shows where the Spectrum's 64K mem‐
2837 ory map (the `W?' and `C?' indicate whether each displayed chunk is
2838 writable or contended respectively). Fuse tracks the memory mapping of
2839 the overall address space in 2KB chunks but will summarise the mapped
2840 pages where they are part of the same page of the underlying memory
2841 source (e.g. 8KB page sizes in the Spectrum 128K and 4KB pages in the
2842 Timex clones' DOCK and EXROM banks).
2843
2844 The next pane to the right has a disassembly, which by default starts
2845 at the current program counter, although this can be modified either by
2846 the `disassemble' command (see below) or by dragging the scrollbar next
2847 to it. The next pane shows the current stack, and the final pane any
2848 `events' which are due to occur and could affect emulation. Any of
2849 these panes can be removed by use of the View menu. Below the displays
2850 are an entry box for debugger commands, and five buttons for control‐
2851 ling the debugger:
2852
2853 Evaluate
2854 Evaluate the command currently in the entry box.
2855
2856 Single Step
2857 Run precisely one Z80 opcode and then stop emulation again.
2858
2859 Continue
2860 Restart emulation, but leave the debugger window open. Note that
2861 the debugger window will not be updated while emulation is run‐
2862 ning.
2863
2864 Break
2865 Stop emulation and return to the debugger.
2866
2867 Close
2868 Close the debugger window and restart emulation.
2869
2870 Double-clicking on an entry in the stack pane will cause emulation to
2871 run until the program counter reaches the value stored at that address,
2872 while double-clicking on an entry in the `events' pane will cause emu‐
2873 lation to run until that time is reached.
2874
2875 The main power of the debugger is via the commands entered into the
2876 entry box, which are similar in nature (but definitely not identical to
2877 or as powerful as) to those in gdb(1). In general, the debugger is
2878 case-insensitive, and numbers will be interpreted as decimal, unless
2879 prefixed by either `0x' or `$' when they will be interpreted as hex.
2880 Each command can be abbreviated to the portion not in curly braces.
2881
2882 ba{se} number
2883 Change the debugger window to displaying output in base number.
2884 Available values are 10 (decimal) or 16 (hex).
2885
2886 br{eakpoint} [address] [if condition]
2887 Set a breakpoint to stop emulation and return to the debugger
2888 whenever an opcode is executed at address and condition evalu‐
2889 ates true. If address is omitted, it defaults to the current
2890 value of PC.
2891
2892 br{eakpoint} p{ort} (re{ad}|w{rite}) port [if condition]
2893 Set a breakpoint to trigger whenever IO port port is read from
2894 or written to and condition evaluates true.
2895
2896 br{eakpoint} (re{ad}|w{rite}) [address] [if condition]
2897 Set a breakpoint to trigger whenever memory location address is
2898 read from (other than via an opcode fetch) or written to and
2899 condition evaluates true. Address again defaults to the current
2900 value of PC if omitted.
2901
2902 br{eakpoint} ti{me} time [if condition]
2903 Set a breakpoint to occur time tstates after the start of the
2904 every frame, assuming condition evaluates true (if one is
2905 given).
2906
2907 br{eakpoint} ev{ent} area:detail [if condition]
2908 Set a breakpoint to occur when the event specified by
2909 area:detail occurs and condition evaluates to true. The events
2910 which can be caught are:
2911
2912 beta128:page
2913 beta128:unpage
2914 The Beta 128 interface is paged into or out of memory
2915 respectively.
2916 didaktik80:page
2917 didaktik80:unpage
2918 The Didaktik 80 interface is paged into or out of memory
2919 respectively.
2920 disciple:page
2921 disciple:unpage
2922 The DISCiPLE interface is paged into or out of memory
2923 respectively.
2924 divide:page
2925 divide:unpage
2926 The DivIDE interface is paged into or out of memory
2927 respectively.
2928 divmmc:page
2929 divmmc:unpage
2930 The DivIDE interface is paged into or out of memory
2931 respectively.
2932 if1:page
2933 if1:unpage
2934 The Interface 1 shadow ROM is paged into or out of mem‐
2935 ory.
2936 multiface:page
2937 multiface:unpage
2938 The Multiface One/128/3 is paged into or out of memory
2939 respectively.
2940 opus:page
2941 opus:unpage
2942 The Opus Discovery is paged into or out of memory respec‐
2943 tively.
2944 plusd:page
2945 plusd:unpage
2946 The +D interface is paged into or out of memory respec‐
2947 tively.
2948 rzx:end
2949 An RZX recording finishes playing.
2950 speccyboot:page
2951 speccyboot:unpage
2952 The SpeccyBoot interface is paged into or out of memory.
2953 spectranet:page
2954 spectranet:unpage
2955 The Spectranet interface is paged into or out of memory.
2956 tape:play
2957 tape:stop
2958 The emulated tape starts or stops playing.
2959 zxatasp:page
2960 zxatasp:unpage
2961 The ZXATASP interface is paged into or out of memory.
2962 zxcf:page
2963 zxcf:unpage
2964 The ZXCF interface is paged into or out of memory.
2965
2966 In all cases, the event can be specified as area:* to catch all
2967 events from that area.
2968
2969 cl{ear} [address]
2970 Remove all breakpoints at address or the current value of PC if
2971 address is omitted. Port read/write breakpoints are unaffected.
2972
2973 com{mmands} id <newline>
2974 <debugger command> <newline>
2975 <debugger command> <newline>
2976 ...
2977 end
2978 Set things such that the specified debugger commands will be
2979 automatically executed when breakpoint id is triggered. There is
2980 currently no user interface for entering multi-line debugger
2981 commands, so the only way to specify this command is on the com‐
2982 mand-line via the --debugger-command option.
2983
2984 cond{ition} id [condition]
2985 Set breakpoint id to trigger only when condition is true, or
2986 unconditionally if condition is omitted.
2987
2988 co{ntinue}
2989 Equivalent to the Continue button.
2990
2991 del{ete} [id]
2992 Remove breakpoint id, or all breakpoints if id is omitted.
2993
2994 di{sassemble} address
2995 Set the centre panel disassembly to begin at address.
2996
2997 ex{it} [expression]
2998 Exit the emulator immediately, using the exit code resulting
2999 from the evaluation of expression, or 0 if expression is omit‐
3000 ted.
3001
3002 fi{nish}
3003 Exit from the current CALL or equivalent. This isn't infallible:
3004 it works by setting a temporary breakpoint at the current con‐
3005 tents of the stack pointer, so will not function correctly if
3006 the code returns to some other point or plays with its stack in
3007 other ways. Also, setting this breakpoint doesn't disable other
3008 breakpoints, which may trigger before this one. In that case,
3009 the temporary breakpoint remains, and the `continue' command can
3010 be used to return to it.
3011
3012 i{gnore} id count
3013 Do not trigger the next count times that breakpoint id would
3014 have triggered.
3015
3016 n{ext}
3017 Step to the opcode following the current one. As with the `fin‐
3018 ish' command, this works by setting a temporary breakpoint at
3019 the next opcode, so is not infallible.
3020
3021 o{ut} port value
3022 Write value to IO port port.
3023
3024 pr{int} expression
3025 Print the value of expression to standard output.
3026
3027 se{t} address value
3028 Poke value into memory at address.
3029
3030 se{t} $variable value
3031 Set the value of the debugger variable variable to value.
3032
3033 se{t} area:detail value
3034 Set the value of the system variable area:detail to value. The
3035 available system variables are listed below.
3036
3037 s{tep}
3038 Equivalent to the Single Step button.
3039
3040 t{breakpoint} [options]
3041 This is the same as the `breakpoint' command in its various
3042 forms, except that the breakpoint is temporary: it will trigger
3043 once and once only, and then be removed.
3044
3045 Addresses can be specified in one of two forms: either an absolute
3046 addresses, specified by an integer in the range 0x0000 to 0xFFFF or as
3047 a `source:page:offset' combination, which refers to a location offset
3048 bytes into memory bank page, independent of where that bank is cur‐
3049 rently paged into memory. RAM and ROM pages are indicated, respec‐
3050 tively, by `RAM' and `ROM' sources (e.g. offset 0x1234 in ROM 1 is
3051 specified as `ROM:1:0x1234'). Other available sources are: `Betadisk',
3052 `Didaktik 80 RAM', `Didaktik 80 ROM', `DISCiPLE RAM', `DISCiPLE ROM',
3053 `DivIDE EPROM', `DivIDE RAM', `DivMMC EPROM', `DivMMC RAM', `If1',
3054 `If2', `Multiface RAM', `Multiface ROM', `Opus RAM', `Opus ROM', `PlusD
3055 RAM', `PlusD ROM', `SpeccyBoot', `Spectranet', `Timex Dock', `Timex
3056 EXROM', `uSource', `ZXATASP' and `ZXCF'. Please, note that spaces in
3057 memory sources should be escaped, e.g., `break Didak‐
3058 tik\ 80\ ROM:0:0x1234'. The 48K machines are treated as having a per‐
3059 manent mapping of page 5 at 0x4000, page 2 at 0x8000 and page 0 at
3060 0xC000; the 16K Spectrum is treated as having page 5 at 0x4000 and no
3061 page at 0x8000 and 0xC000.
3062
3063 Anywhere the debugger is expecting a numeric value, except where it
3064 expects a breakpoint id, you can instead use a numeric expression,
3065 which uses a restricted version of C's syntax; exactly the same syntax
3066 is used for conditional breakpoints, with `0' being false and any other
3067 value being true. In numeric expressions, you can use integer constants
3068 (all calculations are done in integers), system variables, debugger
3069 variables, parentheses, the standard four numeric operations (`+', `-',
3070 `*' and `/'), the (non-)equality operators `==' and `!=', the compari‐
3071 son operators `>', `<', `>=' and `<=', bitwise and (`&'), or (`|') and
3072 exclusive or (`^') and logical and (`&&') and or (`||'). Square brack‐
3073 ets (`[' and `]') can be used to dereference a value; for example
3074 `[0x4000]' will give the value of the first byte of the screen.
3075
3076 System variables are specified via an `area:detail' syntax. The avail‐
3077 able system variables are:
3078
3079 ay:current
3080 The current AY-3-8912 register.
3081 divmmc:control
3082 The last byte written to DivMMC control port.
3083 spectrum:frames
3084 The frame count since reset. Note that this variable can only be
3085 read, not written to.
3086 tape:microphone
3087 The current level of the tape input connected to the `EAR' port.
3088 Note that this variable can only be read, not written to.
3089 ula:last
3090 The last byte written to the ULA. Note that this variable can
3091 only be read, not written to.
3092 ula:mem1ffd
3093 The last byte written to memory control port used by the ZX
3094 Spectrum +2A/3; normally addressed at 0x1ffd, hence the name.
3095 ula:mem7ffd
3096 The last byte written to primary memory control port used by the
3097 ZX Spectrum 128 and later; normally addressed at 0x7ffd, hence
3098 the name.
3099 ula:tstates
3100 The number of tstates since the last interrupt.
3101 z80: register name
3102 The value of the specified register. Both 8-bit registers and
3103 16-bit register pairs are supported. The MEMPTR / WZ hidden reg‐
3104 ister is also supported. The (presumable) Q hidden register is
3105 also supported.
3106 z80:im
3107 The current interrupt mode of the Z80.
3108 z80:iff1
3109 z80:iff2
3110 1 if the specified interrupt flip-flop is currently set, or 0 if
3111 it is not set.
3112
3114 The `poke finder' is a tool which is designed to make the task of find‐
3115 ing (infinite lives etc.) pokes for games a bit easier: it is similar
3116 to the `Lifeguard' utility which was available for use with the Multi‐
3117 face. It works by maintaining a list of locations in which the current
3118 number of lives (etc.) may be stored, and having the ability to remove
3119 from that list any locations which don't contain a specified value.
3120
3121 The poke finder dialog contains an entry box for specifying the value
3122 to be searched for, a count of the current number of possible locations
3123 and, if there are less than 20 possible locations, a list of the possi‐
3124 ble locations (in `page:offset' format). The five buttons act as fol‐
3125 lows:
3126
3127 Incremented
3128 Remove from the list of possible locations all addresses which
3129 have not been incremented since the last search.
3130
3131 Decremented
3132 Remove from the list of possible locations all addresses which
3133 have not been decremented since the last search.
3134
3135 Search
3136 Remove from the list of possible locations all addresses which
3137 do not contain the value specified in the `Search for' field.
3138
3139 Reset
3140 Reset the poke finder so that all locations are considered pos‐
3141 sible.
3142
3143 Close
3144 Close the dialog. Note that this does not reset the current
3145 state of the poke finder.
3146
3147 Double-clicking on an entry in the list of possible locations will
3148 cause a breakpoint to be set to trigger whenever that location is writ‐
3149 ten to.
3150
3151 An example of how to use this may make things a bit clearer. We'll use
3152 the 128K version of Gryzor. Load the game, define keys to suit and
3153 start playing. Immediately pause the game and bring up the poke finder
3154 dialog. We note that we currently have 6 lives, so enter `6' into the
3155 `Search for' field and click `Search'. This reduces the number of pos‐
3156 sible locations to around 931 (you may get a slightly different number
3157 depending on exactly when you paused the game). Play along a bit and
3158 then (deliberately) lose a life. Pause the game again. As we now have
3159 5 lives, replace the `6' in the `Search for' field with a `5' and click
3160 `Search' again. This then reduces the list of possible locations to
3161 just one: page 2, offset 0x00BC. This is the only location in memory
3162 which stored `6' when we had 6 lives and `5' when we had 5 lives, so
3163 its pretty likely that this is where the lives count is stored. Double-
3164 clicking on the `2:0x00BC' entry in the dialog will set the appropriate
3165 breakpoint (you may wish to open the debugger at this point to confirm
3166 this). Play along a bit more. When you next lose a life, emulation is
3167 stopped with PC at 0x91CD. Scrolling up a few addresses in the debug‐
3168 ger's disassembly pane shows a value was loaded from 0x80BC (our hypo‐
3169 thetical lives counter), decremented and then stored again to 0x80BC,
3170 which looks very much like the code to reduce the number of lives. We
3171 can now use the debugger to replace the decrement with a NOP (`set
3172 0x91c9 0'), and playing the game some more after this reveals that this
3173 has worked and we now have infinite lives.
3174
3176 Fuse supports multiface POKEs, allowing to modify specific memory
3177 addresses in order to cheat (infinite lives, infinite ammo, etc.).
3178
3179 The `poke memory' dialog contains a list of recently loaded POKEs and
3180 some entry boxes for adding custom POKEs:
3181
3182 Bank
3183 Sets the 128K memory bank (values `0' to `7') or the current
3184 memory mapping (value `8' or blank).
3185
3186 Address
3187 Memory address to modify. Values in range 16384 to 65535 for 48K
3188 memory mode or 0 to 65535 for 128K memory banks. GTK+ UI also
3189 accepts hex addresses.
3190
3191 Value
3192 New value for the former address, in range 0 to 255. Value 256
3193 means “Prompt to the user later”.
3194
3195 It is possible to load POKEs from an external file using the File,
3196 Open... menu option or the drag-and-drop functionality in the GTK+ and
3197 Win32 UIs. After loading a snapshot or tape, Fuse will try to automat‐
3198 ically locate a POK file with the same file name. This means that if we
3199 open `GAME.TAP', then Fuse will try to open `GAME.POK' and
3200 `POKES/GAME.POK'. See http://www.worldofspectrum.org/POKformat.txt for
3201 more details about this file format.
3202
3203 POKEs loaded in the list can be activated or deactivated as the user
3204 wants and will remain in memory until a machine reset.
3205
3207 In general, disk images for the +3 Spectrum are thought of as being in
3208 DSK format. However, this is actually a slight oversimplification;
3209 there are in fact two similar, but not identical, DSK formats. (The
3210 difference can be seen by doing `head -1 dskfile': one format will
3211 start `MV - CPCEMU' and the other will start `EXTENDED').
3212
3213 Fuse supports both the `CPCEMU' and `EXTENDED' formats.
3214
3216 Fuse supports Betadisk emulation in its Pentagon and Scorpion emula‐
3217 tion, and also under 48K, TC2048, 128K and +2 (but not +2A) emulation
3218 if the Beta 128 interface option from the Options, Peripherals, Disk...
3219 dialog is enabled. When that option is used in 48K or TC2048 emulation
3220 the Beta 128 auto-boot in 48K machines option additionally controls
3221 whether the machine boots directly into the TR-DOS system. See the DISK
3222 FILE FORMATS section for more details on supported disk file formats.
3223
3225 By default, Fuse emulates the Opus Discovery interface with the
3226 optional 2k RAM expansion and a second 40 track single sided disk
3227 drive. See the DISK FILE FORMATS section for more details on supported
3228 disk file formats. The Opus Discovery's printer port is also emulated
3229 for output only. (See the PRINTER EMULATION section for more details.)
3230 The Opus Discovery may only be used with 16K, 48K, 128K, TC2048 and +2
3231 (not +2A) emulation. To access disks, use the same syntax as Inter‐
3232 face 1 and Microdrives.
3233
3235 Fuse supports emulating the +D disk and printer interface. See the DISK
3236 FILE FORMATS section for more details on supported disk file formats.
3237 The +D's printer port is emulated. (See the PRINTER EMULATION section
3238 for more details.) The +D may only be used with 48K, 128K and +2 (not
3239 +2A) emulation. To access disks, you will first need to load G+DOS, by
3240 inserting a disk containing the DOS file (+SYS) and entering “RUN”.
3241 Once DOS is loaded, you can load to/from +D disks by prefixing file‐
3242 names with `dn' where `n' is the number of the drive in use. For exam‐
3243 ple, `LOAD d1"myfile"' would load the file named `myfile' from the emu‐
3244 lated drive 1. Microdrive syntax may also be used.
3245
3246 To save a snapshot, choose the Machine, NMI menu option, and then press
3247 `4' to save a 48K snapshot, or `5' to save a 128K snapshot. When sav‐
3248 ing a 128K snapshot, you must then press Y or N to indicate whether the
3249 screen changed while saving the snapshot, to finish saving. You can
3250 also choose `3' to save a screenshot to disk. Holding Caps Shift
3251 together with any of these options will cause the +D to save to the
3252 `other' drive to the one used last.
3253
3254 Options `1' and `2' allow screenshots to be printed (in monochrome, in
3255 normal and large formats respectively) if printer emulation is enabled.
3256 For saving and loading of snapshots, and saving of screenshots to disk,
3257 G+DOS must be loaded first, but printing of screenshots can be per‐
3258 formed without loading G+DOS.
3259
3260 Finally, `X' will return from the NMI menu.
3261
3263 Fuse supports Didaktik 80 (and Didaktik 40) emulation. It emulates the
3264 original version of the Didaktik 80, running MDOS 1 and with a WD2797
3265 floppy controller. See the DISK FILE FORMATS section for more details
3266 on supported disk file formats. The Didaktik 80 may only be used with
3267 16K, 48K and TC2048 emulation. To press the Didaktik 80's `SNAP' but‐
3268 ton, choose the Machine, Didaktik SNAP menu option.
3269
3271 Fuse supports emulating the DISCiPLE disk and printer interface,
3272 although it does not currently support emulation of the Sinclair Net‐
3273 work, or support emulation of a DISCiPLE attached to a 128K machine.
3274 See the DISK FILE FORMATS section for more details on supported disk
3275 file formats, which are the same as for +D emulation as described
3276 above. The DISCiPLE's printer port is emulated. (See the PRINTER EMULA‐
3277 TION section for more details.) The DISCiPLE may only be used with 48K
3278 emulation at present. To access disks, you will first need to load
3279 GDOS, by inserting a disk containing the DOS file (SYS) and entering
3280 “RUN”. Once DOS is loaded, you can load to/from DISCiPLE disks by pre‐
3281 fixing filenames with `dn' where `n' is the number of the drive in use.
3282 For example, `LOAD d1"myfile"' would load the file named `myfile' from
3283 the emulated drive 1. Microdrive syntax may also be used.
3284
3285 Snapshots can be saved in a similar manner to that of the +D as
3286 described above, but note that GDOS on the DISCiPLE contains a bug
3287 which causes corruption as soon as the NMI button is pressed, affecting
3288 saving of snapshots, and also loading of snapshots that were originally
3289 saved with a +D or SAM Coupé. This will cause corruption even when a
3290 screenshot is printed, or if the menu is never even entered in the
3291 first place (due to Caps Shift not being pressed down, as is required
3292 for the DISCiPLE), provided that GDOS is loaded. This bug is not
3293 present in G+DOS on the +D. (Note: this was caused by saving/restoring
3294 the AF register twice in the NMI handler, where both AF and the AF'
3295 shadow register should have been saved/restored.)
3296
3297 The NMI button works slightly differently on the DISCiPLE than on the
3298 +D. Caps Shift must be held down whilst pressing the NMI button, and
3299 there is no `X' option to exit the menu. Also, printing of screenshots
3300 requires GDOS to be loaded. Depending on the UI that you're using,
3301 holding down Caps Shift whilst choosing the Machine, NMI menu option
3302 may be slightly tricky, or even impossible. For the GTK+ UI, ensure
3303 that the Shift key is held before entering on the Machine menu. For
3304 the widget UI, it does not seem possible to perform this action.
3305
3307 Fuse supports several disk image formats in its +D, Didaktik, DISCiPLE
3308 and Beta 128 emulation.
3309
3310 For reading:
3311
3312 .UDI
3313 Ultra Disk Image; for specification please see
3314 http://faqwiki.zxnet.co.uk/wiki/UDI_format or
3315 http://zxmak.chat.ru/docs.htm
3316
3317 This is the only image format which can store all the relevant
3318 information of the recorded data on a magnetic disk, so it can
3319 be used for any non standard disk format. Fuse can read all
3320 extended track types too (mixed FM/MFM, or tracks with `WEAK'
3321 data or even compressed tracks too).
3322
3323 .FDI
3324 UKV Spectrum Debugger disk image format.
3325
3326 .MGT .IMG
3327 DISCiPLE/+D file formats.
3328
3329 .SAD
3330 For compatibility with SAM Coupé disk images using these for‐
3331 mats. Note that SAM Coupé `.DSK' images share the same format
3332 as `.MGT'.
3333
3334 .D80 .D40
3335 Didaktik 80 and Didaktik 40 file formats.
3336
3337 .TRD
3338 TR-DOS disk image. TRD and SCL sectors are loaded interleaved,
3339 therefore you might experience problems with TR-DOS ROMs that
3340 use the turbo format (sequential sectors); for detailed informa‐
3341 tion please see http://web.ar‐
3342 chive.org/web/20070808150548/http://www.ram‐
3343 soft.bbk.org/tech/tr-info.zip
3344
3345 .SCL
3346 A simple archive format for TR-DOS disk files. For specification
3347 please see http://www.zx-modules.de/fileformats/sclformat.html
3348
3349 .TD0
3350 Teledisk image format; Fuse supports only files which do not use
3351 the “Advanced Compression” option. Detailed description found in
3352 http://www.classiccmp.org/dunfield/img54306/td0notes.txt and
3353 https://web.ar‐
3354 chive.org/web/20130116072335/http://www.fpns.net/willy/wteledsk.htm
3355
3356 .DSK
3357 CPC disk image format; Fuse supports the plain old and the new
3358 extended CPC format too. Further information please see the THE
3359 .DSK FORMAT section and the CPCEMU manual section 7.7.1
3360 http://www.cpc-emu.org/linux/cpcemu_e.txt or the
3361 http://www.cpctech.org.uk/docs/extdsk.html
3362
3363 .OPD .OPU
3364 Opus Discovery file formats.
3365
3366 Fuse supports most of the above formats for writing: .UDI .FDI .MGT
3367 .IMG .SAD .D80 .D40 .TRD .SCL .OPD .OPU .DSK (only the old CPC format).
3368
3369 You can save disk images with any output format, just select the appro‐
3370 priate extension. (e.g. `elite3.udi' to save as an UDI file). If the
3371 appropriate libraries were available when libspectrum(3) was compiled,
3372 than Fuse will try to create UDI images with compressed tracks to save
3373 disk space. There is a .LOG `image' format for debugging purpose. This
3374 is a plain text file that contains three dumps of the loaded disk image
3375 at different details. Not all image formats can store all disk images.
3376 You cannot save a disk image with an inappropriate format that loses
3377 some information (e.g. variable track length or sector length).
3378
3380 Some copy protections have what is described as `weak/random' data.
3381 Each time the sector is read one or more bytes will change, the value
3382 may be random between consecutive reads of the same sector. Two disk
3383 image formats (Extended DSK and UDI) can store this type of data. Fuse
3384 can read and use weak sector data from EDSK and UDI files when present,
3385 and can save back weak sector data to UDI image format.
3386
3388 Fuse can save movies with sound in a specific file format (FMF). This
3389 recording is very fast, and has a moderate size, but you need to use
3390 the fmfconv(1) program in fuse-utils(1) to convert into regular video
3391 and/or audio files. The --movie-compr option allows you to set the
3392 compression level to None, Lossless or High. If zlib(3) is not avail‐
3393 able, only None is valid. The default when Zlib is available is Loss‐
3394 less. Recording a movie may slow down emulation, if you experience
3395 performance problems, you can try to set compression to None.
3396
3397 Fuse records every displayed frame, so by default the recorded file has
3398 about 50 video frame per second. A standard video has about 24–30/s
3399 framerate, so if you set Options/General/Frame rate 1:n or the equiva‐
3400 lent --rate command line option to 2 than recording frame rate reduces
3401 about 25/s. The exact frame rate depends on the Z80 clock frequency
3402 which varies depending on the specific emulated machine.
3403
3404 Note: You can see all of the “gfx” effects only if the Fuse frame rate
3405 option is set to 1, but in most cases you can safely use 2. Also, movie
3406 recording stops if the emulated machine is changed.
3407
3408 The recorded sound sampling rate and the channel number is equal with
3409 the Fuse generated sound sampling rate (44100 Hz by default) and chan‐
3410 nel number (mono by default). The common sampling frequencies in stan‐
3411 dard video files are 44100 Hz and 48000 Hz. If you use --sound-freq
3412 command line option you can change the frequency.
3413
3414 You can record stereo sound if you use AY stereo separation or the
3415 equivalent --separation command line switch.
3416
3417 You can use fmfconv(1) to convert recorded movie file into a standard
3418 video file.
3419
3420 Examples
3421
3422 fuse --movie-start output.fmf --rate 2 --sound-freq 44100 --separation
3423 ACB
3424
3425 start video recording about 25/s video frame rate and 44100 Hz sampling
3426 frequency stereo sound default compression level.
3427
3429 Assuming the appropriate libraries were available when libspectrum(3)
3430 was compiled, snapshots, tape images, dock cartridges and input record‐
3431 ing files (RZX) can be read from files compressed with bzip2(3),
3432 gzip(3) or zip(3) just as if they were uncompressed. In the zip case,
3433 only the first supported file found inside the archive is loaded.
3434 There is currently no support for reading compressed +3, DISCiPLE/+D or
3435 Beta disk images.
3436
3438 Selecting a startup filter doesn't work properly with user interfaces
3439 other than SDL, Win32 and GTK+.
3440
3441 Changing virtual consoles when using SVGAlib for joystick support
3442 causes Fuse to exit. If this is a problem, compile Fuse with the
3443 `--disable-ui-joystick' option.
3444
3445 The poke finder can't search outside `normal' RAM.
3446
3447 The libao file output devices not work properly with the GTK+ UI. No
3448 error reporting, but the created file does not contain any sound data.
3449 If you use a `weak' machine alsa09 makes a lot of clicks and pops and
3450 will output `ALSA: underrun, at least 0ms.' error messages.
3451
3453 ~/.fuserc
3454
3456 bzip2(3), fmfconv(1), fuse-utils(1), gzip(3), libspectrum(3),
3457 ogg123(1), xspect(1), xzx(1), zip(3).
3458
3459 The comp.sys.sinclair Spectrum FAQ, at
3460 http://www.worldofspectrum.org/faq/index.html.
3461
3463 Philip Kendall (philip-fuse@shadowmagic.org.uk).
3464
3465 Matan Ziv-Av wrote the SVGAlib and framebuffer UIs, the glib replace‐
3466 ment code, and did some work on the OSS-specific sound code and the
3467 original widget UI code.
3468
3469 Russell Marks wrote the sound emulation and OSS-specific sound code,
3470 the joystick emulation, some of the printer code, and the original ver‐
3471 sion of this man page.
3472
3473 John Elliott's lib765 and libdsk libraries were used for the original
3474 +3 disk and disk image support.
3475
3476 Ian Collier wrote the ZX Printer emulation (for xz80).
3477
3478 Darren Salt wrote the original versions of the code for +3 emulation,
3479 SLT support, MITSHM support (for the Xlib UI), TZX raw data blocks, RZX
3480 embedded snapshots and compression, the Kempston mouse emulation and
3481 made many improvements to the widget code.
3482
3483 Alexander Yurchenko wrote the OpenBSD/Solaris-specific sound code.
3484
3485 Fredrick Meunier wrote the TC2048, TS2068, Pentagon and Spectrum SE
3486 support, the CoreAudio sound code, as well as maintaining the OS X port
3487 and importing the graphics filter code.
3488
3489 Ludvig Strigeus and The ScummVM project wrote the original graphics
3490 filter code.
3491
3492 Dmitry Sanarin wrote the original Beta disk interface emulation (for
3493 Glukalka).
3494
3495 Witold Filipczyk wrote the TC2068 support.
3496
3497 Matthew Westcott wrote the AY logging code and the DivIDE emulation.
3498
3499 Marek Januszewski wrote various bits of code to make Fuse work under
3500 Win32, including the DirectDraw user interface.
3501
3502 Sergio Baldoví made many improvements to the Win32 UI.
3503
3504 Stuart Brady wrote the DISCiPLE and +D emulation, Scorpion emulation
3505 and the HP-UX sound code.
3506
3507 Garry Lancaster wrote the 8-bit IDE, ZXATASP and ZXCF interface emula‐
3508 tions.
3509
3510 Gergely Szasz wrote the Interface 1, Microdrive emulation and Didak‐
3511 tik 80 emulation, the PAL TV scalers, the TV 3x scaler, the movie log‐
3512 ging code, the ALSA and libao sound code, the µPD765 disk controller
3513 used in the +3 and made many improvements to the widget code.
3514
3515 Michael D Wynne wrote the original Opus disk interface emulation (for
3516 EightyOne).
3517
3518 Patrik Persson wrote the SpeccyBoot emulation.
3519
3520
3521
3522Version 1.5.7 9th December, 2018 fuse(1)