BridgeMats Version B309 Copyright (c) 2013 Usage: BridgeMats.pl [switches] movement-file where movement-file is an ACBLscore movement file and switches are: -b number Number of boards per round (default for ~24 boards) -c number Text color (0 in BridgeMats.sw): 0=use number of tables, black for partial tables 1=Black (program default), 2=Olive, 3=Purple, 4=Green, 5=Blue, 6=Teal, 7=Red, 8=Orange, 9=Brown. -d Dump the movement file as text to stdout (see -n) Use Notepad to print after redirecting (> file.txt) -f factor scale factor: default 1.0 for US Letter. Use 1.27 for full US Legal, 1.11 for Baron/Barclay sleeves, 1.15 for old ACBL. See -W. -g number group this number of ACBLscore rounds as one - when applicable, -g is required for correct next table -h Print this help to stdout and exit -l Omit the last mat (dummy table in ACBLscore) -L Print the license for BridgeMats and exit -m Write .IND rover movement file (sets -n, -d), error if not: input output with -R note S0721.IND S0721R.IND S0721RR.IND rotation S0824.IND S0824R.IND S0824RR.IND rotation S0924.IND S0924R.IND S0924RR.IND rotation S1027.IND S1027R.IND S1027RR.IND rotation S1133.IND S1133R.IND S1133RR.IND rotation S1224.IND unable to compute, if any S/E switch S1326.IND S1326R.IND S1326RR.IND S/E switch -M Perform calculations for .IND rover movement and exit. Over 9 tables: calculations may be lengthy, and a rover movement without conflicts may not exist. -t 8 or -t 11 recommended. To use the results, the program must be modified. -n Produce no PostScript mats, dump only (sets -d) -o number Produce only the mat for this table number -r number Roving pair/player number (value from file is ignored) -R number The direction of the SECOND rover (0=N, 1=E, 2=S, 3=W); must be a double rover individual movement. With rotation, the first rover is always W; without rotation, the first rover is always N. Usually specify 3, but use 0 for S1224 or S1326. -s Print scoring table to Scorer.htm -- this switch must be last, and the switch file is not read. (Open Scorer.htm with MS Word, paste the table into Excel.) -t number Truncate movement after this number of grouped rounds - 27 ungrouped rounds is the maximum without overprinting -w Double-weave movement (even EW down, odd EW up), board jump -W inches Specifies the print area width, in inches. For the width produced prior to version B309, perhaps with -f 1.11 for Baron/Barclay sleeves, use -W 5.0. To fill the width of US Letter paper, use -W 8.0, the default. -x 2-table appendix (Bowman) movement: only top two tables BridgeMats.pl writes a PostScript file of guide cards (table mats) from a binary ACBLscore duplicate bridge movement file. You should run it in a DOS box. Next, open the resulting file in GSview, where you may examine, print and/or convert to a PDF. The PostScript file could also be tweaked using Notepad - its name is the same as the movement file, but with the .PS extension. For best results, the current working directory should contain the movement file (whose extension must be .MOV, .BAM, or .IND), BridgeMats.pl, BridgeMats.ps, and BridgeMats.sw. Movements normally come from C:\ACBLSCOR\MOV, \BAM or \IND - or wherever you saved them from ACBLscore. Perl must be installed on your system and in your path. Get it for MS Windows from http://www.activestate.com/Products/ActivePerl/. Get GSview and Ghostscript from http://www.ghostgum.com.au/ or http://www.cs.wisc.edu/~ghost/gsview/ - both are needed. You'll probably need to run BridgeMats.pl, to determine the best switches to use for a new movement. Some movements are difficult or impossible to diagnose. Check the results! BridgeMats.sw provides specific defaults for the tested cases below. Unless otherwise noted, the movements are ACBLscore "External". A full command line example (others rely on BridgeMats.sw): 13 pairs: bridgemats.pl -c 0 -d -g 2 -l -r 13 H7ROVER.MOV One-winner movements, generally 24 boards: 4 pairs: bridgemats.pl H0203.MOV -- save from ACBLscore 4 pairs: bridgemats.pl H0206.MOV -- ACBLscore external 6 pairs: bridgemats.pl H0305.MOV -- save from ACBLscore 8 pairs: bridgemats.pl H0406.MOV -- save from ACBLscore 10 pairs: bridgemats.pl H0508.MOV -- save from ACBLscore 12 pairs: bridgemats.pl H0608.MOV -- save from ACBLscore 13 pairs: bridgemats.pl H7RVR-S.MOV -- from PDM 14 pairs: bridgemats.pl H0712.MOV -- save from ACBLscore 12-board movements for Bridge Plus: 6 pairs: bridgemats.pl H0305B+.MOV -- save from ACBLscore 8 pairs: bridgemats.pl H0406B+.MOV -- save from ACBLscore 8 pairs: bridgemats.pl QM0404B+.MOV -- from PDM per Sicherman 10 pairs: bridgemats.pl H0506B+.MOV -- save from ACBLscore Square Mitchell Movement (no relay): 4 pairs: bridgemats.pl QM0404.MOV -- from PDM per Sicherman Double-weave movements: 16 pairs: bridgemats.pl M0808.MOV 24 pairs: bridgemats.pl M1212DW.MOV -- from Tim Francis-Wright 2-Table Appendix (Bowman) Movements (require two board sets): 20 pairs: bridgemats.pl MB1008.MOV -- from Tim Francis-Wright 22 pairs: bridgemats.pl MB1108.MOV -- from Tim Francis-Wright 28 pairs: bridgemats.pl MB1412.MOV -- from Tim Francis-Wright 30 pairs: bridgemats.pl MB1513.MOV -- from Tim Francis-Wright Individual movements, with rotation, when possible: 8 players: bridgemats.pl S0207.IND 10 players: bridgemats.pl S0310A.IND 12 players: bridgemats.pl S0311A.IND 13 players: bridgemats.pl S0413.IND 14 players: bridgemats.pl S0414.IND 16 players: bridgemats.pl S0412A.IND 18 players: bridgemats.pl S0509.IND 20 players: bridgemats.pl S0515.IND 22 players: bridgemats.pl S0611.IND * 24 players: bridgemats.pl S0621.IND 26 players: bridgemats.pl S0713M.IND 28 players: bridgemats.pl S0721.IND 29 players: bridgemats.pl S0721R.IND 30 players: bridgemats.pl S0721RR.IND * 32 players: bridgemats.pl S0824.IND * 33 players: bridgemats.pl S0824R.IND * 34 players: bridgemats.pl S0824RR.IND 36 players: bridgemats.pl S0924.IND 37 players: bridgemats.pl S0924R.IND 38 players: bridgemats.pl S0924RR.IND * 40 players: bridgemats.pl S1027.IND * 41 players: bridgemats.pl S1027R.IND * 42 players: bridgemats.pl S1027RR.IND 44 players: bridgemats.pl S1133.IND 45 players: bridgemats.pl S1133R.IND 46 players: bridgemats.pl S1133RR.IND * 48 players: bridgemats.pl S1224.IND 52 players: bridgemats.pl S1326.IND 53 players: bridgemats.pl S1326R.IND 54 players: bridgemats.pl S1326RR.IND * Personal guide cards are required for this movement (print from ACBLscore). Copyright (c) 2013 Peter D. Matthews, Jr. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.