Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SCR2TXT(1)		     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 orig-
	      inal 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.

FreeBSD ports 15.quarterly	  May 18, 2001			      SCR2TXT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=scr2txt&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help