termutil

package module
v0.0.0-...-085b570 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 29, 2022 License: MIT Imports: 9 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	MouseModeNone MouseMode = iota
	MouseModeX10
	MouseModeVT200
	MouseModeVT200Highlight
	MouseModeButtonEvent
	MouseModeAnyEvent
	MouseExtNone MouseExtMode = iota
	MouseExtUTF
	MouseExtSGR
	MouseExtURXVT
)
View Source 
const (
	MainBuffer     uint8 = 0
	AltBuffer      uint8 = 1
	InternalBuffer uint8 = 2
)
View Source 
const TabSize = 8

Variables

This section is empty.

Functions

This section is empty.

Types

type Annotation 

type Annotation struct {
	Image  image.Image
	Text   string
	Width  float64 // Width in cells
	Height float64 // Height in cells
}

type Buffer 

type Buffer struct {
	// contains filtered or unexported fields
}

func NewBuffer 

func NewBuffer(width, height uint16, maxLines uint64, fg color.Color, bg color.Color) *Buffer

NewBuffer creates a new terminal buffer

func (*Buffer) BottomMargin 

func (buffer *Buffer) BottomMargin() uint

func (*Buffer) ClearHighlight 

func (buffer *Buffer) ClearHighlight()

func (*Buffer) ClearSelection 

func (buffer *Buffer) ClearSelection()

func (*Buffer) CursorColumn 

func (buffer *Buffer) CursorColumn() uint16

Column returns cursor column

func (*Buffer) CursorLine 

func (buffer *Buffer) CursorLine() uint16

CursorLine returns cursor line (in Origin Mode it is relative to the top margin)

func (*Buffer) CursorLineAbsolute 

func (buffer *Buffer) CursorLineAbsolute() uint16

CursorLineAbsolute returns absolute cursor line coordinate (ignoring Origin Mode) - view format

func (*Buffer) ExtendSelectionToEntireLines 

func (buffer *Buffer) ExtendSelectionToEntireLines()

func (*Buffer) FindWordAt 

func (buffer *Buffer) FindWordAt(pos Position, runeMatcher RuneMatcher) (start Position, end Position, text string, textIndex int, found bool)

returns raw lines

func (*Buffer) GetBoundedTextAtPosition 

func (buffer *Buffer) GetBoundedTextAtPosition(pos Position) (start Position, end Position, text string, textIndex int, found bool)

func (*Buffer) GetCell 

func (buffer *Buffer) GetCell(viewCol uint16, viewRow uint16) *Cell

func (*Buffer) GetCurrentLine 

func (buffer *Buffer) GetCurrentLine() *Line

creates if necessary

func (*Buffer) GetHighlightAnnotation 

func (buffer *Buffer) GetHighlightAnnotation() *Annotation

func (*Buffer) GetMaxLines 

func (buffer *Buffer) GetMaxLines() uint64

func (*Buffer) GetScrollOffset 

func (buffer *Buffer) GetScrollOffset() uint

func (*Buffer) GetSelection 

func (buffer *Buffer) GetSelection() (string, *Selection)

func (*Buffer) GetVPosition 

func (buffer *Buffer) GetVPosition() int

func (*Buffer) GetViewHighlight 

func (buffer *Buffer) GetViewHighlight() (start Position, end Position, exists bool)

func (*Buffer) GetVisibleLines 

func (buffer *Buffer) GetVisibleLines() []Line

func (*Buffer) GetVisibleSixels 

func (b *Buffer) GetVisibleSixels() []VisibleSixel

func (*Buffer) HasScrollableRegion 

func (buffer *Buffer) HasScrollableRegion() bool

func (*Buffer) Height 

func (buffer *Buffer) Height() int

func (*Buffer) Highlight 

func (buffer *Buffer) Highlight(start Position, end Position, annotation *Annotation)

takes raw coords

func (*Buffer) InScrollableRegion 

func (buffer *Buffer) InScrollableRegion() bool

func (*Buffer) InSelection 

func (buffer *Buffer) InSelection(pos Position) bool

func (*Buffer) IsApplicationCursorKeysModeEnabled 

