aboutsummaryrefslogtreecommitdiff
path: root/source/docs/controls.txt
blob: 703cd33db0b61ec3e599f1d4272b4c1528e156bc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
This lists the available commands, excluding the ones you get back from
S9xGetAllSnes9xCommands(). The various meta-characters are:
  #     - A number. The range is detemined by the context
  ##    - A two-digit number (i.e. with leading zeros)
  [...] - Something optional
  (...) - For grouping with |
  |     - "or", choose one of the options.
  <...> - A named field
  {...} - A list of possible values. Multiple values may be used, but they
          must be in the order listed and joined with +-signs.
  ""    - 'ditto', used to indicate the same list as the above line.

Speeds are: Var, Slow, Med, and Fast. 'Var' starts slow and speeds up as the
button is held.

Axes are: Left/Right, Right/Left, Up/Down, Down/Up, Y/A, A/Y, X/B, B/X, L/R,
and R/L. Negative is listed first (i.e. "Y/A" means negative deflection is
towards Y, while "A/Y" means negative deflection is towards A).

AxisToPointer, ButtonToPointer, and AxisToButtons allow for translating
between different input types. There are 8 'pointers' with IDs
PseudoPointerBase+0 to PseudoPointerBase+7, and 256 'buttons' with IDs
PseudoButtonBase+0 to PseudoButtonBase+255. So for example,
"AxisToButtons 0/255 T=50%" would take the axis data, and do
S9xReportButton(PseudoButtonBase+0,1) when said axis goes past 50% in the
negative direction and S9xReportButton(PseudoButtonBase+255,1) when it goes
over 50% deflection in the positive direction. Similarly, it will do
S9xReportButton(...,0) when the deflection drops under 50% in either
direction. "ButtonToPointer 1u Slow" would move the pointer with ID
PseudoPointerBase+0 up one pixel per frame as long as the button is pressed
(reporting this change at the end of each frame).

---------------
Button Commands
---------------

Joypad# {Up, Down, Left, Right, A, B, X, Y, L, R, Start, Select}
Joypad# Turbo ""
Joypad# Sticky ""
Joypad# StickyTurbo ""
Joypad# ToggleTurbo ""
Joypad# ToggleSticky ""
Joypad# ToggleStickyTurbo ""

Mouse# (L|R|LR)

Superscope AimOffscreen
Superscope {Fire, Cursor, ToggleTurbo, Pause}
Superscope AimOffscreen ""

Justifier# AimOffscreen
Justifier# {Trigger, Start}
Justifier# AimOffscreen ""

ButtonToPointer #[u|d][l|r] <speed>     ; NOTE: "# <speed>" is invalid

-------------
Axis Commands
-------------

Joypad# Axis <axis> T=#%               ; T = 0.1 to 100 by tenths
AxisToButtons #/# T=#%                 ; neg then pos, range 0-255, T as above
AxisToPointer #(h|v) [-]<speed>        ; NOTE: '-' inverts the axis

----------------
Pointer Commands
----------------

Pointer {Mouse1, Mouse2, Superscope, Justifier1, Justifier2}

------
Multis
------

Multis are a type of button command. The basic format of a multi is "{...}",
where the '...' consists of 1 or more valid non-multi button command
strings. The braces are literal, not metacharacters. Subcommands separated
by commas are executed one after the next. Semicolons skip one frame before
continuing subcommand execution. Semicolons may be repeated. When the multi
button is pressed, each subcommand is 'pressed', and when the multi button
is released each subcommand is 'released'.

There are also press-only multis, defined as "+{...}". These act just like
regular multis, with two differences: the multi is only run when you press
the button (release isignored), and each subcommand must be prefixed with
'+' or '-' to indicate whether the the subcommand should be pressed or
released.

For example: {Joypad1 A,Joypad2 A;Joypad3 A;;;;;QuickSave000}
  This presses (or releases) A on pads 1 and 2, then waits one frame, then
  presses A on pad 3, then waits 5 frames, then saves to snapshot 0 (on press
  only).

You may access the multi number in the returned s9xcommand_t structure as
cmd.button.multi_idx. This may be used to assign the same multi to multiple
buttons:
  MULTI#<num>    ; NOTE: that's a literal octothorpe