Settings - vpinball/b2s-backglass GitHub Wiki

When an already opened Backglass is shown, it is possible to open the settings page, by clicking right mouse button. Once finished, the settings can be saved pressing "Save settings" or "Close" to close the window. The settings are stored in a bigger file called B2STableSettings.xml containing global settings (tagged B2STableSettings) as well as settings for each used rom (tagged with the ROM name (cGameName)).

Settings window

Header

In the header you see the name of the table (1) and ROM (cGameName) and if the settings is open through the "B2S Backglass Server" (COM dll) or "B2S Backglass Server EXE" (2) and which version and if x64 is used (3). This information is useful when reporting issues here on github. When the logo is pressed, the current setting paths are shown. (see image below)

General

Some backglasses has double modes called "Authentic" and "Fantasy". Authentic tries to stick to how the backglass look in real life and Fantasy adds new magic to the scene.

Visibility

In this section you can specify which parts should be shown. "Standard" means that the default set in the header of the B2STableSettings.xml is used, as opposed to setting "Visible" or "Hidden" specifically for this one table. "Bring forms" & "Form No Focus" deals with how the windows are opened and how they interact (or not) with the mouse. These settings have become less important since V2.0.0 by using B2SWindowPunch. Standard for the Grill means if both the X and Y positions of the DMD is zero it will hide.

Backglass startmode

B2S Server can be started only using the (COM Object) B2SBackglassServer.dll or by calling B2SBackglassServerEXE.exe. This should improve performance, and newer developments like Backgrounds (small button) is only available in the exe (marked in the window using italic) over time more features are merged back to the dll. The "small button" is available under visibility, background.

exact .directb2s match means (when activate) it only searches *.directb2s files named exactly as the vpx file. This is the new default since 2.0.2!

Performance & LED tuning

In these sections it is possible to tweak the CPU usage by skipping frames on animations and switching LED type.

Screenshot

Choose file path and screenshot file type.

Plugins

Turning off "Error message without backglass" is needed if a table uses Pinup Player without a .directb2s file. The "Plugin settings" button is grayed out if it cannot find the Plugins folder next to the B2S System files, Pressing the button opens the plugin settings window:

Buttons

"Edit Screenres..." opens the B2SScreenResIdentifier for this table. (V2.0.0)

"Save settings..." ...

"Close..."

When the "More..." button is pressed this window is opened:

Additional registry settings

All these can be set in Settings->More... see picture above.

B2STableSettingsExtendedPath

The old way the B2S Server works is that it expects the B2STableSettings.xml in the same folder as the table file.

With Version 2.0.0 if you set the registry key HKCU\Software\B2S\B2STableSettingsExtendedPath to String "1" it will first check the folder of the table file and then the folder where the B2S Server is installed (Tables folder or where you put it).

This way you only need ONE B2STableSettings.xml next to the B2S Server. And in case you need a local version, you can put one manually next to your table file as well.

B2SScreenResFileNameOverride

If you set the registry key HKCU\Software\B2S\B2SScreenResFileNameOverride to a filename different from ScreenRes.txt, this is the name used for the global ScreenRes file in B2S Server as in B2SScreenResIdentifier

B2SWindowPunchActive (V2.0.1)

This registry key HKCU\Software\B2S\B2SWindowPunchActive controls if the B2SInit.cmd (B2SWindowPunch) is called at all.