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. 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 

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.

Diskimage md5s are the ones from the chd header which represent the md5 of the decompressed image.

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 Options

The title bar shows the currently selected profile and the number of selected sets.

You want to scan

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

Sets have to be stored in this way:

<rompath>\<setname>.zip (for compressed sets)
<rompath>\<setname\ (for not compressed sets)

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

Samples have to be stored in this way:

<samplepath>\<setname>.zip (for compressed sets)
<samplepath>\<setname>\sample 1 .... sample n (for not compressed sets)

 

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 the checked Systems

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.

 

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. 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.

Here you can setup which checksums (if available in the datfile) can be checked for. Be warned: Some checksums will lead to long scan time. Checksums are greyed out if they aren't used in the belonging datfile. Check the checksum-checkbox to enable/disable global checksum checking.

Remark: MD5 in CHD is used for DiskImages. It's a check for the MD5 which is stored in the CHD DiskImage Header. The MD5 is calculated over the decompressed Harddiskimage. ClrMamePro won't decompress the image and only checks the stored MD5 value with the one provided in the DatFile.

Zip Full 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 !

When CHD Full Integrity Check is enabled, ClrMamePro will check the integrity of any chd block. This takes long ! You will see a second progressbar while scanning and you can use CANCEL button there to skip this check.

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.

Bad Dump Handling

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.

Misc. Options

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.

Adv. Options

Normally not separated BIOS ROMs are marked as unneeded. Enable this option if ClrMame shouldn't mark them as unneeded.

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.

Some zipprograms add a fake and useless zipentry for subfolders. You can use the fix unneeded option to remove these structures when this options is enabled.

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.

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.
 

Logfile & Fastscan...

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.

You can manually remove the logfile and fastscan files by clicking on remove buttons (red cross).

Other Buttons

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.

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

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. Copy To Clipboard copies all listed items to the clipboard.

 

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