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 / ppmtoacad.1 < prev    next >
Text File  |  1996-11-18  |  5KB  |  144 lines
  1. .TH ppmtoacad 1 "10 October 1991"
  2. .IX ppmtoacad
  3. .IX AutoCAD
  4. .SH NAME
  5. ppmtoacad - convert portable pixmap to AutoCAD database or slide
  6. .SH SYNOPSIS
  7. .na
  8. .B ppmtoacad
  9. 'in 15n
  10. .RB [ -dxb ]
  11. .RB [ -poly ]
  12. .RB [ -background
  13. .IR colour ]
  14. .RB [ -white ]
  15. .RB [ -aspect
  16. .IR ratio ]
  17. .RB [ -8 ]
  18. .RI [ ppmfile ]
  19. .in -15n
  20. .ad
  21. .SH DESCRIPTION
  22. Reads a portable pixmap as input.  Produces an AutoCAD\*R slide file or
  23. binary database import (.dxb) file as output.
  24. If no
  25. .I ppmfile
  26. is specified, input is read from standard input.
  27. .SH OPTIONS
  28. .TP
  29. .B -dxb
  30. An AutoCAD binary database import (.dxb) file is written.  This file
  31. is read with the DXBIN command and, once loaded, becomes part of
  32. the AutoCAD geometrical database and can be viewed and edited like
  33. any other object.  Each sequence of identical pixels becomes a
  34. separate object in the database; this can result in very large AutoCAD
  35. drawing files.  However, if you want to trace over a bitmap, it lets
  36. you zoom and pan around the bitmap as you wish.
  37. .TP
  38. .B -poly
  39. If the
  40. .B -dxb
  41. option is not specified, the output of
  42. .B ppmtoacad
  43. is an AutoCAD slide file.  Normally each row of pixels is
  44. represented by an AutoCAD line entity.  If
  45. .B -poly
  46. is selected, the pixels are rendered as filled polygons.  If the
  47. slide is viewed on a display with higher resolution than the source
  48. pixmap, this will cause the pixels to expand instead of appearing as
  49. discrete lines against the screen background colour.  Regrettably,
  50. this representation yields slide files which occupy more disc space
  51. and take longer to display.
  52. .TP
  53. .BI -background " colour"
  54. Most AutoCAD display drivers can be configured to use any available
  55. colour as the screen background.  Some users perfer a black screen
  56. background, others white, while splinter groups advocate burnt ocher,
  57. tawny puce, and shocking grey.  Discarding pixels whose closest
  58. AutoCAD colour representation is equal to the background colour can
  59. substantially reduce the size of the AutoCAD database or slide file
  60. needed to represent a bitmap.  If no
  61. .B -background
  62. colour is specified, the screen background colour is assumed to be
  63. black.  Any AutoCAD colour number may be specified as the screen
  64. background; colour numbers are assumed to specify the hues defined
  65. in the standard AutoCAD 256 colour palette.
  66. .TP
  67. .B -white
  68. Since many AutoCAD users choose a white screen background, this option
  69. is provided as a short-cut.  Specifying
  70. .B -white
  71. is identical in effect to
  72. .BR "-background 7" .
  73. .TP
  74. .BI -aspect " ratio"
  75. If the source pixmap had non-square pixels, the ratio of the pixel
  76. width to pixel height should be specified as
  77. .IR ratio .
  78. The resulting slide or .dxb file will be corrected so that pixels on
  79. the AutoCAD screen will be square.  For example, to correct an image made
  80. for a 320x200 VGA/MCGA screen, specify
  81. .BR "-aspect 0.8333" .
  82. .TP
  83. .B -8
  84. Restricts the colours in the output file to the 8 RGB shades.
  85. .PP
  86. All flags can be abbreviated to their shortest unique prefix.
  87. .SH BUGS
  88. AutoCAD has a fixed palette of 256 colours, distributed along the hue,
  89. lightness, and saturation axes.  Pixmaps which contain many
  90. nearly-identical colours, or colours not closely approximated by
  91. AutoCAD's palette, may be poorly rendered.
  92. .PP
  93. .B ppmtoacad
  94. works best if the system displaying its output supports the full 256
  95. colour AutoCAD palette.  Monochrome, 8 colour, and 16 colour
  96. configurations will produce less than optimal results.
  97. .PP
  98. When creating a .dxb file or a slide file with the
  99. .B -poly
  100. option,
  101. .B ppmtoacad
  102. finds both vertical and horizontal runs of identical pixels and
  103. consolidates them into rectangular regions to reduce the size of the
  104. output file.  This is effective for images with large areas of
  105. constant colour but it's no substitute for true raster to vector
  106. conversion.  In particular, thin diagonal lines are not optimised at
  107. all by this process.
  108. .PP
  109. Output files can be huge.
  110. .SH "SEE ALSO"
  111. AutoCAD Reference Manual:
  112. .I Slide File Format
  113. and
  114. .IR "Binary Drawing Interchange (DXB) Files" ,
  115. .BR ppm (5)
  116. .SH AUTHOR
  117. .RS 5
  118. .nf
  119. John Walker
  120. Autodesk SA
  121. Avenue des Champs-Montants 14b
  122. CH-2074 MARIN
  123. Suisse/Schweiz/Svizzera/Svizra/Switzerland
  124. .PD 0
  125. .TP 9
  126. Usenet:
  127. kelvin@Autodesk.com
  128. .TP
  129. Fax:
  130. 038/33 88 15
  131. .TP
  132. Voice:
  133. 038/33 76 33
  134. .fi
  135. .RE
  136. .PD
  137. .PP
  138. Permission to use, copy, modify, and distribute this software and its
  139. documentation for any purpose and without fee is hereby granted,
  140. without any conditions or restrictions.  This software is provided ``as
  141. is'' without express or implied warranty.
  142. .PP
  143. AutoCAD and Autodesk are registered trademarks of Autodesk, Inc.
  144.