updated polyglot protocol
[xboard.git] / winboard / install / files / root / WinBoard / doc / texture.html
1 <html>\r
2 <header>\r
3 <title>WGP: Board and Pieces</title>\r
4 </header>\r
5 <body>\r
6 <table cellpadding="20"><tr><td>\r
7 <h1>The WinBoard Gold Pack 4.4.0</h1>\r
8 <h2>For the ultimate WinBoard experience!</h2>\r
9 </td><td>\r
10 <img src="mini.gif">\r
11 </td></tr></table>\r
12 <h3>Using a Bitmap Image for Chess Board</h3>\r
13 <p>\r
14 WinBoard 4.4 allows the user to use arbitrary images for the board squares.\r
15 This feature was first introduced in\r
16 <a href="http://www.ascotti.org/programming/chess/winboard_x.htm">Winboard_x</a>.\r
17 The images have to be given as a bitmap, and the board squares are cut out of it.\r
18 The Winboard_x home page shows some examples of this,\r
19 and hosts the bitmap files needed to acheive them for download.\r
20 The direct links are listed below.\r
21 </p><p>\r
22 The first step is to download the image.\r
23 Of course you could also provide one yourself.\r
24 The format must be bitmap (.bmp), but if you have an image in another format\r
25 (.jpg, .gif) you can use MicroSoft Paint to convert it to .bmp;\r
26 simply open the image file in Paint, and the use the "File -> Save as..." menu \r
27 to save it as bitmap.\r
28 The format in which you save can be selected at the bottom of the save dialog.\r
29 </p><p>\r
30 You will need two bitmaps, one for the light squares,the other for the dark.\r
31 They have to be placed in the folder 'textures',\r
32 which is already premade in the WinBoard folder of this package\r
33 (~\WinBoard\textures).\r
34 The bitmaps will have to be at least 129x129 \r
35 (the largest square size used by winBoard),\r
36 but using a larger bitmap will provide more variety in the squares that WinBoard \r
37 cuts out of it.\r
38 </p><p>\r
39 Next step is to tell WinBoard to use the bitmaps.\r
40 For this the options /liteBackTextureFile="..." and /darkBackTextureFile="..." exist.\r
41 They can be put as arguments on the command line,\r
42 in the winboard.ini file, or in special .ini files called from the command line.\r
43 </p>\r
44 <pre>\r
45 /liteBackTextureFile="textures/wood_l.bmp"\r
46 /darkBackTextureFile="textures/wood_d.bmp"\r
47 /liteBackTextureMode=2\r
48 /darkBackTextureMode=2\r
49 /overrideLineGap=0\r
50 </pre>\r
51 <p>\r
52 When board textures are used, the black lines between the squares that WinBoard usually draws\r
53 often are spoiling the nice look.\r
54 With the /overrideLineGap option you can set them narrower, or make them disappear altogether.\r
55 (The number gives the width in pixels.)\r
56 Note that WinBoard colors these lines for highlighting from- and to-squares of moves,\r
57 so if you make the lines invisibly narrow, you better highlight with an Arrow.\r
58 (You can enable this form of highlighting in the "Options -> General..." menu.\r
59 The TextureMode options determine how squares cut out of the bitmaps are randomly\r
60 rotated before being glued together to form the board.\r
61 </p>\r
62 <h3>Having Many Pre-defined Board Looks</h3>\r
63 <p>\r
64 If you don't want these settings to be permanently stored in your winboard.ini file,\r
65 e.g. because you frequently want to change between different customized looks,\r
66 you can put the options listed above in a small .ini file,\r
67 such as the ~\WinBoard\wood.ini that was provided with this package.\r
68 You can then summon them up at any time by giving "@wood.ini" (without the quotes)\r
69 as an extra option on the bottom line of the startup dialog,\r
70 or even make a separate shortcut that has this option on the "target" line.\r
71 </p>\r
72 <h3>Redefining the Piece Symbols</h3>\r
73 <p>\r
74 For changing the appearence of the pieces, \r
75 you will need to use a true-type font to define the piece symbols.\r
76 Such a true-type font can be scaled to any board size.\r
77 How to do this is decriped on a separate page of this tutorial.\r
78 </p>\r
79 <h3>Links</h3>\r
80 <p>\r
81 <a href="fonts.html">How to Customize the Piece Symbols</a>\r
82 </p>\r
83 <p>\r
84 <a href="shortcuts.html">Customizing WinBoard through Shortcuts</a>\r
85 </p>\r
86 <h3>Some Texture Bitmaps to Download</h3>\r
87 <p>\r
88 <a href="http://www.ascotti.org/programming/chess/zip/WbxSandy.zip">Sandy</a>\r
89 </p><p>\r
90 <a href="http://www.ascotti.org/programming/chess/zip/WbxClouds.zip">Clouds</a>\r
91 </p><p>\r
92 <a href="http://www.ascotti.org/programming/chess/zip/WbxBpWood.zip">Wood</a>\r
93 </p><p>\r
94 <a href="http://www.ascotti.org/programming/chess/zip/WbxDave.zip">Wood</a> (already included in the WinBoard Gold Pack)\r
95 </p>\r
96 </body>\r
97 </html>