From: H.G.Muller <hgm@hgm-xboard.(none)>
Date: Sat, 20 Sep 2014 10:58:32 +0000 (+0200)
Subject: Describe the new texture conventions in manual
X-Git-Url: http://winboard.nl/cgi-bin?p=xboard.git;a=commitdiff_plain;h=7d44b3483bd5cc9f6d2460e0c2c2f4d8630bb57c

Describe the new texture conventions in manual

The exact rules for how textures are scaled in response to their
filename is described in the manual.
---

diff --git a/xboard.texi b/xboard.texi
index 8703fc3..464c756 100644
--- a/xboard.texi
+++ b/xboard.texi
@@ -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