about summary refs log tree commit diff
path: root/pambayer.html
blob: f66af39b1369c2219222a8573f4c0ab58613246f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD><TITLE>Pambayer User Manual</TITLE></HEAD>
<BODY>
<H1>pambayer</H1>
Updated: 18 August 2005
<BR>
<A HREF="#index">Table Of Contents</A>

<H2>NAME</H2>

pambayer - interpret Bayer patterns

<H2 id="synopsis">SYNOPSIS</H2>

<B>pambayer</B>
<b>-type=</b>{<b>1</b>|<b>2</b>|<b>3</b>|<b>4</b>}
[<b>-nointerpolate</b>]
[<I>pamfile</I>]

<P>Minimum unique abbreviation of option is acceptable.  You may use
double hyphens instead of single hyphen to denote options.  You may use
white space in place of the equals sign to separate an option name
from its value.


<H2 id="description">DESCRIPTION</H2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<P><b>pambayer</b> reads a Bayer pattern in a 1-deep Netpbm image and
produces a color image in PAM RGB format as output.

<p>A Bayer pattern is what you get from the optical sensor in some
digital cameras.  Such a camera doesn't have a red, green, and blue
sensor in the exact same place for an individual pixel.  Instead, it
has red, green, and blue sensors laid out in a two dimensional array.
The pattern in which they are laid out is the Bayer pattern.  The
input to <b>pambayer</b> is one sample value for each of those
sensors, so some samples are red, some are green, and some are blue.

<p><b>pambayer</b> turns that into a regular visual image with one pixel
per sensor.  For the two components of each pixel that are missing in the
corresponding Bayer input, <b>pambayer</b> averages the sample values from
the adjacent pixels that do have that component.

<p>But you can have <b>pambayer</b> fill in black instead (see the
<b>-noninterpolate</b> option), which gives you a simpler representation of
what the camera saw, on which you might do further processing.  Such an image
still looks right, though considerably dimmer, if you stand far enough away
and let your eyes do the interpolation.

<p>The input image is a pseudo-PNM image (pseudo- because while the structure
is the same, the sample values have different meanings) or PAM image of
arbitrary tuple type.  <b>pambayer</b> looks at only the first plane of the
input.

<p>The output image is a PAM image of tuple type &quot;RGB&quot;, i.e.
a standard color image.  You can convert this to PPM with
<a href="pamtopnm.html"><b>pamtopnm</b></a>.

<p>If you're interested in just one of the primary colors, use
<b>pamchannel</b> on the output of <b>pambayer</b> to extract it.


<H2 id="options">OPTIONS</H2>

<DL COMPACT>

<dt><b>-type=</b><i>n</i>

<dd>This tells which Bayer pattern the input is:

<dl>
<dt>1
<dd>GBG/RGR/GBG matrix
<dt>2
<dd>RGR/GBG/RGR matrix
<dt>3
<dd>BGB/GRG/BGB matrix
<dt>4
<dd>GRG/BGB/GRG matrix
</dl>

This option is mandatory.

<dt><b>-nointerpolate</b>

<dd>Each output pixel position corresponds to one position in the input
Bayer pattern, which means only one of the three color components is
supplied by the input.  For the other two, this option says to user zero.
Without it, <b>pambayer</b> instead interpolates from the adjacent pixels
that do have that color component.

<p>This option was new in Netpbm 10.49 (December 2009).

</DL>



<H2 id="seealso">SEE ALSO</H2>

<B><A HREF="cameratopam.html">cameratopam</A></B>
<B><A HREF="pam.html">pam</A></B>

<H2 id="history">HISTORY</H2>

<p><b>pambayer</b> was new in Netpbm 10.30 (October 2005).

<HR>
<H2 id="index">Table Of Contents</H2>
<UL>
<LI><A HREF="#synopsis">SYNOPSIS</A>
<LI><A HREF="#options">OPTIONS</A>
<LI><A HREF="#description">DESCRIPTION</A>
<LI><A HREF="#seealso">SEE ALSO</A>
<LI><A HREF="#history">HISTORY</A>
</UL>
</BODY>
</HTML>