trunk/docs/SDL.txt
| r23550 | r23551 | |
| 13 | 13 | |
| 14 | 14 | -[no]oslog |
| 15 | 15 | |
| 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 |
| 17 | 18 | the same time as -log to output the log data to both targets as well. |
| 18 | 19 | Default is OFF (-nooslog). |
| 19 | 20 | |
| r23550 | r23551 | |
| 33 | 34 | |
| 34 | 35 | -[no]multithreading / -[no]mt |
| 35 | 36 | |
| 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). |
| 40 | 43 | |
| 44 | |
| 41 | 45 | -numprocessors <auto|value> / -np <auto|value> |
| 42 | 46 | |
| 43 | 47 | Specify the number of processors to use for work queues. Specifying |
| r23550 | r23551 | |
| 48 | 52 | |
| 49 | 53 | -sdlvideofps |
| 50 | 54 | |
| 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. |
| 52 | 58 | |
| 53 | 59 | -bench [n] |
| 54 | 60 | |
| r23550 | r23551 | |
| 62 | 68 | |
| 63 | 69 | -video <soft|opengl|none> |
| 64 | 70 | |
| 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'. |
| 66 | 74 | |
| 67 | 75 | -numscreens <count> |
| 68 | 76 | |
| r23550 | r23551 | |
| 71 | 79 | screens. Each screen (up to 4) has its own independent settings for |
| 72 | 80 | physical monitor, aspect ratio, resolution, and view, which can be |
| 73 | 81 | 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. |
| 76 | 84 | |
| 77 | 85 | -[no]window / -[no]w |
| 78 | 86 | |
| r23550 | r23551 | |
| 101 | 109 | |
| 102 | 110 | -[no]unevenstretch |
| 103 | 111 | |
| 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) |
| 106 | 114 | |
| 107 | 115 | -[no]centerh |
| 108 | 116 | |
| r23550 | r23551 | |
| 125 | 133 | performance hit. You should only need to turn this on in windowed mode. |
| 126 | 134 | In full screen mode, it is only needed if -triplebuffer does not |
| 127 | 135 | 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. |
| 129 | 140 | The default is OFF (-nowaitvsync). |
| 130 | 141 | |
| 131 | 142 | -[no]syncrefresh |
| r23550 | r23551 | |
| 171 | 182 | and also increases the effective resolution of non-screen elements such |
| 172 | 183 | as artwork and fonts. The default is 1. |
| 173 | 184 | |
| 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 | |
| 178 | 195 | -gl_glsl Enable OpenGL GLSL, if available (default off) |
| 179 | 196 | -gl_glsl_filter Enable OpenGL GLSL filtering instead of FF filtering 0-plain, |
| 180 | 197 | 1-bilinear (default) |
| r23550 | r23551 | |
| 301 | 318 | you are trying to achieve the "exact" pixel resolutions of the original |
| 302 | 319 | games, which requires significant tweaking. This option is also useful |
| 303 | 320 | 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). |
| 306 | 323 | |
| 307 | 324 | |
| 308 | 325 | |