1tumble: build a PDF file from image files 2Copyright 2003-2017 Eric Smith <spacewar@gmail.com> 3 4Tumble is a utility to construct PDF files from one or more image 5files. Supported input image file formats are JPEG, and black and 6white TIFF (single- or multi-page). Black and white images will be 7encoded in the PDF output using lossless Group 4 fax compression 8(ITU-T recommendation T.6). This provides a very good compression 9ratio for text and line art. JPEG images will be preserved with the 10original coding. 11 12The current version of Tumble will only work on little-endian systems, 13such as x86, VAX, and Alpha. The byte order dependencies will be fixed 14in a later release. 15 16The input and output files can be specified on the command line. 17Alternatively, a control file, typically with a ".tum" suffix, may be 18used which allows for more control over the files and options. 19 20The general command line syntax is: 21 22 tumble [options] <input>... -o <output.pdf> 23 24The options in this mode are: 25 26 -v verbose 27 -b <fmt> create bookmarks 28 29If the "-b" option is given, bookmarks will be created using the 30format string, which may contain arbitrary text and/or the following 31format specifiers: 32 33 %F file name, sans suffix e.g., "foo.tif" will just appear as "foo" 34 %p page number of input file, useful for multipage TIFF files 35 36There is currently no documentation for the control file syntax, as it 37is still being refined, and many of the options planned for use in 38control files are not yet fully implemented. Features that will be 39available in control files include: 40 41 image resolution specification - useful for input files with 42 unspecified resolution, or to override 43 image rotation, in units of 90 degrees 44 image cropping 45 grouping to allow different specifications for individual pages 46 or groups of consecutive pages (e.g., chapters) 47 ability to control operations independently on even and odd pages 48 (e.g., different rotation or cropping) 49 more flexible bookmark control 50 page labels, so that the PDF file can present the actual document 51 page numbers such as xvii or 3-27 52 53 54This program is free software; you can redistribute it and/or modify 55it under the terms of the GNU General Public License version 2 as 56published by the Free Software Foundation. Note that permission is 57not granted to redistribute this program under the terms of any other 58version of the General Public License. 59 60This program is distributed in the hope that it will be useful, but 61WITHOUT ANY WARRANTY; without even the implied warranty of 62MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 63General Public License for more details. 64 65You should have received a copy of the GNU General Public License 66along with this program; if not, write to the Free Software 67Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA 68