func (buffer *Buffer) IsApplicationCursorKeysModeEnabled() bool

func (*Buffer) IsCursorVisible 

func (buffer *Buffer) IsCursorVisible() bool

func (*Buffer) IsNewLineMode 

func (buffer *Buffer) IsNewLineMode() bool

func (*Buffer) IsTabSetAtCursor 

func (buffer *Buffer) IsTabSetAtCursor() bool

func (*Buffer) RawLine 

func (buffer *Buffer) RawLine() uint64

cursor Y (raw)

func (*Buffer) ScrollDown 

func (buffer *Buffer) ScrollDown(lines uint)

func (*Buffer) ScrollToEnd 

func (buffer *Buffer) ScrollToEnd()

func (*Buffer) ScrollUp 

func (buffer *Buffer) ScrollUp(lines uint)

func (*Buffer) SelectWordAt 

func (buffer *Buffer) SelectWordAt(pos Position, runeMatcher RuneMatcher)

func (*Buffer) SetScrollOffset 

func (buffer *Buffer) SetScrollOffset(offset uint)

func (*Buffer) SetSelectionEnd 

func (buffer *Buffer) SetSelectionEnd(pos Position)

func (*Buffer) SetSelectionStart 

func (buffer *Buffer) SetSelectionStart(pos Position)

func (*Buffer) TopMargin 

func (buffer *Buffer) TopMargin() uint

func (*Buffer) ViewHeight 

func (buffer *Buffer) ViewHeight() uint16

func (*Buffer) ViewWidth 

func (buffer *Buffer) ViewWidth() uint16

func (*Buffer) Width 

func (buffer *Buffer) Width() uint16

Width returns the width of the buffer in columns

type Cell 

type Cell struct {
	// contains filtered or unexported fields
}

func (*Cell) Attr 

func (cell *Cell) Attr() CellAttributes

func (*Cell) Bg 

func (cell *Cell) Bg() color.Color

func (*Cell) Bold 

func (cell *Cell) Bold() bool

func (*Cell) Dim 

func (cell *Cell) Dim() bool

func (*Cell) Fg 

func (cell *Cell) Fg() color.Color

func (*Cell) Italic 

func (cell *Cell) Italic() bool

func (*Cell) Rune 

func (cell *Cell) Rune() MeasuredRune

func (*Cell) Strikethrough 

func (cell *Cell) Strikethrough() bool

func (*Cell) Underline 

func (cell *Cell) Underline() bool

type CellAttributes 

type CellAttributes struct {
	// contains filtered or unexported fields
}

type Colour 

type Colour uint8
const (
	ColourBlack Colour = iota
	ColourRed
	ColourGreen
	ColourYellow
	ColourBlue
	ColourMagenta
	ColourCyan
	ColourWhite
	ColourBrightBlack
	ColourBrightRed
	ColourBrightGreen
	ColourBrightYellow
	ColourBrightBlue
	ColourBrightMagenta
	ColourBrightCyan
	ColourBrightWhite
	ColourBackground
	ColourForeground
	ColourSelectionBackground
	ColourSelectionForeground
	ColourCursorForeground
	ColourCursorBackground
)

See https://en.wikipedia.org/wiki/ANSI_escape_code#3-bit_and_4-bit

type Line 

type Line struct {
	// contains filtered or unexported fields
}

func (*Line) Len 

func (line *Line) Len() uint16

func (*Line) String 

func (line *Line) String() string

type MeasuredRune 

type MeasuredRune struct {
	Rune  rune
	Width int
}

func (MeasuredRune) Empty 

func (m MeasuredRune) Empty() bool

type Modes 

type Modes struct {
	ShowCursor            bool
	ApplicationCursorKeys bool
	BlinkingCursor        bool
	ReplaceMode           bool // overwrite character at cursor or insert new
	OriginMode            bool // see DECOM docs - whether cursor is positioned within the margins or not
	LineFeedMode          bool
	ScreenMode            bool // DECSCNM (black on white background)
	AutoWrap              bool
	SixelScrolling        bool // DECSDM
	BracketedPasteMode    bool
}

type MouseExtMode 

