skrift 0.1.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd0c67b57871e673fb91b56bd67172fc1f588b69d37dd777cd89ac65fc04a056
-  data.tar.gz: b31c46b7d93b1794e72bb894deb73ca54d63bfc641a7c0e3b9f72d390f97a30b
+  metadata.gz: 9194573a4c3814c4c48eb0f026274a10f43856fc4c480d7d0631967d7b971fcd
+  data.tar.gz: 42646ed388052afa1095fdf4ae4fc700630d5e44a5174f576ace7abed88d0fa5
 SHA512:
-  metadata.gz: 87c484791a46b5e82819d12e6c2633bdd12704f92f78e282f1b97cd89931e52827ec4e97e2b2bed52518cda038adad0a77a49105976f6154fa9e85801e04b529
-  data.tar.gz: a21dd2bd6a20d90639da4264b186d8bae76675e2d9ef4d44a1438d40a4df912396dba0bb3c03aadd58c8518f408e99e3d27bb3a5dae4ff1afc8ad38f238ec308
+  metadata.gz: 506d51fdfca628d4ce5ed43cd1d84bbf6b3d828ab12673e94ac68c540155af8f7cf17f23558e603d07bf18b448a2cb86e1f3b6517f2fb5922e4159d35fdc8676
+  data.tar.gz: cb719b47e60d4c9335bfb218c66a9900f9833375b20f17687fdb466390af21e76fe435d8ea90470a04d3ef88c57c637816e29d346a8d56227bf2b368c05978bb

data/Rakefile

@@ -5,4 +5,9 @@ require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
+desc "Regenerate the committed golden render buffers (review PGM diffs before committing)"
+task :regen_goldens do
+  ruby "spec/support/regen_goldens.rb"
+end
+
 task default: :spec

data/examples/banner.rb

@@ -0,0 +1,96 @@
+# Bypass bundler
+ENV['BUNDLE_GEMFILE'] = nil
+
+require 'pp'
+require_relative '../lib/skrift'
+
+# Function to render a string as a text banner
+def render_text_banner(text, font_path = "resources/Ubuntu-Regular.ttf", scale = 20)
+  # Load the font
+  f = Font.load(font_path)
+  
+  # Create a new SFT instance
+  sft = SFT.new(f)
+  sft.x_scale = scale
+  sft.y_scale = scale
+  sft.x_offset = 0
+  sft.y_offset = 0
+  
+  # Get font metrics
+  metrics = sft.lmetrics
+  
+  # Calculate the maximum height needed for any character
+  max_height = metrics.ascender - metrics.descender + metrics.line_gap
+  
+  # Array to store each row of pixels for the banner
+  banner_rows = []
+  
+  # Initialize the banner with empty rows
+  max_height.to_i.times do
+    banner_rows << []
+  end
+  
+  # Process each character in the text
+  text.each_char do |char|
+    # Get the glyph ID for this character
+    gid = sft.lookup(char.ord)
+    
+    # Skip if glyph not found
+    next if gid.nil?
+    
+    # Get metrics for this glyph
+    gmetrics = sft.gmetrics(gid)
+    
+    # Create an image for this glyph
+    img = Image.new(gmetrics.min_width, gmetrics.min_height)
+    
+    # Render the glyph
+    if sft.render(gid, img)
+      # Calculate vertical offset based on metrics
+      y_offset = metrics.ascender - gmetrics.y_offset
+      
+      # Calculate character width including spacing
+      char_width = img.width + 2  # Width plus spacing
+      
+      # First, add empty space for all rows in the banner for this character
+      banner_rows.each do |row|
+        row.concat([0] * char_width)
+      end
+      
+      # Then, overwrite with actual character data where it exists
+      img.height.times do |row|
+        row_in_banner = row + y_offset.to_i
+        
+        # Skip rows outside the banner bounds
+        next if row_in_banner < 0 || row_in_banner >= banner_rows.length
+        
+        # Get pixel values for this row of the character
+        row_pixels = img.pixels[row * img.width...(row + 1) * img.width]
+        
+        # Calculate the position to start writing pixels
+        start_pos = banner_rows[row_in_banner].length - char_width
+        
+        # Overwrite the empty space with actual character data
+        row_pixels.each_with_index do |pixel, i|
+          banner_rows[row_in_banner][start_pos + i] = pixel
+        end
+      end
+    end
+  end
+  
+  # Print the banner
+  banner_rows.each do |row|
+    row.each do |pixel|
+      # Use ANSI color codes to display grayscale values
+      print "\33[32;48;2;#{pixel};#{pixel};#{pixel}m  "
+    end
+    puts "\33[39;49m"
+  end
+end
+
+# Get text from command line or use default
+text = ARGV[0] || "Hello!"
+scale = ARGV[1] ? ARGV[1].to_i : 20
+
+puts "Rendering: '#{text}' with scale #{scale}"
+render_text_banner(text, "resources/Ubuntu-Regular.ttf", scale)

