[Pkg-cli-apps-commits] [SCM] openbve-data branch, master, updated. debian/1.4.0.0+dfsg-1-4-gc77b0e5

[Paul Sladen]

The following commit has been merged in the master branch:
commit c77b0e5eeb2a5bee50fceb2bac90551c09e5674f
Author: Paul Sladen <debian at paul.sladen.org>
Date:   Sat Jan 14 00:02:56 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 f4a7a7e..fd220d3 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,7 @@ openbve-data (1.4.0.0+dfsg-2) UNRELEASED; urgency=low
   * debian/changelog: DEP5 and bump copyright to latest upstream wording
   * debian/source/format: '3.0 (quilt)'
   * debian/source/options: single-debian-patch
+  * debian/README.source: document 'mask.bin'
 
  -- Paul Sladen <debian at paul.sladen.org>  Thu, 12 Jan 2012 00:31:00 +0100
 

-- 
openbve-data