termvas 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5863ee4752675b2b9b5c77b5e4bf0d0a4864911c7976ce661d21e468dd92e0b6
-  data.tar.gz: 3b850fdefa94a1e8707e320717f72bd9a2822c1142fc098ba0c64e2c0d520d88
+  metadata.gz: e006617f9d17384317e9c45880fbdef15e35049894eb82013557d170e805c97d
+  data.tar.gz: 05fc5d8aeff21250c54bef69b4cd81c023d1c6c02aaac47c1ad72046f3c22ccd
 SHA512:
-  metadata.gz: 7aed972961ce1dd18f54e9973ec4952becc545c35178bf87bd9f838694e018e49921bbf01cc6cd7d60b552e5890af0b77458269471dd758ac2d4da3192719ea9
-  data.tar.gz: 285deddc562970d9e952fb35fd76ebc4a2d4b8ef7926e2d7dfd0f69e339f6c14edf634e001b2023af9e5604389f7bf5252cb37f0df93b4e0dd07c734739169fe
+  metadata.gz: 64cad8ca3988821b0361941f9027c2ff763e7b5b16e5fd8ac7a6b7b9e6f5859697474fe2901f001f98c1525c825aeeb8dae5e3b1c4b70eabd79897a030db556e
+  data.tar.gz: 3cdda1da18561fd32d131dda835f19fc6062b7f4626acef9b0713b5a8ea843cf788843b5f2750b9d656cced5fbf811bfece6c01a3dd257582f540675a2485f81

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-09-25
+
+- Make RBGL an optional backend loaded with `termvas/rbgl`.
+- Use Tessel's shared quantizer for median-cut Sixel output.
+
 ## [0.1.0] - 2026-09-23
 
 - Initial release.

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2026 ydah
+Copyright (c) 2026 Yudai Takada
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,18 +1,19 @@
-# Termvas
+<h1 align="center">Termvas</h1>
 
