V0.42 Default mapping is now horizontal.

Author: peterhinch

FONT_TO_PY.md

@@ -13,6 +13,7 @@ built into firmware is known as frozen bytecode.
 
 ## 1.1 Revision history
 
+22 Mar 2024 V0.42 Default mapping is now horizontal.
 30 Jan 2023 V0.41 With thanks to @ferrolive (Igor Oliveira) who supplied the
 charset file.
  1. Charset file enables Chinese, Japanese and Korean glyphs to be specified.
@@ -92,7 +93,9 @@ $ font_to_py.py -k extended FreeSans.ttf 23 my_extended_font.py
 
  * -f or --fixed If specified, all characters will have the same width. By
  default fonts are assumed to be variable pitch.
- * -x or --xmap Specifies horizontal mapping (default is vertical).
+ * -x or --xmap Specifies horizontal mapping (this is the default).
+ * -y or --ymap Vertical mapping for specialist display hardware. Not compatible
+ with `Writer` classes.
  * -r or --reverse Specifies bit reversal in each font byte.
  * -s or --smallest Ordinal value of smallest character to be stored. Default
  32 (ASCII space).

font_to_py.py

@@ -11,7 +11,7 @@
 
 # The MIT License (MIT)
 #
-# Copyright (c) 2016-2023 Peter Hinch
+# Copyright (c) 2016-2024 Peter Hinch
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -450,7 +450,7 @@ def build_binary_array(self, hmap, reverse, sig):
 STR01 = """# Code generated by font_to_py.py.
 # Font: {}{}
 # Cmd: {}
-version = '0.33'
+version = '0.42'
 
 """
 
@@ -492,14 +492,14 @@ def get_ch(ch):
 STR02H = """
  next_offs = doff + 2 + ((width - 1)//8 + 1) * {0}
  return _mvfont[doff + 2:next_offs], {0}, width
- 
+
 """
 
 # Code emitted for vertically mapped fonts.
 STR02V = """
  next_offs = doff + 2 + (({0} - 1)//8 + 1) * width
  return _mvfont[doff + 2:next_offs], {0}, width
- 
+
 """
 
 # Extra code emitted where -i is specified.
@@ -570,13 +570,13 @@ def write_data(stream, fnt, font_path, hmap, reverse, iterate, charset):
  bw_sparse.odata(sparse)
  bw_sparse.eot()
  stream.write(STRSP)
- print("Sparse")
+ print("Sparse font file.")
  else:
  bw_index = ByteWriter(stream, "_index")
  bw_index.odata(index)
  bw_index.eot()
  stream.write(STR02.format(minchar, maxchar))
- print("Normal")
+ print("Normal (non-sparse) font file.")
  if hmap:
  stream.write(STR02H.format(height))
  else:
@@ -643,6 +643,7 @@ def quit(msg):
  parser.add_argument("outfile", type=str, help="Path and name of output file")
 
  parser.add_argument("-x", "--xmap", action="store_true", help="Horizontal (x) mapping")
+ parser.add_argument("-y", "--ymap", action="store_true", help="Vertical (y) mapping")
  parser.add_argument("-r", "--reverse", action="store_true", help="Bit reversal")
  parser.add_argument("-f", "--fixed", action="store_true", help="Fixed width (monospaced) font")
  parser.add_argument(
@@ -705,6 +706,11 @@ def quit(msg):
  if not os.path.splitext(args.infile)[1].upper() in (".TTF", ".OTF", ".BDF", ".PCF"):
  quit("Font file should be a ttf or otf file.")
 
+ if args.xmap and args.ymap:
+ quit("Cannot be both horizontally and vertically mapped.")
+
+ xmap = args.xmap or not args.ymap # Default is now horizontal
+
  if args.binary:
  if os.path.splitext(args.outfile)[1].upper() == ".PY":
  quit("Binary file must not have a .py extension.")
@@ -713,7 +719,7 @@ def quit(msg):
  quit(BINARY)
 
  print("Writing binary font file.")
- if not write_binary_font(args.outfile, args.infile, args.height, args.xmap, args.reverse):
+ if not write_binary_font(args.outfile, args.infile, args.height, xmap, args.reverse):
  sys.exit(1)
  else:
  if not os.path.splitext(args.outfile)[1].upper() == ".PY":
@@ -760,7 +766,7 @@ def quit(msg):
  args.infile,
  args.height,
  args.fixed,
- args.xmap,
+ xmap,
  args.reverse,
  args.smallest,
  args.largest,