man/man1/pfilt.1

.\" RCSid "$Id: pfilt.1,v 1.6 2023/12/08 17:56:26 greg Exp $"
.TH PFILT 1 11/8/96 RADIANCE
.SH NAME
pfilt - filter a RADIANCE picture
.SH SYNOPSIS
.B pfilt
[
.B options
]
[
.B file
]
.SH DESCRIPTION
.I Pfilt
performs anti-aliasing and scaling on a RADIANCE picture
or hyperspectral image.
The program makes two passes on the picture file in order to
set the exposure to the correct average value.
If no
.I file
is given, the standard input is read.
.TP 10n
.BI -x \ res
Set the output x resolution to
.I res.
This must be less than or equal to the x dimension
of the target device.
If
.I res
is given as a slash followed by a real number, the input resolution
is divided by this number to get the output resolution.
By default, the output resolution is the same as the input.
.TP
.BI -y \ res
Set the output y resolution to
.I res,
similar to the specification of the x resolution above.
.TP
.BI -p \ rat
Set the pixel aspect ratio to
.I rat.
Either the x or the y resolution will be reduced so that the pixels have
this ratio for the specified picture.
If
.I rat
is zero, then the x and y resolutions will adhere to the given maxima.
Zero is the default.
.TP
.BI -c
Pixel aspect ratio is being corrected, so do not write PIXASPECT
variable to output file.
.TP
.BI -e \ exp
Adjust the exposure.
If
.I exp
is preceded by a '+' or '-', the exposure is interpreted in f-stops
(ie. the power of two).
Otherwise,
.I exp
is interpreted as a straight multiplier.
The individual primaries can be changed using
.I \-er,
.I \-eg
and
.I \-eb.
Multiple exposure options have a cumulative effect.
.TP
.BR -t \ lamp
Color-balance the image as if it were illuminated by fixtures of
the given type.
The specification must match a pattern listed in the lamp
lookup table (see the \-f option below).
.TP
.BR -f \ lampdat
Use the specified lamp lookup table rather than the default (lamp.tab).
.TP
.BR \-1
Use only one pass on the file.
This allows the exposure to be controlled absolutely, without
any averaging.
Note that a single pass is much quicker and should be used whenever
the desired exposure is known and star patterns are not required.
.TP
.BR \-2
Use two passes on the input.
This is the default.
.TP
.BR \-b
Use box filtering (default).
Box filtering averages the input pixels corresponding
to each separate output pixel.
.TP
.BI -r \ rad
Use Gaussian filtering with a radius of
.I rad
relative to the output pixel size.
This option with a radius around 0.6 and a reduction in image width and
height of 2 or 3 produces the highest quality pictures.
A radius greater than 0.7 results in a defocused picture.
.TP
.BI -m \ frac
Limit the influence of any given input pixel to
.I frac
of any given output pixel.
This option may be used to mitigate the problems associated with
inadequate image sampling, at the expense of a slightly blurred
image.
The fraction given should not be less than the output picture dimensions
over the input picture dimensions (x_o*y_o/x_i/y_i), or blurring
will occur over the entire image.
This option implies the
.I \-r
option for Gaussian filtering, which defaults to a radius of 0.6.
.TP
.BI -h \ lvl
Set intensity considered ``hot'' to
.I lvl.
This is the level above which areas of the image will begin
to exhibit star diffraction patterns (see below).
The default is 100 watts/sr/m2.
.TP
.BI -n \ N
Set the number of points on star patterns to
.I N.
A value of zero turns star patterns off.
The default is 0.
(Note that two passes are required for star patterns.)\0
.TP
.BI -s \ val
Set the spread for star patterns to
.I val.
This is the value a star pattern will have at the
edge of the image.
The default is .0001.
.TP
.BR \-a
Average hot spots as well.
By default, the areas of the picture above the hot level
are not used in setting the exposure.
.SH ENVIRONMENT
RAYPATH         directories to search for lamp lookup table
.SH FILES
/tmp/rt??????
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
getinfo(1), ies2rad(1), pcomb(1), pcompos(1), pflip(1), pinterp(1),
pvalue(1), protate(1), rad(1), rcomb(1), rmtxop(1),
rpict(1), ximage(1)
Revision:	1.7
Committed:	Tue Dec 12 16:31:45 2023 UTC (17 months ago) by greg
Branch:	MAIN
CVS Tags:	HEAD
Changes since 1.6:	+2 -2 lines
Log Message:	chore(rcomb): Renamed rmtxcomb to simpler "rcomb"
#	User	Rev	Content
1	greg	1.7	.\" RCSid "$Id: pfilt.1,v 1.6 2023/12/08 17:56:26 greg Exp $"
2	greg	1.1	.TH PFILT 1 11/8/96 RADIANCE
3			.SH NAME
4			pfilt - filter a RADIANCE picture
5			.SH SYNOPSIS
6			.B pfilt
7			[
8			.B options
9			]
10			[
11			.B file
12			]
13			.SH DESCRIPTION
14			.I Pfilt
15	greg	1.6	performs anti-aliasing and scaling on a RADIANCE picture
16			or hyperspectral image.
17	greg	1.1	The program makes two passes on the picture file in order to
18			set the exposure to the correct average value.
19			If no
20			.I file
21			is given, the standard input is read.
22			.TP 10n
23			.BI -x \ res
24			Set the output x resolution to
25			.I res.
26			This must be less than or equal to the x dimension
27			of the target device.
28			If
29			.I res
30			is given as a slash followed by a real number, the input resolution
31			is divided by this number to get the output resolution.
32			By default, the output resolution is the same as the input.
33			.TP
34			.BI -y \ res
35			Set the output y resolution to
36			.I res,
37			similar to the specification of the x resolution above.
38			.TP
39			.BI -p \ rat
40			Set the pixel aspect ratio to
41			.I rat.
42			Either the x or the y resolution will be reduced so that the pixels have
43			this ratio for the specified picture.
44			If
45			.I rat
46			is zero, then the x and y resolutions will adhere to the given maxima.
47			Zero is the default.
48			.TP
49			.BI -c
50			Pixel aspect ratio is being corrected, so do not write PIXASPECT
51			variable to output file.
52			.TP
53			.BI -e \ exp
54			Adjust the exposure.
55			If
56			.I exp
57			is preceded by a '+' or '-', the exposure is interpreted in f-stops
58			(ie. the power of two).
59			Otherwise,
60			.I exp
61			is interpreted as a straight multiplier.
62			The individual primaries can be changed using
63			.I \-er,
64			.I \-eg
65			and
66			.I \-eb.
67			Multiple exposure options have a cumulative effect.
68			.TP
69			.BR -t \ lamp
70			Color-balance the image as if it were illuminated by fixtures of
71			the given type.
72			The specification must match a pattern listed in the lamp
73	greg	1.4	lookup table (see the \-f option below).
74	greg	1.1	.TP
75			.BR -f \ lampdat
76			Use the specified lamp lookup table rather than the default (lamp.tab).
77			.TP
78			.BR \-1
79			Use only one pass on the file.
80			This allows the exposure to be controlled absolutely, without
81			any averaging.
82			Note that a single pass is much quicker and should be used whenever
83			the desired exposure is known and star patterns are not required.
84			.TP
85			.BR \-2
86			Use two passes on the input.
87			This is the default.
88			.TP
89			.BR \-b
90			Use box filtering (default).
91			Box filtering averages the input pixels corresponding
92			to each separate output pixel.
93			.TP
94			.BI -r \ rad
95			Use Gaussian filtering with a radius of
96			.I rad
97			relative to the output pixel size.
98			This option with a radius around 0.6 and a reduction in image width and
99			height of 2 or 3 produces the highest quality pictures.
100			A radius greater than 0.7 results in a defocused picture.
101			.TP
102			.BI -m \ frac
103			Limit the influence of any given input pixel to
104			.I frac
105			of any given output pixel.
106			This option may be used to mitigate the problems associated with
107			inadequate image sampling, at the expense of a slightly blurred
108			image.
109	greg	1.5	The fraction given should not be less than the output picture dimensions
110	greg	1.1	over the input picture dimensions (x_o*y_o/x_i/y_i), or blurring
111			will occur over the entire image.
112			This option implies the
113			.I \-r
114			option for Gaussian filtering, which defaults to a radius of 0.6.
115			.TP
116			.BI -h \ lvl
117			Set intensity considered ``hot'' to
118			.I lvl.
119			This is the level above which areas of the image will begin
120			to exhibit star diffraction patterns (see below).
121			The default is 100 watts/sr/m2.
122			.TP
123			.BI -n \ N
124			Set the number of points on star patterns to
125			.I N.
126			A value of zero turns star patterns off.
127			The default is 0.
128			(Note that two passes are required for star patterns.)\0
129			.TP
130			.BI -s \ val
131			Set the spread for star patterns to
132			.I val.
133			This is the value a star pattern will have at the
134			edge of the image.
135			The default is .0001.
136			.TP
137			.BR \-a
138			Average hot spots as well.
139			By default, the areas of the picture above the hot level
140			are not used in setting the exposure.
141			.SH ENVIRONMENT
142			RAYPATH directories to search for lamp lookup table
143			.SH FILES
144	greg	1.3	/tmp/rt??????
145	greg	1.1	.SH AUTHOR
146			Greg Ward
147			.SH "SEE ALSO"
148	greg	1.6	getinfo(1), ies2rad(1), pcomb(1), pcompos(1), pflip(1), pinterp(1),
149	greg	1.7	pvalue(1), protate(1), rad(1), rcomb(1), rmtxop(1),
150	greg	1.6	rpict(1), ximage(1)