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 / ppmtoilbm.1 < prev    next >
Text File  |  1996-11-18  |  4KB  |  146 lines
  1. .TH ppmtoilbm 1 "31 October 1993"
  2. .IX ppmtoilbm
  3. .SH NAME
  4. ppmtoilbm - convert a portable pixmap into an ILBM file
  5. .SH SYNOPSIS
  6. .B ppmtoilbm
  7. .RB [ -maxplanes | -mp
  8. .IR N ]
  9. .RB [ -fixplanes | -fp
  10. .IR N ]
  11. .RB [ -ham6 | -ham8 ]
  12. .RB [ -dcbits | -dcplanes r g b ]
  13. .RB [ -normal | -hamif | -hamforce | -24if | -24force |
  14. .RB -dcif | -dcforce | -cmaponly ]
  15. .RB [ -ecs | -aga ]
  16. .RB [ -compress | -nocompress ]
  17. .RB [ -cmethod
  18. .IR type ]
  19. .RB [ -map ppmfile ]
  20. .RB [ -savemem ]
  21. .RB [ ppmfile ]
  22. .SH DESCRIPTION
  23. Reads a portable pixmap as input.
  24. Produces an ILBM file as output.
  25. .IX "ILBM"
  26. Supported ILBM types are:
  27. .TP
  28. Normal ILBMs with 1-16 planes.
  29. .TP
  30. Amiga HAM with 3-16 planes.
  31. .IX "Amiga"
  32. .IX "HAM"
  33. .TP
  34. 24 bit.
  35. .TP
  36. Color map (BMHD + CMAP chunk only, nPlanes = 0).
  37. .TP
  38. Unofficial direct color.
  39. 1-16 planes for each color component.
  40. .TP
  41. Chunks written:
  42. BMHD, CMAP, CAMG (only for HAM), BODY (not for colormap files)
  43. unofficial DCOL chunk for direct color ILBM
  44. .SH OPTIONS
  45. Options marked with (*) can be prefixed with a "no",
  46. e.g. "-nohamif". All options can be abbreviated to
  47. their shortest unique prefix.
  48. .TP
  49. .B -maxplanes | -mp n
  50. (default 5, minimum 1, maximum 16)
  51. Maximum planes to write in a normal ILBM.  If the pixmap
  52. does not fit into <n> planes, ppmtoilbm writes a HAM file
  53. (if -hamif is used), a 24bit file (if -24if is used) or a
  54. direct color file (if -dcif is used) or aborts with an error.
  55. .TP
  56. .B -fixplanes | -fp n
  57. (min 1, max 16)
  58. If a normal ILBM is written, it will have exactly <n> planes.
  59. .TP
  60. .B -hambits | -hamplanes n
  61. (default 6, min 3, max 16)
  62. Select number of planes for HAM picture.  The current Amiga
  63. hardware supports 6 and 8 planes, so for now you should
  64. only use this values.
  65. .TP
  66. .B -normal (default)
  67. Turns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and
  68. -cmaponly.  Also sets compression type to byterun1.
  69. .TP
  70. .B -hamif (*)
  71. .TP
  72. .B -24if (*)
  73. .TP
  74. .B -dcif (*)
  75. Write a HAM/24bit/direct color file if the pixmap does not
  76. fit into <maxplanes> planes.
  77. .TP
  78. .B -hamforce (*)
  79. .TP
  80. .B -24force (*)
  81. .TP
  82. .B -dcforce (*)
  83. Write a HAM/24bit/direct color file.
  84. .TP
  85. .B -dcbits | -dcplanes r g b
  86. (default 5, min 1, max 16).
  87. Select number of bits for red, green & blue in a direct
  88. color ILBM.
  89. .TP
  90. .B -ecs (default)
  91. Shortcut for: -hamplanes 6 -maxplanes 5
  92. .TP
  93. .B -aga
  94. .TP
  95. .B Shortcut for: -hamplanes 8 -maxplanes 8
  96. .TP
  97. .B -ham6
  98. .TP
  99. .B Shortcut for: -hamplanes 6 -hamforce
  100. .TP
  101. .B -ham8
  102. Shortcut for: -hamplanes 8 -hamforce
  103. .TP
  104. .B -compress (*) (default)
  105. .TP
  106. .B -cmethod none|byterun1
  107. Compress the BODY chunk.  The default compression method is byterun1.
  108. Compression requires building the ILBM image in memory; turning compression
  109. off allows stream-writing of the image, but the resulting file will usually
  110. be 30% to 50% larger.  Another alternative is the -savemem option, this will
  111. keep memory requirements for compression at a minimum, but is very slow.
  112. .TP
  113. .B -map ppmfile
  114. Write a normal ILBM using the colors in <ppmfile> as the
  115. colormap. The colormap file also determines the number of
  116. planes, a -maxplanes or -fixplanes option is ignored.
  117. .TP
  118. .B -cmaponly
  119. Write a colormap file: only BMHD and CMAP chunks, no BODY
  120. chunk, nPlanes = 0.
  121. .TP
  122. .B -savemem
  123. See the -compress option.
  124. .SH "BUGS"
  125. HAM pictures will always get a grayscale colormap; a real color selection
  126. algorithm might give better results.  On the other hand, this allows row-by-row
  127. operation on HAM images, and all HAM images of the same depth (no. of planes)
  128. share a common colormap, which is useful for building HAM animations.
  129. .SH "REFERENCES"
  130. Amiga ROM Kernel Reference Manual - Devices (3rd Ed.)
  131. .br
  132. Addison Wesley, ISBN 0-201-56775-X
  133. .SH "SEE ALSO"
  134. ppm(5), ilbmtoppm(1)
  135. .SH AUTHORS
  136. Copyright (C) 1989 by Jef Poskanzer.
  137. .br
  138. Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de)
  139. .\" Permission to use, copy, modify, and distribute this software and its
  140. .\" documentation for any purpose and without fee is hereby granted, provided
  141. .\" that the above copyright notice appear in all copies and that both that
  142. .\" copyright notice and this permission notice appear in supporting
  143. .\" documentation.  This software is provided "as is" without express or
  144. .\" implied warranty.
  145.  
  146.