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 -lh option (default 24 pixels) and placed in the upper left corner of the picture. This label is generated by the program psign(1). The -la option instructs pcompos 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 override 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 ncols 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 ncols 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, pcompos 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 ncols. The -s N option will cause each image to be separated by at least N pixels. The -o x0 y0 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 ('!').
psign Copyright 1987 | pcompos pic.inp 0 0 +t .5 - 384 64 > pic.out
To make a catalog of images separated by white 10-pixel borders:
pcompos -la -a 4 -s 10 -b 1 1 1 dog*.pic > alldogs.pic
Table of Contents