# MESSUI Configuration

This section describes the basics of the running and configuring the MESSUI. MESSUI is the graphical user interface to the MESS core. This section also includes a description of menu options and system configuration tabs.

## Quick Start

Open MESSUI by double clicking messui.exe and you will see a screen like this:

When you run MESSUI for the first time it will automatically hunt for available system rom files. If it doesn't find any or you add more press "F5" to update the system list.

## Menu Options

MESSUI is far easier to use than the command line versions of MESS. Most of the functions can be accessed from its menus. Here is the complete description of all of MESSUI's menus...

File Menu
Run (Selected System) | Runs the selected system in the system list
Play and Record Input | Saves a file that contains all the control inputs that you make whilst running a system.
Playback Input | Lets you play back the Input file of you running a system.
Select Random system | Runs a system randomly from the list
Open Other Software | Lets you load software from a different folder.
Create Image | Takes the software you've loaded and will save it as a snapshot image.
Properties | Opens the currently selected systems properties box. Here is a description... General - Gives you information on the system. Audit - Tells you if you have a problem with the ROM file. Software - Will let you add more folders of software for the selected system. All the other options are covered in the MESSUI Configuration section below. Any settings changed in this window will only affect the selected system.
Audit All systems | Check all of the systems in MESS to see if the rom files are OK. If this option report a faulty system you will need to re-download it.

View Menu
Toolbar | Toggles the toolbar on the main MESS window
Status Bar | Toggles the status bar on the main MESS window
Folder List | Toggles the folders window on the main MESS window
Picture Area | Toggles the Screen Shot window on the main MESS window
Screenshot Tab | Toggles whether the tabs above the screen shots are displayed.
Fullscreen | Runs the MESSUI using the whole of your screen.
Show Pictures | Lets you pick what pictures are shown in the picture area.
Large Icons | Views the system list as Large icons
Small Icons | Views the system list as small icons
List | Views the system list as a list of systems
Details | Views the system list as a detailed list of systems
Grouped | Views the system list with parent systems and clones listed together.
Arrange Icons | Arranges the icons on the system list if you have moved them
Line Up Icons | Lines up the icons in the main windows without sorting them.
Refresh | Refresh the system list if you add new systems.
Custom Filters | Lets you filter out unwanted system types in the folders window.
Customize Fields | Lets you decide what information is displayed about systems in the detailed system list.

Options Menu
System List Font | Lets you customize the font used to display system names.
System List Clone Colour | Lets you specify a color for systems that are clones to differentiate them.
Directories | Lets you add or overide the default directories used by MESS. Useful if you store you systems on CD for example.
Default System Options | Lets you set the options used for every system in MESS unless it is overidden by changing the systems properties. See below for details.
Reset To Default | Resets all setting to the original default settings.
Interface Options | Changes the settings for when MESSUI initially starts. The best options here are at the bottom as they turn off the annoying "Press OK to continue" loading screen.
Background Image | Lets your pick an image to display as the background to the rom lists
Language | Lets you select an alternative language file if you have a problem understanding English.

Help Menu
Help and Readme Files

## Config Window

You can see below the default options window on MESSUI. This is where you set up all of MESSUI's options. You can access if by going to Options -> Default Options menus. Here is a complete description of what you can change...

Display Tab
Run In A Window | Chooses between running the selected system in a window on your desktop or fullscreen. Most of the time the fullscreen option will make systems run smoother.
Start Out Maximized | Opens a system window using the whole desktop.
Enforce Aspect Ratio | Makes sure that the system screen is drawn in the same aspect as the original machine. If you turn it off the system will be stretched to fill the entire screen therefore distorting it.
Throttle | Enables the speed throttle built into MESS.
Clean Stretch | Stops the blurriness you normally see when MESS has to stretch the system screen
Zoom | Lets you zoom in a system
Rotation | Rotates or flips the screen which is useful if you have an arcade monitor in a cabinet that has been rotated.
Effects | Adds some effects to the systems screen that can give a more "authentic" TV monitor feel on your PC monitor.
Gamma Correction | Increases the overall brightness of the systems screen if you find it too dark.
Brightness Correction | Increases the brightness of the systems screen if you find it too dark.
Pause Brightness | Changes the overall brightness of the system when its paused.

