PSIGN(1)                                                              PSIGN(1)



NNAAMMEE
       psign - produce a RADIANCE picture from text.

SSYYNNOOPPSSIISS
       ppssiiggnn [ ooppttiioonnss ] [ tteexxtt ]

DDEESSCCRRIIPPTTIIOONN
       _P_s_i_g_n produces a RADIANCE picture of the given _t_e_x_t_.  The output dimen-
       sions 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 _t_e_x_t is given, the standard input is read.

       --ccbb _r _g _b Set the background color to _r _g _b The default is white  (1  1
                 1).

       --ccff _r _g _b Set  the  foreground color to _r _g _b The default is black (0 0
                 0).

       --ddrr       Text reads to the right (default).

       --dduu       Text reads upwards.

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

       --dddd       Text reads downwards.

       --hh _c_h_e_i_g_h_t
                 Set the character height to _c_h_e_i_g_h_t_.  The default is 32  pix-
                 els.

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

       --xx _x_s_i_z_e  Set the horizontal image size to _x_s_i_z_e_.  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 _(_-_d_r_) or left _(_-_d_l_)_, then it is not neces-
                 sary to give the _-_y option, since it can be computed from the
                 character height _(_-_h_)_.

       --yy _y_s_i_z_e  Set the vertical image size to _y_s_i_z_e_.  Use with the _-_x option
                 (described above).  If direction is up _(_-_d_u_) or  down  _(_-_d_d_)_,
                 then  it is not necessary to give the _-_x option, since it can
                 be computed from the character height _(_-_h_)_.

       --ss _s_p_a_c_i_n_g
                 Set the intercharacter spacing to _s_p_a_c_i_n_g_.  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  spac-
                 ing  is used in the actual placement of characters.  If _s_p_a_c_-
                 _i_n_g 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 _s_p_a_c_i_n_g 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 _s_p_a_c_i_n_g is zero, which is interpreted
                 as uniformly spaced characters.

       --ff _f_o_n_t_f_i_l_e
                 Load the font from _f_o_n_t_f_i_l_e_.  The default font is helvet.fnt

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

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

EENNVVIIRROONNMMEENNTT
       RAYPATH        path to search for font files

AAUUTTHHOORR
       Greg Ward

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

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



RADIANCE                            10/9/97                           PSIGN(1)