data/examples/banner_boxdrawing.rb

@@ -0,0 +1,139 @@
+# Bypass bundler
+ENV['BUNDLE_GEMFILE'] = nil
+
+require 'pp'
+require_relative '../lib/skrift'
+
+# Function to render a string as a text banner
+def render_text_banner(text, font_path = "resources/FiraGO-Regular.ttf", scale = 16, threshold = 30)
+  # Load the font
+  f = Font.load(font_path)
+  
+  # Create a new SFT instance
+  sft = SFT.new(f)
+  sft.x_scale = scale
+  sft.y_scale = scale
+  sft.x_offset = 0
+  sft.y_offset = 0
+  
+  # Get font metrics
+  metrics = sft.lmetrics
+  
+  # Calculate the maximum height needed for any character
+  max_height = metrics.ascender - metrics.descender + metrics.line_gap
+  
+  # Array to store each row of pixels for the banner
+  banner_rows = []
+  
+  # Initialize the banner with empty rows
+  max_height.to_i.times do
+    banner_rows << []
+  end
+  
+  # Process each character in the text
+  text.each_char do |char|
+    # Get the glyph ID for this character
+    gid = sft.lookup(char.ord)
+    
+    # Skip if glyph not found
+    next if gid.nil?
+    
+    # Get metrics for this glyph
+    gmetrics = sft.gmetrics(gid)
+    
+    # Create an image for this glyph
+    img = Image.new(gmetrics.min_width, gmetrics.min_height)
+    
+    # Render the glyph
+    if sft.render(gid, img)
+      # Calculate vertical offset based on metrics
+      y_offset = metrics.ascender - gmetrics.y_offset
+      
+      # Calculate character width including spacing
+      char_width = img.width + 2  # Width plus spacing
+      
+      # First, add empty space for all rows in the banner for this character
+      banner_rows.each do |row|
+        row.concat([0] * char_width)
+      end
+      
+      # Then, overwrite with actual character data where it exists
+      img.height.times do |row|
+        row_in_banner = row + y_offset.to_i
+        
+        # Skip rows outside the banner bounds
+        next if row_in_banner < 0 || row_in_banner >= banner_rows.length
+        
+        # Get pixel values for this row of the character
+        row_pixels = img.pixels[row * img.width...(row + 1) * img.width]
+        
+        # Calculate the position to start writing pixels
+        start_pos = banner_rows[row_in_banner].length - char_width
+        
+        # Overwrite the empty space with actual character data
+        row_pixels.each_with_index do |pixel, i|
+          banner_rows[row_in_banner][start_pos + i] = pixel
+        end
+      end
+    end
+  end
+  
+  # Print the banner
+  # Process banner for box drawing characters (look at 2x2 blocks)
+  (0...banner_rows.length-1).step(2) do |y|
+    row_str = ""
+    (0...banner_rows[y].length-1).step(2) do |x|
+      # Get the 2x2 grid of pixels (with bounds checking)
+      top_left = banner_rows[y][x]
+      top_right = x+1 < banner_rows[y].length ? banner_rows[y][x+1] : 0
+      bottom_left = y+1 < banner_rows.length ? banner_rows[y+1][x] : 0
+      bottom_right = (y+1 < banner_rows.length && x+1 < banner_rows[y+1].length) ? banner_rows[y+1][x+1] : 0
+      
+      # Check if any pixel is above threshold
+      if [top_left, top_right, bottom_left, bottom_right].max >= threshold
+        # Determine which quadrants are filled (1=filled, 0=empty)
+        tl = top_left >= threshold ? 1 : 0
+        tr = top_right >= threshold ? 1 : 0
+        bl = bottom_left >= threshold ? 1 : 0
+        br = bottom_right >= threshold ? 1 : 0
+        
+        # Calculate average color for foreground
+        fg_pixel = [top_left, top_right, bottom_left, bottom_right].max
+        fg_color = "\e[38;2;#{fg_pixel};#{fg_pixel};#{fg_pixel}m"
+        
+        # Select appropriate Unicode box drawing character based on pattern
+        char = case [tl, tr, bl, br]
+        when [1, 1, 1, 1] then "\u2588" # Full block
+        when [1, 1, 1, 0] then "\u259B" # Quadrant upper left and upper right and lower right
+        when [1, 1, 0, 1] then "\u259C" # Quadrant upper left and lower left and lower right
+        when [1, 0, 1, 1] then "\u2599" # Quadrant upper left and upper right and lower left
+        when [0, 1, 1, 1] then "\u259F" # Quadrant upper right and lower left and lower right
+        when [1, 1, 0, 0] then "\u2580" # Upper half block
+        when [0, 0, 1, 1] then "\u2584" # Lower half block
+        when [1, 0, 1, 0] then "\u258C" # Left half block
+        when [0, 1, 0, 1] then "\u2590" # Right half block
+        when [1, 0, 0, 0] then "\u2598" # Quadrant upper left
+        when [0, 1, 0, 0] then "\u259D" # Quadrant upper right
+        when [0, 0, 1, 0] then "\u2596" # Quadrant lower left
+        when [0, 0, 0, 1] then "\u2597" # Quadrant lower right
+        when [1, 0, 0, 1] then "\u259A" # Quadrant upper left and lower right
+        when [0, 1, 1, 0] then "\u259E" # Quadrant upper right and lower left
+        else " "
+        end
+        row_str += "#{fg_color}#{char}"
+      else
+        # Skip rendering pixels below threshold
+        row_str += " "
+      end
+    end
+    puts row_str + "\e[0m" # Reset all attributes
+  end
+end
+
+# Get text from command line or use default
+text = ARGV[0] || "Hello!"
+scale = ARGV[1] ? ARGV[1].to_i : 16
+threshold = ARGV[2] ? ARGV[2].to_i : 30
+
+puts "Rendering: '#{text}' with scale #{scale} and threshold #{threshold}"
+render_text_banner(text, "resources/FiraGO-Regular.ttf", scale, threshold)

