Class: Muxr::Renderer

Inherits:
Object
  • Object
show all
Defined in:
lib/muxr/renderer.rb

Overview

The Renderer composites the Session into a single grid of cells and then emits ANSI escape sequences to write that grid to STDOUT. It compares the new frame against the previous one and only repositions/redraws cells whose contents changed, keeping output volume low between ticks.

Defined Under Namespace

Classes: Cell

Constant Summary collapse

BORDER_FOCUSED =

yellow (fallback when no mode color)

[:c256, 11].freeze
BORDER_UNFOCUSED =

grey

[:c256, 8].freeze
BORDER_DRAWER_FOCUS =

magenta

[:c256, 13].freeze
BORDER_DRAWER_IDLE =

dark magenta

[:c256, 5].freeze
STATUS_BG = 
[:c256, 236].freeze
STATUS_FG = 
[:c256, 252].freeze
MODE_COLOR =

Vim-style mode palette. Used in two places: the focused pane border (so the user can see at a glance what mode they’re in) and the

MODE

chip in the status bar (same color, smaller real estate).

:prefix maps to the same green as :passthrough because :prefix is a transient sub-state under passthrough — sharing the color avoids a one-frame border flicker when pressing Ctrl-a.

{
  normal:       [:c256, 51].freeze,   # cyan
  passthrough:  [:c256, 42].freeze,   # green
  prefix:       [:c256, 42].freeze,   # green (passthrough sub-state)
  command:      [:c256, 226].freeze,  # yellow
  scrollback:   [:c256, 214].freeze,  # orange
  selection:    [:c256, 201].freeze,  # magenta
  confirm_quit: [:c256, 196].freeze,  # red
  help:         [:c256, 39].freeze    # blue
}.freeze
HORIZONTAL = 
"─".freeze
VERTICAL = 
"│".freeze
TL = 
"┌".freeze
TR = 
"┐".freeze
BL = 
"└".freeze
BR = 
"┘".freeze

Instance Method Summary collapse

Constructor Details

#initialize(out: $stdout) ⇒ Renderer

Returns a new instance of Renderer.



44
45
46
47
48
49
 
# File 'lib/muxr/renderer.rb', line 44

def initialize(out: $stdout)
  @out = out
  @prev = nil
  @prev_w = 0
  @prev_h = 0
end

Instance Method Details

#enter_alt_screen ⇒ Object 



51
52
53
54
55
56
57
58
 
# File 'lib/muxr/renderer.rb', line 51

def enter_alt_screen
  # Close any stale OSC 8 hyperlink the outer terminal might be carrying
  # from before we attached, so the first frame's run-tracker matches
  # reality.
  @out.write("\e[?1049h\e[?25l\e[2J\e[H\e[0m\e]8;;\e\\")
  @out.flush
  @prev = nil
end

#exit_alt_screen ⇒ Object 



60
61
62
63
 
# File 'lib/muxr/renderer.rb', line 60

def exit_alt_screen
  @out.write("\e[0m\e[?25h\e[?1049l")
  @out.flush
end

#render(session, input_state: :normal, command_buffer: "", message: nil, help: false) ⇒ Object 



69
70
71
72
73
74
75
76
77
78
79
80
81
82
 
# File 'lib/muxr/renderer.rb', line 69

def render(session, input_state: :normal, command_buffer: "", message: nil, help: false)
  w = session.width
  h = session.height
  return if w < 4 || h < 3

  frame = Array.new(h) { Array.new(w) { Cell.new(" ", nil, nil, 0, nil) } }

  compose_panes(frame, session, input_state: input_state)
  compose_drawer(frame, session, input_state: input_state) if session.drawer&.visible?
  compose_status_bar(frame, session, input_state: input_state, command_buffer: command_buffer, message: message)
  compose_help(frame, session) if help

  emit_frame(frame, session, input_state: input_state, command_buffer: command_buffer)
end

#reset_frame! ⇒ Object 



65
66
67
 
# File 'lib/muxr/renderer.rb', line 65

def reset_frame!
  @prev = nil
end