skrift-boxdrawing 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3c7c06fda622d08432995d4b07d25eefcb5b0ad3afc418e43c90db3cfae4b5d5
+  data.tar.gz: ff2ba884bb2d66d7f6b4b687651516e53c255a9c5b8cb78964f967e1175820d4
+SHA512:
+  metadata.gz: c24368fed3cf853540ff2fd951f9b4e7e334ef0a8da2aca8fc5bf1e7b55bec0d10024cd358e0fd3c950a10fa3c3df2b1f875c1dbc2c23f1e9108276ff2bdb05a
+  data.tar.gz: 86c8f031e4fc1122abb238c70784d01a798f492672aa7133746231548565f97f0a31b870c4ea1f8596859c7dee615764e72b2e4d4c843021c77c95e09e02ff13

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+# skrift is developed alongside this plugin. To work against a local checkout,
+# set a per-machine override (stored in ~/.bundle/config, never committed):
+#
+#   bundle config set --local local.skrift /path/to/skrift
+gem "skrift", git: "https://github.com/vidarh/skrift.git", branch: "master"
+
+gem "rake", "~> 13.0"
+gem "rspec", "~> 3.0"

data/LICENSE.txt

@@ -0,0 +1,15 @@
+ISC License
+
+© 2026 Vidar Hokstad
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.md

