aboutsummaryrefslogtreecommitdiff
path: root/games/sdlmess/mess.6
blob: 8c758c5cc8e9db3960c8f93b82b4655bb158d065 (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
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
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
.TH mess 6 "December 6, 2008" "" "mess"


.SH NAME
mess \- runs MESS(tm) with SDL library


.SH SYNOPSIS
\fBmess\fP [system] [device] [software] [options]


.SH DESCRIPTION
\fBMESS\fP is an acronym that stands for Multiple Emulator Super System and is based on MAME (Multiple Arcade Machine Emulator). \fBSDLMESS\fP is the official Linux port of \fBMESS\fP using the \fBSDL\fP (Simple Direct Media Layer) library.
.PP
\fBmess\fP will more or less faithfully reproduce computer and console systems on a PC. \fBmess\fP can currently emulate over 250 systems from the last 5 decades.
.br
\fBmess\fP emulates the hardware of the systems and sometimes utilizes \fBROM\fP images to
load programs and games. Therefore, these systems are NOT simulations, but the
actual emulations of the hardware.
.br
\fBSuch ROMs, like any other commercial software, are copyrighted material and it is therefore illegal to use them if you don't own the original machines\fP.
Needless to say, ROMs are not distributed together with mess.
Distribution of mess together with ROM images is a violation of copyright law and should be promptly reported to the authors so that appropriate legal action can be taken.



.SH OPTIONS
.PP
.B
MESS GENERAL OPTIONS:

.B
core configuration options
.IP -readconfig
enable loading of configuration files

.PP
.B
core search path options
.IP -rompath
path to ROMsets and hard disk images
.IP -hashpath
path to hash files
.IP -samplepath
path to samplesets
.IP -artpath
path to artwork files
.IP -ctrlrpath
path to controller definitions
.IP -inipath
path to ini files
.IP -fontpath
path to font files
.IP -cheatpath
path to cheat files

.PP
.B
core output directory options
.IP -cfg_directory
directory to save configurations
.IP -nvram_directory
directory to save nvram contents
.IP -memcard_directory
directory to save memory card contents
.IP -input_directory
directory to save input device logs
.IP -state_directory
directory to save states
.IP -snapshot_directory
directory to save screenshots
.IP -diff_directory
directory to save hard drive image difference files
.IP -comment_directory
directory to save debugger comments

.PP
.B
core state/playback options
.IP -state
saved state to load
.IP -autosave
enable automatic restore at startup, and automatic save at exit time
.IP -playback
playback an input file
.IP -record
record an input file
.IP -mngwrite
optional filename to write a MNG movie of the current session
.IP -aviwrite
optional filename to write an AVI movie of the current session
.IP -wavwrite
optional filename to write a WAV file of the current session
.IP -snapname
override of the default snapshot/movie naming; %g == gamename, %i == index
.IP -snapsize
specify snapshot/movie resolution (<width>x<height>) or 'auto' to use minimal size
.IP -snapview
specify snapshot/movie view or 'internal' to use internal pixel-aspect views

.PP
.B
core performance options
.IP -autoframeskip
enable automatic frameskip selection
.IP -frameskip
set frameskip to fixed value, 0-12 (autoframeskip must be disabled)
.IP -seconds_to_run
number of emulated seconds to run before automatically exiting
.IP -throttle
enable throttling to keep game running in sync with real time
.IP -sleep
enable sleeping, which gives time back to other applications when idle
.IP -speed
controls the speed of gameplay, relative to realtime; smaller numbers are slower
.IP -refreshspeed
automatically adjusts the speed of gameplay to keep the refresh rate lower than the screen

.PP
.B
core rotation options
.IP -rotate
rotate the game screen according to the game's orientation needs it
.IP -ror
rotate screen clockwise 90 degrees
.IP -rol
rotate screen counterclockwise 90 degrees
.IP -autoror
automatically rotate screen clockwise 90 degrees if vertical
.IP -autorol
automatically rotate screen counterclockwise 90 degrees if vertical
.IP -flipx
flip screen left-right
.IP -flipy
flip screen upside-down

.PP
.B
core artwork options
.IP -artwork_crop
crop artwork to game screen size
.IP -use_backdrops
enable backdrops if artwork is enabled and available
.IP -use_overlays
enable overlays if artwork is enabled and available
.IP -use_bezels
enable bezels if artwork is enabled and available

.PP
.B
core screen options
.IP -brightness
default game screen brightness correction
.IP -contrast
default game screen contrast correction
.IP -gamma
default game screen gamma correction
.IP -pause_brightness
 amount to scale the screen brightness when paused

.PP
.B
core vector options
.IP -antialias
use antialiasing when drawing vectors
.IP -beam
set vector beam width
.IP -flicker
set vector flicker effect

.PP
.B
core sound options
.IP -sound
enable sound output
.IP -samplerate
set sound output sample rate
.IP -samples
enable the use of external samples if available
.IP -volume
sound volume in decibels (-32 min, 0 max)

.PP
.B
core input options
.IP -coin_lockout
enable coin lockouts to actually lock out coins
.IP -ctrlr
preconfigure for specified controller
.IP -mouse
enable mouse input
.IP -joystick
enable joystick input
.IP -lightgun
enable lightgun input
.IP -multikeyboard
enable separate input from each keyboard device (if present)
.IP -multimouse
enable separate input from each mouse device (if present)
.IP -steadykey
enable steadykey support
.IP -offscreen_reload
convert lightgun button 2 into offscreen reload
.IP -joystick_map
explicit joystick map, or auto to auto-select
.IP -joystick_deadzone
center deadzone range for joystick where change is ignored (0.0 center, 1.0 end)
.IP -joystick_saturation
end of axis saturation range for joystick where change is ignored (0.0 center, 1.0 end)

.PP
.B
core input automatic enable options
.IP -paddle_device
enable (keyboard|mouse|joystick) if a paddle control is present
.IP -adstick_device
enable (keyboard|mouse|joystick) if an analog joystick control is present
.IP -pedal_device
enable (keyboard|mouse|joystick) if a pedal control is present
.IP -dial_device
enable (keyboard|mouse|joystick) if a dial control is present
.IP -trackball_device
enable (keyboard|mouse|joystick) if a trackball control is present
.IP -lightgun_device
enable (keyboard|mouse|joystick) if a lightgun control is present
.IP -positional_device
enable (keyboard|mouse|joystick) if a positional control is present
.IP -mouse_device
enable (keyboard|mouse|joystick) if a mouse control is present

.PP
.B
core debugging options
.IP -log
generate an error.log file
.IP -verbose
display additional diagnostic information
.IP -update_in_pause
keep calling video updates while in pause
.IP -debug
enable/disable debugger
.IP -debugscript
script for debugger

.PP
.B
core misc options
.IP -bios
select the system BIOS to use
.IP -cheat
enable cheat subsystem
.IP -skip_gameinfo
skip displaying the information screen at startup

.PP
.B
debugging options
.IP -oslog
output error.log data to the system debugger

.PP
.B
performance options
.IP -multithreading
enable multithreading; this enables rendering and blitting on a separate thread
.IP -sdlvideofps
show sdl video performance

.PP
.B
video options
.IP -video
video output method: soft or opengl
.IP -numscreens
number of screens to create; SDLMAME only supports 1 at this time
.IP -window
enable window mode; otherwise, full screen mode is assumed
.IP -maximize
default to maximized windows; otherwise, windows will be minimized
.IP -keepaspect
constrain to the proper aspect ratio
.IP -unevenstretch
allow non-integer stretch factors
.IP -effect
name of a PNG file to use for visual effects, or 'none'
.IP -centerh
center horizontally within the view area
.IP -centerv
center vertically within the view area
.IP -waitvsync
enable waiting for the start of VBLANK before flipping screens; reduces tearing effects
.IP -scalemode
Scale mode: none, async, yv12, yuy2, yv12x2, yuy2x2 (-video soft only)

.PP
.B
opengl.-specific options
.IP -filter
enable bilinear filtering on screen output
.IP -prescale
scale screen rendering by this amount in software
.IP -gl_forcepow2texture
force power of two textures  (default no)
.IP -gl_notexturerect
don't use OpenGL GL_ARB_texture_rectangle (default on)
.IP -gl_vbo
enable OpenGL VBO, if available (default on)
.IP -gl_pbo
enable OpenGL PBO, if available (default on)
.IP -gl_glsl
enable OpenGL GLSL, if available (default off)
.IP -gl_glsl_filter
enable OpenGL GLSL filtering instead of FF filtering 0-plain, 1-bilinear (default)
.IP -glsl_shader_mame0
custom OpenGL GLSL shader set mame bitmap 0
.IP -glsl_shader_mame1
custom OpenGL GLSL shader set mame bitmap 1
.IP -glsl_shader_mame2
custom OpenGL GLSL shader set mame bitmap 2
.IP -glsl_shader_mame3
custom OpenGL GLSL shader set mame bitmap 3
.IP -glsl_shader_mame4
custom OpenGL GLSL shader set mame bitmap 4
.IP -glsl_shader_mame5
custom OpenGL GLSL shader set mame bitmap 5
.IP -glsl_shader_mame6
custom OpenGL GLSL shader set mame bitmap 6
.IP -glsl_shader_mame7
custom OpenGL GLSL shader set mame bitmap 7
.IP -glsl_shader_mame8
custom OpenGL GLSL shader set mame bitmap 8
.IP -glsl_shader_mame9
custom OpenGL GLSL shader set mame bitmap 9
.IP -glsl_shader_screen0
custom OpenGL GLSL shader screen bitmap 0
.IP -glsl_shader_screen1
custom OpenGL GLSL shader screen bitmap 1
.IP -glsl_shader_screen2
custom OpenGL GLSL shader screen bitmap 2
.IP -glsl_shader_screen3
custom OpenGL GLSL shader screen bitmap 3
.IP -glsl_shader_screen4
custom OpenGL GLSL shader screen bitmap 4
.IP -glsl_shader_screen5
custom OpenGL GLSL shader screen bitmap 5
.IP -glsl_shader_screen6
custom OpenGL GLSL shader screen bitmap 6
.IP -glsl_shader_screen7
custom OpenGL GLSL shader screen bitmap 7
.IP -glsl_shader_screen8
custom OpenGL GLSL shader screen bitmap 8
.IP -glsl_shader_screen9
custom OpenGL GLSL shader screen bitmap 9
.IP -gl_glsl_vid_attr
enable OpenGL GLSL handling of brightness and contrast. Better RGB game performance for free. (default)

.PP
.B
per-window video options
.IP -screen
explicit name of the first screen; 'auto' here will try to make a best guess
.IP -aspect
aspect ratio for all screens; 'auto' here will try to make a best guess
.IP -resolution
preferred resolution for all screens; format is <width>x<height>[@<refreshrate>] or 'auto'
.IP -view
preferred view for all screens
.IP -screen0
explicit name of the first screen; 'auto' here will try to make a best guess
.IP -aspect0
aspect ratio of the first screen; 'auto' here will try to make a best guess
.IP -resolution0
preferred resolution of the first screen; format is <width>x<height>[@<refreshrate>] or 'auto'
.IP -view0
preferred view for the first screen
.IP -screen1
explicit name of the second screen; 'auto' here will try to make a best guess
.IP -aspect1
aspect ratio of the second screen; 'auto' here will try to make a best guess
.IP -resolution1
preferred resolution of the second screen; format is <width>x<height>[@<refreshrate>] or 'auto'
.IP -view1
preferred view for the second screen
.IP -screen2
explicit name of the third screen; 'auto' here will try to make a best guess
.IP -aspect2
aspect ratio of the third screen; 'auto' here will try to make a best guess
.IP -resolution2
preferred resolution of the third screen; format is <width>x<height>[@<refreshrate>] or 'auto'
.IP -view2
preferred view for the third screen
.IP -screen3
explicit name of the fourth screen; 'auto' here will try to make a best guess
.IP -aspect3
aspect ratio of the fourth screen; 'auto' here will try to make a best guess
.IP -resolution3
preferred resolution of the fourth screen; format is <width>x<height>[@<refreshrate>] or 'auto'
.IP -view3
preferred view for the fourth screen

.PP
.B
full screen options
.IP -switchres
enable resolution switching
.IP -useallheads
split full screen image across monitors

.PP
.B
sound options
.IP -audio_latency
set audio latency (increase to reduce glitches, decrease for responsiveness)

.PP
.B
sdl keyboard mapping
.IP -keymap
enable keymap
.IP -keymap_file
keymap filename
.IP -uimodekey
Key to toggle MESS keyboard mode

.PP
.B
sdl joystick mapping
.IP -remapjoys
enable physical to logical joystick mapping
.IP -remapjoyfile
joymap filename
.IP -sixaxis
Use special handling for PS3 Sixaxis controllers

.PP
.B
sdl lowlevel driver options
.IP -videodriver
sdl video driver to use ('x11', 'directfb', ... or 'auto' for SDL default
.IP -audiodriver
sdl audio driver to use ('alsa', 'arts', ... or 'auto' for SDL default
.IP -gl_lib
alternative libGL.so to use; 'auto' for system default

.PP
.B
MESS SPECIFIC OPTIONS:
.IP -ramsize
size of RAM (if supported by driver)
.IP -writeconfig
writes configuration to (driver).ini on exit
.IP -skip_warnings
skip displaying the warnings screen
.IP -natural
specifies whether to use a natural keyboard or not

.PP
.B
SDL MESS SPECIFIC OPTIONS:

.PP
.B
core commands
.IP -help
show help message
.IP -validate
perform driver validation on all game drivers

.PP
.B
configuration commands
.IP -createconfig
create the default configuration file
.IP -showconfig
display running parameters
.IP -showusage
show this help

.PP
.B
frontend commands
.IP -listxml
all available info on driver in XML format
.IP -listfull
short name, full name
.IP -listsource
driver sourcefile
.IP -listclones
show clones
.IP -listcrc
CRC-32s
.IP -listroms
list required roms for a driver
.IP -listsamples
list optional samples for a driver
.IP -verifyroms
report romsets that have problems
.IP -verifysamples
report samplesets that have problems
.IP -romident
compare files with known MAME roms
.IP -listdevices
list available devices


.SH FILES
.B /usr/share/games/mess/*/
Default location for roms/, artwork/, and other read-only data for mess.
Can be changed in mess.ini
.TP
.B $HOME/.mess
Default location for writable directories. Can be changed in mess.ini
.TP
.B mess.ini
Config file for mess. Searched for first as $HOME/.mess/mess.ini, then
/etc/mess.ini


.SH EXAMPLE
.B mess \fI3do\fP -cdrm \fIcrashnburn.chd\fP
will launch the game "Crash N' Burn" from the console "3DO".
.TP
.B mess \fI3do\fP -cdrm \fIcrashnburn.chd\fP -bios \fIgoldstar\fP
will launch the game "Crash N' Burn" from the "3DO" console model from "Goldstar".
.TP
.B mess \fIn64\fP -cart \fImariokart64.v64\fP
will launch the game "Mario Kart 64" from the console "Nintendo 64".
.TP
.B mess \fIn64\fP -cart \fImariokart64.v64\fP -inipath \fI~/.mess/mess.ini\fP
will launch the game "Mario Kart 64" from the console "Nintendo 64" using a custom "mess.ini" file stored in the folder ".mess" of your home directory (usually "/home/yourusername/").
.TP
.B mess -showconfig
will output all the mess current configuration.


.SH SEE ALSO
More informations on \fBMESS\fP(tm) available at http://www.mess.org/
.br
\fBSDLMESS\fP original sources are available at http://rbelmont.mameworld.info/


.SH COPYRIGHT
MAME(tm) - Copyright (c) 1997-2008, Nicola Salmoria and the MAME team.
.br
MESS(tm) - Copyright (c) 1998-2008, Nathan Woods and the MESS team.
.br
SDLMESS - Copyright (c) Olivier Galibert and R. Belmont.


.SH AUTHOR
MAME(tm) was written by Nicola Salmoria and the MAME team.
.br
MESS(tm) was written by Nathan Woods and the MESS team.
.br
SDLMAME was written by Olivier Galibert and R. Belmont.
.sp 3
This manual page was written by Ludovic Lechapt <ludomatic@gmail.com>,
for the Debian project but may be used by others!
.sp 3
This manual page was modified by B. Watson for use with SlackBuilds.org