// Copyright 2015 The TCell Authors // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use file except in compliance with the License. // You may obtain a copy of the license at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package tcell import ( "bytes" "io" "os" "strconv" "sync" "unicode/utf8" ) func NewTerminfoScreen() (Screen, error) { ti, e := LookupTerminfo(os.Getenv("TERM")) if e != nil { return nil, e } t := &tScreen{ti: ti} t.keys = make(map[Key][]byte) if len(ti.Mouse) > 0 { t.mouse = []byte(ti.Mouse) } t.prepareKeys() t.w = ti.Columns t.h = ti.Lines t.sigwinch = make(chan os.Signal, 1) // environment overrides if i, _ := strconv.Atoi(os.Getenv("LINES")); i != 0 { t.h = i } if i, _ := strconv.Atoi(os.Getenv("COLUMNS")); i != 0 { t.w = i } return t, nil } // tScreen represents a screen backed by a terminfo implementation. type tScreen struct { ti *Terminfo w int h int in *os.File out *os.File curstyle Style style Style evch chan Event sigwinch chan os.Signal quit chan struct{} indoneq chan struct{} keys map[Key][]byte cx int cy int mouse []byte cells []Cell clear bool cursorx int cursory int tiosp *termiosPrivate baud int wasbtn bool sync.Mutex } func (t *tScreen) Init() error { t.evch = make(chan Event, 2) t.indoneq = make(chan struct{}) if e := t.termioInit(); e != nil { return e } ti := t.ti t.TPuts(ti.EnterCA) t.TPuts(ti.EnterKeypad) t.TPuts(ti.HideCursor) t.TPuts(ti.Clear) t.quit = make(chan struct{}) t.cx = -1 t.cy = -1 t.style = StyleDefault t.cells = ResizeCells(nil, 0, 0, t.w, t.h) t.cursorx = -1 t.cursory = -1 go t.inputLoop() return nil } func (t *tScreen) prepareKey(key Key, val string) { if val != "" { t.keys[key] = []byte(val) } } func (t *tScreen) prepareKeys() { ti := t.ti t.prepareKey(KeyBackspace, ti.KeyBackspace) t.prepareKey(KeyF1, ti.KeyF1) t.prepareKey(KeyF2, ti.KeyF2) t.prepareKey(KeyF3, ti.KeyF3) t.prepareKey(KeyF4, ti.KeyF4) t.prepareKey(KeyF5, ti.KeyF5) t.prepareKey(KeyF6, ti.KeyF6) t.prepareKey(KeyF7, ti.KeyF7) t.prepareKey(KeyF8, ti.KeyF8) t.prepareKey(KeyF9, ti.KeyF9) t.prepareKey(KeyF10, ti.KeyF10) t.prepareKey(KeyF11, ti.KeyF11) t.prepareKey(KeyF12, ti.KeyF12) t.prepareKey(KeyF13, ti.KeyF13) t.prepareKey(KeyF14, ti.KeyF14) t.prepareKey(KeyF15, ti.KeyF15) t.prepareKey(KeyF16, ti.KeyF16) t.prepareKey(KeyF17, ti.KeyF17) t.prepareKey(KeyF18, ti.KeyF18) t.prepareKey(KeyF19, ti.KeyF19) t.prepareKey(KeyF20, ti.KeyF20) t.prepareKey(KeyF21, ti.KeyF21) t.prepareKey(KeyF22, ti.KeyF22) t.prepareKey(KeyF23, ti.KeyF23) t.prepareKey(KeyF24, ti.KeyF24) t.prepareKey(KeyF25, ti.KeyF25) t.prepareKey(KeyF26, ti.KeyF26) t.prepareKey(KeyF27, ti.KeyF27) t.prepareKey(KeyF28, ti.KeyF28) t.prepareKey(KeyF29, ti.KeyF29) t.prepareKey(KeyF30, ti.KeyF30) t.prepareKey(KeyF31, ti.KeyF31) t.prepareKey(KeyF32, ti.KeyF32) t.prepareKey(KeyF33, ti.KeyF33) t.prepareKey(KeyF34, ti.KeyF34) t.prepareKey(KeyF35, ti.KeyF35) t.prepareKey(KeyF36, ti.KeyF36) t.prepareKey(KeyF37, ti.KeyF37) t.prepareKey(KeyF38, ti.KeyF38) t.prepareKey(KeyF39, ti.KeyF39) t.prepareKey(KeyF40, ti.KeyF40) t.prepareKey(KeyF41, ti.KeyF41) t.prepareKey(KeyF42, ti.KeyF42) t.prepareKey(KeyF43, ti.KeyF43) t.prepareKey(KeyF44, ti.KeyF44) t.prepareKey(KeyF45, ti.KeyF45) t.prepareKey(KeyF46, ti.KeyF46) t.prepareKey(KeyF47, ti.KeyF47) t.prepareKey(KeyF48, ti.KeyF48) t.prepareKey(KeyF49, ti.KeyF49) t.prepareKey(KeyF50, ti.KeyF50) t.prepareKey(KeyF51, ti.KeyF51) t.prepareKey(KeyF52, ti.KeyF52) t.prepareKey(KeyF53, ti.KeyF53) t.prepareKey(KeyF54, ti.KeyF54) t.prepareKey(KeyF55, ti.KeyF55) t.prepareKey(KeyF56, ti.KeyF56) t.prepareKey(KeyF57, ti.KeyF57) t.prepareKey(KeyF58, ti.KeyF58) t.prepareKey(KeyF59, ti.KeyF59) t.prepareKey(KeyF60, ti.KeyF60) t.prepareKey(KeyF61, ti.KeyF61) t.prepareKey(KeyF62, ti.KeyF62) t.prepareKey(KeyF63, ti.KeyF63) t.prepareKey(KeyF64, ti.KeyF64) t.prepareKey(KeyInsert, ti.KeyInsert) t.prepareKey(KeyDelete, ti.KeyDelete) t.prepareKey(KeyHome, ti.KeyHome) t.prepareKey(KeyEnd, ti.KeyEnd) t.prepareKey(KeyUp, ti.KeyUp) t.prepareKey(KeyDown, ti.KeyDown) t.prepareKey(KeyLeft, ti.KeyLeft) t.prepareKey(KeyRight, ti.KeyRight) t.prepareKey(KeyPgUp, ti.KeyPgUp) t.prepareKey(KeyPgDn, ti.KeyPgDn) t.prepareKey(KeyHelp, ti.KeyHelp) t.prepareKey(KeyPrint, ti.KeyPrint) t.prepareKey(KeyCancel, ti.KeyCancel) t.prepareKey(KeyExit, ti.KeyExit) t.prepareKey(KeyBacktab, ti.KeyBacktab) } func (t *tScreen) Fini() { ti := t.ti if t.quit != nil { close(t.quit) } t.TPuts(ti.ShowCursor) t.TPuts(ti.AttrOff) t.TPuts(ti.Clear) t.TPuts(ti.ExitCA) t.TPuts(ti.ExitKeypad) t.TPuts(ti.ExitMouse) t.w = 0 t.h = 0 t.cells = nil t.curstyle = Style(-1) t.clear = false t.termioFini() } func (t *tScreen) SetStyle(style Style) { t.Lock() t.style = style t.Unlock() } func (t *tScreen) Clear() { t.Lock() ClearCells(t.cells, t.style) t.Unlock() } func (t *tScreen) SetCell(x, y int, style Style, ch ...rune) { t.Lock() if x < 0 || y < 0 || x >= t.w || y >= t.h { t.Unlock() return } cell := &t.cells[(y*t.w)+x] cell.SetCell(ch, style) t.Unlock() } func (t *tScreen) PutCell(x, y int, cell *Cell) { t.Lock() if x < 0 || y < 0 || x >= t.w || y >= t.h { t.Unlock() return } cp := &t.cells[(y*t.w)+x] cp.PutStyle(cell.Style) cp.PutChars(cell.Ch) t.Unlock() } func (t *tScreen) GetCell(x, y int) *Cell { t.Lock() if x < 0 || y < 0 || x >= t.w || y >= t.h { t.Unlock() return nil } cell := t.cells[(y*t.w)+x] t.Unlock() return &cell } func (t *tScreen) drawCell(x, y int, cell *Cell) { // XXX: this would be a place to check for hazeltine not being able // to display ~, or possibly non-UTF-8 locales, etc. ti := t.ti if t.cy != y || t.cx != x { t.TPuts(ti.TGoto(x, y)) } style := cell.Style if style == StyleDefault { style = t.style } if style != t.curstyle { fg, bg, attrs := style.Decompose() t.TPuts(ti.AttrOff) if attrs&AttrBold != 0 { t.TPuts(ti.Bold) } if attrs&AttrUnderline != 0 { t.TPuts(ti.Underline) } if attrs&AttrReverse != 0 { t.TPuts(ti.Reverse) } if attrs&AttrBlink != 0 { t.TPuts(ti.Blink) } if attrs&AttrDim != 0 { t.TPuts(ti.Dim) } if fg != ColorDefault { c := int(fg) - 1 t.TPuts(ti.TParm(ti.SetFg, c)) } if bg != ColorDefault { c := int(bg) - 1 t.TPuts(ti.TParm(ti.SetBg, c)) } t.curstyle = style } // now emit runes - taking care to not overrun width with a // wide character, and to ensure that we emit exactly one regular // character followed up by any residual combing characters width := int(cell.Width) var str string if len(cell.Ch) == 0 { str = " " } else { str = string(cell.Ch) } if width == 2 && x >= t.w-1 { // too wide to fit; emit space instead width = 1 str = " " } io.WriteString(t.out, str) t.cy = y t.cx = x + width } func (t *tScreen) ShowCursor(x, y int) { t.Lock() t.cursorx = x t.cursory = y t.Unlock() } func (t *tScreen) HideCursor() { t.ShowCursor(-1, -1) } func (t *tScreen) showCursor() { x, y := t.cursorx, t.cursory if x < 0 || y < 0 || x >= t.w || y >= t.h { t.TPuts(t.ti.HideCursor) return } if t.cx != x || t.cy != y { t.TPuts(t.ti.TGoto(x, y)) } t.TPuts(t.ti.ShowCursor) t.cx = x t.cy = y } func (t *tScreen) TPuts(s string) { t.ti.TPuts(t.out, s, t.baud) } func (t *tScreen) Show() { t.Lock() t.resize() t.draw() t.Unlock() } func (t *tScreen) clearScreen() { t.TPuts(t.ti.Clear) t.clear = false } func (t *tScreen) hideCursor() { // does not update cursor position t.TPuts(t.ti.HideCursor) } func (t *tScreen) draw() { // clobber cursor position, because we're gonna change it all t.cx = -1 t.cy = -1 // hide the cursor while we move stuff around t.hideCursor() if t.clear { t.clearScreen() } for row := 0; row < t.h; row++ { for col := 0; col < t.w; col++ { cell := &t.cells[(row*t.w)+col] if !cell.Dirty { continue } t.drawCell(col, row, cell) cell.Dirty = false } } // restore the cursor t.showCursor() } func (t *tScreen) EnableMouse() { if len(t.mouse) != 0 { t.TPuts(t.ti.EnterMouse) } } func (t *tScreen) DisableMouse() { if len(t.mouse) != 0 { t.TPuts(t.ti.ExitMouse) } } func (t *tScreen) Size() (int, int) { t.Lock() w, h := t.w, t.h t.Unlock() return w, h } func (t *tScreen) resize() { var ev Event if w, h, e := t.getWinSize(); e == nil { if w != t.w || h != t.h { ev = NewEventResize(w, h) t.cx = -1 t.cy = -1 t.cells = ResizeCells(t.cells, t.w, t.h, w, h) t.w = w t.h = h } } if ev != nil { t.PostEvent(ev) } } func (t *tScreen) Colors() int { // this doesn't change, no need for lock return t.ti.Colors } func (t *tScreen) PollEvent() Event { select { case <-t.quit: return nil case ev := <-t.evch: return ev } } func (t *tScreen) PostEvent(ev Event) { t.evch <- ev } func (t *tScreen) postMouseEvent(x, y, btn int) { // XTerm mouse events only report at most one button at a time, // which may include a wheel button. Wheel motion events are // reported as single impulses, while other button events are reported // as separate press & release events. button := ButtonNone mod := ModNone // Mouse wheel has bit 6 set, no release events. It should be noted // that wheel events are sometimes misdelivered as mouse button events // during a click-drag, so we debounce these, considering them to be // button press events unless we see an intervening release event. switch btn & 0x43 { case 0: button = Button1 t.wasbtn = true case 1: button = Button2 t.wasbtn = true case 2: button = Button3 t.wasbtn = true case 3: button = ButtonNone t.wasbtn = false case 0x40: if !t.wasbtn { button = WheelUp } else { button = Button1 } case 0x41: if !t.wasbtn { button = WheelDown } else { button = Button2 } } if btn&0x4 != 0 { mod |= ModShift } if btn&0x8 != 0 { mod |= ModMeta } if btn&0x10 != 0 { mod |= ModCtrl } // Some terminals will report mouse coordinates outside the // screen, especially with click-drag events. Clip the coordinates // to the screen in that case. if x < 0 { x = 0 } if x > t.w-1 { x = t.w - 1 } if y < 0 { y = 0 } if y > t.h-1 { y = t.h - 1 } ev := NewEventMouse(x, y, button, mod) t.PostEvent(ev) } // parseSgrMouse attempts to locate an SGR mouse record at the start of the // buffer. It returns true, true if it found one, and the associated bytes // be removed from the buffer. It returns true, false if the buffer might // contain such an event, but more bytes are necessary (partial match), and // false, false if the content is definitely *not* an SGR mouse record. func (t *tScreen) parseSgrMouse(buf *bytes.Buffer) (bool, bool) { b := buf.Bytes() var x, y, btn, state int dig := false neg := false i := 0 val := 0 for i = range b { switch b[i] { case '\x1b': if state != 0 { return false, false } state = 1 case '\x9b': if state != 0 { return false, false } state = 2 case '[': if state != 1 { return false, false } state = 2 case '<': if state != 2 { return false, false } val = 0 dig = false neg = false state = 3 case '-': if state != 3 || state != 4 || state != 5 { return false, false } if dig || neg { return false, false } neg = true // stay in state case '0', '1', '2', '3', '4', '5', '6', '7', '8', '9': if state != 3 && state != 4 && state != 5 { return false, false } val *= 10 val += int(b[i] - '0') dig = true // stay in state case ';': if neg { val = -val } switch state { case 3: btn, val = val, 0 neg, dig, state = false, false, 4 case 4: x, val = val, 0 neg, dig, state = false, false, 5 default: return false, false } case 'm', 'M': if state != 5 { return false, false } if neg { val = -val } y = val // We don't care about the motion bit btn &^= 32 if b[i] == 'm' { // mouse release, clear all buttons btn |= 3 btn &^= 0x40 } // consume the event bytes for i >= 0 { buf.ReadByte() i-- } t.postMouseEvent(x, y, btn) return true, true } } // incomplete & inconclusve at this point return true, false } // parseXtermMouse is like parseSgrMouse, but it parses a legacy // X11 mouse record. func (t *tScreen) parseXtermMouse(buf *bytes.Buffer) (bool, bool) { b := buf.Bytes() state := 0 btn := 0 x := 0 y := 0 for i := range b { switch state { case 0: switch b[i] { case '\x1b': state = 1 case '\x9b': state = 2 default: return false, false } case 1: if b[i] != '[' { return false, false } state = 2 case 2: if b[i] != 'M' { return false, false } state++ case 3: btn = int(b[i]) state++ case 4: x = int(b[i]) - 32 - 1 state++ case 5: y = int(b[i]) - 32 - 1 for i >= 0 { buf.ReadByte() i-- } t.postMouseEvent(x, y, btn) return true, true } } return true, false } func (t *tScreen) parseFunctionKey(buf *bytes.Buffer) (bool, bool) { b := buf.Bytes() partial := false for k, esc := range t.keys { if bytes.HasPrefix(b, esc) { // matched var r rune if len(esc) == 1 { r = rune(b[0]) } ev := NewEventKey(k, r, ModNone) t.PostEvent(ev) for i := 0; i < len(esc); i++ { buf.ReadByte() } return true, true } if bytes.HasPrefix(esc, b) { partial = true } } return partial, false } func (t *tScreen) parseRune(buf *bytes.Buffer) (bool, bool) { b := buf.Bytes() if b[0] >= ' ' && b[0] <= 0x7F { // printable ASCII easy to deal with -- no encodings buf.ReadByte() ev := NewEventKey(KeyRune, rune(b[0]), ModNone) t.PostEvent(ev) return true, true } if b[0] >= 0x80 { if utf8.FullRune(b) { r, _, e := buf.ReadRune() if e == nil { ev := NewEventKey(KeyRune, r, ModNone) t.PostEvent(ev) return true, true } } // Looks like potential escape return true, false } return false, false } func (t *tScreen) scanInput(buf *bytes.Buffer, expire bool) { for { b := buf.Bytes() if len(b) == 0 { buf.Reset() return } partials := 0 if part, comp := t.parseRune(buf); comp { continue } else if part { partials++ } if part, comp := t.parseFunctionKey(buf); comp { continue } else if part { partials++ } if part, comp := t.parseXtermMouse(buf); comp { continue } else if part { partials++ } if part, comp := t.parseSgrMouse(buf); comp { continue } else if part { partials++ } if partials == 0 || expire { // Nothing was going to match, or we timed out // waiting for more data -- just deliver the characters // to the app & let them sort it out. by, _ := buf.ReadByte() ev := NewEventKey(KeyRune, rune(by), ModNone) t.PostEvent(ev) continue } // well we have some partial data, wait until we get // some more break } } func (t *tScreen) inputLoop() { buf := &bytes.Buffer{} chunk := make([]byte, 128) for { select { case <-t.quit: close(t.indoneq) return case <-t.sigwinch: t.Lock() t.resize() t.Unlock() continue default: } n, e := t.in.Read(chunk) switch e { case io.EOF: // If we timeout waiting for more bytes, then it's // time to give up on it. Even at 300 baud it takes // less than 0.5 ms to transmit a whole byte. if buf.Len() > 0 { t.scanInput(buf, true) } continue case nil: default: close(t.indoneq) return } buf.Write(chunk[:n]) // Now we need to parse the input buffer for events t.scanInput(buf, false) } } func (t *tScreen) Sync() { t.Lock() t.resize() t.clear = true InvalidateCells(t.cells) t.draw() t.Unlock() }