Debian Codegraph @

upstream/debian-unstable/man1/pambayer.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pambayer User Manual" 1 "18 August 2005" "netpbm documentation"
7
8 .SH NAME
9 pambayer - interpret Bayer patterns
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpambayer\fP
15 \fB-type=\fP{\fB1\fP|\fB2\fP|\fB3\fP|\fB4\fP}
16 [\fB-nointerpolate\fP]
17 [\fIpamfile\fP]
18 .PP
19 Minimum unique abbreviation of option is acceptable. You may use
20 double hyphens instead of single hyphen to denote options. You may use
21 white space in place of the equals sign to separate an option name
22 from its value.
23
24 .UN description
25 .SH DESCRIPTION
26 .PP
27 This program is part of
28 .BR "Netpbm" (1)\c
29 \&.
30 .PP
31 \fBpambayer\fP reads a Bayer pattern in a 1-deep Netpbm image and
32 produces a color image in PAM RGB format as output.
33 .PP
34 A Bayer pattern is what you get from the optical sensor in some
35 digital cameras. Such a camera doesn't have a red, green, and blue
36 sensor in the exact same place for an individual pixel. Instead, it
37 has red, green, and blue sensors laid out in a two dimensional array.
38 The pattern in which they are laid out is the Bayer pattern. The
39 input to \fBpambayer\fP is one sample value for each of those
40 sensors, so some samples are red, some are green, and some are blue.
41 .PP
42 \fBpambayer\fP turns that into a regular visual image with one pixel
43 per sensor. For the two components of each pixel that are missing in the
44 corresponding Bayer input, \fBpambayer\fP averages the sample values from
45 the adjacent pixels that do have that component.
46 .PP
47 But you can have \fBpambayer\fP fill in black instead (see the
48 \fB-noninterpolate\fP option), which gives you a simpler representation of
49 what the camera saw, on which you might do further processing. Such an image
50 still looks right, though considerably dimmer, if you stand far enough away
51 and let your eyes do the interpolation.
52 .PP
53 The input image is a pseudo-PNM image (pseudo- because while the structure
54 is the same, the sample values have different meanings) or PAM image of
55 arbitrary tuple type. \fBpambayer\fP looks at only the first plane of the
56 input.
57 .PP
58 The output image is a PAM image of tuple type "RGB", i.e.
59 a standard color image. You can convert this to PPM with
60 .BR "\fBpamtopnm\fP" (1)\c
61 \&.
62 .PP
63 If you're interested in just one of the primary colors, use
64 \fBpamchannel\fP on the output of \fBpambayer\fP to extract it.
65
66
67 .UN options
68 .SH OPTIONS
69 .PP
70 In addition to the options common to all programs based on libnetpbm
71 (most notably \fB-quiet\fP, see
72 .UR index.html#commonoptions
73 Common Options
74 .UE
75 \&), \fBpambayer\fP recognizes the following
76 command line options:
77
78
79
80 .TP
81 \fB-type=\fP\fIn\fP
82 This tells which Bayer pattern the input is:
83
84
85 .TP
86 1
87 GBG/RGR/GBG matrix
88 .TP
89 2
90 RGR/GBG/RGR matrix
91 .TP
92 3
93 BGB/GRG/BGB matrix
94 .TP
95 4
96 GRG/BGB/GRG matrix
97
98
99 This option is mandatory.
100
101 .TP
102 \fB-nointerpolate\fP
103 Each output pixel position corresponds to one position in the input
104 Bayer pattern, which means only one of the three color components is
105 supplied by the input. For the other two, this option says to user zero.
106 Without it, \fBpambayer\fP instead interpolates from the adjacent pixels
107 that do have that color component.
108 .sp
109 This option was new in Netpbm 10.49 (December 2009).
110
111
112
113
114
115 .UN seealso
116 .SH SEE ALSO
117 .BR "cameratopam" (1)\c
118 \&
119 .BR "pam" (1)\c
120 \&
121
122 .UN history
123 .SH HISTORY
124 .PP
125 \fBpambayer\fP was new in Netpbm 10.30 (October 2005).
126 .SH DOCUMENT SOURCE
127 This manual page was generated by the Netpbm tool 'makeman' from HTML
128 source. The master documentation is at
129 .IP
130 .B http://netpbm.sourceforge.net/doc/pambayer.html
131 .PP