man/man1/pcompos.1

.\" RCSid "$Id$"
.TH PCOMPOS 1 12/18/97 RADIANCE
.SH NAME
pcompos - composite RADIANCE pictures.
.SH SYNOPSIS
.B pcompos
[
.B "\-x xres"
][
.B "\-y yres"
][
.B "\-b r g b"
][
.B "\-lh h"
][
.B \-la
]
[
.B "\-t min1"
][
.B "\+t max1"
][
.B "\-l lab"
][
.B "=SS"
]
.B "pic1 x1 y1 .."
.br
or
.br
.B pcompos
[
.B "\-a ncols"
][
.B "\-s spacing"
][
.B "\-o x0 y0"
][
options
]
.B "pic1 pic2 .."
.SH DESCRIPTION
.I Pcompos
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
.I \-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 
.I =SS
option, where
.I S
is one of '-', '+' or '0', indicating the minimum, maximum or center
of the image, respectively.
(For example,
.I =+-
would indicate the anchor is relative to the right lower corner, and
.I =-0
would indicate the anchor is relative to the center of the left
edge.)\0
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
.I \-x
and
.I \-y
options, input files can be cropped at the upper boundary.
Specifying a larger dimension produces a border.
The
.I \-b
option specifies a background color to appear wherever input
files do not cover.
The default value is black (0 0 0).
.PP
If input files overlap, later pictures will overwrite earlier ones.
By default, input files are copied unconditionally within the output
boundaries.
The
.I \-t
option specifies a lower threshold intensity under which input pixels
will not be copied to the output.
The
.I \+t
option specifies an upper threshold.
These options are useful for cutting around irregular boundaries in
the input.
.PP
The
.I \-l
option can be used to specify a label for a specific picture, which
will be given a height determined by the
.I \-lh
option (default 24 pixels) and placed in the upper left corner of
the picture.
This label is generated by the program
.I psign(1).
The
.I \-la
option instructs
.I pcompos
to label each picture automatically by its name.
This is particularly useful in conjunction with the
.I \-a
option for producing a catalog of images (see example below).
The
.I \-l
option may still be used to override the default label
for a picture.
.PP
The
.I \-a
option can be used to automatically compute anchor points
that place successive pictures next to each other in
.I 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
.I 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,
.I 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
.I ncols.
The
.I "\-s N"
option will cause each image to be separated by at least N pixels.
The
.I "\-o x0 y0"
option specifies a nonzero anchor point for the bottom left image.
.PP
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 ('!').
.SH EXAMPLE
To put a copyright label at the bottom of a picture:
.IP "" .2i
psign Copyright 1987 | pcompos pic.inp 0 0 +t .5 - 384 64 > pic.out
.PP
To make a catalog of images separated by white 10-pixel borders:
.IP "" .2i
pcompos -la -a 4 -s 10 -b 1 1 1 dog*.pic > alldogs.pic
.SH NOTES
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,
.I pcompos
places an artificial limit of 64 on the number of open files and/or
processes.
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
getinfo(1), pfilt(1), psign(1), rpict(1)
Revision:	1.2
Committed:	Tue Dec 9 15:59:06 2003 UTC (20 years, 4 months ago) by greg
Branch:	MAIN
CVS Tags:	rad3R7P2, rad3R7P1, rad3R6, rad3R6P1
Changes since 1.1:	+1 -1 lines
Log Message:	Fixed RCSid specification
#	Content
1	.\" RCSid "$Id$"
2	.TH PCOMPOS 1 12/18/97 RADIANCE
3	.SH NAME
4	pcompos - composite RADIANCE pictures.
5	.SH SYNOPSIS
6	.B pcompos
7	[
8	.B "\-x xres"
9	][
10	.B "\-y yres"
11	][
12	.B "\-b r g b"
13	][
14	.B "\-lh h"
15	][
16	.B \-la
17	]
18	[
19	.B "\-t min1"
20	][
21	.B "\+t max1"
22	][
23	.B "\-l lab"
24	][
25	.B "=SS"
26	]
27	.B "pic1 x1 y1 .."
28	.br
29	or
30	.br
31	.B pcompos
32	[
33	.B "\-a ncols"
34	][
35	.B "\-s spacing"
36	][
37	.B "\-o x0 y0"
38	][
39	options
40	]
41	.B "pic1 pic2 .."
42	.SH DESCRIPTION
43	.I Pcompos
44	arranges and composites RADIANCE pictures and sends the result to the
45	standard output.
46	Each input picture must be accompanied by an anchor point (unless the
47	.I \-a
48	option is used, see below).
49	This anchor point is the usually position of the picture's
50	left lower corner in the final output, but can be changed
51	for individual pictures with an
52	.I =SS
53	option, where
54	.I S
55	is one of '-', '+' or '0', indicating the minimum, maximum or center
56	of the image, respectively.
57	(For example,
58	.I =+-
59	would indicate the anchor is relative to the right lower corner, and
60	.I =-0
61	would indicate the anchor is relative to the center of the left
62	edge.)\0
63	Negative anchor coordinates result in the input being cropped at the origin.
64	By default, the size of the output picture will be just large enough
65	to encompass all the input files.
66	By specifying a smaller dimension using the
67	.I \-x
68	and
69	.I \-y
70	options, input files can be cropped at the upper boundary.
71	Specifying a larger dimension produces a border.
72	The
73	.I \-b
74	option specifies a background color to appear wherever input
75	files do not cover.
76	The default value is black (0 0 0).
77	.PP
78	If input files overlap, later pictures will overwrite earlier ones.
79	By default, input files are copied unconditionally within the output
80	boundaries.
81	The
82	.I \-t
83	option specifies a lower threshold intensity under which input pixels
84	will not be copied to the output.
85	The
86	.I \+t
87	option specifies an upper threshold.
88	These options are useful for cutting around irregular boundaries in
89	the input.
90	.PP
91	The
92	.I \-l
93	option can be used to specify a label for a specific picture, which
94	will be given a height determined by the
95	.I \-lh
96	option (default 24 pixels) and placed in the upper left corner of
97	the picture.
98	This label is generated by the program
99	.I psign(1).
100	The
101	.I \-la
102	option instructs
103	.I pcompos
104	to label each picture automatically by its name.
105	This is particularly useful in conjunction with the
106	.I \-a
107	option for producing a catalog of images (see example below).
108	The
109	.I \-l
110	option may still be used to override the default label
111	for a picture.
112	.PP
113	The
114	.I \-a
115	option can be used to automatically compute anchor points
116	that place successive pictures next to each other in
117	.I ncols
118	columns.
119	The ordering will place the first picture in the lower left corner,
120	the next just to the right of it, and so on for
121	.I ncols
122	pictures.
123	Then, the next row up repeats the pattern until all the input
124	pictures have been added to the output.
125	If the pictures are of different size,
126	.I pcompos
127	will end up leaving some background areas in the output picture.
128	There will also be an unfinished row at the top if the number
129	of pictures is not evenly divided by
130	.I ncols.
131	The
132	.I "\-s N"
133	option will cause each image to be separated by at least N pixels.
134	The
135	.I "\-o x0 y0"
136	option specifies a nonzero anchor point for the bottom left image.
137	.PP
138	The standard input can be specified with a hyphen ('-').
139	A command that produces a RADIANCE picture can be given in place of a file
140	by preceeding it with an exclamation point ('!').
141	.SH EXAMPLE
142	To put a copyright label at the bottom of a picture:
143	.IP "" .2i
144	psign Copyright 1987 \| pcompos pic.inp 0 0 +t .5 - 384 64 > pic.out
145	.PP
146	To make a catalog of images separated by white 10-pixel borders:
147	.IP "" .2i
148	pcompos -la -a 4 -s 10 -b 1 1 1 dog*.pic > alldogs.pic
149	.SH NOTES
150	Since there is a limit to the number of open files and processes,
151	large collections of images must be created in stages.
152	Even if the system limit on open files is large,
153	.I pcompos
154	places an artificial limit of 64 on the number of open files and/or
155	processes.
156	.SH AUTHOR
157	Greg Ward
158	.SH "SEE ALSO"
159	getinfo(1), pfilt(1), psign(1), rpict(1)