PCOMPOS(1)                                                          PCOMPOS(1)



NNAAMMEE
       pcompos - composite RADIANCE pictures.

SSYYNNOOPPSSIISS
       ppccoommppooss  [  --hh ][ --xx xxrreess ][ --yy yyrreess ][ --bb rr gg bb ][ --llhh hh ][ --llaa ] [ --tt
       mmiinn11 ][ ++tt mmaaxx11 ][ --ll llaabb ][ ==SSSS ] ppiicc11 xx11 yy11 ....
       or
       ppccoommppooss [ --aa nnccoollss ][ --ss ssppaacciinngg ][ --oo xx00 yy00 ][ options ] ppiicc11 ppiicc22  ....

DDEESSCCRRIIPPTTIIOONN
       _P_c_o_m_p_o_s  arranges and composites RADIANCE pictures and sends the result
       to the standard output.  Each input picture must be accompanied  by  an
       anchor  point  (unless  the _-_a option is used, see below).  This anchor
       point is the usually position of the picture's left lower corner in the
       final  output,  but  can be changed for individual pictures with an _=_S_S
       option, where _S is one of '-', '+' or '0', indicating the minimum, max-
       imum  or  center  of  the image, respectively.  (For example, _=_+_- would
       indicate the anchor is relative to the  right  lower  corner,  and  _=_-_0
       would indicate the anchor is relative to the center of the left edge.)
       Negative anchor coordinates result in the input being  cropped  at  the
       origin.   By default, the size of the output picture will be just large
       enough to encompass all the  input  files.   By  specifying  a  smaller
       dimension  using  the  _-_x and _-_y options, input files can be cropped at
       the upper boundary.  Specifying a larger dimension produces  a  border.
       The  _-_b  option  specifies  a background color to appear wherever input
       files do not cover.  The default value is black (0 0 0).  The _-_h option
       may  be used to reduce the information header size, which can grow dis-
       proportionately after multiple runs of _p_c_o_m_p_o_s and/or _p_c_o_m_b_(_1_)_.

       If input files overlap, later pictures will overwrite earlier ones.  By
       default,  input  files  are  copied  unconditionally  within the output
       boundaries.  The _-_t option specifies a lower threshold intensity  under
       which  input  pixels  will  not be copied to the output.  The _+_t option
       specifies an upper threshold.  These options  are  useful  for  cutting
       around irregular boundaries in the input.

       The  _-_l  option  can be used to specify a label for a specific picture,
       which will be given a height determined by the _-_l_h option  (default  24
       pixels) and placed in the upper left corner of the picture.  This label
       is generated by the program _p_s_i_g_n_(_1_)_.  The _-_l_a option instructs _p_c_o_m_p_o_s
       to  label each picture automatically by its name.  This is particularly
       useful in conjunction with the _-_a option for  producing  a  catalog  of
       images  (see  example below).  The _-_l option may still be used to over-
       ride the default label for a picture.

       The _-_a option can be used to automatically compute anchor  points  that
       place  successive  pictures  next  to each other in _n_c_o_l_s columns.  The
       ordering will place the first picture in the  lower  left  corner,  the
       next  just to the right of it, and so on for _n_c_o_l_s pictures.  Then, the
       next row up repeats the pattern until all the input pictures have  been
       added  to  the  output.  If the pictures are of different size, _p_c_o_m_p_o_s
       will end up leaving some background areas in the output picture.  There
       will  also be an unfinished row at the top if the number of pictures is
       not evenly divided by _n_c_o_l_s_.  The _-_s _N option will cause each image  to
       be  separated  by  at  least N pixels.  The _-_o _x_0 _y_0 option specifies a
       nonzero anchor point for the bottom left image.

       The standard input can be specified with a  hyphen  ('-').   A  command
       that  produces  a  RADIANCE  picture can be given in place of a file by
       preceeding it with an exclamation point ('!').

EEXXAAMMPPLLEE
       To put a copyright label at the bottom of a picture:

         psign Copyright 1987 | pcompos inp.hdr 0 0 +t .5 - 384 64 > out.hdr

       To make a catalog of images separated by white 10-pixel borders:

         pcompos -la -a 4 -s 10 -b 1 1 1 dog*.hdr > alldogs.hdr

NNOOTTEESS
       Since there is a limit to the number of open files and processes, large
       collections  of  images  must be created in stages.  Even if the system
       limit on open files is large, _p_c_o_m_p_o_s places an artificial limit of  64
       on the number of open files and/or processes.

AAUUTTHHOORR
       Greg Ward

SSEEEE AALLSSOO
       getinfo(1), pcomb(1), pfilt(1), psign(1), rpict(1)



RADIANCE                           12/18/97                         PCOMPOS(1)
