NAME

Term::ScreenColor - Screen positioning and coloring module for Perl

SYNOPSIS

A Term::Screen based screen positioning module with ANSI color support.

use Term::ScreenColor;

$scr = new Term::ScreenColor;
$scr->at(2,0)->red()->on_yellow()->puts("Hello, Tau Ceti!");
$scr->putcolored('cyan bold on blue', 'Betelgeuse');
$scr->putcolored('1;36;44', 'Altair');
$scr->raw();

DESCRIPTION

Term::ScreenColor adds ANSI coloring support, along with a few other useful methods, to those provided in Term::Screen.

PUBLIC INTERFACE

In addition to the methods described in Term::Screen(3pm), Term::ScreenColor offers the following methods:

color()

Turn on a color by specifying its number in the table specified below:

clear       => 0    black       => 30    on_black    => 40
reset       => 0    red         => 31    on_red      => 41
ansibold    => 1    green       => 32    on_green    => 42
underline   => 4    yellow      => 33    on_yellow   => 43
underscore  => 4    blue        => 34    on_blue     => 44
blink       => 5    magenta     => 35    on_magenta  => 45
inverse     => 7    cyan        => 36    on_cyan     => 46
concealed   => 8    white       => 37    on_white    => 47

black() etc.

Turn on a color by its name.

colorizable()

May be used to either set (if called with one integer argument) or query (if called with no arguments) whether the terminal is believed to support ANSI color codes. If this is set to off (0), no ANSI codes will be output. This provides an easy way for turning on/off color.

putcolored()

Identical to puts(), but wraps its arguments in ANSI color sequences first, using its first argument as color specification. Example:

$scr->putcolored('cyan bold on blue', 'Betelgeuse');
$scr->putcolored('1;36;44', 'Altair');

AUTHOR

Rene Uittenbogaard (ruittenb@users.sourceforge.net)

Term::ScreenColor was based on:

Term::Screen

Originally by Mark Kaehny (kaehny@execpc.com), now maintained by Jonathan Stowe (jns@gellyfish.com)

Term::ANSIColor

By Russ Allbery (rra@cs.stanford.edu) and Zenin (zenin@best.com)

SEE ALSO

Term::Screen(3pm), Term::Cap(3pm), termcap(5), stty(1)