DragonFly On-Line Manual Pages

SCR2TXT(1)             DragonFly General Commands Manual            SCR2TXT(1)

NAME
     scr2txt - convert a video memory dump to plain text (w/ optional ANSI
     codes)

SYNOPSIS
     scr2txt [-a] [-l]

DESCRIPTION
     The scr2txt utility reads a video memory dump, such as that created by
     the vidcontrol(1) utility, and converts it to plain text representation
     of the text from the screenshot.

     scr2txt appends a newline character to the end of each line.

     scr2txt reads from the standard input, and writes to the standard output.

     The following options are available:

     -a       Emit ANSI colour escape codes to recreate the colours of the
              original screenshot.

     -l       Replace any eight-bit line drawing characters with their closest
              seven-bit equivalents.  This may result in odd output depending
              on the font in use when the screenshot was taken.

     See vidcontrol(1) for information about the input file format expected by
     scr2txt.

RETURN VALUES
     The scr2txt utility exits 0 on success or >0 if an error occurred.

EXAMPLES
     The command sequence:

           vidcontrol -p < /dev/ttyv0 > shot.scr
           scr2txt < shot.scr > shot.txt

     will capture the contents of the first virtual terminal, and redirect the
     output to the shot.scr file.  scr2txt then processes this file, and
     writes the output to shot.txt.  Of course this could be rewritten as

           vidcontrol -p < /dev/ttyv0 | scr2txt > shot.txt

     This example will take a snapshot and remap the line drawing characters.

           vidcontrol -p < /dev/ttyv0 | scr2txt -l > shot.txt

SEE ALSO
     scr2png(1), vidcontrol(1), syscons(4), ascii(7)

AUTHORS
     Nik Clayton <nik@FreeBSD.org>

BUGS
     When remapping eight bit characters to seven bit characters, scr2txt
     should have more than one lookup table, depending on the font in use, and
     should be able to process a custom lookup table provided by the user.

DragonFly 6.5-DEVELOPMENT        May 18, 2001        DragonFly 6.5-DEVELOPMENT