home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_docs.lzh / NETPBM / DOCS / pnmtotiff.1 < prev    next >
Text File  |  1996-11-18  |  3KB  |  95 lines
  1. .TH pnmtotiff 1 "13 January 1991"
  2. .IX pnmtotiff
  3. .SH NAME
  4. pnmtotiff - convert a a portable anymap into a TIFF file
  5. .SH SYNOPSIS
  6. .B pnmtotiff
  7. .RB [ -none | -packbits |
  8. .BR -lzw | -g3 | -g4 ]
  9. .RB [ -2d ]
  10. .RB [ -fill ]
  11. .RB [ -predictor
  12. .IR n ]
  13. .RB [ -msb2lsb | -lsb2msb ]
  14. .RB [ -rowsperstrip
  15. .IR n ]
  16. .RI [ pnmfile ]
  17. .SH DESCRIPTION
  18. Reads a portable anymap as input.
  19. Produces a TIFF file as output.
  20. .IX TIFF
  21. .SH OPTIONS
  22. .PP
  23. By default,
  24. .I pnmtotiff
  25. creates a TIFF file with LZW compression.
  26. This is your best bet most of the time.
  27. However, some TIFF readers can't deal with it.
  28. If you want to try another compression scheme or tweak some of the
  29. other even more obscure output options, there are a number of
  30. flags to play with.
  31. .PP
  32. The
  33. .BR -none ,
  34. .BR -packbits ,
  35. .BR -lzw ,
  36. .BR -g3 ,
  37. and
  38. .BR -g4
  39. options are used to override the default and set the compression
  40. scheme used in creating the output file.  The CCITT Group 3 and Group
  41. 4 compression algorithms can only be used with bilevel data.  The
  42. .B -2d
  43. and
  44. .B -fill
  45. options are meaningful only with Group 3 compression:
  46. .B -2d
  47. requests 2-dimensional encoding, while
  48. .B -fill
  49. requests that each encoded scanline be zero-filled to a byte boundry.
  50. The
  51. .B -predictor
  52. option is only meaningful with LZW compression: a predictor value of 2
  53. causes each scanline of the output image to undergo horizontal
  54. differencing before it is encoded; a value of 1 forces each scanline
  55. to be encoded without differencing.
  56. .P
  57. By default,
  58. .I pnmtotiff
  59. creates a TIFF file with msb-to-lsb fill order.
  60. The
  61. .B -msb2lsb
  62. and
  63. .B -lsb2msb
  64. options are used to override the default and set the fill order used
  65. in creating the file.
  66. .P
  67. The
  68. .B -rowsperstrip
  69. option can be used to set the number of rows (scanlines) in each
  70. strip of data in the output file.  By default, the output file has
  71. the number of rows per strip set to a value that will ensure each
  72. strip is no more than 8 kilobytes long.
  73. .SH BUGS
  74. This program is not self-contained.  To use it you must fetch the
  75. TIFF Software package listed in the OTHER.SYSTEMS file and configure
  76. PBMPLUS to use libtiff.  See PBMPLUS's Makefile for details on this
  77. configuration.
  78. .SH "SEE ALSO"
  79. tifftopnm(1), pnm(5)
  80. .SH AUTHOR
  81. Derived by Jef Poskanzer from ras2tiff.c, which is
  82. Copyright (c) 1990 by Sun Microsystems, Inc.
  83. Author: Patrick J. Naughton (naughton@wind.sun.com).
  84. .\" Permission to use, copy, modify, and distribute this software and its
  85. .\" documentation for any purpose and without fee is hereby granted,
  86. .\" provided that the above copyright notice appear in all copies and that
  87. .\" both that copyright notice and this permission notice appear in
  88. .\" supporting documentation.
  89. .\" 
  90. .\" This file is provided AS IS with no warranties of any kind.  The author
  91. .\" shall have no liability with respect to the infringement of copyrights,
  92. .\" trade secrets or any patents by this file or any part thereof.  In no
  93. .\" event will the author be liable for any lost revenue or profits or
  94. .\" other special, indirect and consequential damages.
  95.