Selected Game Content Panel - mmattner/vPinBackupManagerApp GitHub Wiki
Overview
The Selected Game Content panel provides view of game files and related content that make up a game and its settings.
The displayed information allows users to see what values have been found (when viewing current game content) or what values have been stored in the backup file (when viewing backup game content).
This content includes:
- All emulator defined game files, as dictated by configured gamer filters. Examples includes game/table files, as well as B2S and POV files, VPinMAME ROM, and alt colour/sound files or BAM game config files.
- Any Pup Pack content for the game from within the Pinup System PupVideo directory.
- Any Pinup Popper frontend game media files found in the Pinup System POPMedia directory structure.
- For emulators that make use of registry settings to store game information, a set of registry values used by the game.
The source of information viewed in this panel is determined by the selections made in the Selected Game Display Control Panel.
- If >Display Current Content is checked, the displayed content is taken from the currently active Pinup Popper database.
- If Display Backup Content is checked, the displayed content is taken from the currently games backup file.
There are two components that make up this panel, these are listed here and described in further detail below.
Quick View Status Strip
The Quick View Status Strip is shown as a strip of traffic light coloured rectangles across the top of the Selected Game Content panel. This status strip provides a very quick to view indication of the presence or not of key game files. The makeup of the status panels shown in this strip will vary by emulator and is driven by emulator configuration. The colour of each status panel in the strip provides an indication of the game files status, the colours are:
- A red status panel indicates the corresponding file is marked as mandatory and was not found. Failure to supply this file will result in the game not running or being significantly limited.
- A green status panel indicates that the file was found.
- A yellow status panel indicates the file was not found, however the file is not marked as mandatory.
Hovering the mouse over a status panel will provide a description of the file it represents, and for files that were found, will provide the file name for quick reference.
For files that were found a single click will expand the tree view below to navigate to the file that has been clicked on.
Tree View
The Tree View is the large "Windows Explorer" like control that dominates the Selected Game Content panel.
The tree view provides a complete tree-view representation of all content found for the game. Depending in what game content has been found, the tree-view may have 3 base nodes representing:
- The game emulator - containing all game emulator specific files
- Pinup system - containing Pup Pack content and POP media files that were found
- Registry settings - containing details of game specific registry settings.
Expanding the tree and navigating to a file item will show the full path to the file on either the file system (when Current is selected in the Selected Game Display Control Panel) or within the backup file. Double clicking on a file entry will attempt to open the file using the default Windows application associated with the file.
Contents of the registry node (if present) provides a quick way of viewing current registry settings for the game.
Update of Game Content
The Selected Game Content panel will highlight when there are differences identified between the system and backup by highlighting the panels border in an error color. Additionally the files for which differences exist will use colour coding to help to identify the type of difference detected. These files will also trigger right context menu options to allow the differences to be corrected. Using this context menu can save the need to perform another full game backup or restore.
The differences that may occur are:
- File only occurs in the current system: The file is highlighted in green when viewing the current system, the file will not be seen when viewing the backup. The context menu when viewing the current system will allow the file to be backed up or deleted.
- File only occurs in the backup: The file is not seen when viewing the current system, the file is highlighted in green when viewing the backup. The context menu when viewing the backup will allow the file to be restored or deleted from the backup.
- File occurs in both systems but has different content: The file is highlighted in red when viewing both the current system and the backup. The context menu will provide an option to backup or restore the file and to either delete the file or the file backup (whichever content is being viewed).
In the case where it is content in the VPReg.stg file corresponding to the selected game that differs, the context menu options will appear on the VPReg.stg file itself rather than individual content.
The image below shows a case where the games POV file has differences between the backup and the system and the backup content is being viewed.
If differences were found in either the Selected Game Filter Variables or the Selected Game Custom Filters panels, then the option to update files with differences is removed from the Current Game Content panel for all files other than the game file itself. This is because the values of filter variables and custom filters influences the file content displayed in the Current Game Content panel. As a result, these differences must be fixed first. This case is shown below.