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 / pgmcrater.1 < prev    next >
Text File  |  1996-11-18  |  5KB  |  169 lines
  1. .TH pgmcrater 1 "15 October 1991"
  2. .IX pgmcrater
  3. .IX fractals
  4. .IX craters
  5. .SH NAME
  6. pgmcrater - create cratered terrain by fractal forgery
  7. .SH SYNOPSIS
  8. .na
  9. .B pgmcrater
  10. 'ti 15
  11. .RB [ -number
  12. .IR n ]
  13. .RB [ -height | -ysize
  14. .IR s ]
  15. .RB [ -width | -xsize
  16. .IR s ]
  17. .RB [ -gamma
  18. .IR g ]
  19. .ad
  20. .SH DESCRIPTION
  21. .B pgmcrater
  22. creates a portable graymap which mimics cratered terrain.  The graymap
  23. is created by simulating the impact of a given number of craters with
  24. random position and size, then rendering the resulting terrain
  25. elevations based on a light source shining from one side of the
  26. screen.  The size distribution of the craters is based on a power law
  27. which results in many more small craters than large ones.  The number
  28. of craters of a given size varies as the reciprocal of the area as
  29. described on pages 31 and 32 of Peitgen and Saupe[1]; cratered bodies
  30. in the Solar System are observed to obey this relationship.  The
  31. formula used to obtain crater radii governed by this law from a
  32. uniformly distributed pseudorandom sequence was developed by Rudy
  33. Rucker.
  34. .PP
  35. High resolution images with large numbers of craters often benefit
  36. from being piped through
  37. .BR pnmsmooth .
  38. The averaging performed by this process eliminates some of the jagged
  39. pixels and lends a mellow ``telescopic image'' feel to the overall
  40. picture.
  41. .SH OPTIONS
  42. .TP 10
  43. .BI -number " n"
  44. Causes
  45. .I n
  46. craters to be generated.  If no
  47. .B -number
  48. specification is given, 50000 craters will be generated.  Don't expect
  49. to see them all!  For every large crater there are many, many more
  50. tiny ones which tend simply to erode the landscape.  In general, the
  51. more craters you specify the more realistic the result; ideally you
  52. want the entire terrain to have been extensively turned over again and
  53. again by cratering.  High resolution images containing five to ten
  54. million craters are stunning but take quite a while to create.
  55. .TP
  56. .BI -height " height"
  57. Sets the height of the generated image to
  58. .I height
  59. pixels.  The default height is 256 pixels.
  60. .TP
  61. .BI -width " width"
  62. Sets the width of the generated image to
  63. .I width
  64. pixels.  The default width is 256 pixels.
  65. .TP
  66. .BI -xsize " width"
  67. Sets the width of the generated image to
  68. .I width
  69. pixels.  The default width is 256 pixels.
  70. .TP
  71. .BI -ysize " height"
  72. Sets the height of the generated image to
  73. .I height
  74. pixels.  The default height is 256 pixels.
  75. .TP
  76. .BI -gamma " factor"
  77. The specified
  78. .I factor
  79. is used to gamma correct the graymap in the same manner as performed
  80. by
  81. .BR pnmgamma .
  82. The default value is 1.0, which results in a medium contrast image.
  83. Values larger than 1 lighten the image and reduce contrast, while
  84. values less than 1 darken the image, increasing contrast.
  85. .PP
  86. All flags can be abbreviated to their shortest unique prefix.
  87. .SH BUGS
  88. The
  89. .B -gamma
  90. option isn't really necessary since you can achieve the same
  91. effect by piping the output from
  92. .B pgmcrater
  93. through
  94. .BR pnmgamma .
  95. However,
  96. .B pgmcrater
  97. performs an internal gamma map anyway in the process of rendering the
  98. elevation array into a graymap, so there's no additional overhead in
  99. allowing a user-specified gamma.
  100. .PP
  101. Real craters have two distinct morphologies.
  102. .B pgmcrater
  103. simulates only small craters, which are hemispherical in shape
  104. (regardless of the incidence angle of the impacting body, as long as the
  105. velocity is sufficiently high).  Large craters, such as Copernicus and
  106. Tycho on the Moon, have a ``walled plain'' shape with a cross-section more
  107. like:
  108. .nf
  109. .ne 2
  110. .cs R 18
  111.                 /\\                            /\\
  112. .br
  113.           _____/  \\____________/\\____________/  \\_____
  114. .cs R
  115. .fi
  116. .ss 12
  117. Larger craters should really use this profile, including the central
  118. peak, and totally obliterate the pre-existing terrain.
  119. .SH "SEE ALSO"
  120. .PD
  121. .BR pgm (5),
  122. .BR pnmgamma (1),
  123. .BR pnmsmooth (1)
  124. .TP 5
  125. [1]
  126. Peitgen, H.-O., and Saupe, D. eds., The Science Of Fractal Images,
  127. New York: Springer Verlag, 1988.
  128. .ne 10
  129. .SH AUTHOR
  130. .RS 5
  131. .nf
  132. John Walker
  133. Autodesk SA
  134. Avenue des Champs-Montants 14b
  135. CH-2074 MARIN
  136. Suisse/Schweiz/Svizzera/Svizra/Switzerland
  137. .PD 0
  138. .TP 9
  139. Usenet:
  140. kelvin@Autodesk.com
  141. .TP
  142. Fax:
  143. 038/33 88 15
  144. .TP
  145. Voice:
  146. 038/33 76 33
  147. .fi
  148. .RE
  149. .PD
  150. .PP
  151. Permission to use, copy, modify, and distribute this software and its
  152. documentation for any purpose and without fee is hereby granted,
  153. without any conditions or restrictions.  This software is provided ``as
  154. is'' without express or implied warranty.
  155. .PP
  156. .B PLUGWARE!
  157. If you like this kind of stuff, you may also enjoy ``James Gleick's
  158. Chaos--The Software'' for MS-DOS, available for $59.95 from your
  159. local software store or directly from Autodesk, Inc., Attn: Science
  160. Series, 2320 Marinship Way, Sausalito, CA 94965, USA.  Telephone:
  161. (800) 688-2344 toll-free or, outside the U.S. (415) 332-2344 Ext
  162. 4886.  Fax: (415) 289-4718.  ``Chaos--The Software'' includes a more
  163. comprehensive fractal forgery generator which creates
  164. three-dimensional landscapes as well as clouds and planets, plus five
  165. more modules which explore other aspects of Chaos.  The user guide of
  166. more than 200 pages includes an introduction by James Gleick and
  167. detailed explanations by Rudy Rucker of the mathematics and algorithms
  168. used by each program.
  169.