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 / pnmscale.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  79 lines

  1. .TH pnmscale 1 "12 January 1991"
  2. .IX pnmscale
  3. .SH NAME
  4. pnmscale - scale a portable anymap
  5. .SH SYNOPSIS
  6. .B pnmscale
  7. .I s
  8. .RI [ pnmfile ]
  9. .br
  10. .B pnmscale
  11. .BR -xsize | -width | -ysize |
  12. .BR -height
  13. .I s
  14. .RI [ pnmfile ]
  15. .br
  16. .B pnmscale
  17. .BR -xscale | -yscale
  18. .I s
  19. .RI [ pnmfile ]
  20. .br
  21. .B pnmscale
  22. .BR -xscale | -xsize | -width
  23. .I s
  24. .BR -yscale | -ysize | -height
  25. .I s
  26. .RI [ pnmfile ]
  27. .br
  28. .B pnmscale -xysize
  29. .I x y
  30. .RI [ pnmfile ]
  31. .br
  32. .B pnmscale \-pixels
  33. .I n
  34. .RI [ pnmfile ]
  35. .SH DESCRIPTION
  36. Reads a portable anymap as input.
  37. Scales it by the specified factor or factors and produces a portable
  38. anymap as output.
  39. .IX shrinking
  40. .IX enlarging
  41. If the input file is in color, the output will be too,
  42. otherwise it will be grayscale.
  43. You can both enlarge (scale factor > 1) and reduce (scale factor < 1).
  44. .PP
  45. You can specify one dimension as a pixel size, and the other dimension
  46. will be scaled correspondingly.
  47. .PP
  48. You can specify one dimension as a scale, and the other dimension
  49. will not be scaled.
  50. .PP
  51. You can specify different sizes or scales for each axis.
  52. .PP
  53. You can use the special
  54. .B -xysize
  55. flag, which fits the image into
  56. the specified size without changing the aspect ratio.
  57. .PP
  58. Or, you can use the
  59. .B \-pixels
  60. flag, which fits the image into the specified number of
  61. pixels without changing the aspect ratio.
  62. .PP
  63. All flags can be abbreviated to their shortest unique prefix.
  64. .PP
  65. If you enlarge by a factor of 3 or more, you should probably add a
  66. .I pnmsmooth
  67. .IX pnmsmooth
  68. step; otherwise, you can see the original pixels in the resulting image.
  69. .SH "SEE ALSO"
  70. pbmreduce(1), pnmenlarge(1), pnmsmooth(1), pnm(5)
  71. .SH AUTHOR
  72. Copyright (C) 1989, 1991 by Jef Poskanzer.
  73. .\" Permission to use, copy, modify, and distribute this software and its
  74. .\" documentation for any purpose and without fee is hereby granted, provided
  75. .\" that the above copyright notice appear in all copies and that both that
  76. .\" copyright notice and this permission notice appear in supporting
  77. .\" documentation.  This software is provided "as is" without express or
  78. .\" implied warranty.
  79.