Safe Haskell	Safe-Inferred
Language	Haskell2010

Graphics.Vty.Span

Description

A picture is translated into a sequences of state changes and character spans. The attribute is applied to all following spans, including spans of the next row. The nth element of the sequence represents the nth row (from top to bottom) of the picture to render.

A span op sequence will be defined for all rows and columns (and no more) of the region provided with the picture to spansForPic.

Synopsis

data SpanOp
- = TextSpan {
  - textSpanAttr :: !Attr
  - textSpanOutputWidth :: !Int
  - textSpanCharWidth :: !Int
  - textSpanText :: Text
  }
- | Skip !Int
- | RowEnd !Int
columnsToCharOffset :: Int -> SpanOp -> Int
spanOpHasWidth :: SpanOp -> Maybe (Int, Int)
type SpanOps = Vector SpanOp
spanOpsAffectedColumns :: SpanOps -> Int
splitOpsAt :: Int -> SpanOps -> (SpanOps, SpanOps)
dropOps :: Int -> SpanOps -> SpanOps
type DisplayOps = Vector SpanOps
displayOpsRows :: DisplayOps -> Int
displayOpsColumns :: DisplayOps -> Int
affectedRegion :: DisplayOps -> DisplayRegion

Documentation

data SpanOp Source #

This represents an operation on the terminal: either an attribute change or the output of a text string.

Constructors

TextSpan	A span of UTF-8 text occupies a specific number of screen space columns. A single UTF character does not necessarily represent 1 colunm. See Codec.Binary.UTF8.Width TextSpan [Attr] [output width in columns] [number of characters] [data]
Fields textSpanAttr :: !Attr textSpanOutputWidth :: !Int textSpanCharWidth :: !Int textSpanText :: Text
Skip !Int	Skips the given number of columns.
RowEnd !Int	Marks the end of a row. Specifies how many columns are remaining. These columns will not be explicitly overwritten with the span ops. The terminal is require to assure the remaining columns are clear.

Instances

Instances details

Show SpanOp Source #
Instance details Defined in Graphics.Vty.Span Methods showsPrec :: Int -> SpanOp -> ShowS # show :: SpanOp -> String # showList :: [SpanOp] -> ShowS #
Eq SpanOp Source #
Instance details Defined in Graphics.Vty.Span Methods (==) :: SpanOp -> SpanOp -> Bool # (/=) :: SpanOp -> SpanOp -> Bool #

columnsToCharOffset :: Int -> SpanOp -> Int Source #

The number of columns to the character at the given position in the span op.

spanOpHasWidth :: SpanOp -> Maybe (Int, Int) Source #

The width of a single SpanOp in columns.

type SpanOps = Vector SpanOp Source #

A vector of span operations executed in succession. This represents the operations required to render a row of the terminal. The operations in one row may affect subsequent rows. For example, setting the foreground color in one row will affect all subsequent rows until the foreground color is changed.

spanOpsAffectedColumns :: SpanOps -> Int Source #

The number of columns a SpanOps affects.

splitOpsAt :: Int -> SpanOps -> (SpanOps, SpanOps) Source #

dropOps :: Int -> SpanOps -> SpanOps Source #

type DisplayOps = Vector SpanOps Source #

A vector of span operation vectors for display, one per row of the output region.

displayOpsRows :: DisplayOps -> Int Source #

The number of rows the DisplayOps are defined for.

displayOpsColumns :: DisplayOps -> Int Source #

The number of columns the DisplayOps are defined for.

All spans are verified to define same number of columns.

affectedRegion :: DisplayOps -> DisplayRegion Source #