| 5 |
|
.SH SYNOPSIS |
| 6 |
|
.B pcompos |
| 7 |
|
[ |
| 8 |
+ |
.B \-h |
| 9 |
+ |
][ |
| 10 |
|
.B "\-x xres" |
| 11 |
|
][ |
| 12 |
|
.B "\-y yres" |
| 76 |
|
option specifies a background color to appear wherever input |
| 77 |
|
files do not cover. |
| 78 |
|
The default value is black (0 0 0). |
| 79 |
+ |
The |
| 80 |
+ |
.I \-h |
| 81 |
+ |
option may be used to reduce the information header size, which |
| 82 |
+ |
can grow disproportionately after multiple runs of |
| 83 |
+ |
.I pcompos |
| 84 |
+ |
and/or |
| 85 |
+ |
.I pcomb(1). |
| 86 |
|
.PP |
| 87 |
|
If input files overlap, later pictures will overwrite earlier ones. |
| 88 |
|
By default, input files are copied unconditionally within the output |
| 143 |
|
The |
| 144 |
|
.I "\-o x0 y0" |
| 145 |
|
option specifies a nonzero anchor point for the bottom left image. |
| 146 |
+ |
If a negative value is given for ncols, then the rows are reversed, |
| 147 |
+ |
so they start from the top rather than the bottom. |
| 148 |
+ |
This gives a more natural ordering in most cases, but has the |
| 149 |
+ |
side-effect of moving any labels from the upper-left of each placed |
| 150 |
+ |
subimage to the lower-left. |
| 151 |
+ |
Also, the |
| 152 |
+ |
.I \-o |
| 153 |
+ |
option is interpreted differently, where the y0 value is number of |
| 154 |
+ |
pixels from the top (rather than the bottom). |
| 155 |
|
.PP |
| 156 |
|
The standard input can be specified with a hyphen ('-'). |
| 157 |
|
A command that produces a RADIANCE picture can be given in place of a file |
| 159 |
|
.SH EXAMPLE |
| 160 |
|
To put a copyright label at the bottom of a picture: |
| 161 |
|
.IP "" .2i |
| 162 |
< |
psign Copyright 1987 | pcompos pic.inp 0 0 +t .5 - 384 64 > pic.out |
| 162 |
> |
psign Copyright 1987 | pcompos inp.hdr 0 0 +t .5 - 384 64 > out.hdr |
| 163 |
|
.PP |
| 164 |
< |
To make a catalog of images separated by white 10-pixel borders: |
| 164 |
> |
To make a catalog of images separated by white 10-pixel borders and |
| 165 |
> |
ordered four images per row starting from the top-left: |
| 166 |
|
.IP "" .2i |
| 167 |
< |
pcompos -la -a 4 -s 10 -b 1 1 1 dog*.pic > alldogs.pic |
| 167 |
> |
pcompos -la -a -4 -s 10 -b 1 1 1 dog*.hdr > alldogs.hdr |
| 168 |
|
.SH NOTES |
| 169 |
|
Since there is a limit to the number of open files and processes, |
| 170 |
|
large collections of images must be created in stages. |
| 171 |
|
Even if the system limit on open files is large, |
| 172 |
|
.I pcompos |
| 173 |
< |
places an artificial limit of 64 on the number of open files and/or |
| 173 |
> |
places an artificial limit of 1024 on the number of open files and/or |
| 174 |
|
processes. |
| 175 |
|
.SH AUTHOR |
| 176 |
|
Greg Ward |
| 177 |
|
.SH "SEE ALSO" |
| 178 |
< |
getinfo(1), pfilt(1), psign(1), rpict(1) |
| 178 |
> |
getinfo(1), pcomb(1), pfilt(1), psign(1), rpict(1) |
