Describe the new texture conventions in manual
authorH.G.Muller <hgm@hgm-xboard.(none)>
Sat, 20 Sep 2014 10:58:32 +0000 (12:58 +0200)
committerH.G.Muller <hgm@hgm-xboard.(none)>
Sun, 28 Sep 2014 20:14:27 +0000 (22:14 +0200)
The exact rules for how textures are scaled in response to their
filename is described in the manual.

xboard.texi

index 8703fc3..464c756 100644 (file)
@@ -3259,6 +3259,16 @@ and if they should be used rather than using simple colors.
 The algorithm for cutting squares out of a given bitmap is such that
 the picture is perfectly reproduced when a bitmap the size of
 the complete board is given.
+If the filename ends in "-NxM.png", with integer N and M,
+it is assumed to contain a bitmap of a complete board of N files
+and M ranks, and XBoard will scale it to exactly match the
+current square size.
+If N=M=0 it scales the entire bitmap to the size of the board,
+irrespective of the number of files and ranks of the latter.
+Without any -NxM suffix textures are only blown up by an integer
+factor when they are smaller than the square size, or,
+when the name starts with "xq", too small to cover the
+complete Xiangqi board.
 Default: false and ""
 @item -drag/-xdrag or -animateDragging true/false
 @cindex drag, option