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.
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. Cloneitems have a different textcolor. You can change that color via the popup-menu (See below).
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.
By single-clicking the reported messages you will be able to copy parts of them (e.g. the CRC32).
The "?" Symbol will open a new Set-Information window.
The Set Information window will be automatically updated when you click on an item in the Scan-Results window. It shows the name, description, clone, sampleclone and manufacturer information about the currently selected set. It also lists all roms and samples with detailed information like crc32, size, complemented crc, md5 and name.
Missing, wrong sized, wrong named and wrong-crc32 roms/samples are shown with a different icon and a red-backgroundcolor. If the roms are fixable, the color is orange. This color-display is only taken from the current scan. So if you only scanned for wrong-sized roms, you won't see a red background for missing roms. You can use the name-editbox to switch to a different set (even if it's not listed in the scan-results window). If the set isn't shown in scan-results, you don't get any additional coloring of roms with problems !
Hide Parent-ROMs will hide parent roms in clonesets.
The title bar shows the currently selected profile and the number of selected sets.
Check this option if you want to check sets. Combine this e.g. with unneeded, name, missing or case check.
This option should be enabled if you want to scan the ROM files of a set. Combine this option with e.g. missing, unneeded, length, checksum, case or name check.
Check this option if you want to check sample files. Possible with unneeded, missing and case check.
Currently disabled because it's not yet fully supported.
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.
You're using merged sets. You have only one folder for the parent and the clone roms.
Enable the sets you want to check. The scanner only checks checked systems. For example if the listbox shows 'standard' and 'neogeo' and you enable 'neogeo', the scanner will only scan the neogeo sets. Double click this box to specify default-system-paths.
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. The fix-missing operation only looks for the current gameset (or its clones / parent) in all addpaths. 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' (see Advanced..) is enabled.
Checks if a ROM has the correct CRC32 (checksum).
Checks the md5 information (if available) of ROMs. This operation takes LONG !!!. ClrMamePro has to unzip each rom into memory and has to calculate the md5 of it. You should only do it if the current datfile uses md5 tags and you're not sure if you may have some dupes.
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. If you specified UnneededMasks (See Settings Dialog), ClrMamePro won't mark files which match any UnneededMask. You can also exclude folders from being marked as unneeded. Useful if you're using sub-romfolders. You have to specify Excludepaths (See Settings Dialog).
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.
ClrMame will automatically create dummy files for missing 0-crc ROMs (bad dumps). They will have the right length but they are filled with a bytepattern.
With this option you toggle the display of bad (0-crc) roms. You can hide all, show only the missing ones or even show all 0-crc roms.
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. And you'll see the statistics after a scan operation.
This will show you the advanced scanner options window:
Full Zip Integrity Check
This will enable a slow scanmode which unzip each rom/sample
to memory, calculate its checksum and compares it with the stored one. It's
like a PKUNZIP/WINZIP test operation. Possible Errors will be displayed in the
warnings-window. If Inflate or bad crc32 errors are listed, you
have a corrupt zipfile !
Empty (and useless) ZipSubFolders will be marked as unneeded (in an unneeded scan) when this option is enabled.
Allow Not Separated BIOS ROMs
Normally not separated BIOS ROMs are marked as unneeded. Enable this option if ClrMame shouldn't mark them as unneeded.
Move not renamed sets to Backup
Only available when fix name is active. When a renaming operation of a set fails, ClrMamePro moves that still wrong named set to the backupfolder.
Adds the descriptionstring of the listed when creating have/miss lists. Otherwise you only get the setname.
The Scanner window won't appear while a scanning. You'll only see the progress- and the scan-results window.
The Scanner remebers all scan-results. Even after a ClrMamePro restart.
ClrMamePro reorganizes the order of the ROMpaths at runtime to increase scanner speed. If disabled, ClrMamePro takes the rompath order which is set in the Settings dialog.
Looks for fixable missing roms even when fix-missing is disabled. If ClrMamePro finds a fixable file you'll get a "missing (but fixable)" message plus the name of the set where it can be found. This additional check will make the scanner slower.
Same as fix missing, but it scans any (!) set in the addpath for a possible missing file. Not only the parent/clone sets. This takes long !
This option is only used when fixmissing is active. ROMs will be added to the specified System-Default-Path if this option is enabled.
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.
Enter (or browse) a filename of the logfile. The reported lines will be saved in this file if you press 'Save Logfile'. Press the Save Logfile (disk symbol) button to save the current scan-results to a text-file.
Fastscan File: 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.
Save Logfile Automatically
If this option is enabled, the logfile will be saved without prompting after a successful scan/fastscan.
Press the 'Save-Missing List' (Right Symbol) button to create a "miss" set list. It will do a quick scan through your rom/samplepaths to create these lists.
Press the 'Save-Have List' (Left Symbol) button to create a "have" set list. It will do a quick scan through your rom/samplepaths to create these lists.
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.
By clicking on the little button at the bottom-right you will toggle the WarningsWindow.
The warningswindow (below the scanner) has a popupmenu. With the two options you can dock the window to the scanner window and you can clear the messages in that warnings window. Auto-Scroll takes care of scrolling when more than one message is shown in that warnings-window.
When right-clicking an item in the scan-results (all but unneeded files) you'll see a popup menu, too.