Previous 199869 Revisions Next

r23551 Sunday 9th June, 2013 at 00:22:42 UTC by R. Belmont
SDL.txt: edited by someone who actually knows what these do ;-) (nw)
[docs]SDL.txt

trunk/docs/SDL.txt
r23550r23551
1313
1414-[no]oslog
1515
16   Outputs the error.log data to the Windows debugger. This can be used at
16   Outputs the error.log data to the stderr TTY channel (usually the
17   command line window MAME was started in). This can be used at
1718   the same time as -log to output the log data to both targets as well.
1819   Default is OFF (-nooslog).
1920
r23550r23551
3334
3435-[no]multithreading / -[no]mt
3536
36   Enables multithreading within MAME. At the moment, this causes the
37   window and code to execute on a second thread, which can improve performance
38        on hyperthreaded and multicore systems.
39        The default is OFF (-nomultithreading).
37   Enables multithreading for the final drawing operation.  This can help
38   performance on multicore/hyperthreaded systems with slow video cards,
39   but may cause undesired behavior in some games.
40   Note that some drivers in MAME and MESS will use multiple threads even
41   when this is set to OFF, assuming -numprocessors allows it.
42   The default is OFF (-nomultithreading).
4043   
44
4145-numprocessors <auto|value> / -np <auto|value>
4246
4347   Specify the number of processors to use for work queues. Specifying
r23550r23551
4852
4953-sdlvideofps
5054
51        Enable output of SDL-related video performance.
55        Enable output of benchmark data on the SDL video subsystem, including
56      your system's video driver, X server (if applicable), and OpenGL stack
57      in -video opengl mode.
5258
5359-bench [n]
5460
r23550r23551
6268
6369-video <soft|opengl|none>
6470
65   Specifies which video subsystem to use for drawing.  Default is 'soft'.
71   Specifies which video subsystem to use for drawing.  The default for
72   Mac OS X is 'opengl' because OS X is guaranteed to have a compliant
73   OpenGL stack.  The default on all other systems is 'soft'.
6674
6775-numscreens <count>
6876
r23550r23551
7179   screens. Each screen (up to 4) has its own independent settings for
7280   physical monitor, aspect ratio, resolution, and view, which can be
7381   set using the options below. The default is 1.  SDL currently has a
74        limit of 1 with the expectation of increasing this when SDL 2.0 is
75        released.
82   limit of 1 with the expectation of increasing this when SDL 2.0 is
83   released.
7684
7785-[no]window / -[no]w
7886
r23550r23551
101109
102110-[no]unevenstretch
103111
104        Allow non-integer stretch factors allowing for great window sizing
105        flexability.  The default is ON. (-unevenstretch)
112   Allow non-integer stretch factors allowing for great window sizing
113   flexability.  The default is ON. (-unevenstretch)
106114
107115-[no]centerh
108116
r23550r23551
125133   performance hit. You should only need to turn this on in windowed mode.
126134   In full screen mode, it is only needed if -triplebuffer does not
127135   remove the tearing, in which case you should use -notriplebuffer
128   -waitvsync. Note that this option does not work with -video gdi mode.
136   -waitvsync. Note that support for this option depends entirely on your
137   operating system and video drivers; in general it will not work in
138   windowed mode so -video opengl and fullscreen give the greatest chance
139   of success.
129140   The default is OFF (-nowaitvsync).
130141
131142-[no]syncrefresh
r23550r23551
171182        and also increases the effective resolution of non-screen elements such
172183        as artwork and fonts. The default is 1.
173184
174-gl_forcepow2texture Force power of two textures  (default no)
175-gl_notexturerect    Don't use OpenGL GL_ARB_texture_rectangle (default on)
176-gl_vbo              Enable OpenGL VBO,  if available (default on)
177-gl_pbo              Enable OpenGL PBO,  if available (default on)
185-[no]gl_forcepow2texture Always use only power-of-2 sized textures (default off)
186-[no]gl_notexturerect    Don't use OpenGL GL_ARB_texture_rectangle (default on)
187-[no]gl_vbo              Enable OpenGL VBO,  if available (default on)
188-[no]gl_pbo              Enable OpenGL PBO,  if available (default on)
189
190   These 4 options are for compatibility in -video opengl.  If you report
191   rendering artifacts you may be asked to try messing with them by the
192   devs, but normally they should be left at their defaults which results
193   in the best possible video performance.
194
178195-gl_glsl             Enable OpenGL GLSL, if available (default off)
179196-gl_glsl_filter      Enable OpenGL GLSL filtering instead of FF filtering 0-plain,
180197                     1-bilinear (default)
r23550r23551
301318   you are trying to achieve the "exact" pixel resolutions of the original
302319   games, which requires significant tweaking. This option is also useful
303320   on LCD displays, since they run with a fixed resolution and switching
304   resolutions on them is just silly. This option does not work with
305   -video gdi. The default is OFF (-noswitchres).
321   resolutions on them is just silly.
322   The default is OFF (-noswitchres).
306323
307324
308325

Previous 199869 Revisions Next


© 1997-2024 The MAME Team