Provided by: radiance_4R1+20120125-1.1_amd64 bug

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)