Safe Haskell	Safe
Language	Haskell2010

Graphics.Vty.Attributes

Contents

Styles
Setting attribute colors
Setting hyperlinks
Colors

Description

Display attributes

Attributes have three components: a foreground color, a background color, and a style mask. The simplest attribute is the default attribute, or defAttr. Attributes can be modified with withForeColor, withBackColor, and withStyle, e.g.,

    defAttr `withForeColor` red

Image constructors often require an Attr to indicate the attributes used in the image, e.g.,

    string (defAttr `withForeColor` red) "this text will be red"

The appearance of Images using defAttr is determined by the The terminal, so this is not something VTY can control. The user is free to The define the color scheme of the terminal as they see fit.

The value currentAttr will keep the attributes of whatever was output previously.

Synopsis

data Attr = Attr {
- attrStyle :: !(MaybeDefault Style)
- attrForeColor :: !(MaybeDefault Color)
- attrBackColor :: !(MaybeDefault Color)
- attrURL :: !(MaybeDefault Text)
}
data FixedAttr = FixedAttr {
- fixedStyle :: !Style
- fixedForeColor :: !(Maybe Color)
- fixedBackColor :: !(Maybe Color)
- fixedURL :: !(Maybe Text)
}
data MaybeDefault v where
- Default :: MaybeDefault v
- KeepCurrent :: MaybeDefault v
- SetTo :: forall v. (Eq v, Show v, Read v) => !v -> MaybeDefault v
defAttr :: Attr
currentAttr :: Attr
type Style = Word8
withStyle :: Attr -> Style -> Attr
standout :: Style
underline :: Style
reverseVideo :: Style
blink :: Style
dim :: Style
bold :: Style
defaultStyleMask :: Style
styleMask :: Attr -> Word8
hasStyle :: Style -> Style -> Bool
withForeColor :: Attr -> Color -> Attr
withBackColor :: Attr -> Color -> Attr
withURL :: Attr -> Text -> Attr
data Color
- = ISOColor !Word8
- | Color240 !Word8
black :: Color
red :: Color
green :: Color
yellow :: Color
blue :: Color
magenta :: Color
cyan :: Color
white :: Color
brightBlack :: Color
brightRed :: Color
brightGreen :: Color
brightYellow :: Color
brightBlue :: Color
brightMagenta :: Color
brightCyan :: Color
brightWhite :: Color
rgbColor :: Integral i => i -> i -> i -> Color

Documentation

data Attr Source #

A display attribute defines the Color and Style of all the characters rendered after the attribute is applied.

At most 256 colors, picked from a 240 and 16 color palette, are possible for the background and foreground. The 240 colors and 16 colors are points in different palettes. See Color for more information.

Constructors

Attr
Fields attrStyle :: !(MaybeDefault Style) attrForeColor :: !(MaybeDefault Color) attrBackColor :: !(MaybeDefault Color) attrURL :: !(MaybeDefault Text)

Instances

Eq Attr Source #
Instance details Defined in Graphics.Vty.Attributes Methods (==) :: Attr -> Attr -> Bool # (/=) :: Attr -> Attr -> Bool #
Read Attr Source #
Instance details Defined in Graphics.Vty.Attributes Methods readsPrec :: Int -> ReadS Attr # readList :: ReadS [Attr] # readPrec :: ReadPrec Attr # readListPrec :: ReadPrec [Attr] #
Show Attr Source #
Instance details Defined in Graphics.Vty.Attributes Methods showsPrec :: Int -> Attr -> ShowS # show :: Attr -> String # showList :: [Attr] -> ShowS #
Semigroup Attr Source #
Instance details Defined in Graphics.Vty.Attributes Methods (<>) :: Attr -> Attr -> Attr # sconcat :: NonEmpty Attr -> Attr # stimes :: Integral b => b -> Attr -> Attr #
Monoid Attr Source #
Instance details Defined in Graphics.Vty.Attributes Methods mempty :: Attr # mappend :: Attr -> Attr -> Attr # mconcat :: [Attr] -> Attr #

data FixedAttr Source #

Specifies the display attributes such that the final style and color values do not depend on the previously applied display attribute. The display attributes can still depend on the terminal's default colors (unfortunately).

Constructors

FixedAttr
Fields fixedStyle :: !Style fixedForeColor :: !(Maybe Color) fixedBackColor :: !(Maybe Color) fixedURL :: !(Maybe Text)

Instances

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

data MaybeDefault v where Source #

The style and color attributes can either be the terminal defaults. Or be equivalent to the previously applied style. Or be a specific value.

Constructors

Default :: MaybeDefault v
KeepCurrent :: MaybeDefault v
SetTo :: forall v. (Eq v, Show v, Read v) => !v -> MaybeDefault v

Instances

Eq v => Eq (MaybeDefault v) Source #
Instance details Defined in Graphics.Vty.Attributes Methods (==) :: MaybeDefault v -> MaybeDefault v -> Bool # (/=) :: MaybeDefault v -> MaybeDefault v -> Bool #
(Eq v, Show v, Read v) => Read (MaybeDefault v) Source #
Instance details Defined in Graphics.Vty.Attributes Methods readsPrec :: Int -> ReadS (MaybeDefault v) # readList :: ReadS [MaybeDefault v] # readPrec :: ReadPrec (MaybeDefault v) # readListPrec :: ReadPrec [MaybeDefault v] #
Eq v => Show (MaybeDefault v) Source #
Instance details Defined in Graphics.Vty.Attributes Methods showsPrec :: Int -> MaybeDefault v -> ShowS # show :: MaybeDefault v -> String # showList :: [MaybeDefault v] -> ShowS #
Eq v => Semigroup (MaybeDefault v) Source #
Instance details Defined in Graphics.Vty.Attributes Methods (<>) :: MaybeDefault v -> MaybeDefault v -> MaybeDefault v # sconcat :: NonEmpty (MaybeDefault v) -> MaybeDefault v # stimes :: Integral b => b -> MaybeDefault v -> MaybeDefault v #
Eq v => Monoid (MaybeDefault v) Source #
Instance details Defined in Graphics.Vty.Attributes Methods mempty :: MaybeDefault v # mappend :: MaybeDefault v -> MaybeDefault v -> MaybeDefault v # mconcat :: [MaybeDefault v] -> MaybeDefault v #

defAttr :: Attr Source #

Sets the style, background color and foreground color to the default values for the terminal. There is no easy way to determine what the default background and foreground colors are.

currentAttr :: Attr Source #

Keeps the style, background color and foreground color that was previously set. Used to override some part of the previous style.

EG: current_style withForeColor brightMagenta

Would be the currently applied style (be it underline, bold, etc) but with the foreground color set to brightMagenta.

Styles

type Style = Word8 Source #

Styles are represented as an 8 bit word. Each bit in the word is 1 if the style attribute assigned to that bit should be applied and 0 if the style attribute should not be applied.

withStyle :: Attr -> Style -> Attr Source #

Add the given style attribute

standout :: Style Source #