forked from touchHLE/touchHLE
-
Notifications
You must be signed in to change notification settings - Fork 0
/
OPTIONS_HELP.txt
182 lines (138 loc) · 8.27 KB
/
OPTIONS_HELP.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
View options:
--fullscreen
Display the app in full screen. The default is to display in a window
instead, except on Android which always uses full screen.
The app's output will be scaled to fit your screen. This is independent
of the internal resolution, so if the scale hack (see below) is not also
in use, the result may be a bit blurry. An internal resolution larger
than your screen's is possible, in which case the output is downscaled.
--landscape-left
--landscape-right
Changes the orientation the virtual device will have at startup.
The default is portrait.
--landscape-left means rotate 90° counterclockwise from portrait.
--landscape-right means rotate 90° clockwise from portrait.
Usually apps that require landscape mode will tell touchHLE about this,
and it will automatically rotate the window, but some apps neglect to
do this. These options may be useful in that case.
--scale-hack=...
Set a scaling factor for the window. touchHLE will attempt to run the
app with an increased internal resolution. This is a hack and there's
no guarantee it will work correctly for all apps.
The default is no scale hack, which is equivalent to a value of 1 (i.e.
a scale of 1×).
This is a natural number that is at least 1.
Game controller options:
--deadzone=...
Configures the size of the \"dead zone\" for analog stick inputs.
The default value is 0.1, which means that 10% of the stick's range on
the X and Y axes around the center position will be collapsed into a
single point, so that movements in that range are ignored.
This is a floating-point (decimal) number between 0 and 1.
--x-tilt-range=...
--y-tilt-range=...
Set the simulated rotation range of the device axis mapped to the analog
stick X or Y axis.
Positive X on the analog stick is mapped to tilting the device rightward
and positive Y is mapped to tilting the device forward.
By default, an analog stick's axis is mapped to a rotation range of 60°
(30° in either direction). If you wanted a range of 90° on the X axis,
you could use --x-tilt-range=90.
For historical reasons, the device's X axis is mapped to the analog
stick's Y axis and vice versa, as if the device is held in landscape.
This is a floating-point (decimal) number of degrees, without a degree
symbol. It may be negative.
--x-tilt-offset=...
--y-tilt-offset=...
Offset the simulated angle of the device axis mapped to the analog stick
X or Y axis.
Positive X on the analog stick is mapped to tilting the device rightward
and positive Y is mapped to tilting the device forward.
By default, the device is simulated as being level with the ground when
the stick is in the center/neutral position. This option is intended for
games that use a different angle relative to the ground as their neutral
position. For example, if a game expects you to hold the device in a
landscape orientation, with a 45° angle to the ground, you might use
--y-tilt-offset=45.
This is a floating-point (decimal) number of degrees, without a degree
symbol. It may be negative.
--button-to-touch=...
Maps a button on your game controller to a point on the simulated touch
screen of the device. Pressing the button will behave like touching that
part of the screen.
This is three parts separated by commas: the name of a button (DPadLeft,
DPadUp, DPadRight, DPadDown, Start, LeftShoulder or Xbox-like
A, B, X or Y), the X co-ordinate and the Y co-ordinate.
The co-ordinates are floating-point (decimal) numbers. 0,0 is the
top-left corner. The bottom-right corner is 320,480 if the app is in
portrait, and 480,320 if the app is in landscape.
For example, --button-to-touch=A,470,310 will make the A button simulate
tapping in the bottom-right corner of the screen, for a landscape game.
Except where specified in touchHLE_default_options.txt, this is not used
by default. There is however a virtual cursor that is controlled by the
right analog stick (tap/hold by pressing the stick or right shoulder
button).
--stabilize-virtual-cursor=...
Apply motion smoothing and a sticky radius to the virtual cursor
(controlled by the right analog stick).
Some apps are very sensitive to small finger movements and will always
register an attempted "tap" as a scrolling gesture if the finger moves
even very slightly. When combined with the low precision and shakiness
of the virtual cursor, it can be difficult to use certain apps' menus.
This option exists to compensate for this.
The value is two floating-point (decimal) numbers separated by a comma.
The first is the strength of the motion smoothing, and the second is a
radius, in pixels, within which movement of the cursor will be ignored.
To increase these values is to trade off responsiveness and precision
respectively. Either number can be zero if desired. Note that the effect
of the sticky radius is *not* shown on-screen!
For example, --stabilize-virtual-cursor=0.1,10 will smooth out movements
such that sharp movements take about half a second to complete, while
movements within a 10px radius will be completely ignored.
Graphics driver options:
--gles1=...
Force touchHLE to use a particular OpenGL ES 1.1 implementation.
This may be useful for troubleshooting graphics driver issues.
--gles1=gles1_on_gl2 will use touchHLE's GLES1-on-GL2 layer.
--gles1=gles1_native will use native OpenGL ES 1.1.
When this option isn't in use, touchHLE will try each in order and use
the first one that works.
Debugging options:
--disable-direct-memory-access
Force dynarmic to always access guest memory via the memory access
callbacks, rather than using the fast direct access path (page tables).
--gdb=...
Starts touchHLE in debugging mode, listening for GDB remote serial
protocol connections over TCP on the specified host and port.
You can then connect to touchHLE with GDB and make use of its features
to inspect memory and registers, set up software breakpoints, and
continue or step execution.
The host and port should be separated by a colon. The host can be a
host name or an IP address. IPv6 addresses should be enclosed in square
brackets, e.g. --gdb=[::1]:9001 for IPv6 loopback device port 9001.
Other options:
--preferred-languages=...
Specifies a list of preferred languages to be reported to the app.
This should be one or more ISO 639 language codes (usually two letters)
in order of preference, separated by commas. For example,
--preferred-languages=de,ja,en means you would prefer German, or failing
that Japanese, or failing that English.
If this option is not specified, the list comes from your operating
system's language settings.
Whether and how this preference is respected, and whether any particular
language is supported, is determined entirely by the app.
--headless
Run in headless mode. touchHLE will not create a window, so there will
be no graphical output and no input. Only useful for command-line apps.
--print-fps
Logs the current framerate (FPS) to the console once per second.
--fps-limit=...
Modify or disable the framerate (FPS) limit.
By default, touchHLE limits the framerate of an app to 60fps, because
this is required for accurate emulation. Some apps can however run
correctly at a higher framerate than normal.
This is either 'off', to disable the framerate limit, or otherwise
a floating-point (decimal) number of frames per second.
Note that many apps have an internal timer that determines how often
they present frames; increasing the limit will not increase their
framerate, but may make it less consistent.