[ Spectaculator, ZX Spectrum Emulator ] Home | Downloads | Support [ ZX Spectrum Image ]

Table of contents

The zx-state file format
Introduction
Copyrights and acknowledgements
Revision history
Basic information
zx-state header
ZXSTBLOCK header
Block types
ZXSTATASP
ZXSTATASPRAM
ZXSTAYBLOCK
ZXSTCF
ZXSTCFRAM
ZXSTCOVOX
ZXSTBETA128
ZXSTBETADISK
ZXSTCREATOR
ZXSTDOCK
ZXSTDSKFILE
ZXSTGS
ZXSTGSRAMPAGE
ZXSTKEYBOARD
ZXSTIF1
ZXSTIF2ROM
ZXSTJOYSTICK
ZXSTMCART
ZXSTMOUSE
ZXSTMULTIFACE
ZXSTRAMPAGE
ZXSTPLUS3
ZXSTPLUSD
ZXSTPLUSDDISK
ZXSTROM
ZXSTSCLD
ZXSTSIDE
ZXSTSPECDRUM
ZXSTSPECREGS
ZXSTTAPE
ZXSTUSPEECH
ZXSTZXPRINTER
ZXSTZ80REGS

ZXSTJOYSTICK

Joystick setup for both players.

// Joystick options
#define ZXSTJOYF_ALWAYSPORT31   1    // Deprecated

// Supported joystick types
#define ZXSTJT_KEMPSTON   0
#define ZXSTJT_FULLER     1
#define ZXSTJT_CURSOR     2
#define ZXSTJT_SINCLAIR1  3
#define ZXSTJT_SINCLAIR2  4
#define ZXSTJT_COMCOM     5
#define ZXSTJT_TIMEX1     6
#define ZXSTJT_TIMEX2     7
#define ZXSTJT_DISABLED   8

typedef struct _tagZXSTJOYSTICK
{
  ZXSTBLOCK blk;
  DWORD dwFlags;
  BYTE chTypePlayer1;
  BYTE chTypePlayer2;
} ZXSTJOYSTICK, *LPZXSTJOYSTICK;

Members

blk
The block header. The block id is ZXSTBID_JOYSTICK ('J', 'O', 'Y', 0).
dwFlags
If ZXSTJOYF_ALWAYSPORT31 is set, Spectaculator will return 0 for a read of port 31 if Kempston joystick emulation is not enabled.

Note: this flag is now deprecated as it is an emulator feature rather than hardware state information.

chTypePlayer1
Specifies which joystick to emulate for Player 1. This can be one of:
FlagMeaning
ZXSTJT_KEMPSTONKempston joystick emulation
ZXSTJT_FULLERFuller joystick emulation
ZXSTJT_CURSORCursor (AGF or Protek) emulation
ZXSTJT_SINCLAIR1Sinclair Interface II port 1 (or Spectrum +2A/+3 joystick 1)
ZXSTJT_SINCLAIR2Sinclair Interface II port 2 (or Spectrum +2A/+3 joystick 2)
ZXSTJT_COMCOMComcom programmable joystick interface
ZXSTJT_TIMEX1Timex TC2048, TC2068, TS2068 and Spectrum SE built-in joystick, port 1.
ZXSTJT_TIMEX2Timex TC2048, TC2068, TS2068 and Spectrum SE built-in joystick, port 2.
ZXSTJT_DISABLEDDisables joystick emulation for player 1.
chTypePlayer2
Specifies which joystick to emulate for Player 2. This can be one of:
FlagMeaning
ZXSTJT_KEMPSTONKempston joystick emulation
ZXSTJT_FULLERFuller joystick emulation
ZXSTJT_CURSORCursor (AGF or Protek) emulation
ZXSTJT_SINCLAIR1Sinclair Interface II port 1 (or Spectrum +2A/+3 joystick 1)
ZXSTJT_SINCLAIR2Sinclair Interface II port 2 (or Spectrum +2A/+3 joystick 2)
ZXSTJT_COMCOMComcom programmable joystick interface
ZXSTJT_TIMEX1Timex TC2048, TC2068, TS2068 and Spectrum SE built-in joystick, port 1.
ZXSTJT_TIMEX2Timex TC2048, TC2068, TS2068 and Spectrum SE built-in joystick, port 2.
ZXSTJT_DISABLEDDisables joystick emulation for player 2.

Revision history

Available since version 1.1

  Copyright © 2001 - 2008 Jonathan Needle Top