Scanner Dialog

The Scanner - The 'heart' of ClrMamePro. Here the action takes place. You have a separated resizeable scan-results window where all 'errors' are displayed. Don't forget to set the correct merge mode ! See below if you don't know how. The Scanner scans your ROM- and samplepaths and reports wrong sized roms, wrong named games, missing samples and on and on and on....and it can even fix most of the problems.

The Scan Results Window 

ClrMamePro lists all problems in this additional window. It's resizeable, minimizable and moveable. By clicking on the [+] symbols in the tree control you are able to see a more detailed information about the problem. 

The statusline at the bottom of the window shows some additional information about the selected item. You can also drag'n drop files in this window. ClrMamePro will use the current Rebuilder options and rebuilds the dropped files. After the rebuilding process it will do a Fastscan operation (see below). So you should only do that after a finished Scan operation.


The Options

You want to scan

Check this option if you want to check sets. Combine this e.g. with unneeded, name, missing or case check.

Check this option if you want to check sample files. Possible with unneeded, missing and case check.

You're Using

With the merge-settings within the scanning mode you only tell ClrMamePro what sets you're using. While scanning you don't merge things. It's only necessary to know what kind of sets you currently have.

You're using sets which aren't merged. Than means every single set has all needed ROMs in it.

You're using split-sets. You have a folder/zipfile for the parent and one for each clone. The ROMs in the clonefolders only belong to the clone but not to the parentset.

Scan Systems

Enable the sets you want to check. The scanner only checks checked systems. For example if the listbox shows 'arcade' and 'neogeo' and you enable 'neogeo', the scanner will only scan the neogeo sets. Double click this box to specify default-system-paths.

Check & Fix

Checks if a Set/ROM/sample file is missing. If you enable fix missing CMPro tries to add the missing ROMs from one of your 'add paths'. This fixing option isn't affected by the 'ask before fixing' option. Only correct files (right checksum and right length) will be added. To add bad dumps (roms with a 0-crc) you have to use the 0-crc-creation option. BIOS-files won't be added either. You can specify your 'add paths' in the settings dialog. If you grey the fix-missing box you'll activate the advanced fix missing option. The normal version only looks for the current gameset (or its clones / parent) in all addpaths. The advanced version will check any file in the addpaths. WARNING: Using the '(adv) fix missing' option can slow down the scanning process ! HINT: Add your backuppath to the 'add paths'...So it can automatically restore files which were unneeded in previous M.A.M.E. versions. Fix missing will also search all your rompaths (in a very fast way) for missing roms. CMPro will place new roms in the specified System-Default-Paths when 'Use SysDefault Paths' is enabled.

Checks if a ROM has the correct CRC32 (checksum).

Reports unneeded sets/ROMs/samples. Be warned: Everything which isn't a set/ROM/sample (in your ROM/samplepaths) will be reported as unneeded. This may include executable or other files. So be sure that your ROM- and sample paths are set correctly. If backup is enabled you won't lose any files because they'll be stored in your backupfolder. All files in the 'Misc' paths are protected ! They won't be marked as unneeded. Same for files in the ClrMamePro and backupfolder (but not in their subfolders...). If you specified UnneededMasks (See Settings Dialog), ClrMamePro won't mark these extensions as unneeded.

Checks for the correct name of a set/ROM file.

Checks for the correct size of a ROM file.

Checks for the right case of a set/ROM/samplename. This is useful for case-sensitive operating systems.

Misc. Options

This option is only available when fixmissing is active. ROMs will be added to the specified System-Default-Path if this option is enabled.

If this option is enabled, ClrMamePro allows alternative ROMnames. Turning this option off will scan for a much cleaner set....I prefer disabling this option.

Enables the 'sample merging'. M.A.M.E. supports so called 'Alternative Samplesets'. Some sets share their samples. You have to enable this option to get less sample-missing-errors.

Only available if you're doing an unneeded scan. Enabling this option will change the unneeded operation a bit. Now even valid ROM/sample files can be marked as unneeded. It's useful if you're using split merged sets. If so, it'll mark ROMs/samples as unneeded which are inclone sets but belong to the parentset. This option also finds not-separated-biosfiles.

ClrMame will automatically create dummy files for missing 0-crc ROMs (bad dumps). They will have the right length but they are filled with byte-values 0x00.

If you don't want to get missing bad dump messages you should disable this option. Grey this button if you want to see all 0-crc files (not only missing ones).

ClrMamePro will ask you before any fixing operation if you're really sure.

The statistics are added to the logfile if this option is enabled.

The Scan-Results-Window will stay on top of all other windows.

Fixed problems won't be displayed in the Scan-Results Window.

Scan & Fastscan

Press the Scan button to start the scanning process. After it is ended you'll see a scanning summary with some statistics. If you don't abort the scan you'll be able to do fastscans.

Fastscan is the same as scan but it'll only scans the files which reported 'errors' in a previous ended (not aborded) scan operation. So you have to do a valid scan operation first. After an ended fastscan or scan operation, ClrMame will update the fastscan file. If you do a Fastscan all scanner-settings are set to the old values. Exception: You can enable/disable the 'fix' settings.

Fastscan: Enter (or browse) a filename of a fastscan-data-file. This file holds the information about a fastscan. This file will be updated after every ended (not aborded) scan- or fastscan operation.

Logfile

Press the Save Logfile (symbol) button to save the current scan-results to a text-file.

Enter (or browse) a filename of the logfile. The reported lines will be saved in this file if you press 'Save Logfile'.

Press the 'Copy-To-Clipboard' (Symbol) button to copy the current output in the scan-results window to the Windows-Clipboard.

Press the 'Save-Missing-List' (Symbol) button to create a file with a list of missing sets. This option is only available when you enable (at least) 'sets' and 'missing'.

Hide & Show

After a Scan or Fastscan operation you're able to hide or show items in this outputwindow. The output depends on the values of the sets, ROMs, Samples, Missing, Length, Case, Unneeded, Name, Checksum and 'Show all 0-crc' buttons.

Let's assume you did a 'missing' + 'ROMs' + 'Samples' scan. A lot of output was added to the scan-results window. Now you only want to see the missing samples. Disable the 'ROMs' button and the scan-results window will reorganize itself and you'll only see the missing samples. Don't forget: You can only hide / show things which your scan or fastscan operation reported. For example: If you didn't scan for unneeded files, you can't show them after the scan. You have to do a rescan with an enabled 'unneeded' option.

Two little exceptions: 'unneeded' files are displayed if you enable 'unneeded' and sets OR ROMs OR samples. You can't hide missing 0-crcs by disabling 'show missing 0-crcs'. You have to disable 'missing' to do this.


Popup Menus

When right-clicking an item in the scan-results (all but unneeded files) you'll see a popup menu.



You can specify a pre- & a poststring or copy the current foldername (which will be concatenated with the strings: prestring + foldername + poststring) to the clipboard. This is extremly useful if you use download-managers which monitor the clipboard.

Send <....> to brower will send the prestring + foldername + poststring to the default browser.

If you want to see all items and child-items of the scan results window, you can use the 'Expand All' switch.

To prevent the treeview from scrolling (e.g. when a new item is added) you can disable the 'Auto Scroll' option.

If you don't want to see any complemented CRC32s you have to disable the 'Show Complemented CRC' option. But don't forget: After changing this option you have to do a new scan or fastscan to hide/show the complemented CRCs.