A PyQt5-based tool for rendering text using bitmap fonts in PNG format.
 
 
Go to file
Kiyoshi Aman f3ab4d57ff porygon.py: Implement padded4_2 mode.
padded4_2 pads 2bpp so that it'll fit in 4bpp.
2018-02-23 09:01:37 -06:00
.gitignore Omit output directory. 2017-12-07 08:43:59 -06:00
license.txt Initial commit. 2017-12-07 08:38:28 -06:00
melissa8.json melissa8.json: Add palette data. 2018-02-23 08:47:10 -06:00
melissa8.png Initial commit. 2017-12-07 08:38:28 -06:00
porygon.py porygon.py: Implement padded4_2 mode. 2018-02-23 09:01:37 -06:00
readme.txt Rewrite Smeargle, prepare 0.4.0 release. 2018-02-23 09:00:44 -06:00
smeargle.py Rewrite Smeargle, prepare 0.4.0 release. 2018-02-23 09:00:44 -06:00
test.txt Initial commit. 2017-12-07 08:38:28 -06:00

readme.txt

Smeargle 0.4.0 readme
---------------------
Usage: smeargle.py font.json script.txt

font.json is a JSON document which describes the font and provides a mapping
of characters to font indexes and font widths.

script.txt is a plaintext document without formatting which is rendered as an
image in PNG with a limited palette.

Output
------
Smeargle outputs three files, at present:

* <script>_raw.png is the undeduplicated rendering of the script with the
  specified font.
* <script>_compressed.png deduplicates tiles to provide the most compact
  rendering of the font without delving into actual compression algorithms.
* <script>_index.txt provides a mapping of deduplicated tiles to the original
  text.

font.json format
----------------
The following format MUST be observed, or you will not get the output you want.
Remove '//' and everything following it in each line if you plan to copy/paste
this example for your own use. Do not leave a trailing comma on the final entry
in the map.

{
    "font_name": "Example",               // Human-readable, not currently used
    "filename": "example.png",            // Filename of the font (PNG)
    "bits_per_pixel": 2,                  // Depth in bits; 2**n is color count
    "width":  8,                          // Width of a given tile
    "height": 8,                          // Height of a given tile
    "palette": [                          // A list of colors.
        '00bbbb',                         // A color in hex format.
        [0, 0, 0]                         // A color in R,G,B format.
    ],
    "map": {                              // character -> index & width
        " ":  {"index": 115, "width": 4}, // Must be a blank tile somewher
    }
}

porygon.py
----------
Usage: porygon.py image format

This script converts the image into the target format. Run porygon.py without
arguments to see what formats are available.

Changelog
---------
0.4.0
* A complete rewrite of Smeargle to make it more modular.
* Implemented a palette feature in order to ensure strict palette ordering in
  the output images.

0.3.3
* Added support for palette maps. Format is, one per line, 'n=m', where n and
  m must be integers within the colour range for the format.

0.3.2
* Added Linear 4 bits-per-pixel format.

0.3.1
* Make supported formats actually work.

0.3.0
* Added porygon.py script. Linear 1 & 2 and planar 2 bits-per-pixel formats
  are supported.

0.2.2
* Removed binary output. It wasn't emitting anything actually useful to anyone.
* Emit index map as hex.