type MouseExtMode uint

type MouseMode 

type MouseMode uint

type Option 

type Option func(t *Terminal)

func WithLogFile 

func WithLogFile(path string) Option

func WithRequestRender 

func WithRequestRender(f func()) Option

type Position 

type Position struct {
	Line uint64
	Col  uint16
}

type Reader 

type Reader struct {
	// contains filtered or unexported fields
}

func NewReader 

func NewReader(data []byte) *Reader

func (*Reader) ReadRune 

func (reader *Reader) ReadRune() MeasuredRune

type RuneMatcher 

type RuneMatcher func(r rune) bool

type Selection 

type Selection struct {
	Start Position
	End   Position
}

type Sixel 

type Sixel struct {
	X      uint16
	Y      uint64 // raw line
	Width  uint64
	Height uint64
	Image  image.Image
}

type Terminal 

type Terminal struct {
	RequestRender func()
	// contains filtered or unexported fields
}

Terminal communicates with the underlying terminal

func New 

func New(options ...Option) *Terminal

NewTerminal creates a new terminal instance

func (*Terminal) GetActiveBuffer 

func (t *Terminal) GetActiveBuffer() *Buffer

func (*Terminal) GetMouseExtMode 

func (t *Terminal) GetMouseExtMode() MouseExtMode

func (*Terminal) GetMouseMode 

func (t *Terminal) GetMouseMode() MouseMode

func (*Terminal) Lock 

func (t *Terminal) Lock()

func (*Terminal) Process 

func (t *Terminal) Process(data []byte)

func (*Terminal) Unlock 

func (t *Terminal) Unlock()

type Theme 

type Theme struct {
	// contains filtered or unexported fields
}

func (*Theme) ColourFrom24Bit 

func (t *Theme) ColourFrom24Bit(r, g, b string) (color.Color, error)

func (*Theme) ColourFrom4Bit 

func (t *Theme) ColourFrom4Bit(code uint8) color.Color

func (*Theme) ColourFrom8Bit 

func (t *Theme) ColourFrom8Bit(n string) (color.Color, error)

func (*Theme) ColourFromAnsi 

func (t *Theme) ColourFromAnsi(ansi []string, bg bool) (color.Color, error)

func (*Theme) CursorBackground 

func (t *Theme) CursorBackground() color.Color

func (*Theme) CursorForeground 

func (t *Theme) CursorForeground() color.Color

func (*Theme) DefaultBackground 

func (t *Theme) DefaultBackground() color.Color

func (*Theme) DefaultForeground 

func (t *Theme) DefaultForeground() color.Color

func (*Theme) SelectionBackground 

func (t *Theme) SelectionBackground() color.Color

func (*Theme) SelectionForeground 

func (t *Theme) SelectionForeground() color.Color

type ThemeFactory 

type ThemeFactory struct {
	// contains filtered or unexported fields
}

func NewThemeFactory 

func NewThemeFactory() *ThemeFactory

func (*ThemeFactory) Build 

func (t *ThemeFactory) Build() *Theme

func (*ThemeFactory) WithColour 

func (t *ThemeFactory) WithColour(key Colour, colour color.Color) *ThemeFactory

type VisibleSixel 

type VisibleSixel struct {
	ViewLineOffset int
	Sixel          Sixel
}

type WindowManipulator 

type WindowManipulator interface {
	State() WindowState
	Minimise()
	Maximise()
	Restore()
	SetTitle(title string)
	Position() (int, int)
	SizeInPixels() (int, int)
	CellSizeInPixels() (int, int)
	SizeInChars() (int, int)
	ResizeInPixels(int, int)
	ResizeInChars(int, int)
	ScreenSizeInPixels() (int, int)
	ScreenSizeInChars() (int, int)
	Move(x, y int)
	IsFullscreen() bool
	SetFullscreen(enabled bool)
	GetTitle() string
	SaveTitleToStack()
	RestoreTitleFromStack()
	ReportError(err error)
}

type WindowState 

type WindowState uint8
const (
	StateUnknown WindowState = iota
	StateMinimised
	StateNormal
	StateMaximised
)

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.