Man Linux: Main Page and Category List

NAME

       psign - produce a RADIANCE picture from text.

SYNOPSIS

       psign [ options ] [ text ]

DESCRIPTION

       Psign  produces  a  RADIANCE  picture  of  the  given text.  The output
       dimensions are determined by the character height, aspect ratio, number
       of  lines  and line length.  (Also the character size if text squeezing
       is used.)  If no text is given, the standard input is read.

       -cb r g b Set the background color to r g b The default is white  (1  1
                 1).

       -cf r g b Set  the  foreground color to r g b The default is black (0 0
                 0).

       -dr       Text reads to the right (default).

       -du       Text reads upwards.

       -dl       Text reads to the left (upside down).

       -dd       Text reads downwards.

       -h cheight
                 Set the character height  to  cheight.   The  default  is  32
                 pixels.

       -a aspect Set the character aspect ratio (height/width) to aspect.  The
                 default value is 1.67.

       -x xsize  Set the horizontal image size to xsize.  Use with  -y  option
                 (below)  in  place  of the -h specification to control output
                 image size directly.   If  the  character  aspect  ratio  (-a
                 option,  above) is non-zero, then one of the specified x or y
                 output dimensions may be reduced to maintain this ratio.   If
                 direction  is  right  (-dr)  or  left  (-dl),  then it is not
                 necessary to give the -y option, since  it  can  be  computed
                 from the character height (-h).

       -y ysize  Set the vertical image size to ysize.  Use with the -x option
                 (described above).  If direction is up (-du) or  down  (-dd),
                 then  it is not necessary to give the -x option, since it can
                 be computed from the character height (-h).

       -s spacing
                 Set the intercharacter spacing to spacing.  The magnitude  of
                 this  value  is  multiplied  by the character height over the
                 aspect ratio (ie. the character width) to compute the desired
                 distance  between  characters in the output.  The sign of the
                 value,  positive  or  negative,  determines  how  this  ideal
                 spacing  is  used  in the actual placement of characters.  If
                 spacing is positive, then the overall width of the line  will
                 not  be  affected,  nor will indentation of textual elements.
                 Thus, the text format will be  mostly  unaffected.   However,
                 spacing  between  characters will reflect their relative size
                 for a more  natural  appearance.   If  spacing  is  negative,
                 characters  will  be  squeezed  together  to meet the spacing
                 critereon, regardless of how it might affect  the  format  of
                 the  output.  The default value for spacing is zero, which is
                 interpreted as uniformly spaced characters.

       -f fontfile
                 Load the font from fontfile.  The default font is helvet.fnt

EXAMPLE

       To put a big "Hi!" on the terminal:

         psign -h 22 -a 1 -cb 0 0 0 -cf 1 1 1 Hi\! | ttyimage

ENVIRONMENT

       RAYPATH        path to search for font files

AUTHOR

       Greg Ward

BUGS

       The entire bitmap is stored in memory, which can be a problem for large
       and/or high-resolution signs.

SEE ALSO

       getinfo(1), pcompos(1), pfilt(1), ttyimage(1)