data/examples/banner_shadow.rb

@@ -0,0 +1,207 @@
+require 'pp'
+require_relative '../lib/skrift'
+
+# Helper method to determine the appropriate shadow character
+def determine_shadow_char(banner_rows, x, y, threshold)
+  # If current position is above threshold, no shadow needed
+  return nil if x < 0 || y < 0
+  return nil if y < banner_rows.length && x < banner_rows[y].length && banner_rows[y][x] >= threshold
+
+  # Check surrounding pixels
+  up = (y > 0 && y - 1 < banner_rows.length && x < banner_rows[y - 1].length) ? banner_rows[y - 1][x-1] >= threshold : false
+  down = (y + 1 < banner_rows.length && x < banner_rows[y + 1].length) ? banner_rows[y + 1][x-1] >= threshold : false
+  left = (x > 0 && y < banner_rows.length && x - 1 < banner_rows[y].length) ? banner_rows[y][x - 2] >= threshold : false
+  right = (y < banner_rows.length && x + 1 < banner_rows[y].length) ? banner_rows[y][x] >= threshold : false
+
+  # For shadow characters, we need to invert our understanding of "up", "down", etc.
+  # A shadow character connects TO a character, not FROM it.
+  # So we need to swap the directions:
+  # - "up" means the shadow is below a character (connects upward)
+  # - "down" means the shadow is above a character (connects downward)
+  # - "left" means the shadow is to the right of a character (connects leftward)
+  # - "right" means the shadow is to the left of a character (connects rightward)
+
+  # Determine box drawing character based on connections
+  if up && down && left && right
+    return "┼" # Box drawing: vertical and horizontal
+  elsif up && down && left
+    return "│" # Box drawing: vertical
+    #"Y" #┤" # Box drawing: vertical and left
+  elsif up && down && right
+    return "├" # Box drawing: vertical and right
+  elsif up && left && right
+    return "┴" # Box drawing: up and horizontal
+  elsif down && left && right
+    return "┬" # Box drawing: down and horizontal
+  elsif left && right
+    return "X" #
+  elsif up && down
+    return "│" # Box drawing: vertical
+  elsif up && right
+    return "└" # Box drawing: up and right
+  elsif up && left
+    return "┌" # Box drawing: down and right
+    #"B" #┘" # Box drawing: up and left
+  elsif down && right
+    return "┌" # Box drawing: down and right
+  elsif down && left
+    return "┐" # Box drawing: down and left
+  elsif up
+    return "─" # Box drawing: horizontal
+  elsif down
+    return "┐" # Box drawing: down and left #"Z"#╷" # Box drawing: down
+  elsif left
+    return "│" # Box drawing: vertical
+    #"A" #╴" # Box drawing: left
+  elsif right
+    return "╶" # Box drawing: right
+  end
+
+  # If we're below a character but not directly adjacent, use a light shade
+  if y > 0 && y - 1 < banner_rows.length && x < banner_rows[y - 1].length && banner_rows[y - 1][x] >= threshold
+    return "└" # Box drawing: up and right
+  end
+
+  return nil
+end
+
+# Function to render a string as a text banner
+def render_text_banner(text, font_path = "resources/FiraGO-Regular.ttf", scale = 16, threshold = 30)
+  # Load the font
+  f = Font.load(font_path)
+
+  # Create a new SFT instance
+  sft = SFT.new(f)
+  sft.x_scale = scale
+  sft.y_scale = scale
+  sft.x_offset = 0
+  sft.y_offset = 0
+
+  # Get font metrics
+  metrics = sft.lmetrics
+
+  # Calculate the maximum height needed for any character
+  max_height = metrics.ascender - metrics.descender + metrics.line_gap
+
+  # Array to store each row of pixels for the banner
+  banner_rows = []
+
+  # Initialize the banner with empty rows
+  max_height.to_i.times do
+    banner_rows << []
+  end
+
+  # Process each character in the text
+  text.each_char do |char|
+    # Get the glyph ID for this character
+    gid = sft.lookup(char.ord)
+
+    # Skip if glyph not found
+    next if gid.nil?
+
+    # Get metrics for this glyph
+    gmetrics = sft.gmetrics(gid)
+
+    # Create an image for this glyph
+    img = Image.new(gmetrics.min_width, gmetrics.min_height)
+
+    # Render the glyph
+    if sft.render(gid, img)
+      # Calculate vertical offset based on metrics
+      y_offset = metrics.ascender - gmetrics.y_offset
+
+      # Calculate character width including spacing
+      char_width = img.width + 2  # Width plus spacing
+
+      # First, add empty space for all rows in the banner for this character
+      banner_rows.each do |row|
+        row.concat([0] * char_width)
+      end
+
+      # Then, overwrite with actual character data where it exists
+      img.height.times do |row|
+        row_in_banner = row + y_offset.to_i
+
+        # Skip rows outside the banner bounds
+        next if row_in_banner < 0 || row_in_banner >= banner_rows.length
+
+        # Get pixel values for this row of the character
+        row_pixels = img.pixels[row * img.width...(row + 1) * img.width]
+
+        # Calculate the position to start writing pixels
+        start_pos = banner_rows[row_in_banner].length - char_width
+
+        # Overwrite the empty space with actual character data
+        row_pixels.each_with_index do |pixel, i|
+          banner_rows[row_in_banner][start_pos + i] = pixel
+        end
+      end
+    end
+  end
+
+  # Process banner for box drawing characters (look at 2x2 blocks)
+  (0...banner_rows.length).step(2) do |y|
+    row_str = ""
+    (0...banner_rows[y].length - 1).step(2) do |x|
+      # Get the 2x2 grid of pixels (with bounds checking)
+      top_left = banner_rows[y][x]
+      top_right = x + 1 < banner_rows[y].length ? banner_rows[y][x + 1] : 0
+      bottom_left = y + 1 < banner_rows.length ? banner_rows[y + 1][x] : 0
+      bottom_right = (y + 1 < banner_rows.length && x + 1 < banner_rows[y + 1].length) ? banner_rows[y + 1][x + 1] : 0
+
+      # Check if any pixel is above threshold
+      if [top_left, top_right, bottom_left, bottom_right].max >= threshold
+        # Determine which quadrants are filled (1=filled, 0=empty)
+        tl = top_left >= threshold ? 1 : 0
+        tr = top_right >= threshold ? 1 : 0
+        bl = bottom_left >= threshold ? 1 : 0
+        br = bottom_right >= threshold ? 1 : 0
+
+        # Calculate average color for foreground
+        fg_pixel = [top_left, top_right, bottom_left, bottom_right].max
+        fg_color = "\e[38;2;#{fg_pixel};#{fg_pixel/4};#{fg_pixel/4}m"
+
+        # Select appropriate Unicode box drawing character based on pattern
+        char = case [tl, tr, bl, br]
+               when [1, 1, 1, 1] then "\u2588" # Full block
+               when [1, 1, 1, 0] then "\u259B" # Quadrant upper left and upper right and lower right
+               when [1, 1, 0, 1] then "\u259C" # Quadrant upper left and lower left and lower right
+               when [1, 0, 1, 1] then "\u2599" # Quadrant upper left and upper right and lower left
+               when [0, 1, 1, 1] then "\u259F" # Quadrant upper right and lower left and lower right
+               when [1, 1, 0, 0] then "\u2580" # Upper half block
+               when [0, 0, 1, 1] then "\u2584" # Lower half block
+               when [1, 0, 1, 0] then "\u258C" # Left half block
+               when [0, 1, 0, 1] then "\u2590" # Right half block
+               when [1, 0, 0, 0] then "\u2598" # Quadrant upper left
+               when [0, 1, 0, 0] then "\u259D" # Quadrant upper right
+               when [0, 0, 1, 0] then "\u2596" # Quadrant lower left
+               when [0, 0, 0, 1] then "\u2597" # Quadrant lower right
+               when [1, 0, 0, 1] then "\u259A" # Quadrant upper left and lower right
+               when [0, 1, 1, 0] then "\u259E" # Quadrant upper right and lower left
+               else " "
+               end
+        row_str += "#{fg_color}#{char}"
+      else
+        # Check for shadow character
+        shadow_char = determine_shadow_char(banner_rows, x, y, threshold)
+        if shadow_char.nil?
+          row_str += " "
+        else
+          # Use a grey color for shadow
+          shadow_color = "\e[38;2;64;64;64m"
+          row_str += "#{shadow_color}#{shadow_char}"
+        end
+      end
+    end
+    puts row_str + "\e[0m" # Reset all attributes
+  end
+
+end
+
+# Get text from command line or use default
+text = ARGV[0] || "Hello!"
+scale = ARGV[1] ? ARGV[1].to_i : 16
+threshold = ARGV[2] ? ARGV[2].to_i : 30
+
+puts "Rendering: '#{text}' with scale #{scale} and threshold #{threshold}"
+render_text_banner(text, "resources/FiraGO-Regular.ttf", scale, threshold)

data/{test.rb → examples/glyph_dump.rb}

@@ -1,6 +1,6 @@
 
 require 'pp'
-require_relative './lib/skrift'
+require_relative '../lib/skrift'
 
 f = Font.load("resources/Ubuntu-Regular.ttf")
 #f = Font.load("resources/FiraGO-Regular_extended_with_NotoSansEgyptianHieroglyphs-Regular.ttf")
@@ -59,7 +59,7 @@ if sft.render(gid, img)
 #img.pixels = r.post_process
 
 img.height.times do |row|
-  img.pixels[row*img.width .. (row+1)*img.width-1].map do |s|
+  img.pixels[row * img.width .. (row + 1) * img.width - 1].map do |s|
     print "\033[32;48;2;#{s};#{s};#{s}m%02x " % s
   end
   puts "\033[39;49m"