How to install DirectB2S backglass

Edit:  12/24/2016:    There is a newer all-in-one VP Installer that will install Visual Pinball and DirectB2S Server.  You can find it here:  http://www.vpforums....&showfile=11573
====================================================================
Tutorial assumes you have Visual Pinball and Visual PinMame installed and working.  
 
 
How to install DirectB2s backglasses:
----------------------------------------------
- If you do not have B2S server installed.  Install B2S Server to the Visual Pinball\Tables folder: http://www.vpforums....&showfile=12553
 (Follow the B2S Server install instructions here: http://www.vpforums....364#entry214341 )
 
- Configure screenres.txt in the Visual Pinball\Tables folder:   http://www.vpforums....showtopic=18020
(You can manually edit the screenres.txt file using the screenres.txt info below)
 
- Download a DirectB2S backglass and unzip it to the Visual Pinball\Tables folder: http://www.vpforums....oads&showcat=42
 
- Modify existing table script to change from using VPinMame server to the B2S Server:
    - Open table script 
    - If you see 'Choose Controller: 1-VPM, 2-UVP, 3-B2S' near the top of script, change it to option 3
    - Else, search for Set Controller = CreateObject("VPinMAME.Controller")             and change it to      Set Controller = CreateObject("B2S.Server")           
 
Here is a screenres.txt utility to setup and test your screenres.txt file.  You have to experiment with the Backglass display #.  Download, unzip, run and open or create your screenres.txt file
https://drive.google...iew?usp=sharing
 
Details about the screenres.txt file (credit to rosve2020):

1920 <-- Playfield screen X resolution (width)
1080 <-- Playfield screen Y resolution (height)
1280 <-- Backglass screen X resolution (width)
1024 <-- Backglass screen Y resolution(height)
2    <-- Display number for the backglass monitor
0    <-- offset for the backglass on the selected display (normally left at 0)
0    <-- offset for the backglass on the selected display (normally left at 0)
600  <-- Width of the DMD area in pixls
200  <-- Height of the DMD area in pixels
1280 <-- X position of the DMD area relative to the upper left corner of the backglass screen
0    <-- Y position of the DMD area relative to the upper left corner of the backglass screen
0    <-- Y-flip, flips the LED display upside down

 
Multi-monitor troubleshooting
---------------------------------------------
Installing B2S backglasses, typically means you have a multi-monitor setup. Here are some common monitor setup tips:
1) Playfield monitor needs to be primary monitor 1 and it needs to be in landscape orientation (VP will not work if set to Portrait mode)
2) Layout of displays in Windows is important:   In Windows Control Panel -> Display -> Screen resolution.  Playfield monitor should be on the left with additional monitors to the right of the playfield and probably best to have it aligned with the Playfield monitor vertically (i.e. monitors should be not be higher or lower than playfield monitor location).  I don't think the order of the Backglass or DMD monitor is critical.  Mine is setup as Playfield, backglass then DMD monitor going left to right.
3) When using the Visual Pinball program, keep the application window on the playfield monitor, as the B2S backglass may not hide the VP app window when playing tables
4) If the Backglass scoring reels or animated parts are shifted/showing in the wrong location, check the Windows Font Scaling settings and make sure it is set to 100%. Open Screen Resolution by clicking the Start button , clicking Control Panel, and then, under Appearance and Personalization, clicking Adjust screen resolution. Set to 100%
 
DMD rotation
----------------------------------------------
Rotation of the DMD is configurable in the table script, but there is more than one way to change it depending on the table.  The reason the DMD rotation is not consistent is because some authors have their DMD monitor installed horizontal and some vertical in their pincabs
 
1) Run the table and Press F6.  See if there is an option to change DMD rotation.  If not, exit the table and try the options below:
 
2) Open the table script.  Look near the top of the script and look for something like this:
' DMD rotation
Const cDMDRotation  = 1  ' 0 or 1 for a DMD rotation of 90°
 
Change the value to rotate the DMD. 
 
3) Search for DMD.  You should find something like:
 

Sub Table1_Init()

vpmInit Me 

With Controller
.GameName  = cGameName
.SplashInfoLine  = "BARRACORA (Williams 1981)" 
.HandleKeyboard  = True
.ShowDMDOnly = True
.ShowFrame = False
.ShowTitle  = False
.HandleKeyboard = False 
.Hidden = False
.Games(cGameName).Settings.Value("rol") = 1 