-[![Gem version](https://badge.fury.io/rb/termvas.svg)](https://rubygems.org/gems/termvas)
-[![Downloads](https://img.shields.io/gem/dt/termvas?label=downloads)](https://rubygems.org/gems/termvas)
-[![CI](https://github.com/rbgfx/termvas/actions/workflows/ci.yml/badge.svg)](https://github.com/rbgfx/termvas/actions/workflows/ci.yml)
-[![Ruby](https://img.shields.io/badge/ruby-%3E%3D3.1-CC342D?logo=ruby&logoColor=white)](https://www.ruby-lang.org/)
-[![License](https://img.shields.io/badge/license-MIT-750014.svg)](LICENSE.txt)
+<p align="center">A terminal display backend for Ruby graphics.</p>
 
-> A terminal display backend for Ruby graphics.
+<p align="center">
+  <a href="https://rubygems.org/gems/termvas"><img src="https://badge.fury.io/rb/termvas.svg" alt="Gem Version"></a>
+  <a href="https://rubygems.org/gems/termvas"><img src="https://img.shields.io/gem/dt/termvas?label=downloads" alt="Downloads"></a>
+  <a href="https://www.ruby-lang.org/"><img src="https://img.shields.io/badge/ruby-%3E%3D3.1-CC342D?logo=ruby&amp;logoColor=white" alt="Ruby Version"></a>
+  <a href="LICENSE.txt"><img src="https://img.shields.io/badge/license-MIT-750014.svg" alt="License"></a>
+</p>
 
-Termvas presents RGBA frames in terminals through half blocks, Kitty, iTerm2,
-or Sixel output. It also parses keyboard and mouse input for interactive
-applications.
+[Features](#features) · [Installation](#installation) · [Quick Start](#quick-start) · [Terminal Notes](#terminal-notes)
 
-**[Features](#features) · [Installation](#installation) · [Quick start](#quick-start) · [Terminal notes](#terminal-notes) · [Development](#development)**
+***
+
+Termvas presents RGBA frames in terminals through half blocks, Kitty, iTerm2, or Sixel output. It also parses keyboard and mouse input for interactive applications.
 
 ## Features
 
@@ -30,6 +31,10 @@ Add Termvas to your Gemfile:
 
 ~~~ruby
 gem "termvas"
+
+# For Termvas::Backend and the `termvas view` / `play` commands:
+gem "rbgl"
+gem "tessel", ">= 0.2.0"
 ~~~
 
 Then run:
@@ -44,7 +49,13 @@ Or install the released gem:
 gem install termvas
 ~~~
 
-## Quick start
+### Requirements
+
+- Ruby 3.1 or newer.
+- Half-block output works in ANSI terminals; Kitty, iTerm2, and Sixel output require matching terminal support.
+- `require "termvas"` and `termvas doctor` need no extra gems. The RBGL backend needs `rbgl`; `view` / `play`, iTerm2 output, and median-cut Sixel quantization also need `tessel`.
+
+## Quick Start
 
 Inspect the current terminal and display an image:
 
@@ -57,7 +68,7 @@ termvas play frames/*.png --fps 10
 Use the backend from Ruby:
 
 ~~~ruby
-require "termvas"
+require "termvas/rbgl"
 
 backend = Termvas::Backend.new(320, 180, protocol: :blocks)
 backend.set_pixels(rgba_bytes, 320, 180)
@@ -66,6 +77,12 @@ backend.close
 
 The backend expects top-down RGBA8 bytes. Set
 <code>TERMVAS_PROTOCOL</code> to force a protocol.
+For Sixel output, pass <code>quantize: :median_cut</code> to the backend to use
+Tessel's shared quantizer; the default uses the fixed palette.
+
+The encoders, protocol detection, input parser, and terminal sizing utilities
+load with <code>require "termvas"</code> alone. The optional RBGL backend is
+available from <code>require "termvas/rbgl"</code>.
 
 ## Terminal notes
 
@@ -75,6 +92,19 @@ terminal cell area. Use <code>fit: :none</code> to keep the source size.
 Inside tmux, Kitty and Sixel output uses DCS passthrough and requires
 <code>allow-passthrough on</code> in tmux.
 
+## SSH
+
+Remote environment variables may not identify the local terminal. Select a
+protocol supported by that terminal explicitly, and lower the frame rate on
+slow links:
+
+~~~sh
+termvas play frames/*.png --protocol blocks --fps 5
+~~~
+
+For the Ruby backend, set <code>protocol: :blocks</code> and a lower
+<code>max_fps</code> value.
+
 ## Development
 
 ~~~sh
@@ -84,6 +114,10 @@ bundle exec rake verify
 
 See [docs/keys.md](docs/keys.md) for the input event mapping.
 
+## Contributing
+
+Bug reports and pull requests are welcome at [rbgfx/termvas](https://github.com/rbgfx/termvas).
+
 ## License
 
 [MIT](LICENSE.txt)

data/docs/index.html

@@ -0,0 +1,32 @@
+<!doctype html>
+<html lang="en"><head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="theme-color" content="#020617"><meta name="description" content="Display RGBA images with half blocks, Kitty, iTerm2, or Sixel, and read keyboard and mouse input.">
+<meta property="og:title" content="Termvas — Put the frame in the terminal."><meta property="og:description" content="Display RGBA images with half blocks, Kitty, iTerm2, or Sixel, and read keyboard and mouse input."><meta property="og:type" content="website"><meta property="og:url" content="https://rbgfx.github.io/termvas/">
+<meta name="twitter:card" content="summary"><link rel="canonical" href="https://rbgfx.github.io/termvas/"><title>Termvas — Put the frame in the terminal.</title>
+<style>
+:root{color-scheme:dark;--bg:#020617;--panel:#0f172a;--line:#334155;--ink:#e2e8f0;--muted:#94a3b8;--a:#38bdf8;--mono:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--sans:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;--w:min(100% - 2.5rem,76rem)}
+*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--bg);color:var(--ink);font:16px/1.65 var(--sans)}a{color:inherit;text-underline-offset:.22em}a:hover{color:var(--a)}a:focus-visible{outline:3px solid var(--a);outline-offset:4px}h1,h2,h3,p,figure,pre{margin:0}h1,h2,h3{line-height:1.08;text-wrap:balance}p{text-wrap:pretty}code,pre,.mono{font-family:var(--mono);font-variant-numeric:tabular-nums}.wrap{width:var(--w);margin:auto}.skip{position:fixed;left:1rem;top:1rem;z-index:1;transform:translateY(-160%);padding:.7rem 1rem;background:var(--ink);color:var(--bg)}.skip:focus{transform:none}
+header{height:4.75rem;border-bottom:1px solid var(--line);display:flex;align-items:center;justify-content:space-between}.brand{display:flex;align-items:center;gap:.7rem;font-weight:750;text-decoration:none}.mark{width:2rem;height:2rem;display:grid;place-items:center;border:1px solid var(--a);color:var(--a);font:.85rem var(--mono)}nav{display:flex;gap:1.5rem;font-size:.9rem}nav a{text-decoration:none;color:var(--muted)}nav a:last-child{color:var(--ink)}
+.hero{display:grid;grid-template-columns:.88fr 1.12fr;align-items:center;gap:clamp(2rem,6vw,6rem);padding-block:clamp(4rem,9vw,8rem)}.kicker,.visual figcaption,.num{font:.76rem/1.4 var(--mono);color:var(--a)}h1{max-width:11ch;margin-top:1rem;font-size:clamp(3rem,7.5vw,6.5rem);letter-spacing:-.065em}.lede{max-width:40rem;margin-top:1.5rem;color:var(--muted);font-size:1.15rem}.actions{display:flex;flex-wrap:wrap;gap:.8rem;margin-top:2rem}.button{min-height:2.8rem;padding:.65rem 1rem;border:1px solid var(--line);display:inline-flex;align-items:center;text-decoration:none;font-weight:650}.button.primary{background:var(--a);border-color:var(--a);color:var(--bg)}.install{margin-top:1.4rem;color:var(--muted);font:.86rem var(--mono)}.install code{color:var(--ink)}
+.visual{border:1px solid var(--line);background:var(--panel)}.art{min-height:18rem;padding:1.25rem;display:grid;place-items:center;overflow:hidden}.art svg{width:100%;max-height:23rem}.visual figcaption{display:flex;justify-content:space-between;gap:1rem;padding:.75rem 1rem;border-top:1px solid var(--line);color:var(--muted)}.visual figcaption span:last-child{color:var(--a)}
+section.info{padding-block:4.5rem;border-top:1px solid var(--line)}.section-head{display:grid;grid-template-columns:.72fr 1.28fr;gap:2rem;align-items:end;margin-bottom:2rem}h2{font-size:clamp(2rem,4vw,3.25rem);letter-spacing:-.045em}.section-head p,.feature p,.try-copy p{color:var(--muted)}.features{display:grid;grid-template-columns:repeat(3,1fr);border-top:1px solid var(--line)}.feature{padding:1.25rem 1.2rem 1.4rem 0;border-bottom:1px solid var(--line)}.feature+.feature{padding-left:1.2rem;border-left:1px solid var(--line)}.feature h3{margin-top:.8rem;font-size:1.1rem}.feature p{margin-top:.5rem;font-size:.94rem}.try{display:grid;grid-template-columns:.75fr 1.25fr;align-items:center;gap:clamp(2rem,7vw,7rem)}.try-copy p{margin-top:1rem}.try-copy a{color:var(--ink)}pre{overflow-x:auto;padding:1.25rem;border:1px solid var(--line);background:var(--panel);font-size:.82rem;line-height:1.8;tab-size:2}
+footer{display:flex;justify-content:space-between;gap:1rem;padding-block:1.6rem;border-top:1px solid var(--line);color:var(--muted);font-size:.85rem}footer div{display:flex;gap:1.25rem}
+@media(max-width:800px){.hero{grid-template-columns:1fr;gap:2.5rem}.hero-copy{max-width:42rem}.section-head,.try{grid-template-columns:1fr;gap:1rem}}@media(max-width:560px){:root{--w:min(100% - 1.5rem,76rem)}header{height:4.2rem}nav{gap:.8rem;font-size:.8rem}nav a:first-child{display:none}h1{font-size:clamp(3rem,15vw,5rem)}.features{grid-template-columns:1fr}.feature,.feature+.feature{padding:1.1rem 0;border-left:0}.num{display:inline-block}footer{flex-direction:column}.art{min-height:14rem}section.info{padding-block:3.5rem}pre{font-size:.75rem;padding:1rem}}
+@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}}
+.terminal{width:100%;max-width:30rem;padding:1rem;border:1px solid #334155;background:#020617;font:.7rem var(--mono);color:#94a3b8}.pixels{display:grid;grid-template-columns:repeat(6,1fr);gap:3px;width:13rem;margin:1.2rem auto}.pixels i{aspect-ratio:1;background:#065f46}.pixels i:nth-child(3n){background:#34d399}.pixels i:nth-child(4n){background:#a7f3d0}.protocol{display:flex;gap:1rem;border-top:1px solid #334155;padding-top:.7rem;color:#34d399}
+</style>
+</head><body style="--a:#34d399"><a class="skip" href="#main">Skip to content</a><div class="wrap">
+<header><a class="brand" href="#top" aria-label="Termvas home"><span class="mark" aria-hidden="true">T</span><span>Termvas</span></a><nav aria-label="Primary navigation"><a href="#features">Overview</a><a href="#quick-start">Quick start</a><a href="https://github.com/rbgfx/termvas">Source ↗</a></nav></header>
+<main id="main"><section class="hero" id="top" aria-labelledby="title"><div class="hero-copy"><p class="kicker">Terminal image output · Ruby</p><h1 id="title">Put the frame in the terminal.</h1><p class="lede">Display RGBA images with half blocks, Kitty, iTerm2, or Sixel, and read keyboard and mouse input.</p><div class="actions"><a class="button primary" href="#quick-start">Get started</a><a class="button" href="https://rubygems.org/gems/termvas">RubyGems ↗</a></div><p class="install"><span aria-hidden="true">$</span> <code>gem install termvas</code></p></div>
+<figure class="visual" aria-labelledby="cap-termvas"><div class="art"><div class="terminal"><div>termvas · image.png <span style="float:right">320 × 180</span></div><div class="pixels"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></div><div class="protocol"><span>BLOCKS</span><span>KITTY</span><span>ITERM2</span><span>SIXEL</span></div></div></div><figcaption id="cap-termvas"><span>Terminal viewport</span><span>protocol: half blocks</span></figcaption></figure></section>
+<section class="info" id="features" aria-labelledby="feat"><div class="section-head"><h2 id="feat">Images out. Input back.</h2><p>Terminal protocols, frame fitting, and input parsing for interactive applications.</p></div><div class="features"><article class="feature"><span class="num">01</span><h3>Detect the display</h3><p>Choose a protocol automatically or force one with an environment variable.</p></article><article class="feature"><span class="num">02</span><h3>View and play</h3><p>Inspect images or play frame sequences with nearest-neighbor fitting.</p></article><article class="feature"><span class="num">03</span><h3>Parse input safely</h3><p>Read split CSI, keyboard, wheel, and SGR mouse events.</p></article></div></section>
+<section class="info try" id="quick-start" aria-labelledby="quick"><div class="try-copy"><p class="kicker">A small first step</p><h2 id="quick">Start with one example.</h2><p>Install the gem, then follow the project guide for platform requirements and the full API.</p><p><a href="https://github.com/rbgfx/termvas#installation">Read the installation guide ↗</a></p></div><pre><code>termvas doctor
+termvas view image.png
+termvas play frames/*.png --fps 10
+
+backend = Termvas::Backend.new(320, 180, protocol: :blocks)
+# rgba_bytes contains top-down RGBA8 pixel data.
+backend.set_pixels(rgba_bytes, 320, 180)
+backend.close</code></pre></section></main>
+<footer><span>Termvas · Ruby 3.1+ · MIT</span><div><a href="https://github.com/rbgfx/termvas">GitHub</a><a href="https://github.com/rbgfx/termvas/blob/main/LICENSE.txt">License</a></div></footer></div></body></html>

data/exe/termvas

@@ -10,6 +10,7 @@ if command == "doctor"
   puts "terminal: #{ENV['TERM'] || 'unknown'}"
   puts "size: #{IO.console&.winsize&.join('x') || 'unknown'}"
 elsif %w[view play].include?(command)
+  require "termvas/rbgl"
   require "tessel"
   fps = 10.0
   protocol = :auto

data/lib/termvas/rbgl.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require "rbgl"
+require "termvas"
+
+module Termvas
+  class Backend < RBGL::GUI::Backend
+    attr_reader :width, :height, :protocol
+
+    def initialize(width, height, protocol: :auto, fit: :contain, max_fps: 30, quantize: :fixed, tmux: :auto, output: $stdout, input: $stdin, alt_screen: true, **_options)
+      super(Integer(width), Integer(height), "Termvas")
+      @protocol = protocol == :auto ? Detector.protocol : protocol.to_sym
+      @quantize = quantize.to_sym
+      tmux = ENV.key?("TMUX") if tmux == :auto
+      tmux &&= %i[kitty sixel].include?(@protocol)
+      raise ArgumentError, "unsupported terminal protocol: #{@protocol}" unless %i[blocks kitty iterm2 sixel].include?(@protocol)
+      @fit = fit.to_sym
+      raise ArgumentError, "fit must be :contain or :none" unless %i[contain none].include?(@fit)
+      @max_fps = max_fps.nil? ? nil : Float(max_fps)
+      raise ArgumentError, "max_fps must be positive" if @max_fps && !@max_fps.positive?
+      @terminal = Terminal.new(input: input, output: output, alt_screen: alt_screen, tmux: tmux)
+      @output = output
+      @input = input
+      @closed = false
+      @previous = nil
+      @parser = InputParser.new
+      @last_frame_at = nil
+      @terminal.open
+    end
+
+    def open = (@terminal.open; self)
+
+    def present(framebuffer)
+      pixels = framebuffer.respond_to?(:to_rgba_bytes) ? framebuffer.to_rgba_bytes : framebuffer
+      set_pixels(pixels, framebuffer.width, framebuffer.height)
+    end
+
+    def set_pixels(bytes, width = @width, height = @height)
+      bytes = validate_rgba_buffer(bytes, width, height)
+      width, height = Integer(width), Integer(height)
+      if @fit == :contain
+        columns, rows = @terminal.size
+        target_width, target_height = Scaler.contain(width, height, columns, rows)
+        bytes, width, height = Scaler.nearest(bytes, width, height, target_width, target_height)
+      end
+      @previous = nil if @previous_size && @previous_size != [width, height]
+      return if @previous == bytes
+      now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      return if @last_frame_at && @max_fps && now - @last_frame_at < 1.0 / @max_fps
+
+      encoded = case @protocol
+      when :kitty then Encoders::Kitty.encode(bytes, width, height)
+      when :iterm2
+        require "tessel"
+        Encoders::ITerm2.encode(Tessel::PNG.encode(Tessel::Image.from_rgba(width, height, bytes)), width: width, height: height)
+      when :sixel then Encoders::Sixel.encode(bytes, width, height, quantize: @quantize)
+      else Encoders::Blocks.encode(bytes, width, height, previous: @previous)
+      end
+      @terminal.write(encoded)
+      @previous = bytes.dup
+      @previous_size = [width, height]
+      @last_frame_at = now
+    end
+
+    def poll_events
+      return [] unless @input.respond_to?(:read_nonblock)
+      resize = if @terminal.resized?
+        columns, rows = @terminal.size
+        { type: :resize, columns: columns, rows: rows }
+      end
+      bytes = @input.read_nonblock(4096, exception: false)
+      events = bytes.is_a?(String) ? @parser.feed(bytes) : []
+      events = map_mouse_events(events)
+      events.unshift(resize) if resize
+      if events.any? { |event| event[:key] == :close }
+        @closed = true
+        @terminal.close
+      end
+      events
+    rescue IOError, Errno::EIO
+      []
+    end
+
+    def should_close?
+      @closed
+    end
+
+    def close
+      return if @closed
+      @closed = true
+      @terminal.close
+    end
+
+    private
+
+    def map_mouse_events(events)
+      return events unless @previous_size
+
+      columns, rows = @terminal.size
+      display_width = [@previous_size[0], columns].min
+      display_height = [@previous_size[1], rows * 2].min
+      events.filter_map do |event|
+        next event unless event.key?(:x) && event.key?(:y)
+
+        x = event[:x] * display_width.to_f / columns
+        y = event[:y] * display_height.to_f / rows
+        next if x >= display_width || y >= display_height
+
+        event.merge(x: x, y: y)
+      end
+    end
+  end
+end

data/lib/termvas/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Termvas
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/termvas.rb

@@ -2,7 +2,6 @@
 
 require "io/console"
 require "zlib"
-require "rbgl"
 
 require_relative "termvas/version"
 
@@ -100,7 +99,8 @@ module Termvas
         raise ArgumentError, "unsupported Sixel quantizer: #{quantize}" unless %i[fixed median_cut].include?(quantize)
         if quantize == :median_cut
           raise ArgumentError, "palette cannot be combined with median cut" if palette
-          palette, quantized = Quantizer.median_cut(bytes, colors: 256)
+          require "tessel"
+          quantized, palette = Tessel::Quantize.quantize(Tessel::Image.from_rgba(width, height, bytes), colors: 256)
         end
         fixed_palette = palette.nil?
         palette ||= default_palette
@@ -167,49 +167,6 @@ module Termvas
     end
   end
 
-  module Quantizer
-    module_function
-
-    def median_cut(bytes, colors: 256)
-      colors = Integer(colors)
-      raise ArgumentError, "colors must be positive" unless colors.positive?
-      pixels = bytes.bytes.each_slice(4).map { |red, green, blue, _alpha| [red, green, blue] }
-      return [[], "".b] if pixels.empty?
-
-      boxes = [pixels]
-      while boxes.length < colors
-        index = boxes.each_index.max_by { |box_index| split_range(boxes[box_index]) }
-        box = boxes[index]
-        break if box.length < 2
-
-        axis = widest_axis(box)
-        sorted = box.sort_by { |pixel| pixel[axis] }
-        midpoint = sorted.length / 2
-        boxes[index] = sorted.first(midpoint)
-        boxes << sorted.drop(midpoint)
-      end
-
-      palette = boxes.map do |box|
-        box.transpose.map { |channel| (channel.sum.to_f / channel.length).round }
-      end
-      indices = pixels.map do |pixel|
-        palette.each_index.min_by { |index| pixel.zip(palette[index]).sum { |left, right| (left - right)**2 } }
-      end.pack("C*")
-      [palette, indices]
-    end
-
-    def split_range(box)
-      ranges = 3.times.map { |axis| box.map { |pixel| pixel[axis] }.max - box.map { |pixel| pixel[axis] }.min }
-      ranges.max * box.length
-    end
-    private_class_method :split_range
-
-    def widest_axis(box)
-      3.times.max_by { |axis| box.map { |pixel| pixel[axis] }.max - box.map { |pixel| pixel[axis] }.min }
-    end
-    private_class_method :widest_axis
-  end
-
   class InputParser
     CSI_KEYS = { "A" => :up, "B" => :down, "C" => :right, "D" => :left, "H" => :home, "F" => :end }.freeze
     CSI_TILDE_KEYS = { 1 => :home, 2 => :insert, 3 => :delete, 4 => :end, 5 => :page_up, 6 => :page_down }.freeze
@@ -418,109 +375,4 @@ module Termvas
     end
   end
 
-  class Backend < RBGL::GUI::Backend
-    attr_reader :width, :height, :protocol
-
-    def initialize(width, height, protocol: :auto, fit: :contain, max_fps: 30, quantize: :fixed, tmux: :auto, output: $stdout, input: $stdin, alt_screen: true, **_options)
-      super(Integer(width), Integer(height), "Termvas")
-      @protocol = protocol == :auto ? Detector.protocol : protocol.to_sym
-      @quantize = quantize.to_sym
-      tmux = ENV.key?("TMUX") if tmux == :auto
-      tmux &&= %i[kitty sixel].include?(@protocol)
-      raise ArgumentError, "unsupported terminal protocol: #{@protocol}" unless %i[blocks kitty iterm2 sixel].include?(@protocol)
-      @fit = fit.to_sym
-      raise ArgumentError, "fit must be :contain or :none" unless %i[contain none].include?(@fit)
-      @max_fps = max_fps.nil? ? nil : Float(max_fps)
-      raise ArgumentError, "max_fps must be positive" if @max_fps && !@max_fps.positive?
-      @terminal = Terminal.new(input: input, output: output, alt_screen: alt_screen, tmux: tmux)
-      @output = output
-      @input = input
-      @closed = false
-      @previous = nil
-      @parser = InputParser.new
-      @last_frame_at = nil
-      @terminal.open
-    end
-
-    def open = (@terminal.open; self)
-
-    def present(framebuffer)
-      set_pixels(framebuffer.respond_to?(:to_rgba_bytes) ? framebuffer.to_rgba_bytes : framebuffer, framebuffer.width, framebuffer.height)
-    end
-
-    def set_pixels(bytes, width = @width, height = @height)
-      bytes = validate_rgba_buffer(bytes, width, height)
-      width, height = Integer(width), Integer(height)
-      if @fit == :contain
-        columns, rows = @terminal.size
-        target_width, target_height = Scaler.contain(width, height, columns, rows)
-        bytes, width, height = Scaler.nearest(bytes, width, height, target_width, target_height)
-      end
-      @previous = nil if @previous_size && @previous_size != [width, height]
-      return if @previous == bytes
-      now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-      return if @last_frame_at && @max_fps && now - @last_frame_at < 1.0 / @max_fps
-
-      encoded = case @protocol
-      when :kitty then Encoders::Kitty.encode(bytes, width, height)
-      when :iterm2
-        require "tessel"
-        Encoders::ITerm2.encode(Tessel::PNG.encode(Tessel::Image.from_rgba(width, height, bytes)), width: width, height: height)
-      when :sixel then Encoders::Sixel.encode(bytes, width, height, quantize: @quantize)
-      else Encoders::Blocks.encode(bytes, width, height, previous: @previous)
-      end
-      @terminal.write(encoded)
-      @previous = bytes.dup
-      @previous_size = [width, height]
-      @last_frame_at = now
-    end
-
-    def poll_events
-      return [] unless @input.respond_to?(:read_nonblock)
-      resize = if @terminal.resized?
-        columns, rows = @terminal.size
-        { type: :resize, columns: columns, rows: rows }
-      end
-      bytes = @input.read_nonblock(4096, exception: false)
-      events = bytes.is_a?(String) ? @parser.feed(bytes) : []
-      events = map_mouse_events(events)
-      events.unshift(resize) if resize
-      if events.any? { |event| event[:key] == :close }
-        @closed = true
-        @terminal.close
-      end
-      events
-    rescue IOError, Errno::EIO
-      []
-    end
-
-    def should_close?
-      @closed
-    end
-
-    def close
-      return if @closed
-      @closed = true
-      @terminal.close
-    end
-
-    private
-
-    def map_mouse_events(events)
-      return events unless @previous_size
-
-      columns, rows = @terminal.size
-      display_width = [@previous_size[0], columns].min
-      display_height = [@previous_size[1], rows * 2].min
-      events.filter_map do |event|
-        next event unless event.key?(:x) && event.key?(:y)
-
-        x = event[:x] * display_width.to_f / columns
-        y = event[:y] * display_height.to_f / rows
-        next if x >= display_width || y >= display_height
-
-        event.merge(x: x, y: y)
-      end
-    end
-  end
 end

metadata

@@ -1,28 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: termvas
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
-- ydah
+- Yudai Takada
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: rbgl
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.0.0
+date: 2026-09-25 00:00:00.000000000 Z
+dependencies: []
 description: Half block, Kitty, iTerm2, and Sixel terminal output with input parsing.
 email:
 - t.yudai92@gmail.com
@@ -35,9 +22,11 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- docs/index.html
 - docs/keys.md
 - exe/termvas
 - lib/termvas.rb
+- lib/termvas/rbgl.rb
 - lib/termvas/version.rb
 - sig/termvas.rbs
 homepage: https://github.com/rbgfx/termvas
@@ -46,6 +35,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/rbgfx/termvas
   source_code_uri: https://github.com/rbgfx/termvas/tree/main
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -60,7 +50,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Terminal backend for Ruby graphics
 test_files: []