Advanced Tab
Use Direct Draw | Turning this off is a bad idea as it will slow things down considerably!
Triple Buffering | Helps systems run smoothly (if supported by your video card)
Match system Refresh Rate | Syncs your monitor to the refresh rate used on the original system. (If your monitor can!)
Sync To Monitor Refresh | Tells MESS to ignore the systems refresh rate and use your monitors.
Wait For Vertical Sync | Makes MESS wait before drawing a systems screen until the last one finishes which stops the screen appear to "tear."
Stretch Using Hardware | Uses your video card's hardware to stretch a systems graphics to fill the screen.
Switch Resolutions To Fit | Switches the screen resolution to best fit the systems one.
Switch Color Depths To Fit | Tries to ensure that the correct amount of colors are used to match the systems.
Full Screen Brightness | Increases or decreases the overall brightness of the systems screen.
Aspect Ratio | Lets you set the exact screen aspect that suits you monitor. (Useful for widescreen monitors)
Resolution | Lets you set the system screen to an exact size and color depth.
Frame Skipping | If you find that systems are running slow you can tell MESS to skip x amount of frames in every 12. If left on "Auto" MESS will adjust it itself.

Direct3D Tab
Use Direct3D | Lets you use your 3D card to draw the system screen as it can be faster.
Texture Management | Lets DirectX manage all system screen to texture operations rather than MESS. Only change if you have problems.
Rotate Effects | Rotates the d3deffect command to work with vertically aligned monitors.
Filter | Sets the filter (blurriness) when using D3D for rendering the system screen thus reducing jagged edges.
Effect | Adds screen effects when the system screen is drawn.
Prescale | Works like sharp in the effects so doesn't blur the screen.
Scanlines | Sets the scanline intensity if you select this effect.
Feedback | Something about feedback intensity (Whatever that is!)

Sound Tab
Enable Sound And Sound CPU's | Enables / Disables Sound (Tip! Sometimes you can speed up a system by disabling its sound!)
Use Samples | Sometimes systems require extra sound samples to work completely. Sound samples must be downloaded and stored in the samples directory.
Resample If Sample Rate Does Not Match | Lets MESS ensure that the correct sound quality is produced by a system.
Sample Rate | Determines the quality of the sound produced by MESS. (Tip! You can improve performance sometimes by lowering sound quality)
Volume Attenuation | Simply a volume control.
Audio Latency | Increase this slider if you get clicks and pops in a systems sound.

Controllers Tab
Enable Joystick Input | Let you use a joystick to control systems
Analog Joystick Deadzone | Sets the dead zone (a distance a controller travels without registering a movement) of an analog controller when used on a digital system.
Enable Mouse Input | Lets you choose whether MESS uses the mouse on trackball systems.
Enable Lightgun Input | Lets you use a lightgun on systems that support it.
Enable Steadykey Support | If you find that MESS won't let you press more than one key at a time (usually during combos in fighting games on consoles or the Capcom CPS Changer), steadykey will help.
Default Input Layout | Determines which controller ini file MESS uses.

Miscellaneous Tab
Enable system cheats | Cheater...!!
Error log (for Developers) | Enables some extra logging features.
Sleep when possible | Allows MESS to give time back to the system when running with -throttle. This allows other programs to have some CPU time, assuming that the game isn't taxing 100% of your CPU resources. This option can potentially cause hiccups in performance if other demanding programs are running. The default is ON.
Skip System info | Bypasses initial system info screen when starting a new system
Save game state on exit | If save states are supported on the system it will save the state (not working).
Multi-threaded rendering | Enables multithreading within MESS. At the moment, this causes the window and all DirectDraw/Direct3D code to execute on a second thread, which can improve performance on hyperthreaded and multicore systems. The default is OFF (-nomultithreading).
Thread priority | Sets the thread priority for the MESS threads. By default the priority is left alone to guarantee proper cooperation with other applications. The valid range is -15 to 1, with 1 being the highest priority. The default is 0 (NORMAL priority).
Skip warnings | Bypasses system warning screens when starting a new system. Not reccomended.
Use New UI | Utilize a windows menu based system as opposed to the classic "MAME" like interface
Backdrops | Enable artwork used as backdrop images.
Bezels | Enable artwork used as the bezel surround.
Overlays | Enable artwork used as overlays to systems.
Crop Artwork | Crops the edges of the artwork to the edge of the system screen.
BIOS | Select the system BIOS to use.

Vector Tab
Draw Antialiased Vectors | Let you choose whether MESS smoothes the edges of vector graphics systems such as the Vectrex. (Tip! Unchecking this option can significantly improve vector systems speed).
Draw Translucency Vectors | Simulates the translucency of the beam that is generated in arcade machines displays.
Beam Width | Width of the line being drawn for the vector.
Flicker | Simulates the flicker of the beam on arcade machine displays.
Intensity | Sets the brightness of the lines.

You must remember that changing these settings affects all systems. Sometimes you will find that changing a setting to benefit one system can hinder another. The obvious answer is if the system you are using performs badly and other systems don't, change it's settings individually using the file menu → properties option.