initial import

.gitignore

@@ -0,0 +1,4 @@
+*.swp
+*~
+*.pyc
+

README.md

@@ -0,0 +1,35 @@
+png2scr.py
+==========
+
+This is a simple tool to convert a 24 or 32 bit PNG image to
+ZX Spectrum sprite to be uses with SP1 library.
+
+For example:
+```
+$ png2sprite.py -i ship ship.png > ship.h
+```
+
+The tool will generate a C array with the sprite data.
+
+The colors used are:
+
+ * ink: white (rgb 205, 205, 205)
+ * paper: red (rgb 205, 0, 0)
+ * mask: black (rgb 0, 0, 0)
+
+
+Requirements
+------------
+
+The tool requires `PIL` library (or `Pillow`) and `argparse` if
+you're using Python 2 < 2.7.
+
+It should work both in Python 2 and Python 3.
+
+
+License
+-------
+
+The tool is distribute under MIT license (read the beginning of
+the script for a copy of the license).
+

png2sprite.py

@@ -0,0 +1,118 @@
+#!/usr/bin/env python
+"""
+png2sprite.py
+Copyright (C) 2015 by Juan J. Martinez - usebox.net
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+"""
+__version__ = "1.0"
+
+from argparse import ArgumentParser
+from PIL import Image
+
+INK = (205, 205, 205)
+PAPER = (205, 0, 0)
+MASK = (0, 0, 0)
+
+COLORS = [INK, PAPER, MASK,]
+
+def main():
+
+    parser = ArgumentParser(description="png2sprite",
+                            epilog="Copyright (C) 2015 Juan J Martinez <jjm@usebox.net>",
+                            )
+
+    parser.add_argument("--version", action="version", version="%(prog)s "  + __version__)
+    parser.add_argument("-i", "--id", dest="id", default="sprite", type=str,
+                        help="variable name (default: sprite)")
+
+    parser.add_argument("image", help="image to convert", nargs="?")
+
+    args = parser.parse_args()
+
+    if not args.image:
+        parser.error("required parameter: image")
+
+    try:
+        image = Image.open(args.image)
+    except IOError:
+        parser.error("failed to open the image")
+
+    (w, h) = image.size
+
+    if w % 8 or h % 8:
+        parser.error("%r size is not multiple of 8" % args.image)
+
+    if not isinstance(image.getpixel((0, 0)), tuple):
+        parse.error("only RGB(A) images are supported")
+
+    # so we support both RGB and RGBA images
+    data = list(zip(list(image.getdata(0)), list(image.getdata(1)), list(image.getdata(2))))
+
+    for c in data:
+        if c not in COLORS:
+            parser.error("invalid color %r in image" % (c,))
+
+    tiles = []
+    # this is wrong, but assuming nxn sprites works
+    for j in range(h / 8):
+        tiles.extend([255, 0, 255, 0, 255, 0, 255, 0])
+
+    for x in range(0, w, 8):
+        byte = []
+        for j in range(h):
+            sprite = 0
+            mask = 0
+            for i in range(8):
+                d = data[x + i + j * w]
+                if d == INK:
+                    sprite |= 1 << (7 - i)
+                elif d != MASK:
+                    mask |= 1 << (7 - i)
+
+            byte.append(mask)
+            byte.append(sprite)
+
+        tiles.extend(byte)
+        tiles.extend([255, 0, 255, 0, 255, 0, 255, 0])
+        if x + 8 < w:
+            tiles.extend([255, 0, 255, 0, 255, 0, 255, 0])
+
+    tiles.extend([255, 0, 255, 0, 255, 0, 255, 0])
+
+    out = ""
+    for part in range(0, len(tiles), 8):
+        if out:
+            out += ",\n"
+        out += ', '.join(["0x%02x" % b for b in tiles[part: part + 8]])
+
+    # header
+    print("""
+/* png2sprite.py
+ *
+ * %s (%sx%s)
+ */
+""" % (args.image, w, h,))
+
+    print("""uchar %s[] = {\n%s\n};""" % (args.id, out,))
+
+if __name__ == "__main__":
+    main()
+

requirements.txt

@@ -0,0 +1,3 @@
+Pillow
+argparse
+