summaryrefslogtreecommitdiff
path: root/support/dktools/man/man1/bmpp.1
diff options
context:
space:
mode:
Diffstat (limited to 'support/dktools/man/man1/bmpp.1')
-rw-r--r--support/dktools/man/man1/bmpp.11071
1 files changed, 0 insertions, 1071 deletions
diff --git a/support/dktools/man/man1/bmpp.1 b/support/dktools/man/man1/bmpp.1
deleted file mode 100644
index 12a901fb7a..0000000000
--- a/support/dktools/man/man1/bmpp.1
+++ /dev/null
@@ -1,1071 +0,0 @@
-'\" t
-.\" Title: bmpp
-.\" Author: [see the "AUTHORS" section]
-.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\" Date: 03/24/2020
-.\" Manual: \ \&
-.\" Source: \ \&
-.\" Language: English
-.\"
-.TH "BMPP" "1" "03/24/2020" "\ \&" "\ \&"
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el .ds Aq '
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-bmpp \- Bitmap to PDF/PS converter
-.SH "SYNOPSIS"
-.sp
-\fBbmpp\fR [\fB\-l\fR\fIdriver\fR[\fB\&.\fR\fImode\fR][,\fIname\fR[\fB=\fR\fIvalue\fR]\&...]] [\fIoption\fR\&...] \fIfile\fR\&...
-.SH "DESCRIPTION"
-.sp
-The program converts bitmap image files from PNG, JPEG, TIFF and NetPBM to PDF and PS/EPS\&. In this text "bitmap image" refers to bitmap, graymap and pixmap images\&.
-.sp
-For each input file specified on the command line the program creates a corresponding output file with file name suffix "\&.pdf", "\&.eps", "\&.ps" or "\&.bb"\&.
-.sp
-If a directory name is specified on the command line, bmpp traverses the directory and converts all files suitable as bmpp input\&. In the special make\-mode bmpp converts only those files for which there is no up\-to\-date output file yet\&.
-.sp
-The driver choice indicates the file type to produce:
-.PP
-pdf
-.RS 4
-Portable document format (PDF)\&.
-.RE
-.PP
-eps
-.RS 4
-Encapsulated PostScript (EPS), image for inclusion in documents\&.
-.RE
-.PP
-ps
-.RS 4
-Print job file for printing on PostScript printers\&.
-.RE
-.PP
-bb
-.RS 4
-Bounding box file, contains image dimensions only, no image contents\&. LaTeX needs such files sometimes to know how much space to reserve for an image\&.
-.RE
-.sp
-The output mode indicates the intended purpose of the output:
-.PP
-object
-.RS 4
-Object, a file embedded into a graphics or text document by a drawing software or text typesetting software\&.
-.RE
-.PP
-image
-.RS 4
-Image for stand\-alone viewing and processing\&.
-.RE
-.PP
-document
-.RS 4
-The image is fitted to a specified paper size or usable area on paper for printing\&.
-.RE
-.SH "OPTIONS"
-.PP
-\fB\-l\fR \fIdriver\fR[\fB\&.\fR\fImode\fR][\fB,\fR\fIkey\fR[\fB=\fR\fIvalue\fR]\&...] \fB\-\-language=\fR\fIdriver\fR[\fB\&.\fR\fImode\fR][\fB,\fR\fIkey\fR[\fB=\fR\fIvalue\fR]\&...]
-.RS 4
-specifies output driver and output mode\&. The optional key=value pairs can be used for further configuration\&. See section "key=value pairs" below\&.
-.RE
-.PP
-\fB\-m\fR, \fB\-\-make\fR
-.RS 4
-turns on "make operating" for directory processing\&. When processing directories, bmpp in normal operating processes each file it can process\&. In make operating it processes only those files for which there is no up\-to\-date output file yet\&.
-.RE
-.PP
-\fB\-R\fR, \fB\-\-reset\fR
-.RS 4
-resets the program to built\-in default settings, the dk4gra\&.conf configuration files are ignored\&.
-.RE
-.PP
-\fB\-\-help\fR
-.RS 4
-shows a short help text\&.
-.RE
-.PP
-\fB\-\-manual\fR
-.RS 4
-shows a detailed help text\&.
-.RE
-.PP
-\fB\-\-version\fR
-.RS 4
-shows the version number\&.
-.RE
-.PP
-\fB\-\-license\fR
-.RS 4
-shows the license conditions of both bmpp and the used libraries\&.
-.RE
-.SH "KEY=VALUE PAIRS"
-.sp
-Key=value pairs are used to specify configuration details\&.
-.sp
-For boolean settings it is sufficient to write the name to activate the option\&. As an example "\-lps\&.document,duplex" has the same effect as "\-lps\&.document,duplex=true"\&. Use "on", "true", or "yes" to activate boolean settings\&. Use "off", "false", or "no" for deactivation\&.
-.sp
-The following settings can be made:
-.PP
-\fBlevel=\fR\fIinteger\fR
-.RS 4
-PS language level when producing PS output, 2 or 3\&. Default: 3\&.
-.RE
-.PP
-\fBdsc=\fR\fIboolean\fR
-.RS 4
-Write DSC comments (document structuring convention) to PS/EPS output files\&. Default: off
-.RE
-.PP
-\fBlzw=\fR\fIboolean\fR
-.RS 4
-Allow the use of LZW compression in PS level 2 output\&. Default: off
-.RE
-.PP
-\fBcolor=\fR\fIboolean\fR
-.RS 4
-Allow colored output\&. Default: on\&. Deactivating this option results in grayscaled output\&.
-.RE
-.PP
-\fBrgb\-to\-gray=\fR\fIstring\fR
-.RS 4
-Method to convert RGB data to grayscale values\&. Default: bt601\&. See section "Color space conversion" below\&.
-.RE
-.PP
-\fBrgb\-to\-cmyk=\fR\fIstring\fR
-.RS 4
-Method to convert RGB data to CMYK, one from "non\-standard" or "standard"\&. Default: non\-standard\&. The bmpp program does not convert from RGB to CMYK and there are no plans to do so\&. The option is mentioned here for completeness as the used libdk4gra library supports this configuration option\&.
-.RE
-.PP
-\fBalpha=\fR\fIstring\fR
-.RS 4
-Method for alpha channel use, either "mix" or "foreground"\&. Default: mix\&. See section "Alpha channel" below\&.
-.RE
-.PP
-\fBbg=\fR\fIinteger\fR\fB:\fR\fIinteger\fR\fB:\fR\fIinteger\fR[\fB:\fR\fIboolean]\fR
-.RS 4
-Default background color\&. The numbers are RGB values in the range 0\&...255\&. Default: 255:255:255\&. Normally the color specified here is only used if the input image does not contain background color information\&. The optional boolean flag decides about enforcing the background color\&. Enforcing means the background color is used even if there is background color information in the input image file\&. I recommend to use the "force\-bg" option instead of specifying the boolean flag here\&.
-.RE
-.PP
-\fBforce\-bg=\fR\fIboolean\fR
-.RS 4
-Enforcing the background color can be set up differently from specifying the background color\&. Default: off\&.
-.RE
-.PP
-\fBinterpolation=\fR\fIboolean\fR
-.RS 4
-Set interpolation flag in output\&. If this flag is set, PDF/PS rendering programs are allowed to attempt to improve image representation\&. Default: on\&.
-.RE
-.PP
-\fBdct=\fR\fIboolean\fR
-.RS 4
-Allow direct re\-use of DCT encoded data from JPEG input files\&. This avoids decoding and encoding and results in faster processing and smaller output files\&. Default: on\&.
-.RE
-.PP
-\fBdct\-interpolation=\fR\fIboolean\fR
-.RS 4
-Set image interpolation flag when directly re\-using DCT encoded data from JPEG files too\&. Default: off\&.
-.RE
-.PP
-\fBa\-bpc=\fR\fIboolean\fR
-.RS 4
-Analyze bits per component\&. Reduce number of bits per component if reduction if possible without quality loss\&. Default: on\&.
-.RE
-.PP
-\fBa\-color=\fR\fIboolean\fR
-.RS 4
-Analyze use of colors, switch output color space to grayscaled if all pixels are gray\&. Default: on\&.
-.RE
-.PP
-\fBa\-alpha=\fR\fIboolean\fR
-.RS 4
-Analyze alpha channel use, avoid writing an SMask object to PDF output if all pixels are fully opaque\&. Default: on\&.
-.RE
-.PP
-\fBpaper=\fR\fIstring\fR
-.RS 4
-Paper size for documents\&. The paper size must be defined in a dk3paper\&.conf or dk4paper\&.conf file\&. Default: a4\&.
-.RE
-.PP
-\fBduplex=\fR\fIboolean\fR
-.RS 4
-Prepare PS output for duplex printing (print on front side and back side of paper sheet, binding on the left side like a book)\&. Default: on\&.
-.RE
-.PP
-\fBtumble=\fR\fIboolean\fR
-.RS 4
-Prepare PS output for duplex+tumble printing (print on front side and back side of paper sheet, binding on top side like a calendar)\&. Default: off\&.
-.RE
-.PP
-\fBresolution=\fR\fIchoice\fR
-.RS 4
-How to use resolution and calculate image size, one from:
-.PP
-chunk
-.RS 4
-Obtain resolution information from input image file, if available\&. This is the default\&. If there is no resolution information in the input file, use 1px1pt\&.
-.RE
-.PP
-1px1pt
-.RS 4
-Use 72 dpi for resolution in both x and y direction\&. Ignore resolution data in input image file if present\&. Each pixel from input file will use a 1 PS point square in output\&.
-.RE
-.PP
-\fInumber\fR
-.RS 4
-The specified floating point number is used as resolution in dpi for both x and y direction\&.
-.RE
-.PP
-\fInumber\fR\fB:\fR\fInumber\fR
-.RS 4
-The first number specifies the resolution in x direction, the second one specifies the resolution in y direction\&. I recommend to use
-\fInumber\fR
-and
-\fInumber\fR\fB:\fR\fInumber\fR
-only\&. The "chunk" and "1px1pt" variants are only available for backwards compatibility\&. Chunk is the default, instead of 1px1pt you should better use "i\-res=on"\&.
-.RE
-.RE
-.PP
-\fBi\-res=\fR\fIboolean\fR
-.RS 4
-Ignore resolution information in input image file\&. Use 72 dpi, so the image width and height in PS point is equal to the number of pixels in width and height of the input image\&. The result is the same as "resolution=1px1pt"\&. Default: off\&.
-.RE
-.PP
-\fBi\-aspect=\fR\fIboolean\fR
-.RS 4
-Ignore aspect ratio of input image\&. When creating a document the entire available (printable) area on paper sheet is used for the image\&. A distortion due to different x and y scale factors is accepted\&. Default : off\&.
-.RE
-.PP
-\fBrotate=\fR\fIboolean\fR
-.RS 4
-Allow image rotation by 90 degree if the rotated image fits better into the usable area\&. Default: off\&.
-.RE
-.SH "ALPHA CHANNEL"
-.sp
-PNG/TIFF/NetPBM can contain an alpha channel\&. A pixels alpha value expresses opacity in the range 0=transparent to 1=fully opaque\&. An alpha channel found in the input image file is transferred into an SMask object in PDF output\&. For PS/EPS output we have to calculate the color of each pixel, there are two choices:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Mixing the foreground color as retrieved from input file against a background color considering opaqueness from alpha channel\&. This is the default\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Simply use the foreground information found in input image file\&. Use "alpha=foreground" to configure this\&.
-.RE
-.sp
-A background color information (background color chunk) in the input image file is used by default, if present\&.
-.sp
-For input images without background color information you can use the "bg=\&..." option to define a default background color\&. Using "force\-bg=on" you can configure to use the bg=\&... color even if the input image file contains background color information\&.
-.sp
-When creating a PDF document, each page is completely filled with white color before applying any image\&.
-.sp
-When creating a PDF image for an image containing transparency, the image area is filled with background color before applying the image\&.
-.SH "COMPRESSION AND ENCODING"
-.sp
-Flate compression is used for PDF output and PS level 3 output\&.
-.sp
-Run length compression with separated color channels is used for PS level 2 output if the number of bytes per color channel per row does not exceed 16384\&. For images with larger rows no compression is used\&. Alternatively you can enable LZW compression\&.
-.sp
-For separated color channels the data stream contains all red values for a row first, all green values next, all blue values finally\&. Without separated color channels a horizontal red line would be represented by the byte values: 255 0 0 255 0 0 255 0 0 255 0 0 255 0 0 \&... Run length compression would not be possible\&. With separated color channels the red channels contains: 255 255 255 255 255 \&... The green and blue channels contain: 0 0 0 0 0 \&... So run length compression can be applied to colored lines\&.
-.sp
-The compression result is used directly without any further encoding for PDF output\&. For PS/EPS output ASCII\-85 encoding is applied to produce clean 7 bit text\&.
-.SH "IMAGE ANALYSIS"
-.sp
-If the number of bits per component can be reduced for all components of all pixels without quality loss, the smaller bit depth is used in output\&.
-.sp
-If the input images uses RGB, RGB+alpha or CMYK color space but all pixels are gray, bmpp produces grayscaled output\&.
-.sp
-If the input image contains an alpha channel but alpha data indicates full opacity for all pixels, no SMask object is written to PDF output\&.
-.SH "COLOR SPACE CONVERSION"
-.sp
-The following variables containing integer values are used in the formulas below:
-.PP
-\fIMAX\fR
-.RS 4
-Maximum value for a given number of bits per component (i\&.e\&. 15 for 4 bits, 255 for 8 bits)
-.RE
-.PP
-\fIR\fR
-.RS 4
-Red component in range 0 \&... MAX
-.RE
-.PP
-\fIG\fR
-.RS 4
-Green component in range 0 \&... MAX
-.RE
-.PP
-\fIB\fR
-.RS 4
-Blue component in range 0 \&... MAX
-.RE
-.PP
-\fIE\fR
-.RS 4
-Grayscale value in range 0 \&... MAX
-.RE
-.sp
-Several methods can be used to convert RGB data to gray:
-.PP
-\fBbt601\fR
-.RS 4
-Keep luminance:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = (299 * R + 587 * G + 114 * B) / 1000
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBluminance\fR
-.RS 4
-Keep luminance, use shorter coefficients:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = (30 * R + 59 * G + 11 * B) / 100
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBfast\fR
-.RS 4
-Fast calculation without division operations:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = (77 * R + 151 * G + 28 * B) >> 8
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBfastest\fR
-.RS 4
-Yet faster and more inaccurate calculation without multiplication and division (<< and >> are bit shifting operations to left and right):
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = ((R << 1) + (G << 2) + G + B) >> 3
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBbt709\fR
-.RS 4
-Keep luminance, use other coefficients:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = (2126 * R + 7152 * G + 722 * B) / 1000
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBaverage\fR
-.RS 4
-Average of red, green, blue:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = (R + G + B) / 3
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBdesaturation\fR
-.RS 4
-Desaturation results in an image with less contrast:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = (maximum{R,G,B} + minimum{R,G,B}) / 2
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBmin\fR
-.RS 4
-Minimum decomposition uses the minimum of R, G, B:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = minimum{R,G,B}
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBmedian\fR
-.RS 4
-Median decomposition uses the median value of R, G, B:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = median{R,G,B}
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBmax\fR
-.RS 4
-Maximum decomposition uses the maximum of R, G, B:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = maximum{R,G,B}
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBred\fR
-.RS 4
-Just use the red component:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = R
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBgreen\fR
-.RS 4
-Just use the green component:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = G
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.PP
-\fBblue\fR
-.RS 4
-Just use the blue component:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-E = B
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.SH "IMAGE SIZE, RESOLUTION AND ROTATION"
-.sp
-If image resolution information is available the real image dimensions in PS points are calculated by multiplication of width/height in pixels by factor 72, division by x/y resolution and rounding upwards to the next integer value\&. The source of the image resolution is either the input image file if it contains resolution data (resolution=chunk, this is the default) or a resolution specified by the user (resolution=\fInumber\fR or resolution=\fInumber\fR:\fInumber\fR)\&.
-.sp
-If the input image file does not contain resolution data or the user decides to ignore resolution data (i\-res=on), a resolution of 72 dpi is used\&. The output image width/height in PS points is equal to the input image width/height in number of pixels\&.
-.sp
-Some input images \- i\&.e\&. TIFF files generated by a fax gateway \- contain different resolutions for x and y direction\&. For such images ignoring the resolution results in image distorsion\&.
-.sp
-There are two choices to fit an image into a usable/printable area of a page or paper sheet:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Keep the aspect ratio (default), probably leaving parts of the available area unused\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Ignore the aspect ratio (i\-aspect=on) and fill the area completely accepting image distorsion\&.
-.RE
-.sp
-For some image/paper combinations \- i\&.e\&. the image is more wide than high but the paper is more high than wide \- rotating the image by 90 degree allows better fitting to the available area\&. The rotate=on option allows such rotations\&.
-.SH "EXIT STATUS"
-.sp
-0 on success, all other values indicate errors\&.
-.SH "EXAMPLES"
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Create PDF object for use with pdfLaTeX from screenshot\&.png file:
-.sp
-bmpp \-l pdf screenshot\&.png
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Create EPS object screenshot\&.eps for use with LaTeX/dvips:
-.sp
-bmpp \-l eps screenshot\&.png
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Create PDF file fax\&.pdf for printing from fax\&.tif file:
-.sp
-bmpp \-l pdf\&.document,paper=A4,duplex fax\&.tif
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Create PS file fax\&.ps for printing, use language level 2:
-.sp
-bmpp \-l ps\&.document,level=2,paper=A4,duplex fax\&.tif
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Create standalone image file file\&.pdf from file\&.png file:
-.sp
-bmpp \-l pdf\&.image file\&.png
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Create standalone file file\&.ps from file\&.png file:
-.sp
-bmpp \-l ps\&.image file\&.png
-.RE
-.SH "FAQ"
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Do I need to create a dk4gra\&.conf file?
-.sp
-The dk4gra\&.conf configuration file can be used, but normally there is no need to do so\&. I hope I selected useful defaults for the bmpp program\&. One reason to create a dk4gra\&.conf file is to support PS printers handling PS language level 2 only\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-How do I switch PS language level to 2?
-.PP
-On the command line
-.RS 4
-Use "\-lps,level=2" instead of "\-lps"\&.
-.RE
-.PP
-In a dk4gra\&.conf file
-.RS 4
-Create a file dk4gra\&.conf in one of the following directories
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${datadir}/dk4app\-site to set defaults for all users\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${sysconfdir}/dk4app\-site to set defaults for all users\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${HOME}/\&.dk4app to set defaults for the current user\&.
-.sp
-containing the following lines:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-[ps]
-level=2
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.RE
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-How do I enable LZW compression for PS level 2 output?
-.sp
-Note: The LZW algorithm was patent protected for a long time\&. The patent in the USA expired in 2003, the corresponding patent in Germany expired in 2004\&. I do not know the situation in all countries over the world, so you should check the situation in your country yourself\&. Activate LZW only if you are allowed to use it and if you really need it\&.
-.PP
-On the command line
-.RS 4
-Use "\-lps,level=2,lzw" instead of "\-lps,level=2"\&.
-.RE
-.PP
-In a dk4gra\&.conf file
-.RS 4
-Create a file dk4gra\&.conf containing the following lines:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-[ps]
-level=2
-lzw=on
-.fi
-.if n \{\
-.RE
-.\}
-.RE
-.RE
-.SH "FILES"
-.PP
-\fBdk3paper\&.conf\fR / \fBdk4paper\&.conf\fR
-.RS 4
-are the configuration files to define paper sizes\&. If paper=\&... is used, the paper size must be defined in one of these files\&.
-.RE
-.PP
-\fBdk4gra\&.conf\fR
-.RS 4
-is the configuration file for graphics output from the DK tools and libraries project\&.
-.sp
-Cumulative processing is used\&. Settings made in a file processed earlier may be overwritten in files processed later\&. The ${datadir}/dk4app, ${sysconfdir}/dk4app, ${datadir}/dktools, ${sysconfdir}/dktools, ${datadir}/bmpp directories are managed by the package management, you should not create or modify files here\&. Files in these directories may be updated or deleted during package updates\&. Use ${datadir}/dk4app\-site, ${sysconfdir}/dk4app\-site, ${datadir}/dktools\-site, ${sysconfdir}/dktools\-site, ${datadir}/bmpp\-site, ${sysconfdir}/bmpp\-site, ${HOME}/\&.dk4app, ${HOME}/\&.dk4app/dktools, or ${HOME}/\&.dk4app/bmpp for customized dk4gra\&.conf files\&.
-.sp
-On start the bmpp program checks for the file in the following locations in the specified order:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${datadir}/dk4app/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${sysconfdir}/dk4app/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${datadir}/dk4app\-site/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${sysconfdir}/dk4app\-site/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${datadir}/dktools/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${sysconfdir}/dktools/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${datadir}/dktools\-site/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${sysconfdir}/dktools\-site/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${datadir}/bmpp/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${sysconfdir}/bmpp/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${datadir}/bmpp\-site/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${sysconfdir}/bmpp\-site/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${HOME}/\&.dk4app/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${HOME}/\&.dk4app/dktools/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-${HOME}/\&.dk4app/bmpp/dk4gra\&.conf
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-\&./dk4gra\&.conf
-.RE
-.RE
-.SH "RESTRICTIONS"
-.sp
-File name size is restricted to MAXPATHLEN respectively _PATH_MAX on your system\&. The full path names of all files used must fit into this length\&.
-.sp
-The program uses the TIFFReadRGBAImage() function from the libtiff library to read TIFF images\&. The input file must meet the following conditions:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-The file must be compliant to the "TIFF baseline v6\&.0 standard"\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-The number of bits per component must be 8 or less\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-The frames must not be too large, the system must be able to allocate the 4*w*h bytes needed for imaga date in one piece\&.
-.RE
-.sp
-TIFF refers to a group of different compression and encoding mechanisms\&. A TIFF file is a sequence of data chunks, each data chunk contains a tag (chunk type identifier)\&. A lot of tags is defined in standards, i\&.e\&. the "TIFF baseline v6\&.0 standard"\&. Some software vendors add vendor\-specific or non\-standard tags when writing TIFF files\&. So when processing TIFF files in bmpp, you should not be surprised to see warnings or error messages about unknown TIFF tags\&. Neither bmpp nor the tifflib library are to blame for this, it\(cqs the responsibility of the people adding the non\-standard tags\&. Sometimes bmpp can read the image despite of the warnings/errors\&.
-.sp
-If you create bitmaps you want to process with bmpp, you should create PNG images instead of TIFF images if you have the choice\&.
-.SH "AUTHORS"
-.sp
-Dirk Krause
-.SH "HISTORY"
-.sp
-The bmpp program replaces the bmeps program found in earlier versions of the DK tools and libraries project\&. The program was rewritten completely for version 4\&.12\&.0, including the used libraries for reading bitmap images and producing graphics output\&.
-.SH "COPYRIGHT AND LICENSE"
-.sp
-Copyright (c) 2018, Dirk Krause
-.sp
-All rights reserved\&.
-.sp
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-Neither the name of the copyright holder(s) nor the names of contributors may be used to endorse or promote products derived from this software without specific prior written permission\&.
-.RE
-.sp
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \(lqAS IS\(rq AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED\&. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE\&.
-.SH "SEE ALSO"
-.PP
-pnmtops(1)
-.RS 4
-The pnmtops program from the NetPBM project \- see
-http://netpbm\&.sourceforge\&.net
-\- converts NetPBM input files to PS and EPS\&. It can create PS level 1 output, but PS level 1 does not support colored bitmap images\&.
-.RE
-.PP
-convert(1)
-.RS 4
-The convert program from the ImageMagick project can also convert to EPS and PDF\&.
-.RE
-.PP
-dk3paper\&.conf(5)
-.RS 4
-How to define paper sizes\&.
-.RE
-.PP
-dk4gra\&.conf(5)
-.RS 4
-Syntax of dk4gra\&.conf files\&.
-.RE
-.PP
-http://sourceforge\&.net/p/dktools/wiki/Home/
-.RS 4
-Project homepage\&.
-.RE