@@ -0,0 +1,39 @@
+# skrift-boxdrawing
+
+A [Skrift](https://github.com/vidarh/skrift) plugin that renders Unicode
+box-drawing characters (U+2500–U+257F) as crisp alpha buffers for a given cell
+size, **independent of any font**. Fonts vary wildly in how (and whether) they
+draw the box-drawing block; rendering it geometrically gives pixel-accurate,
+seam-free boxes at any size — useful for terminals, TUIs and bars.
+
+It has no X11 (or any platform) dependency: it produces `Skrift::Image` alpha
+buffers, which you composite however you like.
+
+## Usage
+
+Wire it into a `Skrift::GlyphCache` through the `special:` hook, so box-drawing
+codepoints are drawn geometrically and everything else falls through to the
+font:
+
+```ruby
+require "skrift"
+require "skrift/boxdrawing"
+
+boxes = nil
+cache = Skrift::GlyphCache.new("DejaVuSansMono.ttf", x_scale: 16, y_scale: 16,
+                               special: ->(cp) { boxes.glyph(cp) })
+boxes = Skrift::BoxDrawing.new(cache.cell_width, cache.cell_height)
+
+cache.glyph(0x2500) # => a horizontal-line RenderedGlyph, not the font's glyph
+```
+
+Or use it directly:
+
+```ruby
+boxes = Skrift::BoxDrawing.new(cell_width, cell_height)
+img = boxes.glyph(0x250C) # => Skrift::Image (alpha), or nil if cp isn't a box char
+```
+
+## License
+
+ISC. See `LICENSE.txt`.

data/Rakefile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/skrift/boxdrawing/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Skrift
+  class BoxDrawing
+    VERSION = "0.1.0"
+  end
+end

data/lib/skrift/boxdrawing.rb

@@ -0,0 +1,237 @@
+require "skrift"
+require_relative "boxdrawing/version"
+
+module Skrift
+  # Renders Unicode box-drawing glyphs (U+2500..U+257F) as crisp alpha Images
+  # for a fixed cell size, independent of any font. Wire it into a renderer via
+  # Skrift::GlyphCache's `special:` hook:
+  #
+  #   boxes = Skrift::BoxDrawing.new(cache.cell_width, cache.cell_height)
+  #   cache = Skrift::GlyphCache.new(font, x_scale: 16, y_scale: 16,
+  #                                  special: ->(cp) { boxes.glyph(cp) })
+  class BoxDrawing
+    def initialize(boxw, boxh)
+      @boxw, @boxh = boxw, boxh
+      @cache = {}
+    end
+
+    def stride = (@boxw + 3) & ~3
+
+    # A Skrift::Image for a box-drawing codepoint, the full block █ (U+2588),
+    # or nil otherwise.
+    def glyph(cp)
+      return nil unless (0x2500..0x257f).include?(cp) || cp == 0x2588
+      @cache[cp] ||= cache_box(cp)
+    end
+
+    private
+
+    def boxw = @boxw
+    def boxh = @boxh
+
+    def empty_box_image
+      img = Image.new(stride, boxh)
+      img.pixels = Array.new(img.width*img.height,0x00)
+      img
+    end
+
+    # The full block █ must cover the whole cell so a run of them is solid. A
+    # font draws its glyph slightly larger than the cell so adjacent blocks
+    # overlap; fitting that into the fixed cell shrinks it (aspect preserved)
+    # and leaves a border, so fill the cell exactly here instead.
+    def full_block
+      img = empty_box_image
+      boxh.times { |y| boxw.times { |x| img.pixels[y * stride + x] = 255 } }
+      img
+    end
+
+    def cache_box(ch)
+      return full_block if ch.ord == 0x2588
+
+      hx = (boxw+1)/2
+      hy = (boxh+1)/2
+      yoff = hy*stride
+      img = nil
+      h = 1 # 1/3 width of "heavy" line
+
+      lh = light_h = [-255,   0,255,  0, 255]; hh = heavy_h = [-255,  -h,255,  h, 255]
+      lv = light_v = [   0,-255,  0,255, 255]; hv = heavy_v = [  -h,-255,  h,255, 255]
+
+      ll = light_l = [-255,   0,  0,  0, 255]; hl = heavy_l = [-255,  -h,  0,  h, 255]
+      lu = light_u = [   0,-255,  0,  0, 255]; hu = heavy_u = [  -h,-255,  h,  0, 255]
+      lr = light_r = [   0,   0,255,  0, 255]; hr = heavy_r = [   0,  -h,255,  h, 255]
+      ld = light_d = [   0,   0,  0,255, 255]; hd = heavy_d = [  -h,   0,  h,255, 255]
+
+      hc      = [  -h,  -h,  h,  h, 255] # Heavy centre
+
+      d = 2
+      dblc = [-d+1, -d+1, d-1, d-1, 0] # Gap in centre of double lines.
+      light_vc = [0, -d, 0, d, 255] # Light vertical crossing centre of double line.
+
+      dh = double_h = [-255,-d,255,-d, 255] + [-255, d,255, d, 255]
+      dv = double_v = [-d,-255,-d,255, 255] + [d,-255,d,255, 255]
+
+      mask_vbar = [-d+1,-255,d-1,255,0]
+      mask_hbar = [-255,-d+1,255,d-1,0]
+
+      mt= masktop    = [-255,-255, 255,  -1, 0]; maskdtop   = [-255,-255, 255,-d-1, 0]
+      ml=maskleft   = [-255,-255,  -1, 255, 0]; maskdleft  = [-255,-255,-d-1, 255, 0]
+      mb=maskbottom = [-255,   1, 255, 255, 0]; maskdbottom= [-255, d+1, 255, 255, 0]
+      mr=maskright  = [   1,-255, 255, 255, 0]; maskdright = [ d+1,-255, 255, 255, 0]
+
+      mask_lbar = [-255,-d+1,d-1,d-1, 0]; dlbar=double_lbar = [-255,-d,d,d, 255]
+      mask_tbar = [-d+1,-255,d-1,d-1, 0]; dtbar=double_tbar = [-d,-255,d,d, 255]
+      mask_rbar = [-d+1,-d+1,255,d-1, 0]; drbar=double_rbar = [-d,-d,255,d, 255]
+      mask_dbar = [-d+1,-d+1,d-1,255, 0]; ddbar=double_dbar = [-d,-d,d,255, 255]
+
+      mask_c = [0,0,0,0,0]
+
+      hdl = heavy_dl = [heavy_d, heavy_l, hc]
+      hdr = heavy_dr = [heavy_d, heavy_r, hc]
+      hlu = heavy_lu = [heavy_l, heavy_u, hc]
+      hru = heavy_ru = [heavy_r, heavy_u, hc]
+      ldl = light_dl = [light_d, light_l]
+      ldr = light_dr = [light_d, light_r]
+      llu = light_lu = [light_l, light_u]
+      lru = light_ru = [light_r, light_u]
+
+      # FIXME Makes stipples wider when tx/ty etc. are big enough
+      tx = hx - boxw / 3
+      mv2 = mask_v2 = [[-tx, -255, -tx, 255, 0], [tx, -255, tx, 255,0]]
+
+      ty = hy - boxh / 3
+      mh2 = mask_h2 = [[-255,-ty, 255,-ty,0], [-255,ty,255,ty,0]]
+
+      # Three-gap masks for the quadruple-dash glyphs.
+      qx = boxw / 4
+      mv3 = mask_v3 = [[-qx,-255,-qx,255,0], [0,-255,0,255,0], [qx,-255,qx,255,0]]
+      qy = boxh / 4
+      mh3 = mask_h3 = [[-255,-qy,255,-qy,0], [-255,0,255,0,0], [-255,qy,255,qy,0]]
+
+      rects = {
+        0x2500 => lh,       0x2501 => hh,       0x2502 => lv,       0x2503 => hv,
+        # Dashed lines are cut into segments by erase masks across the line:
+        # horizontal masks (mh) dash a vertical line, vertical masks (mv) a
+        # horizontal one. Two gaps give the triple dash, three the quadruple.
+        0x2504 => lh + mv2, 0x2505 => hh + mv2, 0x2506 => lv + mh2, 0x2507 => hv + mh2,
+        0x2508 => lh + mv3, 0x2509 => hh + mv3, 0x250A => lv + mh3, 0x250B => hv + mh3,
+
+        0x250C => ldr,       0x250D => hr + ld,  0x250E => hd + lr,  0x250F => hdr,
+        0x2510 => ldl,       0x2511 => hl + ld,  0x2512 => [hd, ll], 0x2513 => hdl,
+        0x2514 => lru,       0x2515 => lu + hr,  0x2516 => lr + hu,  0x2517 => hru,
+        0x2518 => llu,       0x2519 => [hl, lu], 0x251a => [ll, hu], 0x251b => hlu,
+        0x251c => lv+lr,     0x251d => [lv, hr], 0x251e => ldr + hu, 0x251f => [lru, hd],
+
+        0x2520 => hv  +  lr, 0x2521 => hru +  ld, 0x2522 => hdr +  lu, 0x2523 => hv  + hr,
+        0x2524 => ll  +  lv, 0x2525 => hl  +  lv, 0x2526 => hu  + ldl, 0x2527 => hd  +  lu,
+        0x2528 => hv  +  ll, 0x2529 => hlu +  ld, 0x252a => hdl+lu,    0x252b => hl + hv,
+        0x252c => lh  +  ld, 0x252d => [hl, ldr], 0x252e => [hr, ldr], 0x252f => [hh, ld],
+
+        0x2530 => [lh, hd],  0x2531 => [hdl, lr], 0x2532 => [ll, hdr],  0x2533 => [hh, hd],
+        0x2534 => [lh, lu],  0x2535 => [lru, hl], 0x2536 => [llu, hr], 0x2537 => [hh, lu],
+        0x2538 => [lh, hu],  0x2539 => [hlu, lr], 0x253a => [hru, ll], 0x253b => [hh, hu],
+        0x253c => [lv, lh],  0x253d => lv+lr+hl,  0x253e => ll+lv+hr,  0x253f => [lv, hh],
+
+        0x2540 => [lh, ld, hu], 0x2541 => [light_h, light_u, heavy_d], 0x2542 => [heavy_v, light_h], 0x2543 => [heavy_l, heavy_u, hc, light_d, light_r],
+        0x2544 => [ll, ld, hru], 0x2545 => [heavy_dl, light_ru], 0x2546 => [light_lu, heavy_dr], 0x2547 => [heavy_h, heavy_u, light_d],
+        0x2548 => [hh, hd, light_u], 0x2549 => [heavy_v, heavy_l, light_r], 0x254a => [heavy_v, light_l, heavy_r], 0x254b => [heavy_v, heavy_h],
+        0x254c => [lh, dblc], 0x254d => [heavy_h, dblc], 0x254e => [light_v, dblc], 0x254f => [heavy_v, dblc],
+
+        0x2550 => dh, 0x2551 => dv, 0x2552 => [dh, lv, ml, maskdtop], 0x2553 => [dv, lh, mt, maskdleft],
+        0x2554 => [ddbar, drbar, mask_dbar, mask_rbar], 0x2555 => [dh, mr, lv, maskdtop],
+        0x2556 => [dv, lh,maskdright,mt], 0x2557 => [double_dbar, double_lbar, mask_dbar, mask_lbar],
+        0x2558 => [lv, dh, ml,  maskdbottom], 0x2559 => [lh, dv, maskdleft, mb],
+        0x255A => [dtbar, double_rbar, mask_tbar, mask_rbar], 0x255B => [dh, lv, maskdbottom, mr],
+        0x255C => [dv, lh, mb,  maskdright], 0x255D => [dtbar, dlbar, mask_tbar, mask_lbar],
+        0x255e => [lv, dh, maskleft], 0x255f => [lh, dv, dblc, maskdleft],
+        0x2560 => [dv, drbar, mask_rbar, mask_vbar], 0x2561 => [lv, dh, maskright],
+        0x2562 => [dv, ll, dblc], 0x2563 => [dlbar, dv, mask_lbar, mask_vbar],
+        0x2564 => [dh, ld, dblc], 0x2565 => [lh, dv, mt],
+        0x2566 => [dh, ddbar,mask_hbar, mask_dbar], 0x2567 => [dh, light_u,dblc],
+        0x2568 => [lh, dv, mb],   0x2569 => [dh, double_tbar, mask_hbar, mask_tbar],
+        0x256A => dh+lv, 0x256b => dv+lh, 0x256c => [dh, dv, mask_hbar, mask_vbar],
+
+        # 256d, 256e, 256f, 2570 => curves
+        # FIXME: Current is just very slightly rounded.
+        0x256d => [ldr, mask_c], 0x256e => [ldl, mask_c], 0x256f => [llu, mask_c], 0x2570 => [lru, mask_c],
+
+        # 2571, 2572. 2573 => diagonals, handled below.
+        0x2571 => nil, 0x2572 => nil, 0x2573 => nil,
+
+        0x2574 => ll,      0x2575 => lu,      0x2576 => lr,      0x2577 => ld,
+        0x2578 => hl,      0x2579 => hu,      0x257a => hr,      0x257b => hd,
+        0x257c => ll + hr, 0x257d => lu + hd, 0x257e => hl + lr, 0x257f => hu + ld
+
+      }
+
+      r = rects[ch.ord]
+      if r
+        img = empty_box_image
+        r.flatten.each_slice(5) do |rect|
+          x1,y1,x2,y2, col = *rect
+          x1 = (x1+hx).clamp(0,boxw-1)
+          x2 = (x2+hx).clamp(0,boxw-1)
+          y1 = (y1+hy).clamp(0,boxh-1)
+          y2 = (y2+hy).clamp(0,boxh-1)
+          col ||= 255
+
+          a = Array.new(x2-x1+1,col)
+
+          (y1..y2).each do |y|
+            img.pixels[y*stride + x1 .. y*stride + x2] = a
+          end
+        end
+        return img
+      end
+
+      if ch.ord == 0x2571
+        img = empty_box_image
+        slope = boxw.to_f / boxh
+        x = boxw.to_f-1
+        (0...boxh).each do |y|
+          err = x - x.to_i
+          img.pixels[y*stride+x.ceil] = 255 #(255*(1-err)).floor
+          img.pixels[y*stride+x.ceil-1] = (255*err).floor if x > 0
+          x-= slope
+        end
+        return img
+      end
+
+      # FIXME: If size is *at* certain levels level, this, and the next one fails?
+
+      if ch.ord == 0x2572
+        img = empty_box_image
+        slope = boxw.to_f / boxh
+        x = boxw.to_f-1
+        (0...boxh).each do |y|
+          err = x - x.to_i
+          img.pixels[y*stride+boxw-x.ceil-1]   = 255
+          img.pixels[y*stride+boxw-x.ceil] = (255*err).floor if x > 0
+          x-= slope
+        end
+        return img
+      end
+
+      if ch.ord == 0x2573
+        img = empty_box_image
+        slope = boxw.to_f / boxh
+        x = boxw.to_f-1
+        (0...boxh).each do |y|
+          err = x - x.to_i
+          img.pixels[y*stride+boxw-x.ceil-1]   = 255
+          img.pixels[y*stride+boxw-x.ceil] = (255*err).floor if x > 0
+          img.pixels[y*stride+x.ceil-1] = (255*err).floor if x > 0
+          img.pixels[y*stride+x.ceil] = 255 #(255*(1-err)).floor
+          x-= slope
+        end
+        return img
+      end
+
+      if img
+        img = img.dup
+        img.pixels = img.pixels.dup
+      end
+      img || empty_box_image
+    end
+  end
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: skrift-boxdrawing
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Vidar Hokstad
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-06-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: skrift
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+description: A Skrift plugin that renders Unicode box-drawing characters (U+2500..U+257F)
+  as alpha buffers for a given cell size, independent of any font. Wire it in via
+  Skrift::GlyphCache's `special:` hook.
+email:
+- vidar@hokstad.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/skrift/boxdrawing.rb
+- lib/skrift/boxdrawing/version.rb
+homepage: https://github.com/vidarh/skrift-boxdrawing
+licenses:
+- ISC
+metadata:
+  homepage_uri: https://github.com/vidarh/skrift-boxdrawing
+  source_code_uri: https://github.com/vidarh/skrift-boxdrawing
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key: 
+specification_version: 4
+summary: Crisp Unicode box-drawing glyphs for the Skrift font renderer
+test_files: []