diff options
Diffstat (limited to 'upstream/mageia-cauldron/man1/cameratopam.1')
| -rw-r--r-- | upstream/mageia-cauldron/man1/cameratopam.1 | 192 |
1 files changed, 192 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/cameratopam.1 b/upstream/mageia-cauldron/man1/cameratopam.1 new file mode 100644 index 00000000..ce9fdde5 --- /dev/null +++ b/upstream/mageia-cauldron/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" 0 "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-bright=\fP\fIfraction\fP] +[\fB-no_clip_color\fP] +[\fB-rgb\fP] +[\fB-use_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-bright=\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-bright=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-use_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 |