Simply change the "rol" value from 0 to 1 or vice versa
 
If the "rol" line is not there, you can add it but you will have to follow the style used in the script.  Here are some examples:
   .Games(cGameName).Settings.Value("rol") = 1 
   or
   Controller.Games("XXXX").Settings.Value("rol") = 1         
 
Where "XXXX" is the rom_name
 
 
 DMD Size and Location
---------------------
1) Right click on DMD and enable Border
2) Click and drag DMD to new location.  Click and drag on edges to resize
3) Right click and hide the border (If the DMD moves back or changes to orig size, try moving it to desired location, shake it a little before hiding the border)
 
DMD still wont save location
-----------------------------
1) Start the table, Press F1 to bring up the vPinmame setup and make sure "Cabinet Mode" is checked.  If F1 does not bring up vpinmame setup, you may need to disable "Exclusive Fullscreen" VP mode temporarily.  You will need to do this for any existing tables.  To make this the default setting for new tables, go to the Visual Pinball\Vpinmame folder, run setup.exe, click on Setup Defaults and check the "Cabinet Mode" setting.
1) If you do not see "Cabinet mode, install the latest vPinmame version located here: http://www.vpforums....&showfile=11571.  You can also use the latest VpinMame beta here: http://www.vpforums.....27063&p=256944
Open the zipfile and copy just the VpinMAME.dll file to the VPinMAME subfolder in your VP folder. Overwrite the file by the same name
2) Check Windows monitor setup.  Playfield should be on Left as primary display.  DMD and Backglass monitors should be to the right of the playfield and not higher than the playfield
3) Check if table script is forcing specific DMD location.  Open the script of the table and search for these terms
1) dmd_pos_x
2) dmd_pos_y
3) SetDisplayPosition 
If you find these in the script, make sure they are commented out so they will be ignored.  Just add a ' character at the start of the line to comment it out.  
 
Hide the DMD window if the Backglass already has scoring reels/LED on the backglass.
---------------------------------------------------------------------------------
Search for DMD.  You should find something like:
 

Sub Table1_Init()

vpmInit Me 

With Controller
.GameName  = cGameName
.SplashInfoLine  = "BARRACORA (Williams 1981)" 
.HandleKeyboard  = True
.ShowDMDOnly = True
.ShowFrame = False
.ShowTitle  = False
.HandleKeyboard = False 
.Hidden = False
.Games(cGameName).Settings.Value("rol") = 1 

Simply change the ".Hidden = False" value from False to True or 0 to 1

If the "Hidden" line is not there, you can add it but you will have to follow the style used in the script.  Here are some examples:
.Hidden = 1
or
Controller.Hidden=1

 
Setting up a default DMD location for all tables
--------------------------------------------------
Here are some DMD related tools that are supposed to be able to do this (I have not used them)
http://thebigboss.or...ade/setdmd.html
http://www.hyperspin...?9580-DMD-Mover
 
If you are comfortable with the Windows registry, here is the manual way to setup a specific DMD size and location for all new tables (I used this approach)
1) Setup the DMD for one VP table manually the way you want it.  
2) Open the registry and locate Computer\HK_LOCALUSER\Software\Freeware\Visual PinMame\<rom filename> for the table you manually setup.  Write down the values for the 5 keys below, 
3) Now navigate to Computer\HK_LOCALUSER\Software\Freeware\Visual PinMame\default and create duplicate keys in the Default folder.  
 
ALTERNATE APPROACH: 
1) Setup the DMD for one VP table manually the way you want it.  
2) Open the registry and locate Computer\HK_LOCALUSER\Software\Freeware\Visual PinMame\default   and delete that entry
2) In the registry, now locate Computer\HK_LOCALUSER\Software\Freeware\Visual PinMame\<rom filename> for the table you manually setup and rename it to Computer\HK_LOCALUSER\Software\Freeware\Visual PinMame\default
All new tables will automatically pick up the Default settings
 
 
Every new ROM/Table played will start with the default values.  You can edit any existing ROM entries if desired or delete them, so they will be re-created based on the default entry the next time you play that table
 
Here is a screenshot of the key DMD size, location and rotation settings

 
 
 
I will add more troubleshooting tips to this tutorial as needed