-b r g b
pic1 x1 y1 ..
-o x0 y0
pic1 pic2 ..
arranges and composites RADIANCE pictures and sends the result to the
Each input picture must be accompanied by an anchor point (unless the
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
is one of '-', '+' or '0', indicating the minimum, maximum or center
of the image, respectively.
would indicate the anchor is relative to the right lower corner, and
would indicate the anchor is relative to the center of the left
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
options, input files can be cropped at the upper boundary.
Specifying a larger dimension produces a border.
option specifies a background color to appear wherever input
files do not cover.
The default value is black (0 0 0).
option may be used to reduce the information header size, which
can grow disproportionately after multiple runs of
If input files overlap, later pictures will overwrite earlier ones.
By default, input files are copied unconditionally within the output
option specifies a lower threshold intensity under which input pixels
will not be copied to the output.
option specifies an upper threshold.
These options are useful for cutting around irregular boundaries in
option can be used to specify a label for a specific picture, which
will be given a height determined by the
option (default 24 pixels) and placed in the upper left corner of
This label is generated by the program
to label each picture automatically by its name.
This is particularly useful in conjunction with the
option for producing a catalog of images (see example below).
option may still be used to override the default label
for a picture.
option can be used to automatically compute anchor points
that place successive pictures next to each other in
The ordering will place the first picture in the lower left corner,
the next just to the right of it, and so on for
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,
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
option will cause each image to be separated by at least N pixels.
-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 ('!').
To put a copyright label at the bottom of a picture:
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,
places an artificial limit of 1024 on the number of open files and/or