tiff: build tiff2ps and tiff2pdf into tiff-unsupported

srcpkgs/tiff/files/tiff2pdf.1

@@ -0,0 +1,276 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "TIFF2PDF" "1" "Jun 10, 2023" "4.5" "LibTIFF"
+.SH NAME
+tiff2pdf \- convert a TIFF image to a PDF document
+.SH SYNOPSIS
+.sp
+\fBtiff2pdf\fP [ \fIoptions\fP ] \fIinput.tiff\fP
+.SH DESCRIPTION
+.sp
+\fBtiff2pdf\fP opens a TIFF image and writes a PDF document to standard output.
+.sp
+The program converts one TIFF file to one PDF file, including multiple page
+TIFF files, tiled TIFF files, black and white. grayscale, and color TIFF
+files that contain data of TIFF photometric interpretations of bilevel,
+grayscale, RGB, YCbCr, CMYK separation, and ICC L*a*b* as supported by
+\fBlibtiff\fP and PDF.
+.sp
+If you have multiple TIFF files to convert into one PDF file then use \fBtiffcp\fP
+or other program to concatenate the files into a multiple page TIFF file.
+If the input TIFF file is of huge dimensions (greater than 10000 pixels height
+or width) convert the input image to a tiled TIFF if it is not already.
+.sp
+The standard output is standard output.  Set the output file name with the
+\fI\%\-o\fP option.
+.sp
+All black and white files are compressed into a single strip CCITT G4 Fax
+compressed PDF, unless tiled, where tiled black and white images are
+compressed into tiled CCITT G4 Fax compressed PDF,
+\fBlibtiff\fP CCITT support is assumed.
+.sp
+Color and grayscale data can be compressed using either JPEG compression,
+ITU\-T T.81, or Zip/Deflate LZ77 compression.  Set the compression type using
+the \fI\%\-j\fP or \fI\%\-z\fP options.  JPEG compression support
+requires that \fBlibtiff\fP be configured with JPEG support, and
+Zip/Deflate compression support requires that \fBlibtiff\fP
+be configured with Zip support.  Use only one or the other of
+\fI\%\-j\fP and \fI\%\-z\fP\&.
+.sp
+If the input TIFF contains single strip CCITT G4 Fax compressed information,
+then that is written to the PDF file without transcoding, unless the options
+of no compression and no passthrough are set, \fI\%\-d\fP and \fI\%\-n\fP\&.
+.sp
+If the input TIFF contains JPEG or single strip Zip/Deflate compressed
+information, and they are configured, then that is written to the PDF file
+without transcoding, unless the options of no compression and no passthrough
+are set.
+.sp
+The default page size upon which the TIFF image is placed is determined by
+the resolution and extent of the image data.  Default values for the TIFF
+image resolution can be set using the \fI\%\-x\fP and \fI\%\-y\fP
+options.  The page size can be set using the \fI\%\-p\fP
+option for paper size, or \fI\%\-w\fP and \fI\%\-l\fP
+for paper width and length, then each page of the TIFF image is centered on
+its page.  The distance unit for default resolution and page width and
+length can be set by the \fI\%\-u\fP option, the default unit is inch.
+.sp
+Various items of the output document information can be set with the
+\fI\%\-e\fP, \fI\%\-c\fP, \fI\%\-a\fP, \fI\%\-t\fP, \fI\%\-s\fP,
+and \fI\%\-k\fP options.  Setting the argument of the option to \fB\(dq\(dq\fP for these
+tags causes the relevant document information field to be not written.  Some
+of the document information values otherwise get their information from the
+input TIFF image, the software, author, document name, and image description.
+.sp
+The Portable Document Format (PDF) specification is copyrighted by Adobe
+Systems, Incorporated.
+.SH OPTIONS
+.INDENT 0.0
+.TP
+.B \-o output\-file
+Set the output to go to file \fIoutput\-file\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-j
+Compress with JPEG (requires \fBlibjpeg\fP configured with
+\fBlibtiff\fP).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-z
+Compress with Zip/Deflate (requires :program\(gazlib\(ga configured with
+\fBlibtiff\fP).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-q quality
+Set the compression quality, 1\-100 for JPEG.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-n
+Do not allow data to be converted without uncompressing, no compressed
+data passthrough.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-b
+Set PDF \fBInterpolate\fP user preference.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-d
+Do not compress (decompress).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-i
+Invert colors.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-p paper\-size
+Set paper size, e.g., \fBletter\fP,  \fBlegal\fP, \fBA4\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-F
+Cause the tiff to fill the PDF page.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-u [ i | m ]
+Set distance unit, \fBi\fP for inch, \fBm\fP for centimeter.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-w width
+Set width in units.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-l length
+Set length in units.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-x xres
+Set x/width resolution default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-y yres
+Set y/length resolution default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-r [ d | o ]
+Set \fBd\fP for resolution default for images without resolution,
+\fBo\fP for resolution override for all images.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-f
+Set PDF \fBFit Window\fP user preference.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-e YYYYMMDDHHMMSS
+Set document information date, overrides image or current date/time default,
+\fBYYYYMMDDHHMMSS\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-c creator
+Set document information creator, overrides image software default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-a author
+Set document information author, overrides image artist default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-t title
+Set document information title, overrides image document name default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-s subject
+Set document information subject, overrides image image description default.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-k keywords
+Set document information keywords.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-m size
+Set memory allocation limit (in MiB). Default is 256MiB. Set to 0 to disable the limit.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-h
+List usage reminder to stderr and exit.
+.UNINDENT
+.SH EXAMPLES
+.sp
+The following example would generate the file output.pdf from input.tiff:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+tiff2pdf \-o output.pdf input.tiff
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The following example would generate PDF output from input.tiff and write it
+to standard output:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+tiff2pdf input.tiff
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The following example would generate the file output.pdf from input.tiff,
+putting the image pages on a letter sized page, compressing the output
+with JPEG, with JPEG quality 75, setting the title to \fBDocument\fP, and setting
+the \fBFit Window\fP option:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+tiff2pdf \-p letter \-j \-q 75 \-t \(dqDocument\(dq \-f \-o output.pdf input.tiff
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SH SEE ALSO
+.sp
+\fI\%tiffcp\fP (1),
+\fI\%tiff2ps\fP (1),
+\fI\%libtiff\fP (3tiff),
+.SH AUTHOR
+LibTIFF contributors
+.SH COPYRIGHT
+1988-2022, LibTIFF contributors
+.\" Generated by docutils manpage writer.
+.