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 / pnmalias.1 < prev    next >
Text File  |  1996-11-18  |  3KB  |  113 lines
  1. .TH pnmalias 1 "30 April 1992"
  2. .IX pnmalias
  3. .SH NAME
  4. pnmalias - antialias a portable anyumap.
  5. .SH SYNOPSIS
  6. .B pnmalias
  7. .RB [ -bgcolor
  8. .IR color ]
  9. .RB [ -fgcolor
  10. .IR color ]
  11. .RB [ -bonly ]
  12. .RB [ -fonly ]
  13. .RB [ -balias ]
  14. .RB [ -falias ]
  15. .RB [ -weight
  16. .IR w ]
  17. .RI [ pnmfile ]
  18. .SH DESCRIPTION
  19. Reads a portable anymap as input, and applies anti-aliasing to background and
  20. foreground pixels.
  21. If the input file is a portable bitmap, the 
  22. output anti-aliased image is promoted to a graymap, and a message is printed
  23. informing the user of the change in format.
  24. .SH OPTIONS
  25. .PP
  26. .B \-bgcolor 
  27. .I colorb,
  28. .B \-fgcolor
  29. .I colorf
  30. .RS
  31. set the background color to 
  32. .I colorb,
  33. and the foreground to color to
  34. .I colorf.
  35. Pixels with these values will be anti-aliased. by default,
  36. the background color is taken to be black, and foreground color
  37. is assumed to be white.  
  38. The colors can be specified in five ways:
  39. .TP 5
  40. .B o
  41. A name, assuming
  42. that a pointer to an X11-style color names file was compiled in.
  43. .TP
  44. .B o
  45. An X11-style hexadecimal specifier: rgb:r/g/b, where r g and b are
  46. each 1- to 4-digit hexadecimal numbers.
  47. .TP
  48. .B o
  49. An X11-style decimal specifier: rgbi:r/g/b, where r g and b are
  50. floating point numbers between 0 and 1.
  51. .TP
  52. .B o
  53. For backwards compatibility, an old-X11-style hexadecimal
  54. number: #rgb, #rrggbb, #rrrgggbbb, or #rrrrggggbbbb.
  55. .TP
  56. .B o
  57. For backwards compatibility, a triplet of numbers
  58. separated by commas: r,g,b, where r g and b are
  59. floating point numbers between 0 and 1.
  60. (This style was added before MIT came up with the similar rgbi style.)
  61. .LP
  62. Note that even when dealing with graymaps, background and foreground
  63. colors need to be specified in the fashion described above.
  64. In this case, background and foreground pixel values are taken to be the
  65. value of the red component for the given color.
  66. .RE
  67. .PP
  68. .BR \-bonly , 
  69. .B \-fonly
  70. .RS
  71. Apply anti-aliasing only to background 
  72. .RB ( \-bonly ),
  73. or foreground
  74. .RB ( \-fonly )
  75. pixels.
  76. .RE
  77. .PP
  78. .BR \-balias ,
  79. .B \-falias
  80. .RS
  81. Apply anti-aliasing to all pixels surrounding background
  82. .RB ( \-balias ),
  83. or foreground
  84. .RB ( \-falias )
  85. pixels.  By default, anti-aliasing takes place only among neighboring
  86. background and foreground pixels.
  87. .RE
  88. .PP
  89. .B \-weight
  90. .I w
  91. .RS
  92. Use 
  93. .I w
  94. as the central weight for the aliasing filter.
  95. .I W 
  96. must be a real number in the range
  97. 0 < 
  98. .I w
  99. < 1.
  100. The lower the value of 
  101. .I w 
  102. is, the "blurrier" the output image is.  The default is w = 1/3.
  103. .SH "SEE ALSO"
  104. pbmtext(1), pnmsmooth(1), pnm(5)
  105. .SH AUTHOR
  106. Copyright (C) 1992 by Alberto Accomazzi, Smithsonian Astrophysical Observatory.
  107. .\" Permission to use, copy, modify, and distribute this software and its
  108. .\" documentation for any purpose and without fee is hereby granted, provided
  109. .\" that the above copyright notice appear in all copies and that both that
  110. .\" copyright notice and this permission notice appear in supporting
  111. .\" documentation.  This software is provided "as is" without express or
  112. .\" implied warranty.
  113.