[Pkg-cli-apps-commits] [SCM] openbve branch, master, updated. debian/1.4.0.0-1-3-gf3f83de

[Paul Sladen]

The following commit has been merged in the master branch:
commit f3f83dee8034232b0c113ec30bfbb0a1d6cdf21b
Author: Paul Sladen <debian at paul.sladen.org>
Date:   Sat Jan 14 00:02:17 2012 +0100

    debian/README.source: document 'mask.bin'

diff --git a/debian/README.source b/debian/README.source
index d5ab773..f1eb3c1 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -45,6 +45,29 @@ it and it'll just cause churn in the diffs, instead email michelle and
 get it fixed in the upstream tarball (this will help other people too,
 not just yourself when packaging).
 
+Mask file
+
+'Data/mask.bin' is a raw bitmask used along with 'Data/icon.bmp' for
+the Window Manager icon setting:
+
+  Sdl.SDL_WM_SetIcon(bitmap, mask)
+
+The file is (128 bytes) == (1024 bits) == (32 x 32 bits), in the raw bitmask/
+bitarray form designed for sending straight to:
+
+  http://www.libsdl.org/cgi/docwiki.cgi/SDL_WM_SetIcon
+
+  "points to a bitmap with bits set where the corresponding
+  pixel should be visible.  The format of the bitmap is
+  as follows:  Scanlines come in the usual top-down order.
+  Each scanline consists of (width / 8) bytes, rounded up."
+
+The following Python can be used to print the contents in ASCII-art form:
+
+  import struct
+  print ''.join(map(bin,struct.unpack("32I",open('Data/mask.bin').read(128)))).replace('0b','\n').replace('0',' ').replace('1','*')
+
+
 Commit changelog:
 
   git checkout -f upstream
diff --git a/debian/changelog b/debian/changelog
index 8565dae..0e2fe82 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,7 @@ openbve (1.4.0.0-3) UNRELEASED; urgency=low
 
   * debian/filesystem.cfg: use 'SpecialFolder.LocalApplicationData'
     + emulate behaviour until upstream allows LocalApplicationData
+  * debian/README.source: document 'mask.bin'
 
  -- Paul Sladen <debian at paul.sladen.org>  Fri, 13 Jan 2012 23:00:00 +0100
 

-- 
openbve