index.md - sites - public wiki contents of suckless.org
 (HTM) git clone git://git.suckless.org/sites
 (DIR) Log
 (DIR) Files
 (DIR) Refs
       ---
       index.md (2241B)
       ---
            1 boxdraw
            2 =======
            3 
            4 Summary
            5 -------
            6 Custom rendering of lines/blocks/braille characters for gapless alignment.
            7 
            8 Example
            9 -------
           10 Lines/blocks, tmux splitter, braille "graphics". The top one is with boxdraw:
           11 [![Screenshot](st-boxdraw_v2.png)](st-boxdraw_v2.png)
           12 
           13 
           14 Description
           15 -----------
           16 Graphic lines and blocks characters such as those used by `dialog`, `tree`,
           17 `tmux` etc sometimes align with gaps - which doesn't look very nice. This can
           18 depend on font, size, scaling, and other factors.
           19 
           20 Braille is also increasingly used for graphics (`mapscii`, `vtop`, `gnuplot`,
           21 etc), and may look or align nicer when rendered as "pixels" instead of dots.
           22 
           23 This patch adds options to render most of the lines/blocks characters and/or the
           24 the braille ones without using the font so that they align perfectly regardless
           25 of font, size or other configuration values.
           26 
           27 Supported codepoints are U2500 - U259F except dashes and diagonals, and U28XX.
           28 
           29 See also: unicode references
           30 [U2500.pdf](http://www.unicode.org/charts/PDF/U2500.pdf),
           31 [U2580.pdf](http://www.unicode.org/charts/PDF/U2580.pdf),
           32 [U2800.pdf](http://www.unicode.org/charts/PDF/U2800.pdf),
           33 and example pages
           34 [UTF-8-demo.txt](https://www.cl.cam.ac.uk/~mgk25/ucs/examples/UTF-8-demo.txt)
           35 and
           36 [libvte test page](https://github.com/GNOME/vte/blob/master/doc/boxes.txt).
           37 
           38 Notes:
           39 ------
           40 * The download is a `git --format-patch` file. It can be applied either with
           41   `git am ...`, or with `patch -p1 < ...`.
           42 * boxdraw/braille are disabled by default and configured via `config.h`.
           43   You may need to copy the boxdraw lines from `config.def.h` to `config.h`.
           44 
           45 Download
           46 --------
           47 * [st-boxdraw_v2-0.8.3.diff](st-boxdraw_v2-0.8.3.diff)
           48 * [st-boxdraw_v2-0.8.5.diff](st-boxdraw_v2-0.8.5.diff)
           49 
           50 History
           51 -------
           52 * boxdraw v2-0.8.3: no code changed. Only rebased and adds patch meta-info for
           53 improved conflict resolution when `git am -3` is used.
           54 * boxdraw v2-0.8.2: adds shades, braille (U28XX), configurable bold.
           55   * [st-boxdraw_v2-0.8.2.diff](st-boxdraw_v2-0.8.2.diff)
           56 * boxdraw (v1): U2500-U259F except dashes/diagonals/shades. Bold is thicker.
           57   * [st-boxdraw-20181101-30ec9a3.diff](st-boxdraw-20181101-30ec9a3.diff)
           58 
           59 Author
           60 ------
           61 * Avi Halachmi (:avih) - [https://github.com/avih](https://github.com/avih)