diff options
Diffstat (limited to 'upstream/mageia-cauldron/man1/pnmtotiffcmyk.1')
| -rw-r--r-- | upstream/mageia-cauldron/man1/pnmtotiffcmyk.1 | 211 |
1 files changed, 211 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pnmtotiffcmyk.1 b/upstream/mageia-cauldron/man1/pnmtotiffcmyk.1 new file mode 100644 index 00000000..a8d1c9de --- /dev/null +++ b/upstream/mageia-cauldron/man1/pnmtotiffcmyk.1 @@ -0,0 +1,211 @@ +\ +.\" 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 "Pnmtotiffcmyk User Manual" 0 "21 March 2017" "netpbm documentation" + +.SH NAME + +pnmtotiffcmyk - convert a Netpbm image into a CMYK encoded TIFF file + +.UN synopsis +.SH SYNOPSIS + +\fBpnmtotiffcmyk \fP + [\fB-none\fP|\fB-packbits\fP|\fB-lzw\fP] + [\fB-predictor\fP \fIn\fP] + [\fB-msb2lsb\fP|\fB-lsb2msb\fP] + [\fB-rowsperstrip\fP \fIn\fP] + [\fB-lowdotrange\fP \fIn\fP] + [\fB-highdotrange\fP \fIn\fP] + [\fB-knormal\fP|\fB-konly\fP|\fB-kremove\fP] + [[\fB-default\fP] + [\fB-theta\fP \fIdeg\fP] + [\fB-gamma\fP \fIn\fP] + [\fB-gammap\fP \fIn\fP] + [\fB-negative\fP] + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpnmtotiffcmyk\fPreads a PNM image as input and produces a CMYK +encoded TIFF file as output. It optionally modifies the color +balance and black level, and modifies removal of CMY from under K. +.PP +Output is to Standard Output, but unlike with most Netpbm programs, +Standard Output must be a seekable file. An ordinary file is fine, but you +cannot pipe the output to another program. Furthermore, the program replaces +any content currently in the file even if it was opened for appending. +.PP +\fBpamtotiff\fP generates many other kinds of TIFF files. + + +.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 +\&), \fBpnmtotiffcmyk\fP recognizes the following +command line options: +.PP +The order of most options is not important, but options for particular +conversion algorithms must appear after the algorithm is selected +(\fB-default\fP,\fB-negative\fP). If you don't select an algorithm, +\fBpnmtotiffcmyk\fP assumes \fB-default\fP and the appropriate +options (\fB-theta\fP,\fB-gamma\fP,\fB-gammap\fP) can appear +anywhere. + +.SS \fB-none\fP,\fB-packbits\fP,\fB-lzw\fP,\fB-predictor\fP +.PP +Tiff files can be compressed. By default, \fBpnmtotiffcmyk\fP +uses LZW decompression, but (apparently) some readers cannot read +this, so you may want to select a different algorithm +(\fB-none\fP,\fB-packbits\fP). For LZW compression, a +\fB-predictor\fP value of 2 forces horizontal differencing of +scanlines before encoding; a value of 1 forces no differencing. + +.SS \fB-msb2lsb\fP,\fB-lsb2msb\fP +.PP +These options control fill order (default is \fB-msb2lsb\fP). + +.SS \fB-rowsperstrip\fP +.PP +This sets the number of rows in an image strip (data in the Tiff +files generated by this program is stored in strips - each strip is +compressed individually). The default gives a strip size of no more +than 8 kb. + +.SS \fB-lowdotrange\fP,\fB-highdotrange\fP +.PP +These options set tag values that may be useful for printers. + +.SS \fB-knormal\fP,\fB-kremove\fP,\fB-konly\fP +.PP +These options control the calculation of the CMYK ink levels. +They are useful only for testing and debugging the code. +.PP +\fB-kremove\fP sets the black (K) levels to zero while leaving the +other ink levels as they would be if the black level were normal. +.PP +\fB-konly\fP sets all inks to the normal black value. + +.SS \fB-default\fP,\fB-negative\fP +.PP +These options control what ink levels \fBpnmtotiffcmyk\fP uses to +represent each input color. +.PP +\fB-negative\fP selects a simple algorithm that generates a color +negative. None of the following options apply to this algorithm. The +algorithm is included as an example in the source code to help +implementors of other conversions. +.PP +\fB-default\fP is not necessary, unless you have to countermand a +\fB-negative\fP on the same command line. +.PP +The default conversion from RGB to CMYK is as follows: The basic +values of the 3 pigments are C = 1-R, M = 1-G, Y = 1-B. From this, +\fBpnmtotiffcmyk\fP chooses a black (K) level which is the minimum of +those three. It then replaces that much of the 3 pigments with the +black. I.e. it subtracts K from each of the basic C, M, and Y +values. +.PP +The options below modify this conversion. + +.SS \fB-theta\fP \fIdeg\fP +.PP +\fB-theta\fP provides a simple correction for any color bias that +may occur in the printed image because, in practice, inks do not +exactly complement the primary colors. It rotates the colors (before +black replacement) by \fIdeg\fP degrees in the color wheel. Unless +you are trying to produce unusual effects you will need to use small +values. Try generating three images at -10, 0 (the default) and 10 +degrees and see which has the best color balance. + +.SS \fB-gamma\fP \fIn\fP +.PP +\fB-gamma\fP applies a gamma correction to the black (K) value +described above. Specifically, instead of calculating the K value as +min(C,M,Y), \fBpnmtotiffcmyk\fP raises that value (normalised to the +range 0 to 1) to the \fIn\fPth power. In practice, this means that a +value greater than 1 makes the image lighter and a value less than 1 +makes the image darker. The range of allowed values is 0.1 to 10. + +.SS \fB-gammap\fP \fIn\fP +.PP +This option controls the black replacement. +.PP +If you specify \fB-gammap\fP, \fBpnmtotiffcmyk\fP uses the specified +gamma value in computing how much ink to remove from the 3 pigments, but +still uses the regular gamma value (\fB-gamma\fP option) to generate the +actual amount of black ink with which to replace it. +.PP +Values of \fIn\fP from 0.01 to 10 are valid. +.PP +For example, it may be best to only subtract black from the +colored inks in the very darkest regions. In that case, \fIn\fP +should be a large value, such as 5. +.PP +As a special case, if \fIn\fP is -1, \fBpnmtotiffcmyk\fP does not +remove any pigment (but still adds the black ink). This means dark +areas are even darker. Furthermore, when printed, dark areas contain +a lot of ink which can make high contrast areas, like lettering, +appear fuzzy. It's hard to see what the utility of this is. + +.UN seealso +.SH SEE ALSO +.BR "pamtotiff" (1)\c +\&, +.BR "tifftopnm" (1)\c +\&, +.BR "pnm" (1)\c +\& + +.UN author +.SH AUTHOR + +Copyright (c) 1999 Andrew Cooke (Jara Software). Released under the +GPL with no warranty. See source or COPYRIGHT and LICENCE files in +distribution for full details. + +Much of the code uses ideas from other Netpbm programs, written by Jef +Poskanzer (thanks go to him and libtiff maintainer Sam Leffler). A +small section of the code - some of the tiff tag settings - is derived +directly from pnmtotiff, by Jef Poskanzer, which, in turn, +acknowledges Patrick Naughton with the following text: + +.RS +.PP +Derived by Jef Poskanzer from ras2tif.c, which is: +.PP +Copyright (c) 1990 by Sun Microsystems, Inc. +.PP +Author: Patrick J. Naughton +\fInaughton@wind.sun.com\fP +.PP +Permission to use, copy, modify, and distribute this software and +its documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.PP +This file is provided AS IS with no warranties of any kind. The +author shall have no liability with respect to the infringement of +copyrights, trade secrets or any patents by this file or any part +thereof. In no event will the author be liable for any lost revenue +or profits or other special, indirect and consequential damages. + +.RE +.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/pnmtotiffcmyk.html +.PP
\ No newline at end of file |