Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 192 insertions, 0 deletions

diff --git a/upstream/debian-unstable/man1/cameratopam.1 b/upstream/debian-unstable/man1/cameratopam.1
new file mode 100644
index 00000000..6ee9d9fa
--- /dev/null
+++ b/upstream/debian-unstable/man1/cameratopam.1
@@ -0,0 +1,192 @@
+\
+.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
+.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
+.\" the corresponding HTML page on the Netpbm website, generate a patch
+.\" against that, and send it to the Netpbm maintainer.
+.TH "Cameratopam User Manual" 1 "12 April 2005" "netpbm documentation"
+
+.SH NAME
+cameratopam - convert raw camera image to PAM
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBcameratopam\fP
+
+[\fIinput_file_name\fP]
+
+[\fB-identify_only\fP]
+[\fB-quick_interpolate\fP]
+[\fB-half_size\fP]
+[\fB-four_color_rgb\fP]
+[\fB-document_mode\fP]
+[\fB-balance_auto\fP]
+[\fB-balance_camera\fP]
+[\fB-red_scale=\fP\fIfloat\fP]
+[\fB-blue_scale=\fP\fIfloat\fP]
+[\fB-brightness=\fP\fIfraction\fP]
+[\fB-no_clip_color\fP]
+[\fB-rgb\fP]
+[\fB-secondary\fP]
+[\fB-linear\fP]
+[\fB-verbose\fP]
+.PP
+All options can be abbreviated to their shortest unique prefix.  You
+may use two hyphens instead of one to designate an option.  You may
+use either white space or an equals sign between an option name and
+its value.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBcameratopam\fP converts from any of dozens of raw camera image
+formats to PAM.  
+.PP
+Digital still cameras often can produce images in a special raw
+format in addition to something more standard such as TIFF or JFIF
+(JPEG).  Software supplied with the camera allows you to manipulate
+the image using information which is lost when the camera converts to
+the common format.  A particular camera model often has a unique raw
+format.
+
+
+
+.UN options
+.SH OPTIONS
+.PP
+In addition to the options common to all programs based on libnetpbm
+(most notably \fB-quiet\fP, see 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&), \fBcameratopam\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-identify_only\fP
+Report to Standard Error the format of the input image but don't
+generate an output image.  Program fails if it cannot recognize the
+format.
+
+.TP
+\fB-verbose\fP
+Report to Standard Error details of the processing.
+
+.TP
+\fB-quick_interpolate\fP
+Use simple bilinear interpolation for quick results.  The default
+is to use a slow, high-quality adaptive algorithm.
+
+.TP
+\fB-half_size\fP
+Half-size the output image.  Instead of interpolating, reduce
+each 2x2 block of sensors to one pixel.  Much faster than
+\fB-quick_interpolate\fP.
+
+.TP
+\fB-four_color_rgb\fP
+Interpolate RGB as four colors.  This causes a slight loss of
+detail, so use this only if you see false 2x2 mesh patterns in blue
+sky.
+
+.TP
+\fB-document_mode\fP
+Show the raw data as a grayscale image with no interpolation.
+This is good for photographing black and white documents.
+
+.TP
+\fB-balance_auto\fP
+Automatic color balance.  The default is to use a fixed
+color balance based on a white card photographed in sunlight.
+
+.TP
+\fB-balance_camera\fP
+Use the color balance specified by the camera.  If
+\fBcameratopam\fP can't find this, it prints a warning and reverts to
+the default.
+
+.TP
+\fB-red_scale=\fP\fIfloat\fP
+.TP
+\fB-blue_scale\fP\fIfloat\fP
+Further adjust the color balance by multiplying the red and blue
+channels by these values.  Both default to 1.0.
+
+.TP
+\fB-brightness=\fP\fIfloat\fP
+Change the output brightness.  Default is 1.0.
+
+.TP
+\fB-no_clip_color\fP
+By default, \fBcameratoapm\fP clips all colors to prevent pink
+hues in the highlights.  Combine this option with
+\fB-brightness=0.25\fP to leave the image data completely unclipped.
+
+.TP
+\fB-rgb\fP
+Write raw camera colors to the output file.  By default,
+\fBcameratoapm\fP converts to sRGB colorspace.
+
+.TP
+\fB-secondary\fP
+For cameras based on the Fuji Super CCD SR, this option causes
+\fBcameratopam\fP to use the secondary sensors, in effect
+underexposing the image by four stops to reveal detail in the
+highlights.  \fBcameratopam\fP silently ignores this option for all
+other cameras.
+
+.TP
+\fB-linear\fP
+This option causes \fBcameratopam\fP to generate a variation on
+PAM that has "linear" color samples.  In true PAM, each
+sample in the image raster is gamma-corrected; i.e. it is essentially
+proportional to brightness.  With the \fBlinear\fP option,
+\fBcameratopam\fP generates an image in which the samples are instead
+proportional to light intensity.
+.sp
+Without \fB-linear\fP, the image maxval is 255, so the image
+contains one byte per sample.  With \fB-linear\fP, the maxval is
+65535, so the image contains two bytes per sample.
+.sp
+Without \fB-linear\fP, \fBcameratopam\fP uses a 99th percentile
+white point.  With \fB-linear\fP, it doesn't.  I don't know what that
+means.
+
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "411toppm" (1)\c
+\&, 
+.BR "pamflip" (1)\c
+\&, 
+.BR "pam" (1)\c
+\&,
+
+.UN history
+.SH HISTORY
+.PP
+\fBcameratopam\fP was new in Netpbm 10.28 (June 2005).
+.PP
+It was derived from the program 
+.UR https://dechifro.org/dcraw/
+\fBdcraw\fP by Dave Coffin
+.UE
+\&, by Bryan Henderson in April 2005.  Bryan replaced the part
+that generates the Netpbm output image and removed the Adobe Photoshop
+output function.  Bryan changed the command syntax and made other
+small changes to make the program consistent with Netpbm.  He also
+split the source code into manageable pieces (\fBdcraw\fP had a
+single 5000 line source file).
+.SH DOCUMENT SOURCE
+This manual page was generated by the Netpbm tool 'makeman' from HTML
+source.  The master documentation is at
+.IP
+.B http://netpbm.sourceforge.net/doc/cameratopam.html
+.PP
\ No newline at end of file